diff --git a/.agents/skills/capture-release-evidences/SKILL.md b/.agents/skills/capture-release-evidences/SKILL.md new file mode 100644 index 0000000000..e52cd9d159 --- /dev/null +++ b/.agents/skills/capture-release-evidences/SKILL.md @@ -0,0 +1,52 @@ +--- +name: capture-release-evidences-cx +description: Automatically run a browser-automation agent to visually validate all new UI features from the current release and capture evidence WebP recordings of the changes. +--- + +# Capture Release Evidences Workflow + +Use this workflow to automatically drive a browser-automation agent to explore the newly deployed or locally running application and record evidence of the UI changes introduced in the latest release. + +> **Tool mapping note (v3.8):** The `browser_subagent` tool referenced below is specific to an earlier agent runtime. In Claude Code, substitute with the available browser MCP tools (e.g. `mcp__claude-in-chrome__*`) for navigation/screenshots, plus the `Write` tool for saving artifacts. The high-level steps remain the same regardless of the browser-automation surface in use. + +## Prerequisites + +- OmniRoute must be actively running and accessible (e.g. locally at `http://localhost:20128` or on the Local VPS at `http://192.168.0.15:20128`). +- The user must provide the target URL to be tested, or default to `http://192.168.0.15:20128`. + +## Workflow Steps + +### 1. Identify Target Features + +Review the `CHANGELOG.md` for the latest version to map out the new UI elements. For example: + +- **CLI Tools Settings** +- **New Provider/Model Listings (e.g., Gemini 3.1, Qoder PAT)** +- **New Feature Modals** + +### 2. Run the Browser Subagent + +For each identified feature, invoke the `browser_subagent` using the `default_api:browser_subagent` tool. +**Important Task Guidelines for the Subagent:** + +- `TaskName`: Give it a clear name like "Validate CLIProxyAPI Tool Tab". +- `TaskSummary`: "Navigate to the CLI Tools tab and verify the new Integration settings." +- `Task`: Provide unambiguous instructions for the subagent, such as: "Navigate to http://192.168.0.15:20128/dashboard. Click on the 'Settings' or 'CLI Tools' nav link. Scroll down to find the CLIProxyAPI integration card. Hover over it to trigger UI state. Verify the components render correctly and exit." +- `RecordingName`: Ensure it describes the feature (e.g. `v3_4_5_cli_proxy_api`). This is required and strictly automatically saved as a WebP artifacts video by the system. + +_(Note: The `browser_subagent` automatically creates a WebP recording named by the `RecordingName` parameter. No additional tools for screenshots are needed.)_ + +### 3. Generate Report Artifact + +After the `browser_subagent` finishes its sessions, generate a final Markdown artifact (using `Write` and `IsArtifact=true`) to present the recordings inline to the user using the `![caption](/absolute/path/to/media.webp)` syntax. + +### Example Invocation + +\```json +{ +"TaskName": "Validating Qoder PAT Configuration UI", +"TaskSummary": "Validates the Qoder provider configuration modal", +"Task": "Go to http://192.168.0.15:20128/dashboard. Click on the 'Providers' tab. Find 'Qoder' in the list. Click 'Add Token' or 'Configure'. Type 'test_token' and submit. Return when done.", +"RecordingName": "qoder_pat_ui_validation" +} +\``` diff --git a/.agents/skills/deploy-vps-akamai/SKILL.md b/.agents/skills/deploy-vps-akamai/SKILL.md new file mode 100644 index 0000000000..a0f0cd25c6 --- /dev/null +++ b/.agents/skills/deploy-vps-akamai/SKILL.md @@ -0,0 +1,45 @@ +--- +name: deploy-vps-akamai-cx +description: Deploy the latest OmniRoute code to the Akamai VPS (69.164.221.35) +--- + +# Deploy to Akamai VPS Workflow + +Deploy OmniRoute to the Akamai VPS using `npm pack + scp` + PM2. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` only for independent commands. Do not parallelize dependent build, copy, install, restart, and verification steps. +- Report each remote result explicitly before finishing. + +**Akamai VPS:** `69.164.221.35` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to Akamai VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@69.164.221.35:/tmp/ +``` + +```bash +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'AKAMAI HTTP %{http_code}\n' http://69.164.221.35:20128/ +``` diff --git a/.agents/skills/deploy-vps-both/SKILL.md b/.agents/skills/deploy-vps-both/SKILL.md new file mode 100644 index 0000000000..867fba8f9a --- /dev/null +++ b/.agents/skills/deploy-vps-both/SKILL.md @@ -0,0 +1,56 @@ +--- +name: deploy-vps-both-cx +description: Deploy the latest OmniRoute code to BOTH the Akamai VPS and the Local VPS +--- + +# Deploy to VPS (Both) Workflow + +Deploy OmniRoute to the production VPSs using `npm pack + scp` + PM2. + +**Akamai VPS:** `69.164.221.35` +**Local VPS:** `192.168.0.15` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` +**PM2 entry:** `/usr/lib/node_modules/omniroute/app/server.js` + +> [!IMPORTANT] +> The npm registry rejects packages > 100MB, so deployment uses **npm pack + scp**. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` only for independent commands. +- Build/package once first. After the artifact exists, copy/install/verify on Akamai and Local may run in parallel if they do not depend on each other. +- Report each VPS result explicitly before finishing. + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to both VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@69.164.221.35:/tmp/ && scp omniroute-*.tgz root@192.168.0.15:/tmp/ +``` + +```bash +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" +``` + +```bash +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'AKAMAI HTTP %{http_code}\n' http://69.164.221.35:20128/ +curl -s -o /dev/null -w 'LOCAL HTTP %{http_code}\n' http://192.168.0.15:20128/ +``` diff --git a/.agents/skills/deploy-vps-local/SKILL.md b/.agents/skills/deploy-vps-local/SKILL.md new file mode 100644 index 0000000000..6ba355a263 --- /dev/null +++ b/.agents/skills/deploy-vps-local/SKILL.md @@ -0,0 +1,45 @@ +--- +name: deploy-vps-local-cx +description: Deploy the latest OmniRoute code to the Local VPS (192.168.0.15) +--- + +# Deploy to Local VPS Workflow + +Deploy OmniRoute to the Local VPS using `npm pack + scp` + PM2. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` only for independent commands. Do not parallelize dependent build, copy, install, restart, and verification steps. +- Report each remote result explicitly before finishing. + +**Local VPS:** `192.168.0.15` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to Local VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@192.168.0.15:/tmp/ +``` + +```bash +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'LOCAL HTTP %{http_code}\n' http://192.168.0.15:20128/ +``` diff --git a/.agents/skills/generate-release/SKILL.md b/.agents/skills/generate-release/SKILL.md new file mode 100644 index 0000000000..6632c2a434 --- /dev/null +++ b/.agents/skills/generate-release/SKILL.md @@ -0,0 +1,368 @@ +--- +name: generate-release-cx +description: Create a new release, bump version up to the .10 patch threshold, update changelog, and manage Pull Requests +--- + +# Generate Release Workflow + +Bump version, finalize CHANGELOG, commit, open a **PR to main** and wait for user confirmation before tagging, publishing, and deploying. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` for independent reads, checks, and GitHub calls. +- When the workflow says `notify_user` or `BlockedOnUser: true`, present the report/status in the final response and stop. Do not continue into the next phase until the user explicitly approves. + +> **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** +> NEVER use `npm version minor` or `npm version major`. +> Always use: `npm version patch --no-git-tag-version` +> The threshold rule: when `y` reaches 10, bump to `3.(x+1).0` — e.g. `3.8.10` → `3.9.0`. + +> **🔴 SINGLE BRANCH RULE**: The `release/vX.Y.Z` branch is the **ONLY** development branch for the entire release cycle. ALL work — bug fixes, feature implementations, PR integrations, issue resolutions — MUST be committed directly on this branch. Never create separate `fix/`, `feat/`, or topic branches. When running `/resolve-issues`, `/implement-features`, or `/review-prs`, always work on the current release branch. + +--- + +## ⚠️ Two-Phase Flow + +``` +Phase 1 (automated): bump → docs → i18n → commit → push → open PR + ↕ 🛑 STOP: Notify user, wait for PR confirmation +Phase 2 (post-merge): tag → publish → GitHub release → Docker → deploy +``` + +**NEVER push directly to main or create tags before the user confirms the PR.** + +--- + +## Phase 0: Security Verification (MANDATORY) + +Before creating the release, you must ensure the codebase and supply chain are secure and free of known vulnerabilities. + +1. **Run Local Dependencies Audit:** + + ```bash + npm audit + ``` + + _Fix any `high` or `critical` vulnerabilities identified._ + +2. **Check GitHub CodeQL & Dependabot Alerts:** + Navigate to the repository's **Security** tab on GitHub, or use the project's `vulnerability-scanner` skill to analyze active alerts. Ensure all static analysis findings (e.g., prototype pollution, insecure randomness, ReDoS, shell injections) are addressed and logically committed on a target branch. + +--- + +## Phase 1: Pre-Merge + +### 1. Create release branch + +```bash +git checkout -b release/v3.x.y +``` + +### 2. Determine and sync version + +Check current version in `package.json`: + +```bash +grep '"version"' package.json +``` + +> **🔴 BRANCH-VERSION PARITY RULE**: The logical version in `package.json` MUST exactly match the release branch name. For example, if you are on `release/v3.7.0`, the version in `package.json` MUST be `3.7.0`. +> +> - If this is the FIRST time generating a release for a new minor/major branch (e.g., bumping from 3.6.9 to 3.7.0), you MUST ensure the version is bumped to match the new branch logic. +> - If you are just bumping a patch on the current branch (e.g., 3.6.9 to 3.6.10), use: +> `npm version patch --no-git-tag-version` + +> **⚠️ ATOMIC COMMIT RULE — Version bump MUST happen before committing feature files.** +> +> **CORRECT order:** +> +> 1. `npm version patch --no-git-tag-version` ← bump first +> 2. implement features / fix bugs +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` +> +> **OR if features are already staged:** +> +> 1. implement features (do NOT commit yet) +> 2. `npm version patch --no-git-tag-version` ← bump before committing +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` +> +> **NEVER do this (creates version mismatch in git history):** +> +> - ~~commit features → then bump version → commit package.json separately~~ +> +> This ensures that `git show v3.x.y` always contains both code changes and the version bump together. +> The GitHub release tag will point to a commit that includes ALL changes for that version. + +### 3. Regenerate lock file (REQUIRED after version bump) + +**Mandatory** — skipping causes `@swc/helpers` lock mismatch and CI failures: + +```bash +npm install +``` + +### 4. Finalize CHANGELOG.md + +> **🔴 NO MIXUPS RULE**: Ensure you do NOT mix the backlog of the previous version with the new one. The new version section must ONLY contain the features and fixes for the current release. + +Replace the `[Unreleased]` header with the new version and date. +Keep an empty `## [Unreleased]` section above it, separated by a horizontal rule (`---`). + +```markdown +## [Unreleased] + +--- + +## [3.7.0] — 2026-04-19 + +### ✨ New Features + +- ... + +### 🐛 Bug Fixes + +- ... + +--- + +## [3.6.9] — 2026-04-19 +``` + +### 5. Update openapi.yaml version ⚠️ MANDATORY + +> **CI will fail** if `docs/reference/openapi.yaml` version ≠ `package.json` version (`check:docs-sync` enforces this). + +// turbo + +```bash +VERSION=$(node -p "require('./package.json').version") +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml +echo "✓ openapi.yaml → $VERSION" + +for dir in electron open-sse; do + if [ -d "$dir" ] && [ -f "$dir/package.json" ]; then + (cd "$dir" && npm version "$VERSION" --no-git-tag-version --allow-same-version > /dev/null) + echo "✓ $dir/package.json → $VERSION" + fi +done +# Re-run install to assert the workspace lockfile is updated +npm install +``` + +### 6. Update README.md and i18n docs + +Manually perform these documentation updates (there is no `/update-docs` workflow — it was deprecated in v3.8): + +- Update feature table rows and "What's new in vX.Y.Z" section in `README.md` +- Sync feature changes to all 40 language `docs/i18n/*/README.md` files (use the same row edits across each translated README) +- Update the relevant `docs/.md` if architecture or counts changed +- Re-run `npm run check:docs-sync` and `npm run check:docs-all` to catch drift + +### 7. Run tests + +// turbo + +```bash +npm test +``` + +All tests must pass before creating the PR. + +### 8. Stage, commit, and push + +// turbo-all + +```bash +git add -A +git commit -m "chore(release): v3.x.y — summary of changes" +git push origin release/v3.x.y +``` + +### 9. Open PR to main + +### 9. Open PR to main + +// turbo + +```bash +VERSION=$(node -p "require('./package.json').version") + +# Extract the exact changelog entry for this version from the root CHANGELOG.md +awk "/^## \\[$VERSION\\]/{flag=1; print; next} /^---/{if(flag) {flag=0; exit}} flag" CHANGELOG.md > /tmp/changelog_body.txt + +# Append test status and next steps +echo "" >> /tmp/changelog_body.txt +echo "### Tests" >> /tmp/changelog_body.txt +echo "- All tests pass" >> /tmp/changelog_body.txt +echo "" >> /tmp/changelog_body.txt +echo "### ⚠️ After merging: run Phase 2 steps to tag, publish, and deploy." >> /tmp/changelog_body.txt + +gh pr create \ + --repo diegosouzapw/OmniRoute \ + --base main \ + --head release/v$VERSION \ + --title "Release v$VERSION" \ + --body-file /tmp/changelog_body.txt +``` + +### 10. 🛑 STOP — Notify User & Await PR Confirmation + +**This is a mandatory stop point.** Present the report in the final response and stop. Do not continue to the next phase until the user explicitly approves. + +Inform the user: + +- PR URL +- Summary of changes +- Test results +- List of files changed + +**DO NOT proceed to Phase 2 until the user confirms the PR looks good and merges it.** + +--- + +## Phase 2: Post-Merge Validation (Local VPS) + +> Run these steps only AFTER the user has merged the PR into `main` and all CI jobs have passed. + +### 11. Deploy to Local VPS for Final Validation (MANDATORY) + +Before cutting the official git tag and publishing to the world, deploy the `main` branch to the Local VPS for a final homologation test. + +```bash +git checkout main +git pull origin main + +# Build and pack locally +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts + +# Deploy to LOCAL VPS (192.168.0.15) +scp omniroute-*.tgz root@192.168.0.15:/tmp/ +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" + +# Verify +curl -s -o /dev/null -w "LOCAL: HTTP %{http_code}\n" http://192.168.0.15:20128/ +``` + +### 12. 🛑 STOP — Notify User & Await Final OK + +**This is a mandatory stop point.** +Inform the user that the `main` branch is now running on the Local VPS. +Wait for the user to manually test and give the **OK**. +**DO NOT proceed to Phase 3 until the user confirms the local deploy is stable.** + +--- + +## Phase 3: Official Launch + +> Run these steps only AFTER the user gives the final OK from the Phase 2 local validation. + +### 13. Create Git Tag and GitHub Release (MANDATORY) + +// turbo + +```bash +git checkout main +git pull origin main +VERSION=$(node -p "require('./package.json').version") + +# Extracts the changelog section for this version +NOTES=$(awk "/^## \\[$VERSION\\]/{flag=1; next} /^---/{if(flag) {flag=0; exit}} flag" CHANGELOG.md | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//') +if [ -z "$NOTES" ]; then NOTES="OmniRoute v$VERSION Release"; fi + +git tag -a "v$VERSION" -m "Release v$VERSION" +git push origin "v$VERSION" +gh release create "v$VERSION" --repo diegosouzapw/OmniRoute --title "v$VERSION" --notes "$NOTES" --target main || gh release edit "v$VERSION" --repo diegosouzapw/OmniRoute --title "v$VERSION" --notes "$NOTES" +``` + +### 14. 🐳 Trigger Docker Hub build (MANDATORY — keep npm and Docker in sync) + +> **CRITICAL**: Docker Hub and npm MUST always publish the same version. +> The Docker image is built automatically via GitHub Actions when a new tag is pushed. +> After pushing the tag in step 13, **verify the workflow runs**: + +```bash +# Verify the Docker workflow triggered +gh run list --repo diegosouzapw/OmniRoute --workflow docker-publish.yml --limit 3 + +# Wait for the Docker build to complete (usually 5–10 min) +gh run watch --repo diegosouzapw/OmniRoute +``` + +### 15. Publish to NPM (Optional/Automated) + +Normally handled by CI, but if manual publish is required: + +```bash +npm publish +``` + +### 16. Deploy to AKAMAI VPS (Production) + +Now that the release is officially cut, deploy it to the Akamai VPS. + +```bash +# Deploy to AKAMAI VPS (69.164.221.35) +scp omniroute-*.tgz root@69.164.221.35:/tmp/ +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" + +# Verify +curl -s -o /dev/null -w "AKAMAI: HTTP %{http_code}\n" http://69.164.221.35:20128/ +``` + +## Phase 4: Release Monitoring & Artifact Validation + +> After triggering the official release, actively monitor the CI pipelines until all artifacts are successfully generated. If any pipeline fails, stop and apply the necessary corrections before continuing. + +### 18. Monitor CI Pipelines + +Wait for and verify the successful completion of the following automated jobs: + +1. **Docker Hub Publish** +2. **Electron Build** +3. **NPM Registry Publish** (Check with `npm info omniroute version`) + +```bash +# Monitor Docker Hub workflow +gh run list --repo diegosouzapw/OmniRoute --workflow docker-publish.yml --limit 1 +gh run watch + +# Monitor Electron build +gh run list --repo diegosouzapw/OmniRoute --workflow electron-release.yml --limit 1 +gh run watch + +# Verify NPM version +npm info omniroute version +``` + +### 19. Handle Failures (If Any) + +If a workflow fails: + +- Use `gh run view --log-failed` to identify the error. +- Apply the fix on the `main` branch. +- If necessary, re-trigger the workflow using `gh workflow run --repo diegosouzapw/OmniRoute --ref v3.x.y` + +### 20. Preserve release branch + +```bash +# Branch is kept for historical purposes. Do not delete. +``` + +--- + +## Notes + +- Ensure CHANGELOG, README and `docs/*` are current BEFORE this workflow — run `npm run check:docs-all` and `/version-bump` first (there is no `/update-docs` workflow anymore) +- The `prepublishOnly` script runs `npm run build:cli` automatically during `npm publish` +- After npm publish, verify with `npm info omniroute version` +- Lock file sync errors are caused by skipping `npm install` after version bump +- Use `gh auth switch -u diegosouzapw` if git push fails with wrong account + +## Known CI Pitfalls + +| CI failure | Cause | Fix | +| ------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- | +| `[docs-sync] FAIL - OpenAPI version differs from package.json` | Skipped step 5 — `docs/reference/openapi.yaml` version not updated | Run step 5 (`sed -i ...`) and commit | +| `[docs-sync] FAIL - CHANGELOG.md first section must be "## [Unreleased]"` | `## [Unreleased]` missing or not at top of CHANGELOG | Add `## [Unreleased]\n\n---\n` before the first versioned `## [x.y.z]` | +| Electron Linux `.deb` build fails (`FpmTarget` error) | `fpm` Ruby gem not installed on `ubuntu-latest` runner | Already fixed in `electron-release.yml` (`gem install fpm` step) | +| Docker Hub `502 error writing layer blob` | Transient Docker Hub network error during ARM64 push | Re-run the Docker publish workflow; no code change needed | diff --git a/.agents/skills/implement-features/SKILL.md b/.agents/skills/implement-features/SKILL.md new file mode 100644 index 0000000000..ff88804039 --- /dev/null +++ b/.agents/skills/implement-features/SKILL.md @@ -0,0 +1,713 @@ +--- +name: implement-features-cx +description: Analyze open feature request issues, implement viable ones on dedicated branches, and respond to authors +--- + +# /implement-features — Feature Request Harvest, Research & Implementation Workflow + +## Overview + +A **5-phase** workflow that systematically harvests feature requests from GitHub issues, creates structured idea files, researches solutions across the internet and Git repositories, presents a consolidated report for user approval, then generates detailed implementation plans and executes them. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` for independent reads, checks, and GitHub calls. +- Approval gates are hard stops. Present the report/plan in the final response and do not move to implementation phases until the user explicitly approves. +- Keep harvest/research bounded enough to produce the approval report quickly; do not start implementation while still in report phases. + +**Output directory structure:** + +``` +_ideia/ +├── viable/ # Features approved for implementation +│ ├── need_details/ # ❓ Good idea but waiting for author clarification (issues stay OPEN) +│ │ └── 1015-warp-terminal-mitm.md +│ ├── 1046-native-playground.md # ✅ Ready — researched and planned +│ └── 1046-native-playground.requirements.md +├── defer/ # ⏭️ Good ideas deferred for future cycles (issues CLOSED) +│ └── 1041-smart-auto-combos.md +└── notfit/ # ❌ Out of scope / already exists (issues CLOSED) + └── 945-telegram-integration.md + +_tasks/features-vX.Y.Z/ # Implementation plans (per-release) +└── 1046-native-playground.plan.md +``` + +> **LIFECYCLE RULE:** `viable/` files are **DELETED** once the feature is implemented — they are not moved. Only unimplemented features live in `viable/` (or `viable/need_details/`). Files in `defer/` and `notfit/` remain as permanent reference. + +> **BRANCH RULE**: All implementation work MUST happen on the current `release/vX.Y.Z` branch. Never create separate `feat/` branches. If no release branch exists yet, create one first using `/generate-release` Phase 1 steps 1–5. + +--- + +## Phase 1 — Harvest: Collect & Catalog Feature Ideas + +### 1.1 Identify the Repository + +// turbo + +- Run: `git -C remote get-url origin` to extract owner/repo. + +### 1.2 Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 1.3 Fetch ALL Open Feature Requests + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh issue list` can be truncated by the tool, silently hiding issues. You MUST use the two-step approach below. + +**Step 1 — Get Issue numbers only** (small output, never truncated): + +```bash +# Fetch issues with feature/enhancement labels +gh issue list --repo / --state open -l "enhancement" --limit 500 --json number --jq '.[].number' + +# Also check for [Feature] in title (common pattern when no labels are set) +gh issue list --repo / --state open --limit 500 --json number,title --jq '.[] | select(.title | test("\\[Feature\\]|\\[feature\\]|feature request"; "i")) | .number' +``` + +- Merge both lists, deduplicate. Count and confirm the total. + +**Step 2 — Fetch full metadata for each Issue** (one call per issue): + +```bash +gh issue view --repo / --json number,title,labels,body,comments,createdAt,author,assignees +``` + +- Read the **entire body** — including description, use cases, screenshots, mockups, and any embedded images. +- Read **ALL comments** — community discussion, agreements, restrictions, owner responses, and linked PRs. +- **Images**: If the body or comments contain image URLs (`![...](...)` or `https://...png/jpg/gif`), note them — they may contain UI mockups, wireframes, or architecture diagrams that are essential to understanding the request. +- You may batch these into parallel calls (up to 4 at a time). +- Sort by oldest first (FIFO). + +### 1.4 Create Idea Files (initially in `_ideia/` root) + +For each feature request, create a structured idea file in `/_ideia/`: + +**Filename convention**: `-.md` +Example: `1046-native-playground.md`, `1041-smart-auto-combos.md` + +#### 1.4a — If the idea file does NOT exist yet, create it: + +```markdown +# Feature: + +> GitHub Issue: #<NUMBER> — opened by @<author> on <date> +> Status: 📋 Cataloged | Priority: TBD + +## 📝 Original Request + +<Paste the FULL issue body here, preserving all formatting, images, and code blocks> + +## 💬 Community Discussion + +<Summarize ALL comments chronologically, noting who said what and any decisions or objections raised> + +### Participants + +- @<author> — Original requester +- @<commenter1> — <brief role/opinion> +- ... + +### Key Points + +- <bullet list of the most important discussion points> +- <agreements reached> +- <objections raised> + +## 🎯 Refined Feature Description + +<YOUR interpretation and enrichment of the feature request. Expand on what was asked, fill in logical gaps, provide concrete examples of how it would work. This section should be MORE detailed and clearer than the original request.> + +### What it solves + +- <problem 1> +- <problem 2> + +### How it should work (high level) + +1. <step 1> +2. <step 2> +3. ... + +### Affected areas + +- <list of codebase areas, modules, files likely affected> + +## 📎 Attachments & References + +- <any image URLs, mockup links, or external references from the issue> + +## 🔗 Related Ideas + +- <links to related \_ideia/ files if any overlap found> +``` + +#### 1.4b — If the idea file ALREADY exists, update it: + +- Append new comments from the issue to the **Community Discussion** section. +- Update the **Refined Feature Description** if new information changes the understanding. +- Add any new **Related Ideas** cross-references found. +- **Do NOT overwrite** existing content — append and enrich it. + +### 1.5 Cross-Reference & Deduplication + +After processing all issues: + +- Scan all `_ideia/*.md` files for overlapping features. +- If two features are substantially the same, add `🔗 Related Ideas` cross-references to both. +- If one is a strict subset of another, note it in the smaller file: `> ℹ️ This feature is a subset of #<OTHER_NUMBER>. Consider implementing together.` + +--- + +## Phase 2 — Research: Find Solutions & Build Requirements + +For each cataloged idea that is **viable** (aligns with the project's goals): + +### 2.1 Viability Pre-Check + +Before investing in research, quickly assess: + +- [ ] Does this feature align with the project's goals and architecture? +- [ ] Is it technically feasible with the current codebase? +- [ ] Does it duplicate existing functionality? +- [ ] Would it introduce breaking changes or security risks? +- [ ] Is there enough detail to understand what's needed? + +**Verdict options:** + +| Verdict | When | Action | +| --------------------- | ------------------------------------- | --------------------------- | +| ✅ **VIABLE** | Good idea, enough context | Proceed to Research | +| ❓ **NEEDS DETAIL** | Good idea, insufficient spec | Skip research, ask author | +| ⏭️ **DEFER** | Good idea, too complex for this cycle | Catalog only, skip research | +| ❌ **NOT FIT** | Doesn't fit the project | Explain why | +| 🔁 **ALREADY EXISTS** | Feature already implemented | Point to existing feature | + +### 2.2 Internet Research (for VIABLE features) + +For each viable feature, perform systematic research: + +**Step 1 — Web search for similar implementations:** + +``` +WebSearch("how to implement <feature description> in <tech stack>") +WebSearch("<feature keyword> implementation nextjs typescript 2025 2026") +WebSearch("<feature keyword> open source library npm") +``` + +**Step 2 — Find reference Git repositories:** + +``` +WebSearch("site:github.com <feature keyword> <tech stack> stars:>100") +WebSearch("github <feature keyword> implementation recently updated 2026") +``` + +- Find **up to 10 relevant repositories**, sorted by most recently updated. +- For each repository: + - Note the repo URL, star count, last commit date + - Read its README and relevant source files via `WebFetch` + - Extract the architectural approach, patterns used, and key code snippets + +**Step 3 — Read API docs and standards:** + +If the feature involves an external API, protocol, or standard: + +- Find and read the official documentation +- Note version requirements, authentication patterns, rate limits + +### 2.3 Create Requirements File + +For each researched feature, create a requirements file alongside its idea file: + +**Filename**: `<NUMBER>-<kebab-case-short-title>.requirements.md` + +```markdown +# Requirements: <Feature Title> + +> Feature Idea: [#<NUMBER>](./<NUMBER>-<kebab-case-short-title>.md) +> Research Date: <YYYY-MM-DD> +> Verdict: ✅ VIABLE + +## 🔍 Research Summary + +<Brief summary of what was found during research> + +## 📚 Reference Implementations + +| # | Repository | Stars | Last Updated | Approach | Relevance | +| --- | ---------------- | ----- | ------------ | -------- | ------------ | +| 1 | [repo/name](url) | ⭐ N | YYYY-MM-DD | <brief> | High/Med/Low | +| 2 | ... | | | | | + +### Key Patterns Found + +- <pattern 1 with code snippet or link> +- <pattern 2> + +## 📐 Proposed Solution Architecture + +### Approach + +<Describe the chosen approach based on research findings> + +### New Files + +| File | Purpose | +| --------------------- | ------------- | +| `path/to/new/file.ts` | <description> | + +### Modified Files + +| File | Changes | +| -------------------------- | -------------- | +| `path/to/existing/file.ts` | <what changes> | + +### Database Changes + +- <migrations needed, if any> + +### API Changes + +- <new/modified endpoints, if any> + +### UI Changes + +- <new/modified pages/components, if any> + +## ⚙️ Implementation Effort + +- **Estimated complexity**: Low / Medium / High / Very High +- **Estimated files changed**: ~N +- **Dependencies needed**: <new npm packages, if any> +- **Breaking changes**: Yes/No — <details> +- **i18n impact**: <number of new translation keys> +- **Test coverage needed**: <brief description> + +## ⚠️ Open Questions + +- <question 1> +- <question 2> + +## 🔗 External References + +- <documentation URLs> +- <API references> +``` + +--- + +## Phase 2.5 — Organize & Respond: Sort Files and Post GitHub Comments + +### 2.5.1 Create Directory Structure + +// turbo + +```bash +mkdir -p <project_root>/_ideia/viable +mkdir -p <project_root>/_ideia/viable/need_details +mkdir -p <project_root>/_ideia/defer +mkdir -p <project_root>/_ideia/notfit +``` + +### 2.5.2 Move Idea Files to Category Subdirectories + +After classification, move EVERY idea file to its correct subdirectory: + +```bash +# ✅ VIABLE — move idea + requirements files +mv _ideia/<NUMBER>-*.md _ideia/viable/ +mv _ideia/<NUMBER>-*.requirements.md _ideia/viable/ + +# ❓ NEEDS DETAIL — viable but waiting for author response +mv _ideia/<NUMBER>-*.md _ideia/viable/need_details/ + +# ⏭️ DEFER — move idea files only +mv _ideia/<NUMBER>-*.md _ideia/defer/ + +# ❌ NOT FIT & 🔁 ALREADY EXISTS — move idea files only +mv _ideia/<NUMBER>-*.md _ideia/notfit/ +``` + +No files should remain in `_ideia/` root after this step (except subdirectories). + +### 2.5.3 Post GitHub Comments by Category + +**Each category has a specific comment template and action:** + +--- + +#### For 🔁 ALREADY EXISTS — Comment + CLOSE issue + +// turbo + +The feature already exists in the system. Explain WHERE it is and HOW to use it. + +```markdown +Hi @<author>! Thanks for the suggestion! 🙏 + +Great news — this functionality **already exists** in OmniRoute: + +**📍 Where to find it:** <exact dashboard path or settings location> + +**🔧 How to use it:** + +1. <step 1> +2. <step 2> +3. <step 3> + +If you have any trouble finding or using it, feel free to ask in a Discussion. We're always happy to help! + +Closing this as the feature is already available. 🎉 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ⏭️ DEFER — Comment + CLOSE issue + +// turbo + +Thank the user, explain the idea was cataloged, and that we'll study it before implementing. + +```markdown +Hi @<author>! Thanks for this thoughtful feature request! 🙏 + +We really appreciate the detailed proposal. We've **cataloged your idea** and it's now part of our improvement backlog. + +Due to the **significant architectural impact** of this feature, we'll need to conduct thorough use-case studies and architectural analysis before we start development. This ensures we build it right and don't introduce regressions. + +**What happens next:** + +- Your idea is saved in our internal feature backlog +- We'll conduct architecture studies when this area is prioritized +- We'll notify you here when development begins + +Thank you for contributing to OmniRoute's roadmap! Your input helps shape the product. 🚀 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ❌ NOT FIT — Comment + CLOSE issue + +// turbo + +Politely explain why the feature doesn't fit the project scope. + +```markdown +Hi @<author>! Thanks for the suggestion! 🙏 + +After careful analysis, we've determined that this feature **falls outside OmniRoute's core scope** as a proxy/router. + +**Reason:** <explain why — e.g., "Telegram integration belongs in the application/orchestrator layer that consumes OmniRoute's API, not inside the router itself."> + +**Alternative:** <suggest an alternative approach if possible> + +We appreciate you thinking of ways to improve OmniRoute! If you'd like to discuss this further, feel free to open a Discussion. 🙏 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ❓ NEEDS DETAIL — Comment (keep OPEN) + +// turbo + +Ask for the specific missing details needed. + +```markdown +Hi @<author>! Thanks for the feature request — it's an interesting idea and we'd love to explore it further. 🙏 + +To move forward, we need a few more details: + +1. <specific question 1> +2. <specific question 2> +3. <specific question 3> + +If you know of any **open-source projects or repositories** that implement something similar, please share links — it would help us design the best solution. + +Looking forward to your response! 🚀 +``` + +--- + +#### For ✅ VIABLE — Comment (keep OPEN) + +// turbo + +Thank the user, confirm we've cataloged their idea, and explain it may be implemented in future versions. + +```markdown +Hi @<author>! Thanks for the great feature suggestion! 🙏 + +We've analyzed your request and it aligns well with OmniRoute's roadmap. We've **cataloged this feature** and it's in our implementation backlog. + +**Status:** 📋 Cataloged for future implementation + +This feature may be included in upcoming releases. We'll **respond to this issue and tag you** as soon as implementation begins so you can test it. + +Thank you for helping improve OmniRoute! 🚀 +``` + +**⚠️ Do NOT close viable issues — they remain OPEN for tracking.** + +--- + +## Phase 3 — Report: Present Findings to User + +### 3.1 🛑 MANDATORY STOP — Present Consolidated Report + +After completing Phase 1, Phase 2, and Phase 2.5, **STOP and present the following report** in the chat. Do NOT proceed to implementation. + +Present a structured report containing: + +#### 3.1a — Feature Summary Table + +| # | Issue | Title | Verdict | Location | Action | +| --- | ----- | ----- | --------------- | ----------------------------- | ----------------------------- | +| 1 | #N | Title | ✅ VIABLE | `_ideia/viable/` | Issue OPEN, comment posted | +| 2 | #N | Title | ⏭️ DEFER | `_ideia/defer/` | Issue CLOSED with explanation | +| 3 | #N | Title | ❌ NOT FIT | `_ideia/notfit/` | Issue CLOSED with explanation | +| 4 | #N | Title | 🔁 EXISTS | `_ideia/notfit/` | Issue CLOSED with guidance | +| 5 | #N | Title | ❓ NEEDS DETAIL | `_ideia/viable/need_details/` | Issue OPEN, questions posted | + +#### 3.1b — Viable Features Detail + +For each VIABLE feature, provide a brief paragraph: + +- What was found during research +- The proposed approach +- Key risks or unknowns +- Which reference repositories were most useful + +#### 3.1c — Issues Requiring Author Feedback + +For features marked ❓ NEEDS DETAIL, list: + +- What specific information is missing +- What examples or repository references would help + +#### 3.1d — Ask for User Confirmation + +End the report with: + +> **Ready to proceed with implementation?** +> +> - Reply **"sim"** or **"yes"** to generate full implementation plans for all VIABLE features. +> - Reply with specific issue numbers to select only certain features. +> - Reply **"não"** or **"no"** to stop here. + +--- + +## Phase 4 — Plan: Generate Implementation Plans (after user says "yes") + +> **⚠️ Do NOT enter this phase without explicit user approval from Phase 3.** + +### 4.1 Create Task Directory + +```bash +mkdir -p <project_root>/_tasks/features-vX.Y.Z/ +``` + +### 4.2 Generate One Implementation Plan Per Feature + +For each VIABLE feature approved by the user, create: + +**Filename**: `_tasks/features-vX.Y.Z/<NUMBER>-<kebab-case-title>.plan.md` + +```markdown +# Implementation Plan: <Feature Title> + +> Issue: #<NUMBER> +> Idea: [\_ideia/viable/<NUMBER>-title.md](../../_ideia/viable/<NUMBER>-title.md) +> Requirements: [\_ideia/viable/<NUMBER>-title.requirements.md](../../_ideia/viable/<NUMBER>-title.requirements.md) +> Branch: `release/vX.Y.Z` + +## Overview + +<Brief description of what will be built> + +## Pre-Implementation Checklist + +- [ ] Read all related source files listed below +- [ ] Confirm no conflicts with in-flight PRs +- [ ] Verify database migration numbering + +## Implementation Steps + +### Step 1: <Title> + +**Files:** + +- `path/to/file.ts` — <what to change> + +**Details:** +<Detailed description of the change, including code patterns to follow, function signatures, etc.> + +### Step 2: <Title> + +... + +### Step N: Tests + +**New test files:** + +- `tests/unit/<test-file>.test.mjs` — <what to test> + +**Test cases:** + +- [ ] <test case 1> +- [ ] <test case 2> + +### Step N+1: i18n + +**Translation keys to add:** + +- `<namespace>.<key>` — "<English value>" + +### Step N+2: Documentation + +- [ ] Update CHANGELOG.md +- [ ] Update relevant docs/ files + +## Verification Plan + +1. Run `npm run build` — must pass +2. Run `npm test` — all tests must pass +3. Run `npm run lint` — no new errors +4. <Manual verification steps> + +## Commit Plan +``` + +feat: <description> (#<NUMBER>) + +``` + +``` + +### 4.3 Present Plans for Final Approval + +Present a summary of all generated plans: + +> **Implementation plans generated:** +> +> | # | Feature | Plan File | Steps | Effort | +> | --- | ------- | ---------------------------------------- | ------- | ------ | +> | 1 | <title> | `_tasks/features-vX.Y.Z/N-title.plan.md` | N steps | Medium | +> +> Reply **"sim"** or **"yes"** to begin implementation of all features. +> Reply with specific issue numbers to implement only certain ones. + +--- + +## Phase 5 — Execute: Implement the Plans (after user says "yes") + +> **⚠️ Do NOT enter this phase without explicit user approval from Phase 4.** + +### 5.1 Implement Each Feature + +For each approved plan, execute it step by step: + +1. **Follow the plan** — implement exactly as specified in the `.plan.md` file +2. **Build** — Run `npm run build` after each feature to verify compilation +3. **Test** — Run `npm test` to ensure no regressions +4. **Commit** — Commit with: `feat: <description> (#<NUMBER>)` +5. **Update the plan** — Mark completed steps with `[x]` in the plan file +6. **Continue** — Move to the next feature (do NOT switch branches) + +### 5.2 Respond to Authors (Update Viable Issues) + +For each implemented feature, **close the issue with a final comment**: + +````markdown +✅ **Implemented in `release/vX.Y.Z`!** + +Hi @<author>! Great news — your feature request has been implemented! 🎉 + +**What was done:** + +- <bullet list of what was built> + +**How to try it:** + +```bash +git fetch origin && git checkout release/vX.Y.Z +npm install && npm run dev +``` +```` + +This will be included in the upcoming **vX.Y.Z** release. Feel free to reopen if you spot any issues! 🚀 + +```` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +```` + +Then **DELETE the idea file** — it has served its purpose: + +```bash +# ✅ Implemented files are DELETED (not moved) +rm _ideia/viable/<NUMBER>-<title>.md +rm _ideia/viable/<NUMBER>-<title>.requirements.md # if exists +``` + +> **Why delete?** `viable/` only holds features that still NEED to be done. Once implemented, the commit history and CHANGELOG are the source of truth. Keeping the file would be confusing. + +### 5.3 Finalize & Push + +After implementing all approved features: + +1. **Update CHANGELOG.md** on the release branch with all new feature entries +2. Push the release branch: `git push origin release/vX.Y.Z` +3. Run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user) + +### 5.4 Final Summary Report + +Present a final summary report to the user: + +| Issue | Title | Verdict | Action | Commit | +| ----- | ----- | --------------- | -------------------------------------------------- | --------- | +| #N | Title | ✅ Implemented | Issue closed, idea file deleted | `abc1234` | +| #N | Title | ⏭️ Deferred | Issue closed + saved in `_ideia/defer/` | — | +| #N | Title | ❌ Not Fit | Issue closed + saved in `_ideia/notfit/` | — | +| #N | Title | 🔁 Exists | Issue closed + saved in `_ideia/notfit/` | — | +| #N | Title | ❓ Needs Detail | Issue OPEN, moved to `_ideia/viable/need_details/` | — | + +Include: + +- Total features harvested +- Total ideas cataloged (`viable/need_details/` + `defer/` + `notfit/`) +- Total features implemented (idea files deleted, issues closed) +- Total features deferred +- Total issues closed +- Total issues left open (needs detail only — viable are closed after implementation) +- Test results (pass/fail count) diff --git a/.agents/skills/issue-triage/SKILL.md b/.agents/skills/issue-triage/SKILL.md new file mode 100644 index 0000000000..696c3fef4e --- /dev/null +++ b/.agents/skills/issue-triage/SKILL.md @@ -0,0 +1,51 @@ +--- +name: issue-triage-cx +description: How to respond to GitHub issues with insufficient information +--- + +# Issue Triage Workflow + +Respond to GitHub issues that need more information before they can be investigated. + +## Steps + +### 1. Identify issues needing triage + +```bash +gh issue list --state open --limit 20 +``` + +### 2. Evaluate each issue + +Check if the issue has: + +- Clear reproduction steps +- Environment details (OS, Node.js version, OmniRoute version) +- Error logs/screenshots +- Expected vs actual behavior + +### 3. Respond with triage template + +For issues missing information: + +```markdown +Thank you for reporting this issue! To help us investigate, please provide: + +1. **OmniRoute version**: (`omniroute --version`) +2. **Node.js version**: (`node --version`) +3. **Operating system**: (e.g., Ubuntu 24.04, macOS 15, Windows 11) +4. **Installation method**: (npm, Docker, source) +5. **Steps to reproduce**: (exact commands/actions that trigger the issue) +6. **Error logs**: (paste relevant logs from the console) +7. **Expected behavior**: (what should happen) + +This will help us debug and resolve your issue faster. 🙏 +``` + +### 4. Label the issue + +Add appropriate labels: `needs-info`, `bug`, `enhancement`, `question`, etc. + +```bash +gh issue edit <NUMBER> --add-label "needs-info" +``` diff --git a/.agents/skills/resolve-issues/SKILL.md b/.agents/skills/resolve-issues/SKILL.md new file mode 100644 index 0000000000..a1658f09e0 --- /dev/null +++ b/.agents/skills/resolve-issues/SKILL.md @@ -0,0 +1,173 @@ +--- +name: resolve-issues-cx +description: Fetch all open GitHub issues, analyze bugs, resolve what's possible, triage the rest, wait for user validation, then commit and release +--- + +# /resolve-issues — Automated Issue Resolution Workflow + +## Overview + +This workflow fetches all open issues from the project's GitHub repository, classifies them, analyzes bugs, proposes a resolution plan, waits for user validation, and ONLY THEN implements the fixes, commits, and closes the issues on the current release branch (`release/vX.Y.Z`). It does NOT merge or release automatically — the release branch is later merged via PR to main. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` for independent reads, checks, and GitHub calls. +- The initial report/plan is a hard stop. Do not edit code, close issues, or commit until the user explicitly approves the report. +- Keep classification and bug analysis bounded enough to produce the user-facing report before deep implementation work. + +> **BRANCH RULE**: All work MUST happen on the current `release/vX.Y.Z` branch. Never create separate `fix/` branches. If no release branch exists yet, create one first using `/generate-release` Phase 1 steps 1–5. + +> **⛔ PR PROHIBITION**: If a fix is associated with a contributor's PR, you MUST merge their PR — NEVER close it and re-implement the fix yourself. See `/review-prs` workflow for the full policy. The `gh pr close` command is FORBIDDEN unless the repository owner explicitly requests it. + +## Steps + +### 1. Identify the GitHub Repository + +// turbo + +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo +- Parse the owner and repo name from the URL + +### 2. Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 3. Fetch All Open Issues + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh issue list` can be truncated by the tool, silently hiding issues. You MUST use the two-step approach below to guarantee **all** issues are fetched. + +**Step 3a — Get Issue numbers only** (small output, never truncated): + +- Run: `gh issue list --repo <owner>/<repo> --state open --limit 500 --json number --jq '.[].number'` +- This outputs one issue number per line. Count them and confirm total. + +**Step 3b — Fetch full metadata for each Issue** (one call per issue): + +- For each issue number from step 3a, run: + `gh issue view <NUMBER> --repo <owner>/<repo> --json number,title,labels,body,comments,createdAt,author` +- You may batch these into parallel calls (up to 4 at a time). +- Sort by oldest first (FIFO). + +### 4. Classify Each Issue + +For each issue, determine its type: + +- **Bug** — Has `bug` label, or body contains error messages, stack traces, "doesn't work", "broken", "crash", "error" +- **Feature Request** — Has `enhancement`/`feature` label, or body describes new functionality +- **Question** — Has `question` label, or is asking "how to" something +- **Other** — Anything else + +Focus ONLY on **Bugs** for resolution. Feature requests and questions should be skipped with a note in the final report. + +### 5. Deep-Read Each Bug Issue (One-by-One Analysis) + +**IMPORTANT**: Read each bug issue thoroughly, one at a time, before moving to the next. This is NOT a batch process — each issue needs focused attention. + +#### 5a. Understand the Problem + +For each bug issue, perform the full analysis: + +1. **Read the entire body** — including Description, Steps to Reproduce, Expected/Actual Behavior, Error Logs, and Screenshots +2. **Read ALL comments** — including bot triage comments (Kilo, etc.) and owner/community responses. Pay attention to: + - Whether someone already responded with a fix + - Whether a community member confirmed the issue is resolved + - Whether the issue was marked as duplicate by a bot. **WARNING: DO NOT blindly trust bot duplicate labels (e.g., kilo-duplicate). Bots make mistakes. You MUST read the full conversation and do your own independent analysis to determine if it is truly a duplicate or a distinct bug.** +3. **Identify the claimed error** — extract the exact error message, status code, and provider/model involved + +#### 5b. Check Information Sufficiency + +Verify the issue contains enough to act on: + +- [ ] Clear description of the problem +- [ ] Steps to reproduce OR error logs +- [ ] Provider/model/version information +- [ ] Expected vs actual behavior + +#### 5c. Determine Issue Disposition + +For each bug, classify into one of 5 actions: + +| Disposition | When to Apply | Action | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | +| **✅ CLOSE — Already Fixed** | Owner responded with fix + no user follow-up, OR community confirmed fix | Close with comment citing which version fixed it | +| **✅ CLOSE — Duplicate** | You have independently verified the issue is a duplicate (do NOT rely solely on bot flags) + user provides no new info | Close referencing the original issue | +| **✅ CLOSE — Stale** | We requested logs/info > 7 days ago with no reply | Close thanking the user, invite to reopen if needed | +| **📝 RESPOND — Needs Info** | Issue is real but missing critical reproduction details | Comment asking for specifics per `/issue-triage` | +| **📝 RESPOND — User Config** | Error is caused by unsupported env (Node version, wrong model path, missing API enablement) | Comment explaining the user-side fix | +| **🔧 FIX — Code Change** | Root cause is confirmed in the codebase | Research, propose solution in report, wait for approval | + +#### 5d. For "FIX — Code Change" Issues + +Before coding, perform deep source analysis to formulate a plan: + +1. **Search the codebase** — `grep_search` for error strings, relevant function names, affected files +2. **Search the web** — for upstream API changes, SDK updates, or breaking changes that explain the bug +3. **Read the full source file** — don't rely on grep snippets; understand the surrounding logic +4. **Verify the root cause** — confirm the bug is reproducible based on the code, not just a user misconfiguration +5. **Formulate a proposed solution** — detail the exact files and lines you will change and how you will solve it. +6. **Create an Implementation Plan file** — write your proposed solution to `_tasks/features-vX.Y.Z/<ISSUE_NUMBER>-<short-description>.plan.md` (e.g. `_tasks/features-v3.7.6/1810-auto-restore-probe-failed-db.plan.md`) where `vX.Y.Z` is the current branch version. The plan should contain an Overview, Pre-Implementation Checklist, and detailed Implementation Steps (Files, Changes). +7. **DO NOT modify the codebase yet** — wait for user approval on your report and plan first. + +#### 5e. For "RESPOND" Issues + +Post a substantive comment that: + +- Acknowledges the specific error they reported +- Explains the likely root cause +- Provides concrete steps to resolve (version upgrade, env var fix, model path correction) +- Asks for follow-up info if needed + +**Do NOT post generic template responses.** Every comment should reference the user's specific error messages and environment. + +### 6. Generate Report & Wait for Validation + +Present a summary report to the user detailing your proposed actions. For any bugs that need fixing, explicitly explain your proposed solution (files to change and logic) and point out that it will be implemented on the release branch (`release/vX.Y.Z`) after approval. + +| Issue | Title | Status | Proposed Action / Version | +| ----- | ----- | ------------- | ----------------------------------------- | +| #N | Title | ✅ Close | Already fixed / duplicate (explain why) | +| #N | Title | 🔧 Propose | Explanation of the code fix to be applied | +| #N | Title | 📝 Respond | Guidance comment to be posted | +| #N | Title | ❓ Needs Info | Triage comment to be posted | +| #N | Title | ⏭️ Skip | Feature request / not a bug | + +> **⚠️ IMPORTANT**: Do NOT implement code changes, commit, push, or close issues at this step. +> Wait for the user to review the proposed fixes and respond with **OK** before proceeding. + +- If the user says **OK** or approves → Proceed to step 7 +- If the user requests changes → Adjust the proposed solution and present the report again +- If the user rejects → Revert any accidental changes and stop + +### 7. Implement Fixes, Run Tests & Commit (only after user approval) + +After the user validates and gives the OK: + +1. **Implement the fixes** — modify the codebase according to the approved plan. +2. **Run tests** — `npm run test:all` (or the specific test file) to ensure 100% pass. +3. **Update CHANGELOG.md** with all new bug fix entries. +4. **Commit** each fix individually on the release branch with message format: `fix: <description> (#<issue_number>)`. +5. **Push** the release branch: `git push origin release/vX.Y.Z`. +6. **Close resolved issues immediately**. For each issue that was marked as Fixed, run: + `gh issue close <NUMBER> --repo <owner>/<repo> --comment "Thank you for reporting! This issue has been fixed and will be included in the next release (vX.Y.Z)."` +7. Likewise, close `Duplicate` issues referencing the original, close `Needs Info` if stale, and post the required comments. +8. If the project runs automatic releases or needs a PR, proceed to run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user). + +If NO fixes were committed, skip closing and source control steps and just conclude the workflow. diff --git a/.agents/skills/review-discussions/SKILL.md b/.agents/skills/review-discussions/SKILL.md new file mode 100644 index 0000000000..13e7255069 --- /dev/null +++ b/.agents/skills/review-discussions/SKILL.md @@ -0,0 +1,126 @@ +--- +name: review-discussions-cx +description: Read all open GitHub Discussions, summarize them, respond to pending ones, and create issues from actionable feature requests +--- + +# /review-discussions — GitHub Discussions Review & Response Workflow + +## Overview + +This workflow reads all open GitHub Discussions, generates a categorized summary, identifies which ones need a response, drafts and posts replies, and optionally creates issues from actionable feature requests. It follows the same flow used for Issues but adapted for the Discussions forum. + +> **Tool mapping note (v3.8):** Where steps below say `browser_subagent`, modern runtimes should substitute with the `gh` CLI — `gh api graphql` for reading discussions and mutations for posting comments. `WebFetch` is acceptable for read-only HTML scraping when GraphQL is overkill, but prefer `gh` for any write actions. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` for independent reads and GitHub/browser fetches. +- The summary report is a hard stop. Do not post discussion replies or create issues until the user explicitly approves. + +// turbo-all + +## Steps + +### 1. Identify the GitHub Repository + +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo +- Parse the owner and repo name from the URL + +### 2. Fetch All Open Discussions + +- Use `WebFetch` to fetch `https://github.com/<owner>/<repo>/discussions` +- Parse the discussion list to get all discussion titles, IDs, authors, categories, and dates +- For each discussion, fetch the individual page to read the full content and all comments/replies + +### 3. Summarize All Discussions + +For each discussion, extract: + +- **Title** and **#Number** +- **Author** (GitHub username) +- **Category** (Announcements, General, Ideas, Q&A, Show and tell) +- **Date** created +- **Summary** of the original post (1-2 sentences) +- **Comments count** and key participants +- **Your previous response** (if any) +- **Pending action** — whether a response or follow-up is needed + +### 4. Present Summary Report to User + +Present the full summary to the user organized by category, using a table: + +| # | Category | Title | Author | Date | Status | +| --- | -------- | ----- | ------ | ------ | ----------------- | +| #N | Ideas | Title | @user | Mar 23 | ⚠️ Needs response | +| #N | Q&A | Title | @user | Mar 9 | ✅ Answered | +| #N | General | Title | @user | Mar 19 | ⚠️ Needs response | + +Highlight: + +- **⚠️ Needs response** — No reply from maintainer, or a follow-up comment was left unanswered +- **✅ Answered** — Maintainer already responded +- **🐛 Bug reported** — A bug was mentioned that needs tracking +- **💡 Actionable** — Contains a concrete feature request that could become an issue + +### 5. Draft & Post Responses + +For each discussion that needs a response, draft a reply following these guidelines: + +#### Response Style + +- **Friendly and professional** — Start with "Hey @username!" +- **Acknowledge the contribution** — Thank the user for their input +- **Be specific** — Reference existing features, settings, or dashboard pages if the feature already exists +- **Provide workarounds** — If the request isn't implemented yet, suggest current alternatives +- **Commit to action** — If the request is valid, state that you'll open an issue or add it to the roadmap +- **Keep it concise** — 3-5 paragraphs max + +#### Posting via Browser + +- Use `browser_subagent` to navigate to each discussion and post the comment +- **IMPORTANT**: When typing text in GitHub comment boxes via the browser, use only plain ASCII characters: + - Use regular hyphens `-` instead of em-dashes + - Use `->` instead of arrow symbols + - Do NOT use emoji Unicode characters (the browser keyboard may fail on them) + - Use `**bold**` and `\`code\`` markdown formatting +- Click the green "Comment" button (or "Reply" for threaded replies) after typing +- Verify the comment was posted by checking the page shows the new comment + +### 6. Create Issues from Actionable Feature Requests + +For discussions that contain concrete, actionable feature requests: + +1. Ask the user which ones should become issues +2. For each approved request, create a GitHub issue via `browser_subagent`: + - Navigate to `https://github.com/<owner>/<repo>/issues/new` + - **Title**: `<Feature Name> - <Short description>` + - **Body** should include: + - `## Feature Request` header + - `**Source:** Discussion #N by @author` + - `## Problem` — What limitation the user hit + - `## Proposed Solution` — How it could work + - `### Implementation Ideas` — Technical approach + - `### Current Workarounds` — What users can do today + - `## Additional Context` — Links to related issues/discussions + - Add `enhancement` label + - Click "Submit new issue" / "Create" +3. After creation, go back to the original discussion and post a comment linking to the new issue: + - "I've opened Issue #N to track this feature request. Follow along there for updates!" + +### 7. Final Report + +Present a final summary to the user: + +| Discussion | Action Taken | +| ---------- | ---------------------------------- | +| #N — Title | Responded with workarounds | +| #N — Title | Responded + created Issue #N | +| #N — Title | Already answered, no action needed | +| #N — Title | Responded to follow-up comment | + +## Notes + +- This workflow is **interactive** — always present the summary and wait for user approval before posting responses or creating issues +- If the user says "pode responder" (or similar approval), proceed with posting all drafted responses +- For discussions in non-English languages, respond in the same language as the original post +- Always reference specific dashboard paths, config options, or code files when explaining existing features +- When a discussion reveals a bug, note it separately from feature requests diff --git a/.agents/skills/review-prs/SKILL.md b/.agents/skills/review-prs/SKILL.md new file mode 100644 index 0000000000..bee9b8ae48 --- /dev/null +++ b/.agents/skills/review-prs/SKILL.md @@ -0,0 +1,268 @@ +--- +name: review-prs-cx +description: Analyze open Pull Requests from the project's GitHub repository, generate a critical report, and optionally implement approved changes +--- + +# /review-prs — PR Review & Analysis Workflow + +## ⛔ ABSOLUTE PROHIBITION — Read Before Anything Else + +> **NEVER close a contributor's PR if you intend to use ANY of their code, ideas, or fixes.** +> +> **NEVER manually integrate contributor code into a release branch and then close their PR.** +> +> These actions are **STRICTLY FORBIDDEN** under all circumstances: +> +> 1. ❌ Closing a PR and cherry-picking/copying its code into a release branch +> 2. ❌ Closing a PR "because of conflicts" and re-implementing the same fix yourself +> 3. ❌ Closing a PR and committing a "similar" solution inspired by it +> 4. ❌ Using `gh pr close` on any PR whose content was or will be used +> +> **Why**: Closing a PR after taking the contributor's work means they get ZERO credit on GitHub — no "Merged" badge, no contribution graph entry, no public record. This is effectively stealing their contribution. An audit found this happened to **37 PRs** in the past. +> +> **The ONLY acceptable flow**: Resolve conflicts IN the contributor's branch, push fixes TO their branch, then merge THEIR PR via `gh pr merge`. See Step 7 and Step 8 for the exact procedure. +> +> **When to close a PR**: ONLY when the user (repository owner) explicitly requests it, OR when the PR is clearly spam/malicious, OR when the author themselves asks to close it. In ALL other cases, leave it open. + +## Overview + +This workflow fetches all open PRs from the project's GitHub repository, performs a critical analysis of each one, generates a detailed report, and waits for user approval before proceeding with implementation. **All improvements are committed on the current release branch** (`release/vX.Y.Z`). + +> **BRANCH RULE**: PRs are ALWAYS merged into the current `release/vX.Y.Z` branch, NEVER directly into `main`. The release branch acts as a staging area — only after all PRs are integrated and tests pass does the release branch get merged into `main` via the `/generate-release` workflow. + +## Codex Execution Notes + +The source Claude command uses `// turbo` and `// turbo-all` as execution hints. In Codex, treat them explicitly as follows: + +- `// turbo`: batch independent local reads and small `gh`/`git` calls with `multi_tool_use.parallel`. +- `// turbo-all`: fan out independent per-PR/per-issue calls in practical batches, usually up to 4 GitHub calls at a time. +- Do not expand Step 4 into exhaustive CI-log debugging before Step 6. Fetch numbers, metadata, diffs/review comments, quick merge/conflict status, and only inspect extra logs when they directly affect the verdict. +- Step 6 is a hard stop. In Codex, present the report in the final response and wait for the user before Step 7/8. +- Do not checkout PR branches, edit files, post PR comments, close PRs, merge, cherry-pick, or run broad fix/test loops until the user explicitly approves the report. +- If `gh pr diff` is too large, record the limit and use `gh pr view --json files` plus `git fetch refs/pull/...` with `git diff --stat` / `git diff --name-status`; only read targeted hunks needed for confirmed findings. + +## Steps + +### 1. Identify the GitHub Repository + +- Read `package.json` to get the repository URL, or use the git remote origin URL + // turbo +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo + +### 2. Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +# Bump patch: e.g. 3.3.11 → 3.3.12 +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 3. Fetch Open Pull Requests + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh pr list` can be truncated by the tool, silently hiding PRs. You MUST use the two-step approach below to guarantee **all** PRs are fetched. + +**Step 3a — Get PR numbers only** (small output, never truncated): + +- Run: `gh pr list --repo <owner>/<repo> --state open --limit 500 --json number --jq '.[].number'` +- This outputs one PR number per line. Count them and confirm total. + +**Step 3b — Fetch full metadata for each PR** (one call per PR): + +- For each PR number from step 3a, run: + `gh pr view <NUMBER> --repo <owner>/<repo> --json number,title,author,headRefName,baseRefName,body,createdAt,additions,deletions,files` +- You may batch these into parallel calls (up to 4 at a time). + +**Step 3c — Fetch diffs for each PR** (one call per PR, saved to /tmp): + +- For each PR number, run: + `gh pr diff <NUMBER> --repo <owner>/<repo> > /tmp/pr<NUMBER>.diff` +- Then read each diff file with the appropriate file-read tool (`Read` in Claude Code; equivalent in your agent runtime). + +- For each open PR, collect: + - PR number, title, author, branch, number of commits, date + - PR description/body + - Files changed (diff) + - Existing review comments (from bots or humans) + +**Verification**: Confirm the count of PRs analyzed matches the count from step 3a before proceeding. + +### 3.5 Redirect PR Base Branches to Release Branch + +// turbo-all + +**⚠️ CRITICAL**: Contributors typically open PRs targeting `main`. Before analyzing or merging, redirect ALL open PRs to target the current release branch instead. + +```bash +# Get the current release branch name +RELEASE_BRANCH=$(git branch --show-current) # e.g. release/v3.5.4 + +# For each open PR that targets main, change its base to the release branch +for PR_NUM in $(gh pr list --repo <owner>/<repo> --state open --json number,baseRefName --jq '.[] | select(.baseRefName == "main") | .number'); do + echo "Redirecting PR #$PR_NUM → $RELEASE_BRANCH" + gh pr edit "$PR_NUM" --repo <owner>/<repo> --base "$RELEASE_BRANCH" +done +``` + +This ensures: + +1. PRs merge into the release branch, not directly into `main` +2. Merge conflict detection is accurate against the release branch +3. The release branch accumulates all changes before the final merge to `main` +4. If the release branch doesn't exist on remote yet, push it first: `git push origin $RELEASE_BRANCH` + +### 4. Analyze Each PR — For each open PR, perform the following analysis: + +#### 4a. Feature Assessment + +- **Does it make sense?** Evaluate if the feature fills a real gap or solves a valid problem +- **Alignment** — Check if it aligns with the project's architecture and roadmap +- **Complexity** — Assess if the scope is reasonable or if it should be split + +#### 4b. Code Quality Review + +- Check for code duplication +- Evaluate error handling patterns (consistent with existing codebase?) +- Check naming conventions and code style +- Verify TypeScript types (any `any` usage, missing types?) + +#### 4c. Security Review + +- Check for missing authentication/authorization on new endpoints +- Check for injection vulnerabilities (URL params, SQL, XSS) +- Verify input validation on all user-controlled data +- Check for hardcoded secrets or credentials + +#### 4d. Architecture Review + +- Does the change follow existing patterns? +- Are there any breaking changes to public APIs? +- Is the database schema affected? Migration needed? +- Impact on performance (N+1 queries, missing indexes?) + +#### 4e. Test Coverage + +- Does the PR include tests? +- Are edge cases covered? +- Would existing tests break? + +#### 4f. Cross-Layer (Global) Analysis + +Perform a **global impact assessment** to verify whether the PR changes are complete across all layers of the application: + +- **Backend → Frontend check**: If the PR adds or modifies backend-only resources (new endpoints, services, data models), evaluate whether corresponding frontend changes are missing: + - Does a new endpoint require a new screen/page in the dashboard? + - Should there be a new action button, menu item, or navigation link? + - Are there new data fields that should be displayed or editable in the UI? + - Does a new feature need a toggle, configuration panel, or status indicator? +- **Frontend → Backend check**: If the PR adds frontend elements, verify the backend support exists: + - Are the required API endpoints implemented? + - Is the data model sufficient for the new UI components? +- **Cross-cutting concerns**: Check shared layers (types, DTOs, validation schemas, routes, middleware) for completeness +- **Document gaps** — If missing layers are detected, list them as **IMPORTANT** issues in the report with concrete suggestions for what should be added + +### 5. Generate Report — Create a markdown report for each PR including: + +- **PR Summary** — What it does, files affected, commit count +- **Improvements/Benefits** — Numbered list with impact level (HIGH/MEDIUM/LOW) +- **Risks & Issues** — Categorized as CRITICAL / IMPORTANT / MINOR +- **Scoring Table** — Rate across: Feature Relevance, Code Quality, Security, Robustness, Tests +- **Verdict** — Ready to merge? With mandatory vs optional fixes +- **Next Steps** — What will happen if approved + +### 6. Present to User + +- Show the report in the final response and stop. Mark this as a blocking checkpoint awaiting explicit user approval before continuing. +- Wait for user decision: + - **Approved** → Proceed to step 7 + - **Approved with changes** → Implement the fixes and corrections before merging + - **Rejected** → Close the PR or leave a review comment + +### 7. Pre-Merge Fixes & CI Green-Lighting (if approved) + +> **⚠️ Fixes and Conflict Resolutions MUST be pushed back to the PR branch before merging.** We want the PR itself to be green and fully valid before it integrates. + +- **Sync latest fixes & Resolve Conflicts:** Merge the current `release` branch into the PR branch. If there are merge conflicts, you MUST resolve them inside the author's PR branch. NEVER resolve conflicts by closing their PR and doing the work in a separate branch, as this steals credit from the original author. +- **Implement improvements:** Apply the required fixes identified in the analysis directly on the PR branch (e.g., adding missing API routes, fixing SSRF, applying comments from other agents). +- **Pushing changes to PR branches:** + + ```bash + # Checkout the PR locally + gh pr checkout <NUMBER> + + # Apply fixes, commit your changes + git commit -m "chore: apply review suggestions and missing layers" + + # Attempt to push directly to the PR branch + git push + ``` + +- **Fallback (ONLY for external forks without maintainer edit access):** + Using `cherry-pick` instead of fixing the contributor's PR directly is a **LAST RESORT**. You MUST ALWAYS attempt to `git push` your fixes to their branch first. + **ONLY if `git push` explicitly fails with a permission/access error** (meaning the contributor unchecked "Allow edits from maintainers" or it's a locked fork), you may use `git cherry-pick` to bring their changes into the release branch and fix the issues locally. + Even then, ensure you preserve the contributor's authorship (`git commit --author="Contributor Name <email>"` if creating new commits). + Once you have integrated their work into the release branch, **DO NOT close their PR**. Leave it open so the contributor retains credit. Under NO CIRCUMSTANCES should you use `gh pr close`. + +- Run the project's test suite locally to verify nothing breaks: + // turbo +- Run: `npm test` or equivalent test command + +### 8. Merge into Release Branch (NEVER CLOSE!) + +> **⚠️ CRITICAL**: NEVER use `gh pr close` for a PR whose idea or code was accepted. Closing a PR in a contributor's face after taking their idea—or closing it just because it had conflicts—is unacceptable. +> You MUST ALWAYS resolve conflicts and apply fixes ON THE AUTHOR'S PR BRANCH (unless explicitly locked from edits), and then merge the PR using GitHub so the contributor gets the official "Merged" badge and proper credit on their profile. **Do not use cherry-pick just because it is "easier" than resolving conflicts on their branch.** + +Even if the PR had severe conflicts or required significant architectural adjustments, you MUST: + +1. Resolve any conflicts and apply the fixes directly to their PR branch (as detailed in step 7) or use cherry-picking into the release branch. +2. If you managed to fix their branch, merge it into the release branch using the GitHub CLI: + `gh pr merge <NUMBER> --repo <owner>/<repo> --squash --body "Integrated into release/vX.Y.Z"` +3. If you had to use cherry-picking because you couldn't push to their branch, DO NOT close the PR. GitHub will sometimes auto-detect the cherry-picked commits and mark it as Merged. If it doesn't, leave it open. The repository owner will handle it. NEVER run `gh pr close`. + +In ALL cases: + +- Post a **thank-you comment** on the PR via the GitHub API before or immediately after merging. +- The message should: + - Thank the author by name/username for their contribution. + - Explain what was adjusted or improved (if we pushed fixes to their branch or cherry-picked). + - Note it will be included in the upcoming release. + - Be friendly, professional, and encouraging. + +> **⚠️ MANDATORY CHANGELOG CREDIT**: When cherry-picking is used (because the PR branch couldn't be pushed to or `gh pr merge` failed), the contributor does NOT get the automatic GitHub "Merged" badge. In this case, you MUST compensate by adding an explicit entry to `CHANGELOG.md` in the `[Unreleased]` section with `(#PR_NUMBER — thanks @username)` format. This ensures the contributor gets public credit in the release notes even if GitHub doesn't auto-detect the cherry-pick. This is NOT optional — skipping it effectively erases the contributor's work from the release record. + +### 9. Sync Local Release Branch + +After merging PRs, sync the local release branch to include the new changes: + +```bash +git fetch origin +git pull origin release/vX.Y.Z +``` + +### 10. Continue or Finalize + +After processing all approved PRs: + +- If more PRs remain, go back to step 7 +- When all PRs are processed, **update CHANGELOG.md** on the release branch with all new entries +- Run **test coverage** to verify the gate (≥75% statements/lines/functions, ≥70% branches — measured ~82%): + ```bash + npm run test:coverage + ``` +- Fix any test regressions introduced by merged PRs +- Run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user) +- The `/generate-release` workflow handles the final merge from `release/vX.Y.Z` → `main` diff --git a/.agents/skills/version-bump/SKILL.md b/.agents/skills/version-bump/SKILL.md new file mode 100644 index 0000000000..3d3ddf9f4a --- /dev/null +++ b/.agents/skills/version-bump/SKILL.md @@ -0,0 +1,347 @@ +--- +name: version-bump-cx +description: Bump version, auto-generate CHANGELOG from git commits, update all versioned files, and refresh root + docs/ documentation to reflect the current project state +--- + +# Version Bump Workflow + +Automatically bump the project version, generate CHANGELOG entries from git history since the last tag, update every file that references the version, and refresh project documentation to reflect the current state. + +## Codex Execution Notes + +- Treat `// turbo` / `// turbo-all` as instructions to use `multi_tool_use.parallel` for independent reads, checks, and GitHub calls. +- Any user-approval phase is a hard stop: present the report/status in the final response and wait before committing, pushing, tagging, publishing, or deploying. + +> **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** +> NEVER use `npm version minor` or `npm version major`. +> Always use: `npm version patch --no-git-tag-version` +> The threshold rule: when `y` reaches 10, bump to `3.(x+1).0` — e.g. `3.4.10` → `3.5.0`. + +--- + +## Phase 1: Determine Version + +### 1. Read current version and last tag + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +CURRENT_VERSION=$(node -p "require('./package.json').version") +LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "") +CURRENT_BRANCH=$(git branch --show-current) +echo "Current version: $CURRENT_VERSION" +echo "Last tag: $LAST_TAG" +echo "Current branch: $CURRENT_BRANCH" +``` + +### 2. Calculate new version + +Apply the patch bump rule: + +- If the current patch number is `9`, the new version is `3.(minor+1).0` +- Otherwise, increment patch: `3.x.y` → `3.x.(y+1)` + +If the version was ALREADY bumped (e.g. you are on a release branch and package.json already has the new version), **skip the npm version bump** and use the existing version. + +### 3. Bump package.json (if needed) + +// turbo + +```bash +# Only if version hasn't been bumped yet +npm version patch --no-git-tag-version +``` + +Or for threshold (y=10): + +```bash +# Manual threshold bump +VERSION="3.X.0" # compute manually +npm version "$VERSION" --no-git-tag-version +``` + +--- + +## Phase 2: Generate CHANGELOG from Git History + +### 4. Collect commits since last tag + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null) +echo "=== Commits since $LAST_TAG ===" +git log "$LAST_TAG"..HEAD --pretty=format:"%h %s" --no-merges | head -100 +echo "" +echo "=== Merge commits ===" +git log "$LAST_TAG"..HEAD --merges --pretty=format:"%h %s" | head -50 +``` + +### 5. Classify commits and generate CHANGELOG section + +Analyze each commit message and classify into categories based on the conventional-commit prefix and content: + +| Category | Patterns | +| ------------------- | ------------------------------------------------ | +| ✨ New Features | `feat:`, `feat(*):` | +| 🐛 Bug Fixes | `fix:`, `fix(*):` | +| ⚠️ Breaking Changes | `BREAKING CHANGE`, `!:` suffix | +| 🛠️ Maintenance | `chore:`, `refactor:`, `perf:`, `build:` | +| 🧪 Tests | `test:`, `tests:` | +| 📝 Documentation | `docs:` | +| 🔒 Security | `security:`, CVE references, vulnerability fixes | +| 🌍 i18n | translation updates, locale changes | + +For each category with entries, create a markdown section with descriptive bullet points. Use the commit messages but rewrite them to be human-readable and descriptive (not raw commit messages). + +**If a commit references a PR number** (e.g. `#880`, `PR #885`), include it in the description. + +### 6. Update CHANGELOG.md + +Replace the `## [Unreleased]` section content with the generated entries, then add the new versioned section: + +```markdown +## [Unreleased] + +--- + +## [NEW_VERSION] — YYYY-MM-DD + +### ✨ New Features + +- **Feature name:** Description (#PR) + +### 🐛 Bug Fixes + +- **Fix name:** Description (#PR) + +### 🛠️ Maintenance + +- **Item:** Description + +--- + +## [PREVIOUS_VERSION] — YYYY-MM-DD + +... +``` + +The date must be today's date in `YYYY-MM-DD` format. + +--- + +## Phase 3: Sync Version Across All Files + +### 7. Update workspace package.json files and openapi.yaml + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") + +# Update docs/reference/openapi.yaml version +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml +echo "✓ docs/reference/openapi.yaml → $VERSION" + +# Update workspace packages (open-sse, electron) +for dir in electron open-sse; do + if [ -d "$dir" ] && [ -f "$dir/package.json" ]; then + (cd "$dir" && npm version "$VERSION" --no-git-tag-version --allow-same-version > /dev/null) + echo "✓ $dir/package.json → $VERSION" + fi +done + +echo "✓ All workspace packages synced to $VERSION" +``` + +### 8. Update llm.txt version references + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") +OLD_VERSION_PATTERN='[0-9]\+\.[0-9]\+\.[0-9]\+' + +# Update "Current version:" line +sed -i "s/\*\*Current version:\*\* $OLD_VERSION_PATTERN/**Current version:** $VERSION/" llm.txt + +# Update "Key Features (vX.Y.Z)" header +sed -i "s/## Key Features (v$OLD_VERSION_PATTERN)/## Key Features (v$VERSION)/" llm.txt + +echo "✓ llm.txt → $VERSION" +``` + +### 9. Regenerate lock file + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm install +echo "✓ Lock file regenerated" +``` + +--- + +## Phase 4: Update Root Documentation + +Based on the CHANGELOG entries generated in Phase 2, review and update these root-level files if relevant changes warrant updates: + +### 10. Review and update root documentation files + +For each file below, read the current content and determine if the CHANGELOG entries require any updates. Only modify files where substantive changes have occurred: + +| File | When to update | +| ----------------- | --------------------------------------------------------------------------------------------------------------------------- | +| `README.md` | New providers, major features, stats changes (test count, provider count), badges, installation instructions, feature table | +| `AGENTS.md` | Architecture changes, new modules, new commands, new providers, new services/handlers/executors | +| `CONTRIBUTING.md` | Dev workflow changes, new tooling, test infrastructure changes | +| `SECURITY.md` | Security fixes, new auth mechanisms, vulnerability disclosures | +| `llm.txt` | Provider count changes, new features, architecture changes | + +**Update rules:** + +- **README.md**: Update provider count, test count, feature highlights table, badges if any numbers changed. If a new provider was added, add it to the provider table. If a major feature was added, add it to the features section. +- **AGENTS.md**: If new architecture components (handlers, executors, services, DB modules) were added, update the Architecture section. If new commands were added, update the Build/Test table. +- **SECURITY.md**: Add new vulnerability fixes or security improvements to the relevant section. +- **llm.txt**: Update provider count, feature list, version references. + +### 11. Review and update docs/ files (excluding i18n/) + +For each file in `docs/` (excluding `docs/i18n/`), review if CHANGELOG changes affect it: + +| File | When to update | +| --------------------------------------------- | ------------------------------------------------------------------ | +| `docs/reference/API_REFERENCE.md` | New API endpoints, changed request/response formats | +| `docs/architecture/ARCHITECTURE.md` | New modules, new services, changed data flow | +| `docs/architecture/CODEBASE_DOCUMENTATION.md` | New files, architectural changes, module reorganization | +| `docs/architecture/REPOSITORY_MAP.md` | New folders / files / one-line descriptions | +| `docs/reference/CLI-TOOLS.md` | New CLI tool integrations, config format changes | +| `docs/guides/USER_GUIDE.md` | UX changes, new dashboard pages, settings changes | +| `docs/reference/PROVIDER_REFERENCE.md` | New providers (regenerate via `scripts/gen-provider-reference.ts`) | +| `docs/frameworks/MCP-SERVER.md` | New MCP tools, changed tool signatures, scope changes | +| `docs/frameworks/A2A-SERVER.md` | New A2A skills, protocol changes | +| `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md` | New external agent protocols supported | +| `docs/frameworks/CLOUD_AGENT.md` | Cloud agent additions (codex-cloud, devin, jules) or API changes | +| `docs/architecture/AUTHZ_GUIDE.md` | New route classifications, policy changes | +| `docs/security/GUARDRAILS.md` | New guardrails registered, priority/order changes | +| `docs/security/COMPLIANCE.md` | Audit log / retention / no-log policy changes | +| `docs/frameworks/SKILLS.md` | Skill framework / registry / built-in skill changes | +| `docs/frameworks/MEMORY.md` | Memory pipeline / extraction / injection / Qdrant changes | +| `docs/frameworks/EVALS.md` | Evaluation framework changes, new evaluators | +| `docs/frameworks/WEBHOOKS.md` | New webhook events, payload schema changes | +| `docs/routing/REASONING_REPLAY.md` | Reasoning capture/replay pipeline changes | +| `docs/routing/AUTO-COMBO.md` | Routing changes, new strategies, scoring weight changes | +| `docs/architecture/RESILIENCE_GUIDE.md` | Circuit breaker / cooldown / lockout behavior changes | +| `docs/security/STEALTH_GUIDE.md` | TLS / CLI fingerprint changes | +| `docs/ops/TUNNELS_GUIDE.md` | Cloudflare tunnel feature changes | +| `docs/guides/ELECTRON_GUIDE.md` | Electron build / signing / packaging changes | +| `docs/guides/TROUBLESHOOTING.md` | New known issues, resolved problems | +| `docs/ops/RELEASE_CHECKLIST.md` | Process changes | +| `docs/ops/COVERAGE_PLAN.md` | Coverage gate adjustments, target metrics | +| `docs/reference/openapi.yaml` | Already updated in step 7 | + +**Only update files where the CHANGELOG entries directly affect the documented content.** Do NOT update files just to bump a version number — only when the documented behavior, features, or architecture has actually changed. + +--- + +## Phase 5: Verify + +### 12. Run lint check + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm run lint +``` + +### 13. Run tests + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm test +``` + +### 14. Verify version sync across all files + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") +echo "Expected version: $VERSION" +echo "" + +echo "--- package.json ---" +grep '"version"' package.json | head -1 + +echo "--- open-sse/package.json ---" +grep '"version"' open-sse/package.json | head -1 + +echo "--- electron/package.json ---" +[ -f electron/package.json ] && grep '"version"' electron/package.json | head -1 + +echo "--- docs/reference/openapi.yaml ---" +grep " version:" docs/reference/openapi.yaml | head -1 + +echo "--- llm.txt ---" +grep "Current version:" llm.txt + +echo "--- CHANGELOG.md (first versioned entry) ---" +grep "^## \[" CHANGELOG.md | head -2 +``` + +### 15. 🛑 STOP — Present Summary to User + +**STOP** and present a summary to the user including: + +- Old version → New version +- CHANGELOG entries generated +- Files modified +- Test results +- Any documentation updates made + +**Wait for the user to confirm before committing.** + +--- + +## Phase 6: Commit (only after user approval) + +### 16. Stage and commit + +// turbo-all + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +git add -A +VERSION=$(node -p "require('./package.json').version") +git commit -m "chore(release): bump to v$VERSION — changelog, docs, version sync" +``` + +--- + +## Notes + +- This workflow does **NOT** create tags, releases, or deploy. Use `/generate-release` for the full release cycle after this. +- This workflow does **NOT** update `docs/i18n/` translations. Translation updates are handled manually or via release tooling — there is no `/update-i18n` workflow shipped in this repo. +- The CHANGELOG generation is based on git commits since the last tag. If there are no new commits, the workflow should inform the user and stop. +- Always verify the generated CHANGELOG entries make sense — raw commit messages may need rewriting for clarity. +- If the version was already bumped (e.g. you're on a `release/vX.Y.Z` branch), skip the `npm version` step and use the existing version. + +## Version Touchpoints Checklist + +| File | Field/Pattern | +| ----------------------------- | ----------------------------------------------------------- | +| `package.json` | `"version": "X.Y.Z"` | +| `open-sse/package.json` | `"version": "X.Y.Z"` | +| `electron/package.json` | `"version": "X.Y.Z"` | +| `docs/reference/openapi.yaml` | `version: X.Y.Z` | +| `llm.txt` | `**Current version:** X.Y.Z` and `## Key Features (vX.Y.Z)` | +| `CHANGELOG.md` | `## [X.Y.Z] — YYYY-MM-DD` | diff --git a/.agents/workflows/capture-release-evidences.md b/.agents/workflows/capture-release-evidences-ag.md similarity index 69% rename from .agents/workflows/capture-release-evidences.md rename to .agents/workflows/capture-release-evidences-ag.md index 54b373fdd7..30ab18d572 100644 --- a/.agents/workflows/capture-release-evidences.md +++ b/.agents/workflows/capture-release-evidences-ag.md @@ -1,10 +1,12 @@ --- -description: Automatically run the browser_subagent to visually validate all new UI features from the current release and capture evidence WebP recordings of the changes. +description: Automatically run a browser-automation agent to visually validate all new UI features from the current release and capture evidence WebP recordings of the changes. --- # Capture Release Evidences Workflow -Use this workflow to automatically drive the `browser_subagent` to explore the newly deployed or locally running application and record evidence of the UI changes introduced in the latest release. +Use this workflow to automatically drive a browser-automation agent to explore the newly deployed or locally running application and record evidence of the UI changes introduced in the latest release. + +> **Tool mapping note (v3.8):** The `browser_subagent` tool referenced below is specific to an earlier agent runtime. In Claude Code, substitute with the available browser MCP tools (e.g. `mcp__claude-in-chrome__*`) for navigation/screenshots, plus the `Write` tool for saving artifacts. The high-level steps remain the same regardless of the browser-automation surface in use. ## Prerequisites @@ -35,7 +37,7 @@ _(Note: The `browser_subagent` automatically creates a WebP recording named by t ### 3. Generate Report Artifact -After the `browser_subagent` finishes its sessions, generate a final Markdown artifact (using `write_to_file` and `IsArtifact=true`) to present the recordings inline to the user using the `![caption](/absolute/path/to/media.webp)` syntax. +After the `browser_subagent` finishes its sessions, generate a final Markdown artifact (using `Write` and `IsArtifact=true`) to present the recordings inline to the user using the `![caption](/absolute/path/to/media.webp)` syntax. ### Example Invocation diff --git a/.agents/workflows/deploy-vps-akamai.md b/.agents/workflows/deploy-vps-akamai-ag.md similarity index 100% rename from .agents/workflows/deploy-vps-akamai.md rename to .agents/workflows/deploy-vps-akamai-ag.md diff --git a/.agents/workflows/deploy-vps-both.md b/.agents/workflows/deploy-vps-both-ag.md similarity index 100% rename from .agents/workflows/deploy-vps-both.md rename to .agents/workflows/deploy-vps-both-ag.md diff --git a/.agents/workflows/deploy-vps-local.md b/.agents/workflows/deploy-vps-local-ag.md similarity index 100% rename from .agents/workflows/deploy-vps-local.md rename to .agents/workflows/deploy-vps-local-ag.md diff --git a/.agents/workflows/generate-release.md b/.agents/workflows/generate-release-ag.md similarity index 83% rename from .agents/workflows/generate-release.md rename to .agents/workflows/generate-release-ag.md index 399e12d214..8919137688 100644 --- a/.agents/workflows/generate-release.md +++ b/.agents/workflows/generate-release-ag.md @@ -1,15 +1,15 @@ --- -description: Create a new release, bump version up to 1.x.10 threshold, update changelog, and manage Pull Requests +description: Create a new release, bump version up to the .10 patch threshold, update changelog, and manage Pull Requests --- # Generate Release Workflow Bump version, finalize CHANGELOG, commit, open a **PR to main** and wait for user confirmation before tagging, publishing, and deploying. -> **VERSION RULE: Always use PATCH bumps (2.x.y → 2.x.y+1)** +> **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** > NEVER use `npm version minor` or `npm version major`. > Always use: `npm version patch --no-git-tag-version` -> The threshold rule: when `y` reaches 10, bump to `2.(x+1).0` — e.g. `2.1.10` → `2.2.0`. +> The threshold rule: when `y` reaches 10, bump to `3.(x+1).0` — e.g. `3.8.10` → `3.9.0`. > **🔴 SINGLE BRANCH RULE**: The `release/vX.Y.Z` branch is the **ONLY** development branch for the entire release cycle. ALL work — bug fixes, feature implementations, PR integrations, issue resolutions — MUST be committed directly on this branch. Never create separate `fix/`, `feat/`, or topic branches. When running `/resolve-issues`, `/implement-features`, or `/review-prs`, always work on the current release branch. @@ -49,7 +49,7 @@ Before creating the release, you must ensure the codebase and supply chain are s ### 1. Create release branch ```bash -git checkout -b release/v2.x.y +git checkout -b release/v3.x.y ``` ### 2. Determine and sync version @@ -72,19 +72,19 @@ grep '"version"' package.json > > 1. `npm version patch --no-git-tag-version` ← bump first > 2. implement features / fix bugs -> 3. `git add -A && git commit -m "chore(release): v2.x.y — all changes in ONE commit"` +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` > > **OR if features are already staged:** > > 1. implement features (do NOT commit yet) > 2. `npm version patch --no-git-tag-version` ← bump before committing -> 3. `git add -A && git commit -m "chore(release): v2.x.y — all changes in ONE commit"` +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` > > **NEVER do this (creates version mismatch in git history):** > > - ~~commit features → then bump version → commit package.json separately~~ > -> This ensures that `git show v2.x.y` always contains both code changes and the version bump together. +> This ensures that `git show v3.x.y` always contains both code changes and the version bump together. > The GitHub release tag will point to a commit that includes ALL changes for that version. ### 3. Regenerate lock file (REQUIRED after version bump) @@ -124,13 +124,13 @@ Keep an empty `## [Unreleased]` section above it, separated by a horizontal rule ### 5. Update openapi.yaml version ⚠️ MANDATORY -> **CI will fail** if `docs/openapi.yaml` version ≠ `package.json` version (`check:docs-sync` enforces this). +> **CI will fail** if `docs/reference/openapi.yaml` version ≠ `package.json` version (`check:docs-sync` enforces this). // turbo ```bash VERSION=$(node -p "require('./package.json').version") -sed -i "s/ version: .*/ version: $VERSION/" docs/openapi.yaml +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml echo "✓ openapi.yaml → $VERSION" for dir in electron open-sse; do @@ -145,11 +145,12 @@ npm install ### 6. Update README.md and i18n docs -Run `/update-docs` workflow steps to: +Manually perform these documentation updates (there is no `/update-docs` workflow — it was deprecated in v3.8): -- Update feature table rows in `README.md` -- Sync changes to all 29 language `docs/i18n/*/README.md` files -- Update `docs/FEATURES.md` if Settings section changed +- Update feature table rows and "What's new in vX.Y.Z" section in `README.md` +- Sync feature changes to all 40 language `docs/i18n/*/README.md` files (use the same row edits across each translated README) +- Update the relevant `docs/<AREA>.md` if architecture or counts changed +- Re-run `npm run check:docs-sync` and `npm run check:docs-all` to catch drift ### 7. Run tests @@ -167,8 +168,8 @@ All tests must pass before creating the PR. ```bash git add -A -git commit -m "chore(release): v2.x.y — summary of changes" -git push origin release/v2.x.y +git commit -m "chore(release): v3.x.y — summary of changes" +git push origin release/v3.x.y ``` ### 9. Open PR to main @@ -200,7 +201,7 @@ gh pr create \ ### 10. 🛑 STOP — Notify User & Await PR Confirmation -**This is a mandatory stop point.** Use `notify_user` with `BlockedOnUser: true`: +**This is a mandatory stop point.** Present the report in the final response and stop. Do not continue to the next phase until the user explicitly approves. Inform the user: @@ -333,7 +334,7 @@ If a workflow fails: - Use `gh run view <RUN_ID> --log-failed` to identify the error. - Apply the fix on the `main` branch. -- If necessary, re-trigger the workflow using `gh workflow run <workflow_name.yml> --repo diegosouzapw/OmniRoute --ref v2.x.y` +- If necessary, re-trigger the workflow using `gh workflow run <workflow_name.yml> --repo diegosouzapw/OmniRoute --ref v3.x.y` ### 20. Preserve release branch @@ -345,7 +346,7 @@ If a workflow fails: ## Notes -- Always run `/update-docs` BEFORE this workflow (ensures CHANGELOG and README are current) +- Ensure CHANGELOG, README and `docs/*` are current BEFORE this workflow — run `npm run check:docs-all` and `/version-bump` first (there is no `/update-docs` workflow anymore) - The `prepublishOnly` script runs `npm run build:cli` automatically during `npm publish` - After npm publish, verify with `npm info omniroute version` - Lock file sync errors are caused by skipping `npm install` after version bump @@ -353,9 +354,9 @@ If a workflow fails: ## Known CI Pitfalls -| CI failure | Cause | Fix | -| ------------------------------------------------------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------- | -| `[docs-sync] FAIL - OpenAPI version differs from package.json` | Skipped step 5 — `docs/openapi.yaml` version not updated | Run step 5 (`sed -i ...`) and commit | -| `[docs-sync] FAIL - CHANGELOG.md first section must be "## [Unreleased]"` | `## [Unreleased]` missing or not at top of CHANGELOG | Add `## [Unreleased]\n\n---\n` before the first versioned `## [x.y.z]` | -| Electron Linux `.deb` build fails (`FpmTarget` error) | `fpm` Ruby gem not installed on `ubuntu-latest` runner | Already fixed in `electron-release.yml` (`gem install fpm` step) | -| Docker Hub `502 error writing layer blob` | Transient Docker Hub network error during ARM64 push | Re-run the Docker publish workflow; no code change needed | +| CI failure | Cause | Fix | +| ------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- | +| `[docs-sync] FAIL - OpenAPI version differs from package.json` | Skipped step 5 — `docs/reference/openapi.yaml` version not updated | Run step 5 (`sed -i ...`) and commit | +| `[docs-sync] FAIL - CHANGELOG.md first section must be "## [Unreleased]"` | `## [Unreleased]` missing or not at top of CHANGELOG | Add `## [Unreleased]\n\n---\n` before the first versioned `## [x.y.z]` | +| Electron Linux `.deb` build fails (`FpmTarget` error) | `fpm` Ruby gem not installed on `ubuntu-latest` runner | Already fixed in `electron-release.yml` (`gem install fpm` step) | +| Docker Hub `502 error writing layer blob` | Transient Docker Hub network error during ARM64 push | Re-run the Docker publish workflow; no code change needed | diff --git a/.agents/workflows/implement-features.md b/.agents/workflows/implement-features-ag.md similarity index 98% rename from .agents/workflows/implement-features.md rename to .agents/workflows/implement-features-ag.md index 6a0938a868..afb8b3ed93 100644 --- a/.agents/workflows/implement-features.md +++ b/.agents/workflows/implement-features-ag.md @@ -201,22 +201,22 @@ For each viable feature, perform systematic research: **Step 1 — Web search for similar implementations:** ``` -search_web("how to implement <feature description> in <tech stack>") -search_web("<feature keyword> implementation nextjs typescript 2025 2026") -search_web("<feature keyword> open source library npm") +WebSearch("how to implement <feature description> in <tech stack>") +WebSearch("<feature keyword> implementation nextjs typescript 2025 2026") +WebSearch("<feature keyword> open source library npm") ``` **Step 2 — Find reference Git repositories:** ``` -search_web("site:github.com <feature keyword> <tech stack> stars:>100") -search_web("github <feature keyword> implementation recently updated 2026") +WebSearch("site:github.com <feature keyword> <tech stack> stars:>100") +WebSearch("github <feature keyword> implementation recently updated 2026") ``` - Find **up to 10 relevant repositories**, sorted by most recently updated. - For each repository: - Note the repo URL, star count, last commit date - - Read its README and relevant source files via `read_url_content` + - Read its README and relevant source files via `WebFetch` - Extract the architectural approach, patterns used, and key code snippets **Step 3 — Read API docs and standards:** diff --git a/.agents/workflows/issue-triage.md b/.agents/workflows/issue-triage-ag.md similarity index 100% rename from .agents/workflows/issue-triage.md rename to .agents/workflows/issue-triage-ag.md diff --git a/.agents/workflows/resolve-issues.md b/.agents/workflows/resolve-issues-ag.md similarity index 100% rename from .agents/workflows/resolve-issues.md rename to .agents/workflows/resolve-issues-ag.md diff --git a/.agents/workflows/review-discussions.md b/.agents/workflows/review-discussions-ag.md similarity index 92% rename from .agents/workflows/review-discussions.md rename to .agents/workflows/review-discussions-ag.md index e9f6a0cd1b..bd1192e29e 100644 --- a/.agents/workflows/review-discussions.md +++ b/.agents/workflows/review-discussions-ag.md @@ -8,6 +8,8 @@ description: Read all open GitHub Discussions, summarize them, respond to pendin This workflow reads all open GitHub Discussions, generates a categorized summary, identifies which ones need a response, drafts and posts replies, and optionally creates issues from actionable feature requests. It follows the same flow used for Issues but adapted for the Discussions forum. +> **Tool mapping note (v3.8):** Where steps below say `browser_subagent`, in modern Claude Code substitute with the `gh` CLI via Bash — `gh api graphql` for reading discussions and mutations for posting comments. `WebFetch` is acceptable for read-only HTML scraping when GraphQL is overkill, but prefer `gh` for any write actions. + // turbo-all ## Steps @@ -19,7 +21,7 @@ This workflow reads all open GitHub Discussions, generates a categorized summary ### 2. Fetch All Open Discussions -- Use `read_url_content` to fetch `https://github.com/<owner>/<repo>/discussions` +- Use `WebFetch` to fetch `https://github.com/<owner>/<repo>/discussions` - Parse the discussion list to get all discussion titles, IDs, authors, categories, and dates - For each discussion, fetch the individual page to read the full content and all comments/replies diff --git a/.agents/workflows/review-prs-ag.md b/.agents/workflows/review-prs-ag.md new file mode 100644 index 0000000000..22d9404b8b --- /dev/null +++ b/.agents/workflows/review-prs-ag.md @@ -0,0 +1,256 @@ +--- +description: Analyze open Pull Requests from the project's GitHub repository, generate a critical report, and optionally implement approved changes +--- + +# /review-prs — PR Review & Analysis Workflow + +## ⛔ ABSOLUTE PROHIBITION — Read Before Anything Else + +> **NEVER close a contributor's PR if you intend to use ANY of their code, ideas, or fixes.** +> +> **NEVER manually integrate contributor code into a release branch and then close their PR.** +> +> These actions are **STRICTLY FORBIDDEN** under all circumstances: +> +> 1. ❌ Closing a PR and cherry-picking/copying its code into a release branch +> 2. ❌ Closing a PR "because of conflicts" and re-implementing the same fix yourself +> 3. ❌ Closing a PR and committing a "similar" solution inspired by it +> 4. ❌ Using `gh pr close` on any PR whose content was or will be used +> +> **Why**: Closing a PR after taking the contributor's work means they get ZERO credit on GitHub — no "Merged" badge, no contribution graph entry, no public record. This is effectively stealing their contribution. An audit found this happened to **37 PRs** in the past. +> +> **The ONLY acceptable flow**: Resolve conflicts IN the contributor's branch, push fixes TO their branch, then merge THEIR PR via `gh pr merge`. See Step 7 and Step 8 for the exact procedure. +> +> **When to close a PR**: ONLY when the user (repository owner) explicitly requests it, OR when the PR is clearly spam/malicious, OR when the author themselves asks to close it. In ALL other cases, leave it open. + +## Overview + +This workflow fetches all open PRs from the project's GitHub repository, performs a critical analysis of each one, generates a detailed report, and waits for user approval before proceeding with implementation. **All improvements are committed on the current release branch** (`release/vX.Y.Z`). + +> **BRANCH RULE**: PRs are ALWAYS merged into the current `release/vX.Y.Z` branch, NEVER directly into `main`. The release branch acts as a staging area — only after all PRs are integrated and tests pass does the release branch get merged into `main` via the `/generate-release` workflow. + +## Steps + +### 1. Identify the GitHub Repository + +- Read `package.json` to get the repository URL, or use the git remote origin URL + // turbo +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo + +### 2. Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +# Bump patch: e.g. 3.3.11 → 3.3.12 +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 3. Fetch Open Pull Requests + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh pr list` can be truncated by the tool, silently hiding PRs. You MUST use the two-step approach below to guarantee **all** PRs are fetched. + +**Step 3a — Get PR numbers only** (small output, never truncated): + +- Run: `gh pr list --repo <owner>/<repo> --state open --limit 500 --json number --jq '.[].number'` +- This outputs one PR number per line. Count them and confirm total. + +**Step 3b — Fetch full metadata for each PR** (one call per PR): + +- For each PR number from step 3a, run: + `gh pr view <NUMBER> --repo <owner>/<repo> --json number,title,author,headRefName,baseRefName,body,createdAt,additions,deletions,files` +- You may batch these into parallel calls (up to 4 at a time). + +**Step 3c — Fetch diffs for each PR** (one call per PR, saved to /tmp): + +- For each PR number, run: + `gh pr diff <NUMBER> --repo <owner>/<repo> > /tmp/pr<NUMBER>.diff` +- Then read each diff file with the appropriate file-read tool (`Read` in Claude Code; equivalent in your agent runtime). + +- For each open PR, collect: + - PR number, title, author, branch, number of commits, date + - PR description/body + - Files changed (diff) + - Existing review comments (from bots or humans) + +**Verification**: Confirm the count of PRs analyzed matches the count from step 3a before proceeding. + +### 3.5 Redirect PR Base Branches to Release Branch + +// turbo-all + +**⚠️ CRITICAL**: Contributors typically open PRs targeting `main`. Before analyzing or merging, redirect ALL open PRs to target the current release branch instead. + +```bash +# Get the current release branch name +RELEASE_BRANCH=$(git branch --show-current) # e.g. release/v3.5.4 + +# For each open PR that targets main, change its base to the release branch +for PR_NUM in $(gh pr list --repo <owner>/<repo> --state open --json number,baseRefName --jq '.[] | select(.baseRefName == "main") | .number'); do + echo "Redirecting PR #$PR_NUM → $RELEASE_BRANCH" + gh pr edit "$PR_NUM" --repo <owner>/<repo> --base "$RELEASE_BRANCH" +done +``` + +This ensures: + +1. PRs merge into the release branch, not directly into `main` +2. Merge conflict detection is accurate against the release branch +3. The release branch accumulates all changes before the final merge to `main` +4. If the release branch doesn't exist on remote yet, push it first: `git push origin $RELEASE_BRANCH` + +### 4. Analyze Each PR — For each open PR, perform the following analysis: + +#### 4a. Feature Assessment + +- **Does it make sense?** Evaluate if the feature fills a real gap or solves a valid problem +- **Alignment** — Check if it aligns with the project's architecture and roadmap +- **Complexity** — Assess if the scope is reasonable or if it should be split + +#### 4b. Code Quality Review + +- Check for code duplication +- Evaluate error handling patterns (consistent with existing codebase?) +- Check naming conventions and code style +- Verify TypeScript types (any `any` usage, missing types?) + +#### 4c. Security Review + +- Check for missing authentication/authorization on new endpoints +- Check for injection vulnerabilities (URL params, SQL, XSS) +- Verify input validation on all user-controlled data +- Check for hardcoded secrets or credentials + +#### 4d. Architecture Review + +- Does the change follow existing patterns? +- Are there any breaking changes to public APIs? +- Is the database schema affected? Migration needed? +- Impact on performance (N+1 queries, missing indexes?) + +#### 4e. Test Coverage + +- Does the PR include tests? +- Are edge cases covered? +- Would existing tests break? + +#### 4f. Cross-Layer (Global) Analysis + +Perform a **global impact assessment** to verify whether the PR changes are complete across all layers of the application: + +- **Backend → Frontend check**: If the PR adds or modifies backend-only resources (new endpoints, services, data models), evaluate whether corresponding frontend changes are missing: + - Does a new endpoint require a new screen/page in the dashboard? + - Should there be a new action button, menu item, or navigation link? + - Are there new data fields that should be displayed or editable in the UI? + - Does a new feature need a toggle, configuration panel, or status indicator? +- **Frontend → Backend check**: If the PR adds frontend elements, verify the backend support exists: + - Are the required API endpoints implemented? + - Is the data model sufficient for the new UI components? +- **Cross-cutting concerns**: Check shared layers (types, DTOs, validation schemas, routes, middleware) for completeness +- **Document gaps** — If missing layers are detected, list them as **IMPORTANT** issues in the report with concrete suggestions for what should be added + +### 5. Generate Report — Create a markdown report for each PR including: + +- **PR Summary** — What it does, files affected, commit count +- **Improvements/Benefits** — Numbered list with impact level (HIGH/MEDIUM/LOW) +- **Risks & Issues** — Categorized as CRITICAL / IMPORTANT / MINOR +- **Scoring Table** — Rate across: Feature Relevance, Code Quality, Security, Robustness, Tests +- **Verdict** — Ready to merge? With mandatory vs optional fixes +- **Next Steps** — What will happen if approved + +### 6. Present to User + +- Show the report in the final response and stop. Mark this as a blocking checkpoint awaiting explicit user approval. +- Wait for user decision: + - **Approved** → Proceed to step 7 + - **Approved with changes** → Implement the fixes and corrections before merging + - **Rejected** → Close the PR or leave a review comment + +### 7. Pre-Merge Fixes & CI Green-Lighting (if approved) + +> **⚠️ Fixes and Conflict Resolutions MUST be pushed back to the PR branch before merging.** We want the PR itself to be green and fully valid before it integrates. + +- **Sync latest fixes & Resolve Conflicts:** Merge the current `release` branch into the PR branch. If there are merge conflicts, you MUST resolve them inside the author's PR branch. NEVER resolve conflicts by closing their PR and doing the work in a separate branch, as this steals credit from the original author. +- **Implement improvements:** Apply the required fixes identified in the analysis directly on the PR branch (e.g., adding missing API routes, fixing SSRF, applying comments from other agents). +- **Pushing changes to PR branches:** + + ```bash + # Checkout the PR locally + gh pr checkout <NUMBER> + + # Apply fixes, commit your changes + git commit -m "chore: apply review suggestions and missing layers" + + # Attempt to push directly to the PR branch + git push + ``` + +- **Fallback (ONLY for external forks without maintainer edit access):** + Using `cherry-pick` instead of fixing the contributor's PR directly is a **LAST RESORT**. You MUST ALWAYS attempt to `git push` your fixes to their branch first. + **ONLY if `git push` explicitly fails with a permission/access error** (meaning the contributor unchecked "Allow edits from maintainers" or it's a locked fork), you may use `git cherry-pick` to bring their changes into the release branch and fix the issues locally. + Even then, ensure you preserve the contributor's authorship (`git commit --author="Contributor Name <email>"` if creating new commits). + Once you have integrated their work into the release branch, **DO NOT close their PR**. Leave it open so the contributor retains credit. Under NO CIRCUMSTANCES should you use `gh pr close`. + +- Run the project's test suite locally to verify nothing breaks: + // turbo +- Run: `npm test` or equivalent test command + +### 8. Merge into Release Branch (NEVER CLOSE!) + +> **⚠️ CRITICAL**: NEVER use `gh pr close` for a PR whose idea or code was accepted. Closing a PR in a contributor's face after taking their idea—or closing it just because it had conflicts—is unacceptable. +> You MUST ALWAYS resolve conflicts and apply fixes ON THE AUTHOR'S PR BRANCH (unless explicitly locked from edits), and then merge the PR using GitHub so the contributor gets the official "Merged" badge and proper credit on their profile. **Do not use cherry-pick just because it is "easier" than resolving conflicts on their branch.** + +Even if the PR had severe conflicts or required significant architectural adjustments, you MUST: + +1. Resolve any conflicts and apply the fixes directly to their PR branch (as detailed in step 7) or use cherry-picking into the release branch. +2. If you managed to fix their branch, merge it into the release branch using the GitHub CLI: + `gh pr merge <NUMBER> --repo <owner>/<repo> --squash --body "Integrated into release/vX.Y.Z"` +3. If you had to use cherry-picking because you couldn't push to their branch, DO NOT close the PR. GitHub will sometimes auto-detect the cherry-picked commits and mark it as Merged. If it doesn't, leave it open. The repository owner will handle it. NEVER run `gh pr close`. + +In ALL cases: + +- Post a **thank-you comment** on the PR via the GitHub API before or immediately after merging. +- The message should: + - Thank the author by name/username for their contribution. + - Explain what was adjusted or improved (if we pushed fixes to their branch or cherry-picked). + - Note it will be included in the upcoming release. + - Be friendly, professional, and encouraging. + +> **⚠️ MANDATORY CHANGELOG CREDIT**: When cherry-picking is used (because the PR branch couldn't be pushed to or `gh pr merge` failed), the contributor does NOT get the automatic GitHub "Merged" badge. In this case, you MUST compensate by adding an explicit entry to `CHANGELOG.md` in the `[Unreleased]` section with `(#PR_NUMBER — thanks @username)` format. This ensures the contributor gets public credit in the release notes even if GitHub doesn't auto-detect the cherry-pick. This is NOT optional — skipping it effectively erases the contributor's work from the release record. + +### 9. Sync Local Release Branch + +After merging PRs, sync the local release branch to include the new changes: + +```bash +git fetch origin +git pull origin release/vX.Y.Z +``` + +### 10. Continue or Finalize + +After processing all approved PRs: + +- If more PRs remain, go back to step 7 +- When all PRs are processed, **update CHANGELOG.md** on the release branch with all new entries +- Run **test coverage** to verify the gate (≥75% statements/lines/functions, ≥70% branches — measured ~82%): + ```bash + npm run test:coverage + ``` +- Fix any test regressions introduced by merged PRs +- Run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user) +- The `/generate-release` workflow handles the final merge from `release/vX.Y.Z` → `main` diff --git a/.agents/workflows/version-bump.md b/.agents/workflows/version-bump-ag.md similarity index 66% rename from .agents/workflows/version-bump.md rename to .agents/workflows/version-bump-ag.md index 0667e0eb1d..8c356e52b5 100644 --- a/.agents/workflows/version-bump.md +++ b/.agents/workflows/version-bump-ag.md @@ -136,9 +136,9 @@ The date must be today's date in `YYYY-MM-DD` format. cd /home/diegosouzapw/dev/proxys/OmniRoute VERSION=$(node -p "require('./package.json').version") -# Update docs/openapi.yaml version -sed -i "s/ version: .*/ version: $VERSION/" docs/openapi.yaml -echo "✓ docs/openapi.yaml → $VERSION" +# Update docs/reference/openapi.yaml version +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml +echo "✓ docs/reference/openapi.yaml → $VERSION" # Update workspace packages (open-sse, electron) for dir in electron open-sse; do @@ -208,22 +208,36 @@ For each file below, read the current content and determine if the CHANGELOG ent For each file in `docs/` (excluding `docs/i18n/`), review if CHANGELOG changes affect it: -| File | When to update | -| -------------------------------- | --------------------------------------------------- | -| `docs/API_REFERENCE.md` | New API endpoints, changed request/response formats | -| `docs/ARCHITECTURE.md` | New modules, new services, changed data flow | -| `docs/CLI-TOOLS.md` | New CLI tool integrations, config format changes | -| `docs/FEATURES.md` | New features, removed features, changed settings | -| `docs/MCP-SERVER.md` | New MCP tools, changed tool signatures | -| `docs/A2A-SERVER.md` | New A2A skills, protocol changes | -| `docs/USER_GUIDE.md` | UX changes, new dashboard pages, settings changes | -| `docs/VM_DEPLOYMENT_GUIDE.md` | Deployment changes, new env vars | -| `docs/TROUBLESHOOTING.md` | New known issues, resolved problems | -| `docs/AUTO-COMBO.md` | Routing changes, new strategies | -| `docs/CODEBASE_DOCUMENTATION.md` | New files, architectural changes | -| `docs/RELEASE_CHECKLIST.md` | Process changes | -| `docs/COVERAGE_PLAN.md` | Test changes | -| `docs/openapi.yaml` | Already updated in step 7 | +| File | When to update | +| --------------------------------------------- | ------------------------------------------------------------------ | +| `docs/reference/API_REFERENCE.md` | New API endpoints, changed request/response formats | +| `docs/architecture/ARCHITECTURE.md` | New modules, new services, changed data flow | +| `docs/architecture/CODEBASE_DOCUMENTATION.md` | New files, architectural changes, module reorganization | +| `docs/architecture/REPOSITORY_MAP.md` | New folders / files / one-line descriptions | +| `docs/reference/CLI-TOOLS.md` | New CLI tool integrations, config format changes | +| `docs/guides/USER_GUIDE.md` | UX changes, new dashboard pages, settings changes | +| `docs/reference/PROVIDER_REFERENCE.md` | New providers (regenerate via `scripts/gen-provider-reference.ts`) | +| `docs/frameworks/MCP-SERVER.md` | New MCP tools, changed tool signatures, scope changes | +| `docs/frameworks/A2A-SERVER.md` | New A2A skills, protocol changes | +| `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md` | New external agent protocols supported | +| `docs/frameworks/CLOUD_AGENT.md` | Cloud agent additions (codex-cloud, devin, jules) or API changes | +| `docs/architecture/AUTHZ_GUIDE.md` | New route classifications, policy changes | +| `docs/security/GUARDRAILS.md` | New guardrails registered, priority/order changes | +| `docs/security/COMPLIANCE.md` | Audit log / retention / no-log policy changes | +| `docs/frameworks/SKILLS.md` | Skill framework / registry / built-in skill changes | +| `docs/frameworks/MEMORY.md` | Memory pipeline / extraction / injection / Qdrant changes | +| `docs/frameworks/EVALS.md` | Evaluation framework changes, new evaluators | +| `docs/frameworks/WEBHOOKS.md` | New webhook events, payload schema changes | +| `docs/routing/REASONING_REPLAY.md` | Reasoning capture/replay pipeline changes | +| `docs/routing/AUTO-COMBO.md` | Routing changes, new strategies, scoring weight changes | +| `docs/architecture/RESILIENCE_GUIDE.md` | Circuit breaker / cooldown / lockout behavior changes | +| `docs/security/STEALTH_GUIDE.md` | TLS / CLI fingerprint changes | +| `docs/ops/TUNNELS_GUIDE.md` | Cloudflare tunnel feature changes | +| `docs/guides/ELECTRON_GUIDE.md` | Electron build / signing / packaging changes | +| `docs/guides/TROUBLESHOOTING.md` | New known issues, resolved problems | +| `docs/ops/RELEASE_CHECKLIST.md` | Process changes | +| `docs/ops/COVERAGE_PLAN.md` | Coverage gate adjustments, target metrics | +| `docs/reference/openapi.yaml` | Already updated in step 7 | **Only update files where the CHANGELOG entries directly affect the documented content.** Do NOT update files just to bump a version number — only when the documented behavior, features, or architecture has actually changed. @@ -268,8 +282,8 @@ grep '"version"' open-sse/package.json | head -1 echo "--- electron/package.json ---" [ -f electron/package.json ] && grep '"version"' electron/package.json | head -1 -echo "--- docs/openapi.yaml ---" -grep " version:" docs/openapi.yaml | head -1 +echo "--- docs/reference/openapi.yaml ---" +grep " version:" docs/reference/openapi.yaml | head -1 echo "--- llm.txt ---" grep "Current version:" llm.txt @@ -310,18 +324,18 @@ git commit -m "chore(release): bump to v$VERSION — changelog, docs, version sy ## Notes - This workflow does **NOT** create tags, releases, or deploy. Use `/generate-release` for the full release cycle after this. -- This workflow does **NOT** update `docs/i18n/` translations. Use `/update-i18n` separately after committing. +- This workflow does **NOT** update `docs/i18n/` translations. Translation updates are handled manually or via release tooling — there is no `/update-i18n` workflow shipped in this repo. - The CHANGELOG generation is based on git commits since the last tag. If there are no new commits, the workflow should inform the user and stop. - Always verify the generated CHANGELOG entries make sense — raw commit messages may need rewriting for clarity. - If the version was already bumped (e.g. you're on a `release/vX.Y.Z` branch), skip the `npm version` step and use the existing version. ## Version Touchpoints Checklist -| File | Field/Pattern | -| ----------------------- | ----------------------------------------------------------- | -| `package.json` | `"version": "X.Y.Z"` | -| `open-sse/package.json` | `"version": "X.Y.Z"` | -| `electron/package.json` | `"version": "X.Y.Z"` | -| `docs/openapi.yaml` | `version: X.Y.Z` | -| `llm.txt` | `**Current version:** X.Y.Z` and `## Key Features (vX.Y.Z)` | -| `CHANGELOG.md` | `## [X.Y.Z] — YYYY-MM-DD` | +| File | Field/Pattern | +| ----------------------------- | ----------------------------------------------------------- | +| `package.json` | `"version": "X.Y.Z"` | +| `open-sse/package.json` | `"version": "X.Y.Z"` | +| `electron/package.json` | `"version": "X.Y.Z"` | +| `docs/reference/openapi.yaml` | `version: X.Y.Z` | +| `llm.txt` | `**Current version:** X.Y.Z` and `## Key Features (vX.Y.Z)` | +| `CHANGELOG.md` | `## [X.Y.Z] — YYYY-MM-DD` | diff --git a/.claude/commands/capture-release-evidences-cc.md b/.claude/commands/capture-release-evidences-cc.md new file mode 100644 index 0000000000..b2eb264b6f --- /dev/null +++ b/.claude/commands/capture-release-evidences-cc.md @@ -0,0 +1,51 @@ +--- +description: Automatically run a browser-automation agent to visually validate all new UI features from the current release and capture evidence WebP recordings of the changes. +--- + +# Capture Release Evidences Workflow + +Use this workflow to automatically drive a browser-automation agent to explore the newly deployed or locally running application and record evidence of the UI changes introduced in the latest release. + +> **Tool mapping note (v3.8):** This workflow references a `browser_subagent` tool that was specific to an earlier agent runtime. In Claude Code, substitute with the available browser MCP tools (e.g. `mcp__claude-in-chrome__*`) for navigation/screenshots, plus the `Write` tool for saving artifacts. The high-level steps below remain the same regardless of which browser-automation surface is used. + +## Prerequisites + +- OmniRoute must be actively running and accessible (e.g. locally at `http://localhost:20128` or on the Local VPS at `http://192.168.0.15:20128`). +- The user must provide the target URL to be tested, or default to `http://192.168.0.15:20128`. + +## Workflow Steps + +### 1. Identify Target Features + +Review the `CHANGELOG.md` for the latest version to map out the new UI elements. For example: + +- **CLI Tools Settings** +- **New Provider/Model Listings (e.g., Gemini 3.1, Qoder PAT)** +- **New Feature Modals** + +### 2. Run the Browser Subagent + +For each identified feature, invoke the `browser_subagent` using the `default_api:browser_subagent` tool. +**Important Task Guidelines for the Subagent:** + +- `TaskName`: Give it a clear name like "Validate CLIProxyAPI Tool Tab". +- `TaskSummary`: "Navigate to the CLI Tools tab and verify the new Integration settings." +- `Task`: Provide unambiguous instructions for the subagent, such as: "Navigate to http://192.168.0.15:20128/dashboard. Click on the 'Settings' or 'CLI Tools' nav link. Scroll down to find the CLIProxyAPI integration card. Hover over it to trigger UI state. Verify the components render correctly and exit." +- `RecordingName`: Ensure it describes the feature (e.g. `v3_4_5_cli_proxy_api`). This is required and strictly automatically saved as a WebP artifacts video by the system. + +_(Note: The `browser_subagent` automatically creates a WebP recording named by the `RecordingName` parameter. No additional tools for screenshots are needed.)_ + +### 3. Generate Report Artifact + +After the `browser_subagent` finishes its sessions, generate a final Markdown artifact (using `Write` and `IsArtifact=true`) to present the recordings inline to the user using the `![caption](/absolute/path/to/media.webp)` syntax. + +### Example Invocation + +\```json +{ +"TaskName": "Validating Qoder PAT Configuration UI", +"TaskSummary": "Validates the Qoder provider configuration modal", +"Task": "Go to http://192.168.0.15:20128/dashboard. Click on the 'Providers' tab. Find 'Qoder' in the list. Click 'Add Token' or 'Configure'. Type 'test_token' and submit. Return when done.", +"RecordingName": "qoder_pat_ui_validation" +} +\``` diff --git a/.claude/commands/deploy-vps-akamai-cc.md b/.claude/commands/deploy-vps-akamai-cc.md new file mode 100644 index 0000000000..b25ae3cd99 --- /dev/null +++ b/.claude/commands/deploy-vps-akamai-cc.md @@ -0,0 +1,39 @@ +--- +description: Deploy the latest OmniRoute code to the Akamai VPS (69.164.221.35) +--- + +# Deploy to Akamai VPS Workflow + +Deploy OmniRoute to the Akamai VPS using `npm pack + scp` + PM2. + +**Akamai VPS:** `69.164.221.35` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to Akamai VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@69.164.221.35:/tmp/ +``` + +```bash +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'AKAMAI HTTP %{http_code}\n' http://69.164.221.35:20128/ +``` diff --git a/.claude/commands/deploy-vps-both-cc.md b/.claude/commands/deploy-vps-both-cc.md new file mode 100644 index 0000000000..e1aa4d1def --- /dev/null +++ b/.claude/commands/deploy-vps-both-cc.md @@ -0,0 +1,49 @@ +--- +description: Deploy the latest OmniRoute code to BOTH the Akamai VPS and the Local VPS +--- + +# Deploy to VPS (Both) Workflow + +Deploy OmniRoute to the production VPSs using `npm pack + scp` + PM2. + +**Akamai VPS:** `69.164.221.35` +**Local VPS:** `192.168.0.15` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` +**PM2 entry:** `/usr/lib/node_modules/omniroute/app/server.js` + +> [!IMPORTANT] +> The npm registry rejects packages > 100MB, so deployment uses **npm pack + scp**. + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to both VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@69.164.221.35:/tmp/ && scp omniroute-*.tgz root@192.168.0.15:/tmp/ +``` + +```bash +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" +``` + +```bash +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'AKAMAI HTTP %{http_code}\n' http://69.164.221.35:20128/ +curl -s -o /dev/null -w 'LOCAL HTTP %{http_code}\n' http://192.168.0.15:20128/ +``` diff --git a/.claude/commands/deploy-vps-local-cc.md b/.claude/commands/deploy-vps-local-cc.md new file mode 100644 index 0000000000..549b1f0b2a --- /dev/null +++ b/.claude/commands/deploy-vps-local-cc.md @@ -0,0 +1,39 @@ +--- +description: Deploy the latest OmniRoute code to the Local VPS (192.168.0.15) +--- + +# Deploy to Local VPS Workflow + +Deploy OmniRoute to the Local VPS using `npm pack + scp` + PM2. + +**Local VPS:** `192.168.0.15` +**Process manager:** PM2 (`omniroute`) +**Port:** `20128` + +## Steps + +### 1. Build + pack locally + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts +``` + +### 2. Copy to Local VPS and install + +// turbo-all + +```bash +scp omniroute-*.tgz root@192.168.0.15:/tmp/ +``` + +```bash +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" +``` + +### 3. Verify the deployment + +```bash +curl -s -o /dev/null -w 'LOCAL HTTP %{http_code}\n' http://192.168.0.15:20128/ +``` diff --git a/.claude/commands/generate-release-cc.md b/.claude/commands/generate-release-cc.md new file mode 100644 index 0000000000..7cb717c423 --- /dev/null +++ b/.claude/commands/generate-release-cc.md @@ -0,0 +1,362 @@ +--- +description: Create a new release, bump version up to the .10 patch threshold, update changelog, and manage Pull Requests +--- + +# Generate Release Workflow + +Bump version, finalize CHANGELOG, commit, open a **PR to main** and wait for user confirmation before tagging, publishing, and deploying. + +> **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** +> NEVER use `npm version minor` or `npm version major`. +> Always use: `npm version patch --no-git-tag-version` +> The threshold rule: when `y` reaches 10, bump to `3.(x+1).0` — e.g. `3.8.10` → `3.9.0`. + +> **🔴 SINGLE BRANCH RULE**: The `release/vX.Y.Z` branch is the **ONLY** development branch for the entire release cycle. ALL work — bug fixes, feature implementations, PR integrations, issue resolutions — MUST be committed directly on this branch. Never create separate `fix/`, `feat/`, or topic branches. When running `/resolve-issues`, `/implement-features`, or `/review-prs`, always work on the current release branch. + +--- + +## ⚠️ Two-Phase Flow + +``` +Phase 1 (automated): bump → docs → i18n → commit → push → open PR + ↕ 🛑 STOP: Notify user, wait for PR confirmation +Phase 2 (post-merge): tag → publish → GitHub release → Docker → deploy +``` + +**NEVER push directly to main or create tags before the user confirms the PR.** + +--- + +## Phase 0: Security Verification (MANDATORY) + +Before creating the release, you must ensure the codebase and supply chain are secure and free of known vulnerabilities. + +1. **Run Local Dependencies Audit:** + + ```bash + npm audit + ``` + + _Fix any `high` or `critical` vulnerabilities identified._ + +2. **Check GitHub CodeQL & Dependabot Alerts:** + Navigate to the repository's **Security** tab on GitHub, or use the project's `vulnerability-scanner` skill to analyze active alerts. Ensure all static analysis findings (e.g., prototype pollution, insecure randomness, ReDoS, shell injections) are addressed and logically committed on a target branch. + +--- + +## Phase 1: Pre-Merge + +### 1. Create release branch + +```bash +git checkout -b release/v3.x.y +``` + +### 2. Determine and sync version + +Check current version in `package.json`: + +```bash +grep '"version"' package.json +``` + +> **🔴 BRANCH-VERSION PARITY RULE**: The logical version in `package.json` MUST exactly match the release branch name. For example, if you are on `release/v3.7.0`, the version in `package.json` MUST be `3.7.0`. +> +> - If this is the FIRST time generating a release for a new minor/major branch (e.g., bumping from 3.6.9 to 3.7.0), you MUST ensure the version is bumped to match the new branch logic. +> - If you are just bumping a patch on the current branch (e.g., 3.6.9 to 3.6.10), use: +> `npm version patch --no-git-tag-version` + +> **⚠️ ATOMIC COMMIT RULE — Version bump MUST happen before committing feature files.** +> +> **CORRECT order:** +> +> 1. `npm version patch --no-git-tag-version` ← bump first +> 2. implement features / fix bugs +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` +> +> **OR if features are already staged:** +> +> 1. implement features (do NOT commit yet) +> 2. `npm version patch --no-git-tag-version` ← bump before committing +> 3. `git add -A && git commit -m "chore(release): v3.x.y — all changes in ONE commit"` +> +> **NEVER do this (creates version mismatch in git history):** +> +> - ~~commit features → then bump version → commit package.json separately~~ +> +> This ensures that `git show v3.x.y` always contains both code changes and the version bump together. +> The GitHub release tag will point to a commit that includes ALL changes for that version. + +### 3. Regenerate lock file (REQUIRED after version bump) + +**Mandatory** — skipping causes `@swc/helpers` lock mismatch and CI failures: + +```bash +npm install +``` + +### 4. Finalize CHANGELOG.md + +> **🔴 NO MIXUPS RULE**: Ensure you do NOT mix the backlog of the previous version with the new one. The new version section must ONLY contain the features and fixes for the current release. + +Replace the `[Unreleased]` header with the new version and date. +Keep an empty `## [Unreleased]` section above it, separated by a horizontal rule (`---`). + +```markdown +## [Unreleased] + +--- + +## [3.7.0] — 2026-04-19 + +### ✨ New Features + +- ... + +### 🐛 Bug Fixes + +- ... + +--- + +## [3.6.9] — 2026-04-19 +``` + +### 5. Update openapi.yaml version ⚠️ MANDATORY + +> **CI will fail** if `docs/reference/openapi.yaml` version ≠ `package.json` version (`check:docs-sync` enforces this). + +// turbo + +```bash +VERSION=$(node -p "require('./package.json').version") +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml +echo "✓ openapi.yaml → $VERSION" + +for dir in electron open-sse; do + if [ -d "$dir" ] && [ -f "$dir/package.json" ]; then + (cd "$dir" && npm version "$VERSION" --no-git-tag-version --allow-same-version > /dev/null) + echo "✓ $dir/package.json → $VERSION" + fi +done +# Re-run install to assert the workspace lockfile is updated +npm install +``` + +### 6. Update README.md and i18n docs + +Manually perform these documentation updates (there is no `/update-docs` slash command — it was deprecated in v3.8): + +- Update feature table rows and "What's new in vX.Y.Z" section in `README.md` +- Sync feature changes to all 40 language `docs/i18n/*/README.md` files (use the same row edits across each translated README) +- Update the relevant `docs/<AREA>.md` if architecture or counts changed (e.g. `docs/frameworks/MCP-SERVER.md` when MCP tools change) +- Re-run `npm run check:docs-sync` and `npm run check:docs-all` to catch drift + +### 7. Run tests + +// turbo + +```bash +npm test +``` + +All tests must pass before creating the PR. + +### 8. Stage, commit, and push + +// turbo-all + +```bash +git add -A +git commit -m "chore(release): v3.x.y — summary of changes" +git push origin release/v3.x.y +``` + +### 9. Open PR to main + +### 9. Open PR to main + +// turbo + +```bash +VERSION=$(node -p "require('./package.json').version") + +# Extract the exact changelog entry for this version from the root CHANGELOG.md +awk "/^## \\[$VERSION\\]/{flag=1; print; next} /^---/{if(flag) {flag=0; exit}} flag" CHANGELOG.md > /tmp/changelog_body.txt + +# Append test status and next steps +echo "" >> /tmp/changelog_body.txt +echo "### Tests" >> /tmp/changelog_body.txt +echo "- All tests pass" >> /tmp/changelog_body.txt +echo "" >> /tmp/changelog_body.txt +echo "### ⚠️ After merging: run Phase 2 steps to tag, publish, and deploy." >> /tmp/changelog_body.txt + +gh pr create \ + --repo diegosouzapw/OmniRoute \ + --base main \ + --head release/v$VERSION \ + --title "Release v$VERSION" \ + --body-file /tmp/changelog_body.txt +``` + +### 10. 🛑 STOP — Notify User & Await PR Confirmation + +**This is a mandatory stop point.** Present the report in the final response and stop. Do not continue to the next phase until the user explicitly approves. + +Inform the user: + +- PR URL +- Summary of changes +- Test results +- List of files changed + +**DO NOT proceed to Phase 2 until the user confirms the PR looks good and merges it.** + +--- + +## Phase 2: Post-Merge Validation (Local VPS) + +> Run these steps only AFTER the user has merged the PR into `main` and all CI jobs have passed. + +### 11. Deploy to Local VPS for Final Validation (MANDATORY) + +Before cutting the official git tag and publishing to the world, deploy the `main` branch to the Local VPS for a final homologation test. + +```bash +git checkout main +git pull origin main + +# Build and pack locally +cd /home/diegosouzapw/dev/proxys/OmniRoute && rm -f omniroute-*.tgz && rm -rf .next/cache app/.next/cache && npm run build:cli && rm -rf app/logs app/coverage app/.git app/.app-build-backup* && npm pack --ignore-scripts + +# Deploy to LOCAL VPS (192.168.0.15) +scp omniroute-*.tgz root@192.168.0.15:/tmp/ +ssh root@192.168.0.15 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Local done'" + +# Verify +curl -s -o /dev/null -w "LOCAL: HTTP %{http_code}\n" http://192.168.0.15:20128/ +``` + +### 12. 🛑 STOP — Notify User & Await Final OK + +**This is a mandatory stop point.** +Inform the user that the `main` branch is now running on the Local VPS. +Wait for the user to manually test and give the **OK**. +**DO NOT proceed to Phase 3 until the user confirms the local deploy is stable.** + +--- + +## Phase 3: Official Launch + +> Run these steps only AFTER the user gives the final OK from the Phase 2 local validation. + +### 13. Create Git Tag and GitHub Release (MANDATORY) + +// turbo + +```bash +git checkout main +git pull origin main +VERSION=$(node -p "require('./package.json').version") + +# Extracts the changelog section for this version +NOTES=$(awk "/^## \\[$VERSION\\]/{flag=1; next} /^---/{if(flag) {flag=0; exit}} flag" CHANGELOG.md | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//') +if [ -z "$NOTES" ]; then NOTES="OmniRoute v$VERSION Release"; fi + +git tag -a "v$VERSION" -m "Release v$VERSION" +git push origin "v$VERSION" +gh release create "v$VERSION" --repo diegosouzapw/OmniRoute --title "v$VERSION" --notes "$NOTES" --target main || gh release edit "v$VERSION" --repo diegosouzapw/OmniRoute --title "v$VERSION" --notes "$NOTES" +``` + +### 14. 🐳 Trigger Docker Hub build (MANDATORY — keep npm and Docker in sync) + +> **CRITICAL**: Docker Hub and npm MUST always publish the same version. +> The Docker image is built automatically via GitHub Actions when a new tag is pushed. +> After pushing the tag in step 13, **verify the workflow runs**: + +```bash +# Verify the Docker workflow triggered +gh run list --repo diegosouzapw/OmniRoute --workflow docker-publish.yml --limit 3 + +# Wait for the Docker build to complete (usually 5–10 min) +gh run watch --repo diegosouzapw/OmniRoute +``` + +### 15. Publish to NPM (Optional/Automated) + +Normally handled by CI, but if manual publish is required: + +```bash +npm publish +``` + +### 16. Deploy to AKAMAI VPS (Production) + +Now that the release is officially cut, deploy it to the Akamai VPS. + +```bash +# Deploy to AKAMAI VPS (69.164.221.35) +scp omniroute-*.tgz root@69.164.221.35:/tmp/ +ssh root@69.164.221.35 "npm install -g /tmp/omniroute-*.tgz --ignore-scripts && cd /usr/lib/node_modules/omniroute/app && npm rebuild better-sqlite3 && pm2 delete omniroute 2>/dev/null; pm2 start /root/.omniroute/ecosystem.config.cjs --update-env && pm2 save && echo '✅ Akamai done'" + +# Verify +curl -s -o /dev/null -w "AKAMAI: HTTP %{http_code}\n" http://69.164.221.35:20128/ +``` + +## Phase 4: Release Monitoring & Artifact Validation + +> After triggering the official release, actively monitor the CI pipelines until all artifacts are successfully generated. If any pipeline fails, stop and apply the necessary corrections before continuing. + +### 18. Monitor CI Pipelines + +Wait for and verify the successful completion of the following automated jobs: + +1. **Docker Hub Publish** +2. **Electron Build** +3. **NPM Registry Publish** (Check with `npm info omniroute version`) + +```bash +# Monitor Docker Hub workflow +gh run list --repo diegosouzapw/OmniRoute --workflow docker-publish.yml --limit 1 +gh run watch <RUN_ID> + +# Monitor Electron build +gh run list --repo diegosouzapw/OmniRoute --workflow electron-release.yml --limit 1 +gh run watch <RUN_ID> + +# Verify NPM version +npm info omniroute version +``` + +### 19. Handle Failures (If Any) + +If a workflow fails: + +- Use `gh run view <RUN_ID> --log-failed` to identify the error. +- Apply the fix on the `main` branch. +- If necessary, re-trigger the workflow using `gh workflow run <workflow_name.yml> --repo diegosouzapw/OmniRoute --ref v3.x.y` + +### 20. Preserve release branch + +```bash +# Branch is kept for historical purposes. Do not delete. +``` + +--- + +## Notes + +- Ensure CHANGELOG, README and `docs/*` are current BEFORE this workflow — run `npm run check:docs-all` and `/version-bump` first (there is no `/update-docs` slash command anymore) +- The `prepublishOnly` script runs `npm run build:cli` automatically during `npm publish` +- After npm publish, verify with `npm info omniroute version` +- Lock file sync errors are caused by skipping `npm install` after version bump +- Use `gh auth switch -u diegosouzapw` if git push fails with wrong account + +## Known CI Pitfalls + +| CI failure | Cause | Fix | +| ------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- | +| `[docs-sync] FAIL - OpenAPI version differs from package.json` | Skipped step 5 — `docs/reference/openapi.yaml` version not updated | Run step 5 (`sed -i ...`) and commit | +| `[docs-sync] FAIL - CHANGELOG.md first section must be "## [Unreleased]"` | `## [Unreleased]` missing or not at top of CHANGELOG | Add `## [Unreleased]\n\n---\n` before the first versioned `## [x.y.z]` | +| Electron Linux `.deb` build fails (`FpmTarget` error) | `fpm` Ruby gem not installed on `ubuntu-latest` runner | Already fixed in `electron-release.yml` (`gem install fpm` step) | +| Docker Hub `502 error writing layer blob` | Transient Docker Hub network error during ARM64 push | Re-run the Docker publish workflow; no code change needed | diff --git a/.claude/commands/implement-features-cc.md b/.claude/commands/implement-features-cc.md new file mode 100644 index 0000000000..afb8b3ed93 --- /dev/null +++ b/.claude/commands/implement-features-cc.md @@ -0,0 +1,706 @@ +--- +description: Analyze open feature request issues, implement viable ones on dedicated branches, and respond to authors +--- + +# /implement-features — Feature Request Harvest, Research & Implementation Workflow + +## Overview + +A **5-phase** workflow that systematically harvests feature requests from GitHub issues, creates structured idea files, researches solutions across the internet and Git repositories, presents a consolidated report for user approval, then generates detailed implementation plans and executes them. + +**Output directory structure:** + +``` +_ideia/ +├── viable/ # Features approved for implementation +│ ├── need_details/ # ❓ Good idea but waiting for author clarification (issues stay OPEN) +│ │ └── 1015-warp-terminal-mitm.md +│ ├── 1046-native-playground.md # ✅ Ready — researched and planned +│ └── 1046-native-playground.requirements.md +├── defer/ # ⏭️ Good ideas deferred for future cycles (issues CLOSED) +│ └── 1041-smart-auto-combos.md +└── notfit/ # ❌ Out of scope / already exists (issues CLOSED) + └── 945-telegram-integration.md + +_tasks/features-vX.Y.Z/ # Implementation plans (per-release) +└── 1046-native-playground.plan.md +``` + +> **LIFECYCLE RULE:** `viable/` files are **DELETED** once the feature is implemented — they are not moved. Only unimplemented features live in `viable/` (or `viable/need_details/`). Files in `defer/` and `notfit/` remain as permanent reference. + +> **BRANCH RULE**: All implementation work MUST happen on the current `release/vX.Y.Z` branch. Never create separate `feat/` branches. If no release branch exists yet, create one first using `/generate-release` Phase 1 steps 1–5. + +--- + +## Phase 1 — Harvest: Collect & Catalog Feature Ideas + +### 1.1 Identify the Repository + +// turbo + +- Run: `git -C <project_root> remote get-url origin` to extract owner/repo. + +### 1.2 Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 1.3 Fetch ALL Open Feature Requests + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh issue list` can be truncated by the tool, silently hiding issues. You MUST use the two-step approach below. + +**Step 1 — Get Issue numbers only** (small output, never truncated): + +```bash +# Fetch issues with feature/enhancement labels +gh issue list --repo <owner>/<repo> --state open -l "enhancement" --limit 500 --json number --jq '.[].number' + +# Also check for [Feature] in title (common pattern when no labels are set) +gh issue list --repo <owner>/<repo> --state open --limit 500 --json number,title --jq '.[] | select(.title | test("\\[Feature\\]|\\[feature\\]|feature request"; "i")) | .number' +``` + +- Merge both lists, deduplicate. Count and confirm the total. + +**Step 2 — Fetch full metadata for each Issue** (one call per issue): + +```bash +gh issue view <NUMBER> --repo <owner>/<repo> --json number,title,labels,body,comments,createdAt,author,assignees +``` + +- Read the **entire body** — including description, use cases, screenshots, mockups, and any embedded images. +- Read **ALL comments** — community discussion, agreements, restrictions, owner responses, and linked PRs. +- **Images**: If the body or comments contain image URLs (`![...](...)` or `https://...png/jpg/gif`), note them — they may contain UI mockups, wireframes, or architecture diagrams that are essential to understanding the request. +- You may batch these into parallel calls (up to 4 at a time). +- Sort by oldest first (FIFO). + +### 1.4 Create Idea Files (initially in `_ideia/` root) + +For each feature request, create a structured idea file in `<project_root>/_ideia/`: + +**Filename convention**: `<NUMBER>-<kebab-case-short-title>.md` +Example: `1046-native-playground.md`, `1041-smart-auto-combos.md` + +#### 1.4a — If the idea file does NOT exist yet, create it: + +```markdown +# Feature: <Title from Issue> + +> GitHub Issue: #<NUMBER> — opened by @<author> on <date> +> Status: 📋 Cataloged | Priority: TBD + +## 📝 Original Request + +<Paste the FULL issue body here, preserving all formatting, images, and code blocks> + +## 💬 Community Discussion + +<Summarize ALL comments chronologically, noting who said what and any decisions or objections raised> + +### Participants + +- @<author> — Original requester +- @<commenter1> — <brief role/opinion> +- ... + +### Key Points + +- <bullet list of the most important discussion points> +- <agreements reached> +- <objections raised> + +## 🎯 Refined Feature Description + +<YOUR interpretation and enrichment of the feature request. Expand on what was asked, fill in logical gaps, provide concrete examples of how it would work. This section should be MORE detailed and clearer than the original request.> + +### What it solves + +- <problem 1> +- <problem 2> + +### How it should work (high level) + +1. <step 1> +2. <step 2> +3. ... + +### Affected areas + +- <list of codebase areas, modules, files likely affected> + +## 📎 Attachments & References + +- <any image URLs, mockup links, or external references from the issue> + +## 🔗 Related Ideas + +- <links to related \_ideia/ files if any overlap found> +``` + +#### 1.4b — If the idea file ALREADY exists, update it: + +- Append new comments from the issue to the **Community Discussion** section. +- Update the **Refined Feature Description** if new information changes the understanding. +- Add any new **Related Ideas** cross-references found. +- **Do NOT overwrite** existing content — append and enrich it. + +### 1.5 Cross-Reference & Deduplication + +After processing all issues: + +- Scan all `_ideia/*.md` files for overlapping features. +- If two features are substantially the same, add `🔗 Related Ideas` cross-references to both. +- If one is a strict subset of another, note it in the smaller file: `> ℹ️ This feature is a subset of #<OTHER_NUMBER>. Consider implementing together.` + +--- + +## Phase 2 — Research: Find Solutions & Build Requirements + +For each cataloged idea that is **viable** (aligns with the project's goals): + +### 2.1 Viability Pre-Check + +Before investing in research, quickly assess: + +- [ ] Does this feature align with the project's goals and architecture? +- [ ] Is it technically feasible with the current codebase? +- [ ] Does it duplicate existing functionality? +- [ ] Would it introduce breaking changes or security risks? +- [ ] Is there enough detail to understand what's needed? + +**Verdict options:** + +| Verdict | When | Action | +| --------------------- | ------------------------------------- | --------------------------- | +| ✅ **VIABLE** | Good idea, enough context | Proceed to Research | +| ❓ **NEEDS DETAIL** | Good idea, insufficient spec | Skip research, ask author | +| ⏭️ **DEFER** | Good idea, too complex for this cycle | Catalog only, skip research | +| ❌ **NOT FIT** | Doesn't fit the project | Explain why | +| 🔁 **ALREADY EXISTS** | Feature already implemented | Point to existing feature | + +### 2.2 Internet Research (for VIABLE features) + +For each viable feature, perform systematic research: + +**Step 1 — Web search for similar implementations:** + +``` +WebSearch("how to implement <feature description> in <tech stack>") +WebSearch("<feature keyword> implementation nextjs typescript 2025 2026") +WebSearch("<feature keyword> open source library npm") +``` + +**Step 2 — Find reference Git repositories:** + +``` +WebSearch("site:github.com <feature keyword> <tech stack> stars:>100") +WebSearch("github <feature keyword> implementation recently updated 2026") +``` + +- Find **up to 10 relevant repositories**, sorted by most recently updated. +- For each repository: + - Note the repo URL, star count, last commit date + - Read its README and relevant source files via `WebFetch` + - Extract the architectural approach, patterns used, and key code snippets + +**Step 3 — Read API docs and standards:** + +If the feature involves an external API, protocol, or standard: + +- Find and read the official documentation +- Note version requirements, authentication patterns, rate limits + +### 2.3 Create Requirements File + +For each researched feature, create a requirements file alongside its idea file: + +**Filename**: `<NUMBER>-<kebab-case-short-title>.requirements.md` + +```markdown +# Requirements: <Feature Title> + +> Feature Idea: [#<NUMBER>](./<NUMBER>-<kebab-case-short-title>.md) +> Research Date: <YYYY-MM-DD> +> Verdict: ✅ VIABLE + +## 🔍 Research Summary + +<Brief summary of what was found during research> + +## 📚 Reference Implementations + +| # | Repository | Stars | Last Updated | Approach | Relevance | +| --- | ---------------- | ----- | ------------ | -------- | ------------ | +| 1 | [repo/name](url) | ⭐ N | YYYY-MM-DD | <brief> | High/Med/Low | +| 2 | ... | | | | | + +### Key Patterns Found + +- <pattern 1 with code snippet or link> +- <pattern 2> + +## 📐 Proposed Solution Architecture + +### Approach + +<Describe the chosen approach based on research findings> + +### New Files + +| File | Purpose | +| --------------------- | ------------- | +| `path/to/new/file.ts` | <description> | + +### Modified Files + +| File | Changes | +| -------------------------- | -------------- | +| `path/to/existing/file.ts` | <what changes> | + +### Database Changes + +- <migrations needed, if any> + +### API Changes + +- <new/modified endpoints, if any> + +### UI Changes + +- <new/modified pages/components, if any> + +## ⚙️ Implementation Effort + +- **Estimated complexity**: Low / Medium / High / Very High +- **Estimated files changed**: ~N +- **Dependencies needed**: <new npm packages, if any> +- **Breaking changes**: Yes/No — <details> +- **i18n impact**: <number of new translation keys> +- **Test coverage needed**: <brief description> + +## ⚠️ Open Questions + +- <question 1> +- <question 2> + +## 🔗 External References + +- <documentation URLs> +- <API references> +``` + +--- + +## Phase 2.5 — Organize & Respond: Sort Files and Post GitHub Comments + +### 2.5.1 Create Directory Structure + +// turbo + +```bash +mkdir -p <project_root>/_ideia/viable +mkdir -p <project_root>/_ideia/viable/need_details +mkdir -p <project_root>/_ideia/defer +mkdir -p <project_root>/_ideia/notfit +``` + +### 2.5.2 Move Idea Files to Category Subdirectories + +After classification, move EVERY idea file to its correct subdirectory: + +```bash +# ✅ VIABLE — move idea + requirements files +mv _ideia/<NUMBER>-*.md _ideia/viable/ +mv _ideia/<NUMBER>-*.requirements.md _ideia/viable/ + +# ❓ NEEDS DETAIL — viable but waiting for author response +mv _ideia/<NUMBER>-*.md _ideia/viable/need_details/ + +# ⏭️ DEFER — move idea files only +mv _ideia/<NUMBER>-*.md _ideia/defer/ + +# ❌ NOT FIT & 🔁 ALREADY EXISTS — move idea files only +mv _ideia/<NUMBER>-*.md _ideia/notfit/ +``` + +No files should remain in `_ideia/` root after this step (except subdirectories). + +### 2.5.3 Post GitHub Comments by Category + +**Each category has a specific comment template and action:** + +--- + +#### For 🔁 ALREADY EXISTS — Comment + CLOSE issue + +// turbo + +The feature already exists in the system. Explain WHERE it is and HOW to use it. + +```markdown +Hi @<author>! Thanks for the suggestion! 🙏 + +Great news — this functionality **already exists** in OmniRoute: + +**📍 Where to find it:** <exact dashboard path or settings location> + +**🔧 How to use it:** + +1. <step 1> +2. <step 2> +3. <step 3> + +If you have any trouble finding or using it, feel free to ask in a Discussion. We're always happy to help! + +Closing this as the feature is already available. 🎉 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ⏭️ DEFER — Comment + CLOSE issue + +// turbo + +Thank the user, explain the idea was cataloged, and that we'll study it before implementing. + +```markdown +Hi @<author>! Thanks for this thoughtful feature request! 🙏 + +We really appreciate the detailed proposal. We've **cataloged your idea** and it's now part of our improvement backlog. + +Due to the **significant architectural impact** of this feature, we'll need to conduct thorough use-case studies and architectural analysis before we start development. This ensures we build it right and don't introduce regressions. + +**What happens next:** + +- Your idea is saved in our internal feature backlog +- We'll conduct architecture studies when this area is prioritized +- We'll notify you here when development begins + +Thank you for contributing to OmniRoute's roadmap! Your input helps shape the product. 🚀 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ❌ NOT FIT — Comment + CLOSE issue + +// turbo + +Politely explain why the feature doesn't fit the project scope. + +```markdown +Hi @<author>! Thanks for the suggestion! 🙏 + +After careful analysis, we've determined that this feature **falls outside OmniRoute's core scope** as a proxy/router. + +**Reason:** <explain why — e.g., "Telegram integration belongs in the application/orchestrator layer that consumes OmniRoute's API, not inside the router itself."> + +**Alternative:** <suggest an alternative approach if possible> + +We appreciate you thinking of ways to improve OmniRoute! If you'd like to discuss this further, feel free to open a Discussion. 🙏 +``` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +``` + +--- + +#### For ❓ NEEDS DETAIL — Comment (keep OPEN) + +// turbo + +Ask for the specific missing details needed. + +```markdown +Hi @<author>! Thanks for the feature request — it's an interesting idea and we'd love to explore it further. 🙏 + +To move forward, we need a few more details: + +1. <specific question 1> +2. <specific question 2> +3. <specific question 3> + +If you know of any **open-source projects or repositories** that implement something similar, please share links — it would help us design the best solution. + +Looking forward to your response! 🚀 +``` + +--- + +#### For ✅ VIABLE — Comment (keep OPEN) + +// turbo + +Thank the user, confirm we've cataloged their idea, and explain it may be implemented in future versions. + +```markdown +Hi @<author>! Thanks for the great feature suggestion! 🙏 + +We've analyzed your request and it aligns well with OmniRoute's roadmap. We've **cataloged this feature** and it's in our implementation backlog. + +**Status:** 📋 Cataloged for future implementation + +This feature may be included in upcoming releases. We'll **respond to this issue and tag you** as soon as implementation begins so you can test it. + +Thank you for helping improve OmniRoute! 🚀 +``` + +**⚠️ Do NOT close viable issues — they remain OPEN for tracking.** + +--- + +## Phase 3 — Report: Present Findings to User + +### 3.1 🛑 MANDATORY STOP — Present Consolidated Report + +After completing Phase 1, Phase 2, and Phase 2.5, **STOP and present the following report** in the chat. Do NOT proceed to implementation. + +Present a structured report containing: + +#### 3.1a — Feature Summary Table + +| # | Issue | Title | Verdict | Location | Action | +| --- | ----- | ----- | --------------- | ----------------------------- | ----------------------------- | +| 1 | #N | Title | ✅ VIABLE | `_ideia/viable/` | Issue OPEN, comment posted | +| 2 | #N | Title | ⏭️ DEFER | `_ideia/defer/` | Issue CLOSED with explanation | +| 3 | #N | Title | ❌ NOT FIT | `_ideia/notfit/` | Issue CLOSED with explanation | +| 4 | #N | Title | 🔁 EXISTS | `_ideia/notfit/` | Issue CLOSED with guidance | +| 5 | #N | Title | ❓ NEEDS DETAIL | `_ideia/viable/need_details/` | Issue OPEN, questions posted | + +#### 3.1b — Viable Features Detail + +For each VIABLE feature, provide a brief paragraph: + +- What was found during research +- The proposed approach +- Key risks or unknowns +- Which reference repositories were most useful + +#### 3.1c — Issues Requiring Author Feedback + +For features marked ❓ NEEDS DETAIL, list: + +- What specific information is missing +- What examples or repository references would help + +#### 3.1d — Ask for User Confirmation + +End the report with: + +> **Ready to proceed with implementation?** +> +> - Reply **"sim"** or **"yes"** to generate full implementation plans for all VIABLE features. +> - Reply with specific issue numbers to select only certain features. +> - Reply **"não"** or **"no"** to stop here. + +--- + +## Phase 4 — Plan: Generate Implementation Plans (after user says "yes") + +> **⚠️ Do NOT enter this phase without explicit user approval from Phase 3.** + +### 4.1 Create Task Directory + +```bash +mkdir -p <project_root>/_tasks/features-vX.Y.Z/ +``` + +### 4.2 Generate One Implementation Plan Per Feature + +For each VIABLE feature approved by the user, create: + +**Filename**: `_tasks/features-vX.Y.Z/<NUMBER>-<kebab-case-title>.plan.md` + +```markdown +# Implementation Plan: <Feature Title> + +> Issue: #<NUMBER> +> Idea: [\_ideia/viable/<NUMBER>-title.md](../../_ideia/viable/<NUMBER>-title.md) +> Requirements: [\_ideia/viable/<NUMBER>-title.requirements.md](../../_ideia/viable/<NUMBER>-title.requirements.md) +> Branch: `release/vX.Y.Z` + +## Overview + +<Brief description of what will be built> + +## Pre-Implementation Checklist + +- [ ] Read all related source files listed below +- [ ] Confirm no conflicts with in-flight PRs +- [ ] Verify database migration numbering + +## Implementation Steps + +### Step 1: <Title> + +**Files:** + +- `path/to/file.ts` — <what to change> + +**Details:** +<Detailed description of the change, including code patterns to follow, function signatures, etc.> + +### Step 2: <Title> + +... + +### Step N: Tests + +**New test files:** + +- `tests/unit/<test-file>.test.mjs` — <what to test> + +**Test cases:** + +- [ ] <test case 1> +- [ ] <test case 2> + +### Step N+1: i18n + +**Translation keys to add:** + +- `<namespace>.<key>` — "<English value>" + +### Step N+2: Documentation + +- [ ] Update CHANGELOG.md +- [ ] Update relevant docs/ files + +## Verification Plan + +1. Run `npm run build` — must pass +2. Run `npm test` — all tests must pass +3. Run `npm run lint` — no new errors +4. <Manual verification steps> + +## Commit Plan +``` + +feat: <description> (#<NUMBER>) + +``` + +``` + +### 4.3 Present Plans for Final Approval + +Present a summary of all generated plans: + +> **Implementation plans generated:** +> +> | # | Feature | Plan File | Steps | Effort | +> | --- | ------- | ---------------------------------------- | ------- | ------ | +> | 1 | <title> | `_tasks/features-vX.Y.Z/N-title.plan.md` | N steps | Medium | +> +> Reply **"sim"** or **"yes"** to begin implementation of all features. +> Reply with specific issue numbers to implement only certain ones. + +--- + +## Phase 5 — Execute: Implement the Plans (after user says "yes") + +> **⚠️ Do NOT enter this phase without explicit user approval from Phase 4.** + +### 5.1 Implement Each Feature + +For each approved plan, execute it step by step: + +1. **Follow the plan** — implement exactly as specified in the `.plan.md` file +2. **Build** — Run `npm run build` after each feature to verify compilation +3. **Test** — Run `npm test` to ensure no regressions +4. **Commit** — Commit with: `feat: <description> (#<NUMBER>)` +5. **Update the plan** — Mark completed steps with `[x]` in the plan file +6. **Continue** — Move to the next feature (do NOT switch branches) + +### 5.2 Respond to Authors (Update Viable Issues) + +For each implemented feature, **close the issue with a final comment**: + +````markdown +✅ **Implemented in `release/vX.Y.Z`!** + +Hi @<author>! Great news — your feature request has been implemented! 🎉 + +**What was done:** + +- <bullet list of what was built> + +**How to try it:** + +```bash +git fetch origin && git checkout release/vX.Y.Z +npm install && npm run dev +``` +```` + +This will be included in the upcoming **vX.Y.Z** release. Feel free to reopen if you spot any issues! 🚀 + +```` + +```bash +gh issue close <NUMBER> --repo <owner>/<repo> --comment "<comment above>" +```` + +Then **DELETE the idea file** — it has served its purpose: + +```bash +# ✅ Implemented files are DELETED (not moved) +rm _ideia/viable/<NUMBER>-<title>.md +rm _ideia/viable/<NUMBER>-<title>.requirements.md # if exists +``` + +> **Why delete?** `viable/` only holds features that still NEED to be done. Once implemented, the commit history and CHANGELOG are the source of truth. Keeping the file would be confusing. + +### 5.3 Finalize & Push + +After implementing all approved features: + +1. **Update CHANGELOG.md** on the release branch with all new feature entries +2. Push the release branch: `git push origin release/vX.Y.Z` +3. Run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user) + +### 5.4 Final Summary Report + +Present a final summary report to the user: + +| Issue | Title | Verdict | Action | Commit | +| ----- | ----- | --------------- | -------------------------------------------------- | --------- | +| #N | Title | ✅ Implemented | Issue closed, idea file deleted | `abc1234` | +| #N | Title | ⏭️ Deferred | Issue closed + saved in `_ideia/defer/` | — | +| #N | Title | ❌ Not Fit | Issue closed + saved in `_ideia/notfit/` | — | +| #N | Title | 🔁 Exists | Issue closed + saved in `_ideia/notfit/` | — | +| #N | Title | ❓ Needs Detail | Issue OPEN, moved to `_ideia/viable/need_details/` | — | + +Include: + +- Total features harvested +- Total ideas cataloged (`viable/need_details/` + `defer/` + `notfit/`) +- Total features implemented (idea files deleted, issues closed) +- Total features deferred +- Total issues closed +- Total issues left open (needs detail only — viable are closed after implementation) +- Test results (pass/fail count) diff --git a/.claude/commands/issue-triage-cc.md b/.claude/commands/issue-triage-cc.md new file mode 100644 index 0000000000..5268fb102f --- /dev/null +++ b/.claude/commands/issue-triage-cc.md @@ -0,0 +1,50 @@ +--- +description: How to respond to GitHub issues with insufficient information +--- + +# Issue Triage Workflow + +Respond to GitHub issues that need more information before they can be investigated. + +## Steps + +### 1. Identify issues needing triage + +```bash +gh issue list --state open --limit 20 +``` + +### 2. Evaluate each issue + +Check if the issue has: + +- Clear reproduction steps +- Environment details (OS, Node.js version, OmniRoute version) +- Error logs/screenshots +- Expected vs actual behavior + +### 3. Respond with triage template + +For issues missing information: + +```markdown +Thank you for reporting this issue! To help us investigate, please provide: + +1. **OmniRoute version**: (`omniroute --version`) +2. **Node.js version**: (`node --version`) +3. **Operating system**: (e.g., Ubuntu 24.04, macOS 15, Windows 11) +4. **Installation method**: (npm, Docker, source) +5. **Steps to reproduce**: (exact commands/actions that trigger the issue) +6. **Error logs**: (paste relevant logs from the console) +7. **Expected behavior**: (what should happen) + +This will help us debug and resolve your issue faster. 🙏 +``` + +### 4. Label the issue + +Add appropriate labels: `needs-info`, `bug`, `enhancement`, `question`, etc. + +```bash +gh issue edit <NUMBER> --add-label "needs-info" +``` diff --git a/.claude/commands/resolve-issues-cc.md b/.claude/commands/resolve-issues-cc.md new file mode 100644 index 0000000000..01f8f68879 --- /dev/null +++ b/.claude/commands/resolve-issues-cc.md @@ -0,0 +1,166 @@ +--- +description: Fetch all open GitHub issues, analyze bugs, resolve what's possible, triage the rest, wait for user validation, then commit and release +--- + +# /resolve-issues — Automated Issue Resolution Workflow + +## Overview + +This workflow fetches all open issues from the project's GitHub repository, classifies them, analyzes bugs, proposes a resolution plan, waits for user validation, and ONLY THEN implements the fixes, commits, and closes the issues on the current release branch (`release/vX.Y.Z`). It does NOT merge or release automatically — the release branch is later merged via PR to main. + +> **BRANCH RULE**: All work MUST happen on the current `release/vX.Y.Z` branch. Never create separate `fix/` branches. If no release branch exists yet, create one first using `/generate-release` Phase 1 steps 1–5. + +> **⛔ PR PROHIBITION**: If a fix is associated with a contributor's PR, you MUST merge their PR — NEVER close it and re-implement the fix yourself. See `/review-prs` workflow for the full policy. The `gh pr close` command is FORBIDDEN unless the repository owner explicitly requests it. + +## Steps + +### 1. Identify the GitHub Repository + +// turbo + +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo +- Parse the owner and repo name from the URL + +### 2. Ensure Release Branch Exists + +// turbo + +Before doing any work, ensure you are on the current release branch: + +```bash +# Check current branch +git branch --show-current + +# If on main, determine next version and create the release branch +VERSION=$(node -p "require('./package.json').version") +NEXT=$(node -p "const [a,b,c]=('$VERSION').split('.').map(Number); c>=9?a+'.'+(b+1)+'.0':a+'.'+b+'.'+(c+1)") +git checkout -b release/v$NEXT +npm version patch --no-git-tag-version +npm install +``` + +If already on a `release/vX.Y.Z` branch, continue working there. + +### 3. Fetch All Open Issues + +// turbo-all + +**⚠️ CRITICAL**: The JSON output of `gh issue list` can be truncated by the tool, silently hiding issues. You MUST use the two-step approach below to guarantee **all** issues are fetched. + +**Step 3a — Get Issue numbers only** (small output, never truncated): + +- Run: `gh issue list --repo <owner>/<repo> --state open --limit 500 --json number --jq '.[].number'` +- This outputs one issue number per line. Count them and confirm total. + +**Step 3b — Fetch full metadata for each Issue** (one call per issue): + +- For each issue number from step 3a, run: + `gh issue view <NUMBER> --repo <owner>/<repo> --json number,title,labels,body,comments,createdAt,author` +- You may batch these into parallel calls (up to 4 at a time). +- Sort by oldest first (FIFO). + +### 4. Classify Each Issue + +For each issue, determine its type: + +- **Bug** — Has `bug` label, or body contains error messages, stack traces, "doesn't work", "broken", "crash", "error" +- **Feature Request** — Has `enhancement`/`feature` label, or body describes new functionality +- **Question** — Has `question` label, or is asking "how to" something +- **Other** — Anything else + +Focus ONLY on **Bugs** for resolution. Feature requests and questions should be skipped with a note in the final report. + +### 5. Deep-Read Each Bug Issue (One-by-One Analysis) + +**IMPORTANT**: Read each bug issue thoroughly, one at a time, before moving to the next. This is NOT a batch process — each issue needs focused attention. + +#### 5a. Understand the Problem + +For each bug issue, perform the full analysis: + +1. **Read the entire body** — including Description, Steps to Reproduce, Expected/Actual Behavior, Error Logs, and Screenshots +2. **Read ALL comments** — including bot triage comments (Kilo, etc.) and owner/community responses. Pay attention to: + - Whether someone already responded with a fix + - Whether a community member confirmed the issue is resolved + - Whether the issue was marked as duplicate by a bot. **WARNING: DO NOT blindly trust bot duplicate labels (e.g., kilo-duplicate). Bots make mistakes. You MUST read the full conversation and do your own independent analysis to determine if it is truly a duplicate or a distinct bug.** +3. **Identify the claimed error** — extract the exact error message, status code, and provider/model involved + +#### 5b. Check Information Sufficiency + +Verify the issue contains enough to act on: + +- [ ] Clear description of the problem +- [ ] Steps to reproduce OR error logs +- [ ] Provider/model/version information +- [ ] Expected vs actual behavior + +#### 5c. Determine Issue Disposition + +For each bug, classify into one of 5 actions: + +| Disposition | When to Apply | Action | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | +| **✅ CLOSE — Already Fixed** | Owner responded with fix + no user follow-up, OR community confirmed fix | Close with comment citing which version fixed it | +| **✅ CLOSE — Duplicate** | You have independently verified the issue is a duplicate (do NOT rely solely on bot flags) + user provides no new info | Close referencing the original issue | +| **✅ CLOSE — Stale** | We requested logs/info > 7 days ago with no reply | Close thanking the user, invite to reopen if needed | +| **📝 RESPOND — Needs Info** | Issue is real but missing critical reproduction details | Comment asking for specifics per `/issue-triage` | +| **📝 RESPOND — User Config** | Error is caused by unsupported env (Node version, wrong model path, missing API enablement) | Comment explaining the user-side fix | +| **🔧 FIX — Code Change** | Root cause is confirmed in the codebase | Research, propose solution in report, wait for approval | + +#### 5d. For "FIX — Code Change" Issues + +Before coding, perform deep source analysis to formulate a plan: + +1. **Search the codebase** — `grep_search` for error strings, relevant function names, affected files +2. **Search the web** — for upstream API changes, SDK updates, or breaking changes that explain the bug +3. **Read the full source file** — don't rely on grep snippets; understand the surrounding logic +4. **Verify the root cause** — confirm the bug is reproducible based on the code, not just a user misconfiguration +5. **Formulate a proposed solution** — detail the exact files and lines you will change and how you will solve it. +6. **Create an Implementation Plan file** — write your proposed solution to `_tasks/features-vX.Y.Z/<ISSUE_NUMBER>-<short-description>.plan.md` (e.g. `_tasks/features-v3.7.6/1810-auto-restore-probe-failed-db.plan.md`) where `vX.Y.Z` is the current branch version. The plan should contain an Overview, Pre-Implementation Checklist, and detailed Implementation Steps (Files, Changes). +7. **DO NOT modify the codebase yet** — wait for user approval on your report and plan first. + +#### 5e. For "RESPOND" Issues + +Post a substantive comment that: + +- Acknowledges the specific error they reported +- Explains the likely root cause +- Provides concrete steps to resolve (version upgrade, env var fix, model path correction) +- Asks for follow-up info if needed + +**Do NOT post generic template responses.** Every comment should reference the user's specific error messages and environment. + +### 6. Generate Report & Wait for Validation + +Present a summary report to the user detailing your proposed actions. For any bugs that need fixing, explicitly explain your proposed solution (files to change and logic) and point out that it will be implemented on the release branch (`release/vX.Y.Z`) after approval. + +| Issue | Title | Status | Proposed Action / Version | +| ----- | ----- | ------------- | ----------------------------------------- | +| #N | Title | ✅ Close | Already fixed / duplicate (explain why) | +| #N | Title | 🔧 Propose | Explanation of the code fix to be applied | +| #N | Title | 📝 Respond | Guidance comment to be posted | +| #N | Title | ❓ Needs Info | Triage comment to be posted | +| #N | Title | ⏭️ Skip | Feature request / not a bug | + +> **⚠️ IMPORTANT**: Do NOT implement code changes, commit, push, or close issues at this step. +> Wait for the user to review the proposed fixes and respond with **OK** before proceeding. + +- If the user says **OK** or approves → Proceed to step 7 +- If the user requests changes → Adjust the proposed solution and present the report again +- If the user rejects → Revert any accidental changes and stop + +### 7. Implement Fixes, Run Tests & Commit (only after user approval) + +After the user validates and gives the OK: + +1. **Implement the fixes** — modify the codebase according to the approved plan. +2. **Run tests** — `npm run test:all` (or the specific test file) to ensure 100% pass. +3. **Update CHANGELOG.md** with all new bug fix entries. +4. **Commit** each fix individually on the release branch with message format: `fix: <description> (#<issue_number>)`. +5. **Push** the release branch: `git push origin release/vX.Y.Z`. +6. **Close resolved issues immediately**. For each issue that was marked as Fixed, run: + `gh issue close <NUMBER> --repo <owner>/<repo> --comment "Thank you for reporting! This issue has been fixed and will be included in the next release (vX.Y.Z)."` +7. Likewise, close `Duplicate` issues referencing the original, close `Needs Info` if stale, and post the required comments. +8. If the project runs automatic releases or needs a PR, proceed to run `/generate-release` workflow Phase 1 steps 7–10 (tests → commit → push → open PR to main → wait for user). + +If NO fixes were committed, skip closing and source control steps and just conclude the workflow. diff --git a/.claude/commands/review-discussions-cc.md b/.claude/commands/review-discussions-cc.md new file mode 100644 index 0000000000..fc8630ffcb --- /dev/null +++ b/.claude/commands/review-discussions-cc.md @@ -0,0 +1,120 @@ +--- +description: Read all open GitHub Discussions, summarize them, respond to pending ones, and create issues from actionable feature requests +--- + +# /review-discussions — GitHub Discussions Review & Response Workflow + +## Overview + +This workflow reads all open GitHub Discussions, generates a categorized summary, identifies which ones need a response, drafts and posts replies, and optionally creates issues from actionable feature requests. It follows the same flow used for Issues but adapted for the Discussions forum. + +> **Tool mapping note (v3.8):** Where steps below say `browser_subagent` (an earlier-runtime tool), in Claude Code use the `gh` CLI via the `Bash` tool — `gh api graphql` for reading discussions and `gh api graphql -F query=...` mutations for posting comments. `WebFetch` is acceptable for read-only HTML scraping when GraphQL is overkill, but prefer `gh` for any write actions. + +// turbo-all + +## Steps + +### 1. Identify the GitHub Repository + +- Run: `git -C <project_root> remote get-url origin` to extract the owner/repo +- Parse the owner and repo name from the URL + +### 2. Fetch All Open Discussions + +- Use `WebFetch` to fetch `https://github.com/<owner>/<repo>/discussions` +- Parse the discussion list to get all discussion titles, IDs, authors, categories, and dates +- For each discussion, fetch the individual page to read the full content and all comments/replies + +### 3. Summarize All Discussions + +For each discussion, extract: + +- **Title** and **#Number** +- **Author** (GitHub username) +- **Category** (Announcements, General, Ideas, Q&A, Show and tell) +- **Date** created +- **Summary** of the original post (1-2 sentences) +- **Comments count** and key participants +- **Your previous response** (if any) +- **Pending action** — whether a response or follow-up is needed + +### 4. Present Summary Report to User + +Present the full summary to the user organized by category, using a table: + +| # | Category | Title | Author | Date | Status | +| --- | -------- | ----- | ------ | ------ | ----------------- | +| #N | Ideas | Title | @user | Mar 23 | ⚠️ Needs response | +| #N | Q&A | Title | @user | Mar 9 | ✅ Answered | +| #N | General | Title | @user | Mar 19 | ⚠️ Needs response | + +Highlight: + +- **⚠️ Needs response** — No reply from maintainer, or a follow-up comment was left unanswered +- **✅ Answered** — Maintainer already responded +- **🐛 Bug reported** — A bug was mentioned that needs tracking +- **💡 Actionable** — Contains a concrete feature request that could become an issue + +### 5. Draft & Post Responses + +For each discussion that needs a response, draft a reply following these guidelines: + +#### Response Style + +- **Friendly and professional** — Start with "Hey @username!" +- **Acknowledge the contribution** — Thank the user for their input +- **Be specific** — Reference existing features, settings, or dashboard pages if the feature already exists +- **Provide workarounds** — If the request isn't implemented yet, suggest current alternatives +- **Commit to action** — If the request is valid, state that you'll open an issue or add it to the roadmap +- **Keep it concise** — 3-5 paragraphs max + +#### Posting via Browser + +- Use `browser_subagent` to navigate to each discussion and post the comment +- **IMPORTANT**: When typing text in GitHub comment boxes via the browser, use only plain ASCII characters: + - Use regular hyphens `-` instead of em-dashes + - Use `->` instead of arrow symbols + - Do NOT use emoji Unicode characters (the browser keyboard may fail on them) + - Use `**bold**` and `\`code\`` markdown formatting +- Click the green "Comment" button (or "Reply" for threaded replies) after typing +- Verify the comment was posted by checking the page shows the new comment + +### 6. Create Issues from Actionable Feature Requests + +For discussions that contain concrete, actionable feature requests: + +1. Ask the user which ones should become issues +2. For each approved request, create a GitHub issue via `browser_subagent`: + - Navigate to `https://github.com/<owner>/<repo>/issues/new` + - **Title**: `<Feature Name> - <Short description>` + - **Body** should include: + - `## Feature Request` header + - `**Source:** Discussion #N by @author` + - `## Problem` — What limitation the user hit + - `## Proposed Solution` — How it could work + - `### Implementation Ideas` — Technical approach + - `### Current Workarounds` — What users can do today + - `## Additional Context` — Links to related issues/discussions + - Add `enhancement` label + - Click "Submit new issue" / "Create" +3. After creation, go back to the original discussion and post a comment linking to the new issue: + - "I've opened Issue #N to track this feature request. Follow along there for updates!" + +### 7. Final Report + +Present a final summary to the user: + +| Discussion | Action Taken | +| ---------- | ---------------------------------- | +| #N — Title | Responded with workarounds | +| #N — Title | Responded + created Issue #N | +| #N — Title | Already answered, no action needed | +| #N — Title | Responded to follow-up comment | + +## Notes + +- This workflow is **interactive** — always present the summary and wait for user approval before posting responses or creating issues +- If the user says "pode responder" (or similar approval), proceed with posting all drafted responses +- For discussions in non-English languages, respond in the same language as the original post +- Always reference specific dashboard paths, config options, or code files when explaining existing features +- When a discussion reveals a bug, note it separately from feature requests diff --git a/.agents/workflows/review-prs.md b/.claude/commands/review-prs-cc.md similarity index 84% rename from .agents/workflows/review-prs.md rename to .claude/commands/review-prs-cc.md index ea985ef5f2..64071d9c6f 100644 --- a/.agents/workflows/review-prs.md +++ b/.claude/commands/review-prs-cc.md @@ -79,7 +79,7 @@ If already on a `release/vX.Y.Z` branch, continue working there. - For each PR number, run: `gh pr diff <NUMBER> --repo <owner>/<repo> > /tmp/pr<NUMBER>.diff` -- Then read each diff file with `view_file`. +- Then read each diff file with the `Read` tool. - For each open PR, collect: - PR number, title, author, branch, number of commits, date @@ -174,7 +174,7 @@ Perform a **global impact assessment** to verify whether the PR changes are comp ### 6. Present to User -- Show the report via `notify_user` with `BlockedOnUser: true` +- Show the report in the final response and stop. This is a mandatory checkpoint awaiting explicit user approval before continuing. - Wait for user decision: - **Approved** → Proceed to step 7 - **Approved with changes** → Implement the fixes and corrections before merging @@ -199,10 +199,11 @@ Perform a **global impact assessment** to verify whether the PR changes are comp git push ``` -- **Fallback (For external forks without maintainer edit access or severe conflicts):** - If `git push` fails because the PR comes from an external fork without write access, or there are extreme conflicts, you MUST NOT CLOSE THE PR. - Instead, use `git cherry-pick`, or a reverse merge to bring their changes into the release branch, fix the issues locally, and commit them. Ensure you preserve the contributor's authorship (`git commit --author="Contributor Name <email>"` if creating new commits). - Once you have integrated their work into the release branch, DO NOT close their PR. Instead, leave it open or try to merge it using the CLI if possible. Under NO CIRCUMSTANCES should you use `gh pr close`. Leave it open so the contributor retains credit. +- **Fallback (ONLY for external forks without maintainer edit access):** + Using `cherry-pick` instead of fixing the contributor's PR directly is a **LAST RESORT**. You MUST ALWAYS attempt to `git push` your fixes to their branch first. + **ONLY if `git push` explicitly fails with a permission/access error** (meaning the contributor unchecked "Allow edits from maintainers" or it's a locked fork), you may use `git cherry-pick` to bring their changes into the release branch and fix the issues locally. + Even then, ensure you preserve the contributor's authorship (`git commit --author="Contributor Name <email>"` if creating new commits). + Once you have integrated their work into the release branch, **DO NOT close their PR**. Leave it open so the contributor retains credit. Under NO CIRCUMSTANCES should you use `gh pr close`. - Run the project's test suite locally to verify nothing breaks: // turbo @@ -211,7 +212,7 @@ Perform a **global impact assessment** to verify whether the PR changes are comp ### 8. Merge into Release Branch (NEVER CLOSE!) > **⚠️ CRITICAL**: NEVER use `gh pr close` for a PR whose idea or code was accepted. Closing a PR in a contributor's face after taking their idea—or closing it just because it had conflicts—is unacceptable. -> You MUST ALWAYS resolve conflicts and apply fixes on the author's PR branch, and then merge the PR using GitHub so the contributor gets the official "Merged" badge and proper credit on their profile. +> You MUST ALWAYS resolve conflicts and apply fixes ON THE AUTHOR'S PR BRANCH (unless explicitly locked from edits), and then merge the PR using GitHub so the contributor gets the official "Merged" badge and proper credit on their profile. **Do not use cherry-pick just because it is "easier" than resolving conflicts on their branch.** Even if the PR had severe conflicts or required significant architectural adjustments, you MUST: @@ -229,6 +230,8 @@ In ALL cases: - Note it will be included in the upcoming release. - Be friendly, professional, and encouraging. +> **⚠️ MANDATORY CHANGELOG CREDIT**: When cherry-picking is used (because the PR branch couldn't be pushed to or `gh pr merge` failed), the contributor does NOT get the automatic GitHub "Merged" badge. In this case, you MUST compensate by adding an explicit entry to `CHANGELOG.md` in the `[Unreleased]` section with `(#PR_NUMBER — thanks @username)` format. This ensures the contributor gets public credit in the release notes even if GitHub doesn't auto-detect the cherry-pick. This is NOT optional — skipping it effectively erases the contributor's work from the release record. + ### 9. Sync Local Release Branch After merging PRs, sync the local release branch to include the new changes: @@ -244,7 +247,7 @@ After processing all approved PRs: - If more PRs remain, go back to step 7 - When all PRs are processed, **update CHANGELOG.md** on the release branch with all new entries -- Run **test coverage** to verify all metrics stay above 85%: +- Run **test coverage** to verify the gate (≥75% statements/lines/functions, ≥70% branches — measured ~82%): ```bash npm run test:coverage ``` diff --git a/.claude/commands/version-bump-cc.md b/.claude/commands/version-bump-cc.md new file mode 100644 index 0000000000..fbc63871ce --- /dev/null +++ b/.claude/commands/version-bump-cc.md @@ -0,0 +1,341 @@ +--- +description: Bump version, auto-generate CHANGELOG from git commits, update all versioned files, and refresh root + docs/ documentation to reflect the current project state +--- + +# Version Bump Workflow + +Automatically bump the project version, generate CHANGELOG entries from git history since the last tag, update every file that references the version, and refresh project documentation to reflect the current state. + +> **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** +> NEVER use `npm version minor` or `npm version major`. +> Always use: `npm version patch --no-git-tag-version` +> The threshold rule: when `y` reaches 10, bump to `3.(x+1).0` — e.g. `3.4.10` → `3.5.0`. + +--- + +## Phase 1: Determine Version + +### 1. Read current version and last tag + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +CURRENT_VERSION=$(node -p "require('./package.json').version") +LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "") +CURRENT_BRANCH=$(git branch --show-current) +echo "Current version: $CURRENT_VERSION" +echo "Last tag: $LAST_TAG" +echo "Current branch: $CURRENT_BRANCH" +``` + +### 2. Calculate new version + +Apply the patch bump rule: + +- If the current patch number is `9`, the new version is `3.(minor+1).0` +- Otherwise, increment patch: `3.x.y` → `3.x.(y+1)` + +If the version was ALREADY bumped (e.g. you are on a release branch and package.json already has the new version), **skip the npm version bump** and use the existing version. + +### 3. Bump package.json (if needed) + +// turbo + +```bash +# Only if version hasn't been bumped yet +npm version patch --no-git-tag-version +``` + +Or for threshold (y=10): + +```bash +# Manual threshold bump +VERSION="3.X.0" # compute manually +npm version "$VERSION" --no-git-tag-version +``` + +--- + +## Phase 2: Generate CHANGELOG from Git History + +### 4. Collect commits since last tag + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null) +echo "=== Commits since $LAST_TAG ===" +git log "$LAST_TAG"..HEAD --pretty=format:"%h %s" --no-merges | head -100 +echo "" +echo "=== Merge commits ===" +git log "$LAST_TAG"..HEAD --merges --pretty=format:"%h %s" | head -50 +``` + +### 5. Classify commits and generate CHANGELOG section + +Analyze each commit message and classify into categories based on the conventional-commit prefix and content: + +| Category | Patterns | +| ------------------- | ------------------------------------------------ | +| ✨ New Features | `feat:`, `feat(*):` | +| 🐛 Bug Fixes | `fix:`, `fix(*):` | +| ⚠️ Breaking Changes | `BREAKING CHANGE`, `!:` suffix | +| 🛠️ Maintenance | `chore:`, `refactor:`, `perf:`, `build:` | +| 🧪 Tests | `test:`, `tests:` | +| 📝 Documentation | `docs:` | +| 🔒 Security | `security:`, CVE references, vulnerability fixes | +| 🌍 i18n | translation updates, locale changes | + +For each category with entries, create a markdown section with descriptive bullet points. Use the commit messages but rewrite them to be human-readable and descriptive (not raw commit messages). + +**If a commit references a PR number** (e.g. `#880`, `PR #885`), include it in the description. + +### 6. Update CHANGELOG.md + +Replace the `## [Unreleased]` section content with the generated entries, then add the new versioned section: + +```markdown +## [Unreleased] + +--- + +## [NEW_VERSION] — YYYY-MM-DD + +### ✨ New Features + +- **Feature name:** Description (#PR) + +### 🐛 Bug Fixes + +- **Fix name:** Description (#PR) + +### 🛠️ Maintenance + +- **Item:** Description + +--- + +## [PREVIOUS_VERSION] — YYYY-MM-DD + +... +``` + +The date must be today's date in `YYYY-MM-DD` format. + +--- + +## Phase 3: Sync Version Across All Files + +### 7. Update workspace package.json files and openapi.yaml + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") + +# Update docs/reference/openapi.yaml version +sed -i "s/ version: .*/ version: $VERSION/" docs/reference/openapi.yaml +echo "✓ docs/reference/openapi.yaml → $VERSION" + +# Update workspace packages (open-sse, electron) +for dir in electron open-sse; do + if [ -d "$dir" ] && [ -f "$dir/package.json" ]; then + (cd "$dir" && npm version "$VERSION" --no-git-tag-version --allow-same-version > /dev/null) + echo "✓ $dir/package.json → $VERSION" + fi +done + +echo "✓ All workspace packages synced to $VERSION" +``` + +### 8. Update llm.txt version references + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") +OLD_VERSION_PATTERN='[0-9]\+\.[0-9]\+\.[0-9]\+' + +# Update "Current version:" line +sed -i "s/\*\*Current version:\*\* $OLD_VERSION_PATTERN/**Current version:** $VERSION/" llm.txt + +# Update "Key Features (vX.Y.Z)" header +sed -i "s/## Key Features (v$OLD_VERSION_PATTERN)/## Key Features (v$VERSION)/" llm.txt + +echo "✓ llm.txt → $VERSION" +``` + +### 9. Regenerate lock file + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm install +echo "✓ Lock file regenerated" +``` + +--- + +## Phase 4: Update Root Documentation + +Based on the CHANGELOG entries generated in Phase 2, review and update these root-level files if relevant changes warrant updates: + +### 10. Review and update root documentation files + +For each file below, read the current content and determine if the CHANGELOG entries require any updates. Only modify files where substantive changes have occurred: + +| File | When to update | +| ----------------- | --------------------------------------------------------------------------------------------------------------------------- | +| `README.md` | New providers, major features, stats changes (test count, provider count), badges, installation instructions, feature table | +| `AGENTS.md` | Architecture changes, new modules, new commands, new providers, new services/handlers/executors | +| `CONTRIBUTING.md` | Dev workflow changes, new tooling, test infrastructure changes | +| `SECURITY.md` | Security fixes, new auth mechanisms, vulnerability disclosures | +| `llm.txt` | Provider count changes, new features, architecture changes | + +**Update rules:** + +- **README.md**: Update provider count, test count, feature highlights table, badges if any numbers changed. If a new provider was added, add it to the provider table. If a major feature was added, add it to the features section. +- **AGENTS.md**: If new architecture components (handlers, executors, services, DB modules) were added, update the Architecture section. If new commands were added, update the Build/Test table. +- **SECURITY.md**: Add new vulnerability fixes or security improvements to the relevant section. +- **llm.txt**: Update provider count, feature list, version references. + +### 11. Review and update docs/ files (excluding i18n/) + +For each file in `docs/` (excluding `docs/i18n/`), review if CHANGELOG changes affect it: + +| File | When to update | +| --------------------------------------------- | ------------------------------------------------------------------ | +| `docs/reference/API_REFERENCE.md` | New API endpoints, changed request/response formats | +| `docs/architecture/ARCHITECTURE.md` | New modules, new services, changed data flow | +| `docs/architecture/CODEBASE_DOCUMENTATION.md` | New files, architectural changes, module reorganization | +| `docs/architecture/REPOSITORY_MAP.md` | New folders / files / one-line descriptions | +| `docs/reference/CLI-TOOLS.md` | New CLI tool integrations, config format changes | +| `docs/guides/USER_GUIDE.md` | UX changes, new dashboard pages, settings changes | +| `docs/reference/PROVIDER_REFERENCE.md` | New providers (regenerate via `scripts/gen-provider-reference.ts`) | +| `docs/frameworks/MCP-SERVER.md` | New MCP tools, changed tool signatures, scope changes | +| `docs/frameworks/A2A-SERVER.md` | New A2A skills, protocol changes | +| `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md` | New external agent protocols supported | +| `docs/frameworks/CLOUD_AGENT.md` | Cloud agent additions (codex-cloud, devin, jules) or API changes | +| `docs/architecture/AUTHZ_GUIDE.md` | New route classifications, policy changes | +| `docs/security/GUARDRAILS.md` | New guardrails registered, priority/order changes | +| `docs/security/COMPLIANCE.md` | Audit log / retention / no-log policy changes | +| `docs/frameworks/SKILLS.md` | Skill framework / registry / built-in skill changes | +| `docs/frameworks/MEMORY.md` | Memory pipeline / extraction / injection / Qdrant changes | +| `docs/frameworks/EVALS.md` | Evaluation framework changes, new evaluators | +| `docs/frameworks/WEBHOOKS.md` | New webhook events, payload schema changes | +| `docs/routing/REASONING_REPLAY.md` | Reasoning capture/replay pipeline changes | +| `docs/routing/AUTO-COMBO.md` | Routing changes, new strategies, scoring weight changes | +| `docs/architecture/RESILIENCE_GUIDE.md` | Circuit breaker / cooldown / lockout behavior changes | +| `docs/security/STEALTH_GUIDE.md` | TLS / CLI fingerprint changes | +| `docs/ops/TUNNELS_GUIDE.md` | Cloudflare tunnel feature changes | +| `docs/guides/ELECTRON_GUIDE.md` | Electron build / signing / packaging changes | +| `docs/guides/TROUBLESHOOTING.md` | New known issues, resolved problems | +| `docs/ops/RELEASE_CHECKLIST.md` | Process changes | +| `docs/ops/COVERAGE_PLAN.md` | Coverage gate adjustments, target metrics | +| `docs/reference/openapi.yaml` | Already updated in step 7 | + +**Only update files where the CHANGELOG entries directly affect the documented content.** Do NOT update files just to bump a version number — only when the documented behavior, features, or architecture has actually changed. + +--- + +## Phase 5: Verify + +### 12. Run lint check + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm run lint +``` + +### 13. Run tests + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +npm test +``` + +### 14. Verify version sync across all files + +// turbo + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +VERSION=$(node -p "require('./package.json').version") +echo "Expected version: $VERSION" +echo "" + +echo "--- package.json ---" +grep '"version"' package.json | head -1 + +echo "--- open-sse/package.json ---" +grep '"version"' open-sse/package.json | head -1 + +echo "--- electron/package.json ---" +[ -f electron/package.json ] && grep '"version"' electron/package.json | head -1 + +echo "--- docs/reference/openapi.yaml ---" +grep " version:" docs/reference/openapi.yaml | head -1 + +echo "--- llm.txt ---" +grep "Current version:" llm.txt + +echo "--- CHANGELOG.md (first versioned entry) ---" +grep "^## \[" CHANGELOG.md | head -2 +``` + +### 15. 🛑 STOP — Present Summary to User + +**STOP** and present a summary to the user including: + +- Old version → New version +- CHANGELOG entries generated +- Files modified +- Test results +- Any documentation updates made + +**Wait for the user to confirm before committing.** + +--- + +## Phase 6: Commit (only after user approval) + +### 16. Stage and commit + +// turbo-all + +```bash +cd /home/diegosouzapw/dev/proxys/OmniRoute +git add -A +VERSION=$(node -p "require('./package.json').version") +git commit -m "chore(release): bump to v$VERSION — changelog, docs, version sync" +``` + +--- + +## Notes + +- This workflow does **NOT** create tags, releases, or deploy. Use `/generate-release` for the full release cycle after this. +- This workflow does **NOT** update `docs/i18n/` translations. Translation updates are handled manually or via release tooling — the `/update-i18n` command does not currently exist as a Claude Code slash command. +- The CHANGELOG generation is based on git commits since the last tag. If there are no new commits, the workflow should inform the user and stop. +- Always verify the generated CHANGELOG entries make sense — raw commit messages may need rewriting for clarity. +- If the version was already bumped (e.g. you're on a `release/vX.Y.Z` branch), skip the `npm version` step and use the existing version. + +## Version Touchpoints Checklist + +| File | Field/Pattern | +| ----------------------------- | ----------------------------------------------------------- | +| `package.json` | `"version": "X.Y.Z"` | +| `open-sse/package.json` | `"version": "X.Y.Z"` | +| `electron/package.json` | `"version": "X.Y.Z"` | +| `docs/reference/openapi.yaml` | `version: X.Y.Z` | +| `llm.txt` | `**Current version:** X.Y.Z` and `## Key Features (vX.Y.Z)` | +| `CHANGELOG.md` | `## [X.Y.Z] — YYYY-MM-DD` | diff --git a/.dockerignore b/.dockerignore index 069c1e6781..fb2d2a7d3a 100644 --- a/.dockerignore +++ b/.dockerignore @@ -38,7 +38,9 @@ playwright-report blob-report # Documentation (not needed in container) -docs +# Keep the docs directory itself in context so openapi.yaml can be re-included. +docs/* +!docs/openapi.yaml *.md !README.md diff --git a/.env.example b/.env.example index 0bd7ebd43e..8ecf74c35e 100644 --- a/.env.example +++ b/.env.example @@ -91,6 +91,12 @@ OMNIROUTE_USE_TURBOPACK=1 # Used by: src/lib/runtime/ports.ts — preserves canonical port in Electron. # OMNIROUTE_PORT=20128 +# Hostname/bind address for the Next.js server. +# Used by: scripts/run-next.mjs (HOST), Playwright runner (HOSTNAME). +# Default: 0.0.0.0 (HOST) / 127.0.0.1 (HOSTNAME inside tests). +#HOST=0.0.0.0 +#HOSTNAME=127.0.0.1 + # Environment mode — affects Next.js behavior, logging verbosity, and caching. # Values: production | development | Default: production NODE_ENV=production @@ -147,6 +153,10 @@ ALLOW_API_KEY_REVEAL=false # Default: false (blocked) | Set true to enable local providers. # OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true +# Legacy alias toggling the SSRF guard. Used by: src/shared/network/outboundUrlGuard.ts +# When unset, OmniRoute uses the per-feature defaults. Set to "false"/"0" to disable. +# OUTBOUND_SSRF_GUARD_ENABLED=true + # ═══════════════════════════════════════════════════════════════════════════════ # 5. INPUT SANITIZATION & PII PROTECTION (FASE-01) @@ -250,6 +260,20 @@ NEXT_PUBLIC_CLOUD_URL= # Legacy alias — fallback for NEXT_PUBLIC_BASE_URL in sync schedulers. # NEXT_PUBLIC_APP_URL=http://localhost:20128 +# Public callback URL for asynchronous image/audio jobs (kie.ai, etc.). +# Used by: open-sse/utils/kieTask.ts — overrides callbackUrlFromBaseUrl(). +# Honor order: KIE_CALLBACK_URL → OMNIROUTE_KIE_CALLBACK_URL → OMNIROUTE_PUBLIC_URL. +#KIE_CALLBACK_URL= +#OMNIROUTE_KIE_CALLBACK_URL= +#OMNIROUTE_PUBLIC_URL= + +# Upstream quota endpoints used by the Usage page. Override only for +# debugging or when routing through a corporate mirror. Used by: +# open-sse/services/usage.ts. +#OMNIROUTE_CROF_USAGE_URL=https://crof.ai/usage_api/ +#OMNIROUTE_GEMINI_CLI_USAGE_URL=https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist +#OMNIROUTE_CODEWHISPERER_BASE_URL=https://codewhisperer.us-east-1.amazonaws.com + # ═══════════════════════════════════════════════════════════════════════════════ # 8. OUTBOUND PROXY (Upstream Provider Calls) @@ -332,6 +356,17 @@ NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=true # Full list: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills # OMNIROUTE_MCP_SCOPES=admin,combos,health +# Compress MCP tool descriptions before serializing the manifest. +# Used by: open-sse/mcp-server/descriptionCompressor.ts — reduces token spend +# for clients that read the full tool catalog. +# Accepted disabling values: 0, false, off. Default: enabled. +# OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS=1 + +# Algorithm/profile used when description compression is enabled. +# Used by: open-sse/mcp-server/descriptionCompressor.ts +# Set to 0/false/off to skip compression entirely. Default: rtk +# OMNIROUTE_MCP_DESCRIPTION_COMPRESSION=rtk + # Model catalog sync interval in hours. # Used by: src/shared/services/modelSyncScheduler.ts — periodic model refresh. # Default: 24 @@ -347,6 +382,48 @@ PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70 # Useful for: CI builds, test environments, or resource-constrained containers. # OMNIROUTE_DISABLE_BACKGROUND_SERVICES=false +# Force runtime background tasks (healthchecks/sync) even under automated test +# detection. Used by: src/lib/config/runtimeSettings.ts — overrides the test +# heuristic in instrumentation-node.ts. Default: unset (tests skip background). +#OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS=1 + +# Background job interval for budget reset checks (ms). Default: 600000 (10m). +# Used by: src/lib/jobs/budgetResetJob.ts. Floor: 10000. +#OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS=600000 + +# Reasoning cache cleanup cadence (ms). Default: 1800000 (30m). Floor: 60000. +# Used by: src/lib/jobs/reasoningCacheCleanupJob.ts. +#OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS=1800000 + +# Spend write batcher cadence (ms) and buffer size before forced flush. +# Used by: src/lib/spend/batchWriter.ts. Defaults: 60000 ms / 1000 entries. +#OMNIROUTE_SPEND_FLUSH_INTERVAL_MS=60000 +#OMNIROUTE_SPEND_MAX_BUFFER_SIZE=1000 + +# Config hot-reload polling interval (ms). Default: 5000. +# Used by: src/lib/config/hotReload.ts. Lower than 1000ms is rejected. +#OMNIROUTE_CONFIG_HOT_RELOAD_MS=5000 + +# Override the migrations directory used by src/lib/db/migrationRunner.ts. +# Default: <repo>/src/lib/db/migrations. +#OMNIROUTE_MIGRATIONS_DIR= + +# Trust user-managed RTK project filter rules without strict signature checks. +# Used by: open-sse/services/compression/engines/rtk/filterLoader.ts. Default: 0. +#OMNIROUTE_RTK_TRUST_PROJECT_FILTERS=0 + +# Force a DB healthcheck regardless of cadence. Default: 0. +# Used by: src/lib/db/core.ts::shouldRunDbHealthCheck(). +#OMNIROUTE_FORCE_DB_HEALTHCHECK=0 + +# DB healthcheck cadence override (ms). Default: 21600000 (6h). +# Used by: src/lib/db/core.ts::getDbHealthCheckIntervalMs(). +#OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS=21600000 + +# Skip the Redis-backed auth cache used by API key lookups (forces DB reads). +# Used by: src/lib/db/apiKeys.ts. Set to 1 to disable. Default: enabled. +#OMNIROUTE_DISABLE_REDIS_AUTH_CACHE=0 + # Flag set by bootstrap script after initial setup is complete. # Used by: src/app/(dashboard)/dashboard/page.tsx — shows setup wizard vs. dashboard. # OMNIROUTE_BOOTSTRAPPED=false @@ -355,6 +432,11 @@ PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70 # Used by: open-sse/executors/antigravity.ts — escape hatch for multi-project setups. # OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE=0 +# Adjust how Antigravity advertises remaining credits. Used by: +# open-sse/services/antigravityCredits.ts — accepts forced override strings. +# Default: empty (use upstream-reported credits). +#ANTIGRAVITY_CREDITS= + # ═══════════════════════════════════════════════════════════════════════════════ # 11. OAUTH PROVIDER CREDENTIALS @@ -393,12 +475,27 @@ ANTIGRAVITY_OAUTH_CLIENT_SECRET=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 # ── GitHub Copilot ── GITHUB_OAUTH_CLIENT_ID=Iv1.b507a08c87ecfe98 +# ── Windsurf / Devin CLI ── +# Public Firebase Web API key used by Windsurf's Secure Token Service to refresh +# short-lived browser-flow tokens. This is a client-side credential embedded in +# the Windsurf app itself (not a secret). Long-lived import tokens skip this entirely. +# Source: extracted from Devin CLI binary (devin.exe / model_configs_v2.bin). +WINDSURF_FIREBASE_API_KEY=AIzaSyBpLTEGSt59AUPKxBb7lIWjSE2ZXQH7mgU + # ── GitLab Duo ── # Register an OAuth app at: https://gitlab.com/-/profile/applications # Set redirect URI to: http://localhost:20128/callback (or your NEXT_PUBLIC_BASE_URL + /callback) # Required scopes: api, read_user, openid, profile, email # GITLAB_DUO_OAUTH_CLIENT_ID=*** # GITLAB_DUO_OAUTH_CLIENT_SECRET=*** # optional — PKCE flow does not require a secret +# +# Self-managed GitLab Duo instance overrides. +# Used by: src/lib/oauth/gitlab.ts and src/lib/oauth/constants/oauth.ts — +# fall back to these when the _DUO_ variants above are unset. +#GITLAB_DUO_BASE_URL=https://gitlab.com +#GITLAB_BASE_URL=https://gitlab.com +#GITLAB_OAUTH_CLIENT_ID= +#GITLAB_OAUTH_CLIENT_SECRET= # ── Qoder ── QODER_OAUTH_CLIENT_SECRET=4Z3YjXycVsQvyGF1etiNlIBB4RsqSDtW @@ -470,6 +567,10 @@ QWEN_USER_AGENT="QwenCode/0.15.9 (linux; x64)" CURSOR_USER_AGENT="Cursor/3.3" GEMINI_CLI_USER_AGENT="google-api-nodejs-client/10.3.0" +# Override Codex client version sent in headers independently of the +# CODEX_USER_AGENT string. Used by: open-sse/config/codexClient.ts. +# CODEX_CLIENT_VERSION=0.130.0 + # ═══════════════════════════════════════════════════════════════════════════════ # 13. CLI FINGERPRINT COMPATIBILITY (Anti-Detection) @@ -484,7 +585,6 @@ GEMINI_CLI_USER_AGENT="google-api-nodejs-client/10.3.0" # CLI_COMPAT_CLAUDE=1 # CLI_COMPAT_GITHUB=1 # CLI_COMPAT_ANTIGRAVITY=1 -# CLI_COMPAT_KIRO=1 # CLI_COMPAT_CURSOR=1 # CLI_COMPAT_KIMI_CODING=1 # CLI_COMPAT_KILOCODE=1 @@ -494,6 +594,12 @@ GEMINI_CLI_USER_AGENT="google-api-nodejs-client/10.3.0" # Or enable for all providers at once: # CLI_COMPAT_ALL=1 +# ── Kimi Coding CLI identity overrides ── +# Used by: src/lib/oauth/providers/kimi-coding.ts — sent in OAuth + API headers. +# Leave unset to use the captured defaults baked into the OmniRoute build. +#KIMI_CLI_VERSION=1.36.0 +#KIMI_CODING_DEVICE_ID= + # ═══════════════════════════════════════════════════════════════════════════════ # 14. API KEY PROVIDERS @@ -502,20 +608,20 @@ GEMINI_CLI_USER_AGENT="google-api-nodejs-client/10.3.0" # Preferred setup: Dashboard → Providers → Add API Key. # Setting here is an alternative for Docker/headless deployments. +# Static API keys for direct-authentication providers wired through the runtime. +# OmniRoute loads provider credentials from the encrypted database or +# data/provider-credentials.json. The variables below are documented escape +# hatches that are referenced in code today. # DEEPSEEK_API_KEY= -# GROQ_API_KEY= -# XAI_API_KEY= -# MISTRAL_API_KEY= -# PERPLEXITY_API_KEY= -# TOGETHER_API_KEY= -# FIREWORKS_API_KEY= -# CEREBRAS_API_KEY= -# COHERE_API_KEY= # NVIDIA_API_KEY= +# Windsurf / Devin CLI direct API key. +# Used by: open-sse/executors/devin-cli.ts — bypasses OAuth when set. +# WINDSURF_API_KEY= + # Embedding Providers (optional — used by /v1/embeddings) -# NEBIUS_API_KEY= -# Provider keys above (OpenAI, Mistral, Together, Fireworks, NVIDIA) also work for embeddings. +# OpenAI/Mistral/Together/Fireworks/NVIDIA configured via Dashboard → Providers +# also work for embeddings. # ═══════════════════════════════════════════════════════════════════════════════ @@ -539,6 +645,29 @@ GEMINI_CLI_USER_AGENT="google-api-nodejs-client/10.3.0" # FETCH_CONNECT_TIMEOUT_MS=30000 # TCP connection establishment (default: 30s) # FETCH_KEEPALIVE_TIMEOUT_MS=4000 # Keep-alive socket idle timeout (default: 4s) +# Default timeout (ms) for src/shared/utils/fetchTimeout.ts. Acts as the +# fallback when FETCH_TIMEOUT_MS is unset. Default: 120000 (2 min). +# OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS=120000 + +# ── ChatGPT TLS sidecar (Firefox-fingerprinted client) ── +# Used by: open-sse/services/chatgptTlsClient.ts — wire-level timeout for +# the bogdanfinn/tls-client koffi binding and the JS-side grace window +# layered on top of it when the native library is wedged. +# OMNIROUTE_CHATGPT_TLS_TIMEOUT_MS=60000 +# OMNIROUTE_CHATGPT_TLS_GRACE_MS=10000 + +# ── Circuit breaker thresholds and reset windows ── +# Used by: open-sse/config/constants.ts → src/lib/resilience/settings.ts. +# Defaults match historical PROVIDER_PROFILES values (post-scaling for +# 500+ connections). Lower the threshold to react faster, raise it to +# tolerate more transient failures before short-circuiting. +# OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD=8 +# OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS=60000 +# OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD=12 +# OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS=30000 +# OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD=2 +# OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS=15000 + # ── Stream idle detection ── # STREAM_IDLE_TIMEOUT_MS=600000 # Max silence between SSE chunks (default: 600000) # # Extended-thinking models rarely pause >90s. @@ -621,6 +750,14 @@ APP_LOG_TO_FILE=true # Default: 512 # CALL_LOG_PIPELINE_MAX_SIZE_KB=512 +# Call log payload truncation limits — controls how much of request/response +# bodies is retained in the database. +# Used by: open-sse/handlers/chatCore.ts — cloneBoundedChatLogPayload() +# CHAT_LOG_TEXT_LIMIT=65536 # Max string length before truncation (default: 64 KB) +# CHAT_LOG_ARRAY_TAIL_ITEMS=24 # Number of array items retained from tail (default: 24) +# CHAT_LOG_MAX_DEPTH=6 # Max nesting depth before truncation (default: 6) +# CHAT_LOG_MAX_OBJECT_KEYS=80 # Max object keys retained (default: 80, 0 = no limit) + # Maximum rows in the proxy_logs SQLite table. # Default: 100000 # PROXY_LOGS_TABLE_MAX_ROWS=100000 @@ -703,6 +840,13 @@ APP_LOG_TO_FILE=true # NANOBANANA_POLL_TIMEOUT_MS=120000 # Max wait for job completion (default: 120s) # NANOBANANA_POLL_INTERVAL_MS=2500 # Poll frequency (default: 2.5s) +# ── AWS Bedrock (Kiro / Audio) ── +# Region used to construct AWS Bedrock endpoints. Used by: +# src/lib/providers/validation.ts and open-sse/handlers/audioSpeech.ts. +# AWS_REGION takes precedence over AWS_DEFAULT_REGION when both are set. +# AWS_REGION=us-east-1 +# AWS_DEFAULT_REGION=us-east-1 + # ── Cloudflare Workers AI ── # Account ID override for Cloudflare Workers AI executor. # Used by: open-sse/executors/cloudflare-ai.ts @@ -762,21 +906,55 @@ APP_LOG_TO_FILE=true # Used by: open-sse/services/rateLimitManager.ts # RATE_LIMIT_MAX_WAIT_MS=120000 +# Force the auto-enable rate limit safety net on/off regardless of the persisted +# Dashboard setting. Used by: open-sse/services/rateLimitManager.ts. +# Accepted values: true|1|on (force on), false|0|off (force off), unset (use Dashboard). +# RATE_LIMIT_AUTO_ENABLE= + +# Stagger interval (ms) between provider token healthchecks at startup. +# Used by: src/lib/tokenHealthCheck.ts. Default: 3000. +# HEALTHCHECK_STAGGER_MS=3000 + # ═══════════════════════════════════════════════════════════════════════════════ # 22. DEBUGGING # ═══════════════════════════════════════════════════════════════════════════════ # These variables enable verbose debugging output. NEVER enable in production. -# Dump Cursor protobuf decode/encode details to console. -# CURSOR_PROTOBUF_DEBUG=1 - -# Dump raw Cursor SSE stream data to console. +# Cursor executor verbose debug (decoded SSE chunks, etc.). +# CURSOR_STREAM_DEBUG is kept as a backward-compatible alias. +# Used by: open-sse/executors/cursor.ts +# CURSOR_DEBUG=1 # CURSOR_STREAM_DEBUG=1 +# When CURSOR_DEBUG=1, also append raw decoded chunks to this file path. +# CURSOR_DUMP_FILE=/tmp/cursor-stream.log + +# Cursor stream idle timeout (ms). Default: 300000 (5 min). +# Used by: open-sse/executors/cursor.ts. +# CURSOR_STREAM_TIMEOUT_MS=300000 + +# Cursor state DB path override (for cursor version detection). +# Used by: open-sse/utils/cursorVersionDetector.ts. Default: probed automatically. +# CURSOR_STATE_DB_PATH= + +# Direct Cursor bearer token used by scripts/cursor-tap.cjs (developer tooling). +# CURSOR_TOKEN= + # Log Responses API SSE-to-JSON translation details. # DEBUG_RESPONSES_SSE_TO_JSON=true +# Log request shape (content-type + content-length) for large chat payloads. +# Used by: src/app/api/v1/chat/completions/route.ts. Set to "0" to silence. +# Default: enabled. +# OMNIROUTE_LOG_REQUEST_SHAPE=1 + +# Write raw (untruncated) request/response JSON in call log artifacts. +# When enabled, serializeArtifactForStorage skips size-based truncation. +# Also enabled automatically when APP_LOG_LEVEL=debug. +# WARNING: produces large files — use only for temporary debugging. +# CHAT_DEBUG_FILE=true + # Enable E2E test mode — relaxes auth and enables test harness hooks. # NEXT_PUBLIC_OMNIROUTE_E2E_MODE=true @@ -792,3 +970,140 @@ APP_LOG_TO_FILE=true # GitHub Personal Access Token with issues:write scope. # GITHUB_ISSUES_TOKEN=ghp_xxxx + +# Generic GitHub access token consumed by issue triage / agent helpers. +# Used by: src/app/api/v1/issues/* and src/lib/cloudAgent/* — falls back to +# GITHUB_ISSUES_TOKEN when unset. +# GITHUB_TOKEN= + + +# ═══════════════════════════════════════════════════════════════════════════════ +# 24. PROVIDER QUOTAS, TUNNELS & SANDBOXED SKILLS +# ═══════════════════════════════════════════════════════════════════════════════ +# Provider quota endpoints, network tunnels (Tailscale, Ngrok, MITM debug +# proxy), 1Proxy egress pool, skills sandbox runtime, and miscellaneous CLI +# binaries referenced by the executor layer or the dashboard runtime. + +# ── Alibaba (Bailian) coding plan quota ── +# Host/full URL override used by: open-sse/services/bailianQuotaFetcher.ts. +# When unset the fetcher uses the production Alibaba endpoints. +# ALIBABA_CODING_PLAN_HOST= +# ALIBABA_CODING_PLAN_QUOTA_URL= + +# ── Context window tuning ── +# Tokens reserved for completion output when computing prompt budgets. +# Used by: open-sse/services/contextManager.ts. Default: 1024. +# CONTEXT_RESERVE_TOKENS=1024 + +# ── Model alias rewriting (legacy compatibility) ── +# Toggle the legacy model-alias compatibility layer used by older clients. +# Used by: open-sse/services/model.ts. Default: enabled. +# MODEL_ALIAS_COMPAT_ENABLED=true + +# ── Devin CLI binary path ── +# Used by: open-sse/executors/devin-cli.ts. Default: looked up via PATH. +# CLI_DEVIN_BIN=devin + +# ── Command Code (custom CLI) callback ── +# Local port used for OAuth-style callbacks from the Command Code CLI helper. +# Used by: src/app/api/providers/command-code/auth/shared.ts. +# COMMAND_CODE_CALLBACK_PORT= + +# ── MITM debug proxy (development only) ── +# Used by: src/mitm/server.cjs — captures upstream traffic for inspection. +# MITM_LOCAL_PORT=443 +# MITM_DISABLE_TLS_VERIFY=0 + +# ── 1Proxy egress pool ── +# Used by: src/lib/oneproxySync.ts — fetches proxy nodes from the OmniRoute +# CrofAI 1Proxy service. Disable, override URL, or tune the import quality. +# ONEPROXY_ENABLED=true +# ONEPROXY_API_URL=https://1proxy-api.aitradepulse.com +# ONEPROXY_MAX_PROXIES=500 +# ONEPROXY_MIN_QUALITY_THRESHOLD=50 + +# ── Tailscale tunnel binaries ── +# Optional explicit paths to tailscale/tailscaled binaries used by the +# dashboard's tunnel manager. Used by: src/lib/tailscaleTunnel.ts. +# TAILSCALE_BIN=/usr/local/bin/tailscale +# TAILSCALED_BIN=/usr/local/bin/tailscaled + +# ── Ngrok tunnel ── +# Used by: src/lib/ngrokTunnel.ts — authenticates outbound tunnels. +# NGROK_AUTHTOKEN= + +# ── Database backups ── +# Used by: src/lib/db/backup.ts. +# DB_BACKUP_MAX_FILES=20 +# DB_BACKUP_RETENTION_DAYS=0 + +# ── TLS sidecar override ── +# Used by: open-sse/services/chatgptTlsClient.ts tests. Production deployments +# should leave this unset; the sidecar is auto-managed. +# OMNIROUTE_TLS_PROXY_URL= + +# ── Skills sandbox (experimental) ── +# Used by: src/lib/skills/builtins.ts. All values support comma lists where +# noted in the source. +# SKILLS_MAX_FILE_BYTES=1048576 +# SKILLS_MAX_HTTP_RESPONSE_BYTES=256000 +# SKILLS_MAX_SANDBOX_OUTPUT_CHARS=100000 +# SKILLS_SANDBOX_TIMEOUT_MS=10000 +# SKILLS_SANDBOX_NETWORK_ENABLED=0 +# SKILLS_ALLOWED_SANDBOX_IMAGES= + + +# ═══════════════════════════════════════════════════════════════════════════════ +# 25. TEST & E2E +# ═══════════════════════════════════════════════════════════════════════════════ +# Used by scripts/run-next-playwright.mjs, scripts/smoke-electron-packaged.mjs, +# scripts/run-ecosystem-tests.mjs and scripts/uninstall.mjs. +# Production deployments should leave every value below unset. + +# E2E bootstrap mode for the Playwright runner. Accepted: auth | fresh | reuse. +# Default (when unset): auth. +# OMNIROUTE_E2E_BOOTSTRAP_MODE=auth + +# Admin password injected into the Playwright test environment. +# Falls back to INITIAL_PASSWORD when unset. +# OMNIROUTE_E2E_PASSWORD= + +# Disable the local healthcheck poll during Playwright runs (default: true). +# OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK=true + +# Disable the OAuth token healthcheck loop during tests (default: true). +# OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK=true + +# Silence healthcheck noise in Playwright stdout (default: true). +# OMNIROUTE_HIDE_HEALTHCHECK_LOGS=true + +# Skip the Next.js production build before Playwright starts (CI optimization). +# OMNIROUTE_PLAYWRIGHT_SKIP_BUILD=0 + +# Skip the OmniRoute uninstall hook (used by CI to keep node_modules intact). +# OMNIROUTE_SKIP_UNINSTALL_HOOK=0 + +# Ecosystem/protocol test orchestrators wait this long (ms) for the server to +# become healthy. Default: 180000. +# ECOSYSTEM_SERVER_WAIT_MS=180000 + +# Docs translation pipeline (used by scripts/i18n/run-translation.mjs). +# OpenAI-compatible base URL, e.g. https://cloud.omniroute.online/v1 +# OMNIROUTE_TRANSLATION_API_URL= +# Bearer token for the translation backend (NEVER commit a real key here). +# OMNIROUTE_TRANSLATION_API_KEY= +# Model id, e.g. gpt-4o-mini or cx/gpt-5.4-mini. +# OMNIROUTE_TRANSLATION_MODEL=gpt-4o-mini +# Per-request timeout in milliseconds (default 60000). +# OMNIROUTE_TRANSLATION_TIMEOUT_MS=60000 +# Number of parallel translation requests (default 4). +# OMNIROUTE_TRANSLATION_CONCURRENCY=4 + +# Electron smoke harness (used by scripts/smoke-electron-packaged.mjs). +# ELECTRON_SMOKE_URL=http://127.0.0.1:20128/login +# ELECTRON_SMOKE_TIMEOUT_MS=45000 +# ELECTRON_SMOKE_SETTLE_MS=2000 +# ELECTRON_SMOKE_APP_EXECUTABLE= +# ELECTRON_SMOKE_DATA_DIR= +# ELECTRON_SMOKE_KEEP_DATA=0 +# ELECTRON_SMOKE_STREAM_LOGS=0 diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 647c7a0d43..420299a3df 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -41,6 +41,32 @@ jobs: - run: npm run typecheck:core - run: npm run typecheck:noimplicit:core + docs-sync-strict: + name: Docs Sync (Strict) + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v6 + - uses: actions/setup-node@v6 + with: + node-version: ${{ env.CI_NODE_VERSION }} + cache: npm + - run: npm ci + - run: npm run check:docs-all + - name: i18n translation drift (strict) + run: node scripts/i18n/check-translation-drift.mjs + + i18n-ui-coverage: + name: i18n UI Coverage + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v6 + - uses: actions/setup-node@v6 + with: + node-version: ${{ env.CI_NODE_VERSION }} + cache: npm + - run: npm ci + - run: node scripts/i18n/check-ui-keys-coverage.mjs --threshold=80 + i18n-matrix: name: Build language matrix runs-on: ubuntu-latest @@ -71,7 +97,7 @@ jobs: - name: Validate ${{ matrix.lang }} run: | - python3 scripts/validate_translation.py quick -l '${{ matrix.lang }}' > result.txt + python3 scripts/i18n/validate_translation.py quick -l '${{ matrix.lang }}' > result.txt - name: Upload result if: always() @@ -94,7 +120,7 @@ jobs: - name: Fetch base branch run: git fetch --no-tags origin "${GITHUB_BASE_REF}" --depth=1 - name: Validate source changes include tests - run: node scripts/check-pr-test-policy.mjs --summary-file .artifacts/pr-test-policy.md + run: node scripts/check/check-pr-test-policy.mjs --summary-file .artifacts/pr-test-policy.md - name: Publish PR test policy summary if: always() run: | @@ -255,7 +281,7 @@ jobs: run: | mkdir -p coverage if [ -f coverage/coverage-summary.json ]; then - node scripts/test-report-summary.mjs \ + node scripts/check/test-report-summary.mjs \ --input coverage/coverage-summary.json \ --output coverage/coverage-report.md \ --threshold 60 @@ -436,7 +462,7 @@ jobs: cache: npm - run: npm ci - run: npm run check:node-runtime - - run: node --import tsx/esm --test --test-shard=${{ matrix.shard }}/2 tests/integration/*.test.ts + - run: node --import tsx/esm --test --test-force-exit --test-concurrency=1 --test-shard=${{ matrix.shard }}/2 tests/integration/*.test.ts test-security: name: Security Tests @@ -462,6 +488,8 @@ jobs: if: always() needs: - lint + - docs-sync-strict + - i18n-ui-coverage - i18n - pr-test-policy @@ -507,6 +535,8 @@ jobs: echo "| Job | Status |" >> "$GITHUB_STEP_SUMMARY" echo "|-----|--------|" >> "$GITHUB_STEP_SUMMARY" echo "| Lint | $(status '${{ needs.lint.result }}') |" >> "$GITHUB_STEP_SUMMARY" + echo "| Docs Sync (Strict) | $(status '${{ needs.docs-sync-strict.result }}') |" >> "$GITHUB_STEP_SUMMARY" + echo "| i18n UI Coverage | $(status '${{ needs.i18n-ui-coverage.result }}') |" >> "$GITHUB_STEP_SUMMARY" echo "| PR Test Policy | $(status '${{ needs.pr-test-policy.result }}') |" >> "$GITHUB_STEP_SUMMARY" echo "| SonarQube | $(status '${{ needs.sonarqube.result }}') |" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/claude-code-review.yml b/.github/workflows/claude-code-review.yml index b5e8cfd4dc..a639c3fa36 100644 --- a/.github/workflows/claude-code-review.yml +++ b/.github/workflows/claude-code-review.yml @@ -36,9 +36,8 @@ jobs: uses: anthropics/claude-code-action@v1 with: claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }} - plugin_marketplaces: 'https://github.com/anthropics/claude-code.git' - plugins: 'code-review@claude-code-plugins' - prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}' + plugin_marketplaces: "https://github.com/anthropics/claude-code.git" + plugins: "code-review@claude-code-plugins" + prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}" # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md # or https://code.claude.com/docs/en/cli-reference for available options - diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml index 6b15fac7af..eb9719ecca 100644 --- a/.github/workflows/claude.yml +++ b/.github/workflows/claude.yml @@ -47,4 +47,3 @@ jobs: # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md # or https://code.claude.com/docs/en/cli-reference for available options # claude_args: '--allowed-tools Bash(gh pr *)' - diff --git a/.husky/pre-commit b/.husky/pre-commit index 7fad3fc22f..1bfbc29d10 100755 --- a/.husky/pre-commit +++ b/.husky/pre-commit @@ -6,5 +6,16 @@ if ! command -v npx >/dev/null 2>&1; then fi npx lint-staged -node scripts/check-docs-sync.mjs +node scripts/check/check-docs-sync.mjs npm run check:any-budget:t11 + +# Strict env-doc sync (FASE 2) +node scripts/check/check-env-doc-sync.mjs + +# i18n docs drift advisory (FASE 5) — warn-only on pre-commit; CI enforces strict. +node scripts/i18n/check-translation-drift.mjs --warn || \ + echo "⚠️ i18n drift detected. Run 'npm run i18n:run' to update locale mirrors." + +# i18n UI coverage advisory (FASE 6) — pre-commit warns; CI enforces strict. +node scripts/i18n/check-ui-keys-coverage.mjs --threshold=80 || \ + echo "⚠️ UI i18n coverage below 80% for at least one locale." diff --git a/.husky/pre-push b/.husky/pre-push index 4e35eb020c..0bb7cedf2d 100755 --- a/.husky/pre-push +++ b/.husky/pre-push @@ -1,8 +1,8 @@ #!/usr/bin/env sh -if ! command -v npm >/dev/null 2>&1; then - echo "⚠️ npm not found in PATH — skipping pre-push hooks" - echo " Run 'npm test' manually before pushing." - exit 0 -fi +#if ! command -v npm >/dev/null 2>&1; then +# echo "⚠️ npm not found in PATH — skipping pre-push hooks" +# echo " Run 'npm test' manually before pushing." +# exit 0 +#fi -npm run test:unit +#npm run test:unit diff --git a/.i18n-state.json b/.i18n-state.json new file mode 100644 index 0000000000..7f1665f66f --- /dev/null +++ b/.i18n-state.json @@ -0,0 +1,24 @@ +{ + "sources": { + "CLAUDE.md": { + "source_hash": "ee7af1716a6e22feb93bb160f8b2810fa7dce8f56075b218ced51b04863f1786", + "locales": { + "pt-BR": { + "source_hash": "ee7af1716a6e22feb93bb160f8b2810fa7dce8f56075b218ced51b04863f1786", + "target_hash": "7a85c5795d376e8572598f9d963e32ec62f925b952b61b60c78fa42785836014", + "updated_at": "2026-05-13T20:02:23.088Z" + } + } + }, + "docs/architecture/ARCHITECTURE.md": { + "source_hash": "7e691870a4f6f25a535a023206cff5ef88aed619c9734851ebdacdd3a3bafcc8", + "locales": { + "pt-BR": { + "source_hash": "7e691870a4f6f25a535a023206cff5ef88aed619c9734851ebdacdd3a3bafcc8", + "target_hash": "3e2a58f341f20b29cf245330b094bec40ffeede43526b4d416c660c37abca8db", + "updated_at": "2026-05-13T22:58:05.984Z" + } + } + } + } +} diff --git a/.issues/feat-batch-delete-provider-accounts.md b/.issues/feat-batch-delete-provider-accounts.md deleted file mode 100644 index fe84a123c8..0000000000 --- a/.issues/feat-batch-delete-provider-accounts.md +++ /dev/null @@ -1,328 +0,0 @@ -# Feature Proposal: Batch Delete Provider Accounts - -## Summary - -Add **batch delete** functionality for provider accounts (connections) in the provider detail page (`/dashboard/providers/[id]`). Users select multiple accounts via checkboxes and delete them in a single action, replacing the current one-by-one delete workflow. - -## Problem Statement - -Users managing multiple provider accounts (e.g., 20+ API keys or OAuth connections) have to delete accounts individually. Each deletion requires: - -1. Finding the account -2. Clicking the delete button -3. Confirming via browser `confirm()` dialog -4. Waiting for the API call -5. Repeating for every account - -This is: -- **Time-consuming**: O(n) confirm dialogs and API calls for n accounts -- **Error-prone**: Easy to accidentally click the wrong account -- **Tedious**: No way to quickly clean up stale or duplicate accounts - -## Solution - -Add a checkbox-based selection UI to the provider connections list: - -``` -┌────────────────────────────────────────────────────────────────┐ -│ [x] Account #1 (kiro-prod) [Delete Selected (3)] │ -│ [x] Account #2 (kiro-staging) │ -│ [ ] Account #3 (kiro-backup) │ -└────────────────────────────────────────────────────────────────┘ -``` - -## Detailed PR Specification - -### Files to Modify - -| File | Change | -|------|--------| -| `src/app/(dashboard)/dashboard/providers/[id]/page.tsx` | Add batch delete state, select-all + per-row checkboxes, batch delete handler | -| `src/app/api/providers/route.ts` | Add `DELETE /api/providers` with `POST` body `ids: string[]` for batch delete | -| `src/lib/db/providers.ts` | Add `deleteProviderConnections(ids: string[])` batch DB function | -| `src/i18n/messages/en.json` | Add i18n keys: `batchDeleteSelected`, `batchDeleteConfirm`, `batchDeleteSuccess` | -| `src/i18n/messages/*.json` | Add i18n keys to all locale files | -| `tests/unit/db-providers-crud.test.ts` | Add unit tests for batch delete DB function | -| `tests/integration/api-routes-critical.test.ts` | Add integration test for batch delete API endpoint | - -### 1. DB Layer (`src/lib/db/providers.ts`) - -```typescript -export async function deleteProviderConnections(ids: string[]): Promise<number> { - const db = getDbInstance() as unknown as DbLike; - if (ids.length === 0) return 0; - - // Delete quota snapshots for each connection first - const deleteSnapshots = db.prepare("DELETE FROM quota_snapshots WHERE connection_id = ?"); - for (const id of ids) { - deleteSnapshots.run(id); - } - - // Batch delete connections - const placeholders = ids.map(() => "?").join(","); - const result = db.prepare( - `DELETE FROM provider_connections WHERE id IN (${placeholders})` - ).run(...ids); - - backupDbFile("pre-write"); - invalidateDbCache("connections"); - return result.changes ?? 0; -} -``` - -### 2. API Route (`src/app/api/providers/route.ts`) - -Add a new route handler for batch delete. The existing `/api/providers/[id]` only handles single-id operations. The main providers route file (`/api/providers/route.ts`) should be extended: - -```typescript -// DELETE /api/providers — Batch delete connections -// Body: { ids: string[] } -export async function DELETE(request: Request) { - const authError = await requireManagementAuth(request); - if (authError) return authError; - - let body: { ids?: string[] }; - try { - body = await request.json(); - } catch { - return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); - } - - if (!Array.isArray(body.ids) || body.ids.length === 0) { - return NextResponse.json( - { error: "ids must be a non-empty array of connection IDs" }, - { status: 400 } - ); - } - - if (body.ids.length > 100) { - return NextResponse.json( - { error: "Cannot delete more than 100 connections at once" }, - { status: 400 } - ); - } - - try { - const deleted = await deleteProviderConnections(body.ids); - await syncToCloudIfEnabled(); - - logAuditEvent({ - action: "provider.credentials.batch_revoked", - actor: "admin", - resourceType: "provider_credentials", - status: "success", - metadata: { count: deleted, ids: body.ids }, - }); - - return NextResponse.json({ message: `Deleted ${deleted} connection(s)`, deleted }); - } catch (error) { - console.log("Error batch deleting connections:", error); - return NextResponse.json({ error: "Failed to batch delete connections" }, { status: 500 }); - } -} -``` - -### 3. UI Layer (`src/app/(dashboard)/dashboard/providers/[id]/page.tsx`) - -#### New State Variables - -```typescript -// Batch selection state -const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set()); -const [batchDeleting, setBatchDeleting] = useState(false); -``` - -#### New Functions - -```typescript -const handleToggleSelectAll = useCallback(() => { - setSelectedIds((prev) => - prev.size === connections.length ? new Set() : new Set(connections.map((c) => c.id)) - ); -}, [connections]); - -const handleToggleSelectOne = useCallback((id: string) => { - setSelectedIds((prev) => { - const next = new Set(prev); - if (next.has(id)) next.delete(id); - else next.add(id); - return next; - }); -}, []); - -const handleBatchDelete = async () => { - if (selectedIds.size === 0) return; - if (!confirm(t("batchDeleteConfirm", { count: selectedIds.size }))) return; - - setBatchDeleting(true); - try { - const res = await fetch("/api/providers", { - method: "DELETE", - headers: { "Content-Type": "application/json" }, - body: JSON.stringify({ ids: Array.from(selectedIds) }), - }); - - if (res.ok) { - setSelectedIds(new Set()); - await fetchConnections(); - notify.success(t("batchDeleteSuccess", { count: selectedIds.size })); - } else { - const data = await res.json(); - notify.error(data.error || "Batch delete failed"); - } - } catch (error) { - notify.error("Network error during batch delete"); - } finally { - setBatchDeleting(false); - } -}; -``` - -#### Per-Row Checkbox (inside `ConnectionRow`) - -Add a checkbox as the first element of each row: - -```tsx -// In ConnectionRow interface, add: -interface ConnectionRowProps { - isSelected?: boolean; - onToggleSelect?: () => void; - // ... existing props -} - -// In ConnectionRow render, before priority arrows: -<div className="flex items-center gap-3 flex-1 min-w-0"> - <input - type="checkbox" - checked={isSelected} - onChange={onToggleSelect} - className="w-4 h-4 rounded border-border text-primary focus:ring-primary/30 cursor-pointer" - /> - {/* Priority arrows */} - ... -``` - -#### Header Row (above connections list) - -```tsx -<div className="flex items-center justify-between px-3 py-2 bg-muted/50 rounded-t-lg border border-b-0 border-border"> - <label className="flex items-center gap-2 cursor-pointer select-none"> - <input - type="checkbox" - checked={selectedIds.size === connections.length && connections.length > 0} - ref={(el) => { if (el) el.indeterminate = selectedIds.size > 0 && selectedIds.size < connections.length; }} - onChange={handleToggleSelectAll} - className="w-4 h-4 rounded border-border text-primary focus:ring-primary/30" - /> - <span className="text-sm font-medium text-text-muted"> - {selectedIds.size > 0 - ? `${selectedIds.size} selected` - : `${connections.length} accounts`} - </span> - </label> - - {selectedIds.size > 0 && ( - <Button - variant="destructive" - size="sm" - icon="delete" - loading={batchDeleting} - onClick={handleBatchDelete} - > - {t("batchDeleteSelected", { count: selectedIds.size })} - </Button> - )} -</div> -``` - -### 4. i18n Keys (to add to all locale files) - -```json -{ - "batchDeleteSelected": "Delete Selected ({count})", - "batchDeleteConfirm": "Delete {count} connection(s)? This action cannot be undone.", - "batchDeleteSuccess": "Deleted {count} connection(s)" -} -``` - -### 5. Testing - -#### Unit Test (`tests/unit/db-providers-crud.test.ts`) - -```typescript -test("deleteProviderConnections deletes multiple connections", async () => { - const ids = [ - (await createProviderConnection({ provider: "openai", name: "test-1", authType: "apikey" })).id!, - (await createProviderConnection({ provider: "openai", name: "test-2", authType: "apikey" })).id!, - ]; - - const deleted = await deleteProviderConnections(ids); - expect(deleted).toBe(2); - - for (const id of ids) { - const conn = await getProviderConnectionById(id); - expect(conn).toBeNull(); - } -}); - -test("deleteProviderConnections with empty array returns 0", async () => { - const deleted = await deleteProviderConnections([]); - expect(deleted).toBe(0); -}); -``` - -#### Integration Test (`tests/integration/api-routes-critical.test.ts`) - -```typescript -test("DELETE /api/providers — batch delete", async () => { - const ids = [conn1.id, conn2.id]; - const res = await fetch("http://localhost:20128/api/providers", { - method: "DELETE", - headers: { "Content-Type": "application/json", "Authorization": `Bearer ${apiKey}` }, - body: JSON.stringify({ ids }), - }); - - expect(res.status).toBe(200); - const data = await res.json(); - expect(data.deleted).toBe(2); -}); -``` - -### UX Details - -1. **Indeterminate select-all**: When some (but not all) rows are selected, the select-all checkbox shows as indeterminate (dash) -2. **Confirmation**: Shows `confirm()` with count ("Delete 3 connections?") -3. **Optimistic update**: Immediately clears selected IDs and removes deleted connections from list on success -4. **Error handling**: Shows error notification; connections remain in list if delete fails -5. **Loading state**: Button shows spinner during delete; row checkboxes disabled -6. **Empty state**: No "Delete Selected" button when nothing selected -7. **Audit logging**: Each batch delete logged as `provider.credentials.batch_revoked` - -### Non-Goals - -- Bulk enable/disable (separate feature) -- Moving selected accounts (separate feature) -- Batch rename/edit (separate feature) -- Deleting across different providers (each provider page operates independently) - -### Risks & Mitigations - -| Risk | Mitigation | -|------|------------| -| User accidentally deletes wrong accounts | Require confirmation dialog with count | -| Too many connections selected | Cap at 100 per batch; show error if exceeded | -| Partial failure on batch delete | DB runs in transaction; all-or-nothing semantics | -| Performance with large selections | Batch SQL with `IN (...)` clause is efficient up to 100 | - -### Coverage - -Per repository rules, this change affects production code in `src/` → automated tests required: -- Unit test for `deleteProviderConnections()` in `tests/unit/db-providers-crud.test.ts` -- Integration test for `DELETE /api/providers` batch endpoint in `tests/integration/api-routes-critical.test.ts` -- Run `npm run test:coverage` — all 4 metrics must meet 60% minimum - ---- - -## Related Issues - -- Closes this issue on merge diff --git a/.npmignore b/.npmignore index cc14c145c2..80bfe11e38 100644 --- a/.npmignore +++ b/.npmignore @@ -52,8 +52,8 @@ AGENTS.md bun.lock # Build artifacts (pre-built goes inside app/) -.next/ -node_modules/ +/.next/ +/node_modules/ # Ignore large binary files and other build directories *.tgz diff --git a/@omniroute/opencode-provider/README.md b/@omniroute/opencode-provider/README.md new file mode 100644 index 0000000000..33689031a1 --- /dev/null +++ b/@omniroute/opencode-provider/README.md @@ -0,0 +1,45 @@ +# @omniroute/opencode-provider + +Provider plugin for connecting [OpenCode](https://github.com/anomalyco/opencode) to [OmniRoute](https://github.com/diegosouzapw/OmniRoute). + +## Installation + +```bash +npm install @omniroute/opencode-provider +``` + +## Usage + +```javascript +import { createOmniRouteProvider } from "@omniroute/opencode-provider"; + +const provider = createOmniRouteProvider({ + baseURL: "http://localhost:20128/v1", + apiKey: "your-omniroute-api-key", +}); +``` + +Then configure OpenCode to use the provider: + +```jsonc +// OpenCode settings +{ + "provider": provider +} +``` + +## API + +### `createOmniRouteProvider(options)` + +Creates an OpenCode-compatible provider object that routes requests through OmniRoute. + +**Options:** + +| Option | Type | Required | Description | +| --------- | -------- | -------- | ---------------------------------------------------------- | +| `baseURL` | `string` | Yes | OmniRoute API base URL (e.g., `http://localhost:20128/v1`) | +| `apiKey` | `string` | Yes | OmniRoute API key | +| `model` | `string` | No | Model identifier (default: `"opencode"`) | + +**Returns:** An OpenCode-compatible provider object with `id`, `name`, `npm`, `options`, and `auth` fields. diff --git a/@omniroute/opencode-provider/index.d.ts b/@omniroute/opencode-provider/index.d.ts new file mode 100644 index 0000000000..32b235cb9e --- /dev/null +++ b/@omniroute/opencode-provider/index.d.ts @@ -0,0 +1,3 @@ +import OmniRouteProvider from "./index.js"; +export { OmniRouteProvider }; +export default OmniRouteProvider; diff --git a/@omniroute/opencode-provider/index.js b/@omniroute/opencode-provider/index.js new file mode 100644 index 0000000000..3fb4f441d1 --- /dev/null +++ b/@omniroute/opencode-provider/index.js @@ -0,0 +1 @@ +export { createOmniRouteProvider, default as default } from "./index.ts"; diff --git a/@omniroute/opencode-provider/index.ts b/@omniroute/opencode-provider/index.ts new file mode 100644 index 0000000000..e053e65c65 --- /dev/null +++ b/@omniroute/opencode-provider/index.ts @@ -0,0 +1,54 @@ +/** + * OpenCode provider plugin for OmniRoute AI Gateway + * + * Usage: + * import { createOmniRouteProvider } from "@omniroute/opencode-provider"; + * const provider = createOmniRouteProvider({ + * baseURL: "http://localhost:20128/v1", + * apiKey: "your-api-key", + * }); + * + * Then add to OpenCode settings: + * { "provider": provider } + */ + +export interface OmniRouteProviderOptions { + baseURL: string; + apiKey: string; + model?: string; +} + +export interface OmniRouteProvider { + id: string; + name: string; + npm: string; + options: Record<string, unknown>; + auth: { type: string; apiKey: string }; +} + +export function createOmniRouteProvider(options: OmniRouteProviderOptions): OmniRouteProvider { + if (!options.baseURL) { + throw new Error("baseURL is required"); + } + if (!options.apiKey) { + throw new Error("apiKey is required"); + } + + const baseURL = options.baseURL.replace(/\/+$/, ""); + + return { + id: "omniroute", + name: "OmniRoute AI Gateway", + npm: "@omniroute/opencode-provider", + options: { + baseURL: `${baseURL}/v1`, + model: options.model || "opencode", + }, + auth: { + type: "apiKey", + apiKey: options.apiKey, + }, + }; +} + +export default createOmniRouteProvider; diff --git a/@omniroute/opencode-provider/package.json b/@omniroute/opencode-provider/package.json new file mode 100644 index 0000000000..4ffc071ca2 --- /dev/null +++ b/@omniroute/opencode-provider/package.json @@ -0,0 +1,20 @@ +{ + "name": "@omniroute/opencode-provider", + "version": "1.0.0", + "description": "OpenCode provider plugin for OmniRoute AI Gateway", + "type": "module", + "main": "index.js", + "types": "index.d.ts", + "files": [ + "index.js", + "index.d.ts", + "README.md" + ], + "keywords": [ + "omniroute", + "opencode", + "provider" + ], + "license": "MIT", + "peerDependencies": {} +} diff --git a/AGENTS.md b/AGENTS.md index aadaf98b2e..eb84cf6a1d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -127,13 +127,18 @@ Always run `prettier --write` on changed files. ### Data Layer (`src/lib/db/`) -All persistence uses SQLite through domain-specific modules: -`core.ts`, `providers.ts`, `models.ts`, `combos.ts`, `apiKeys.ts`, `settings.ts`, -`backup.ts`, `proxies.ts`, `prompts.ts`, `webhooks.ts`, `detailedLogs.ts`, -`domainState.ts`, `registeredKeys.ts`, `quotaSnapshots.ts`, `modelComboMappings.ts`, -`cliToolState.ts`, `encryption.ts`, `readCache.ts`, `secrets.ts`, `stateReset.ts`, -`contextHandoffs.ts`, `compression.ts`. -Schema migrations live in `db/migrations/` and run via `migrationRunner.ts`. +All persistence uses SQLite through **45+ domain-specific modules** in `src/lib/db/`. Top modules: + +- Core: `core.ts`, `migrationRunner.ts`, `encryption.ts`, `stateReset.ts` +- Providers / catalog: `providers.ts`, `models.ts`, `providerLimits.ts`, `compressionAnalytics.ts` +- Routing: `combos.ts`, `modelComboMappings.ts`, `domainState.ts`, `commandCodeAuth.ts` +- Auth: `apiKeys.ts`, `secrets.ts`, `registeredKeys.ts`, `sessionAccountAffinity.ts` +- Usage / billing: `quotaSnapshots.ts`, `creditBalance.ts`, `usage*.ts`, `compressionCacheStats.ts` +- Storage: `backup.ts`, `cleanup.ts`, `jsonMigration.ts`, `healthCheck.ts`, `databaseSettings.ts` +- Extension modules: `evals.ts`, `webhooks.ts`, `reasoningCache.ts`, `readCache.ts`, `tierConfig.ts`, `compressionCombos.ts`, `compressionScheduler.ts`, `batches.ts`, `files.ts`, `syncTokens.ts`, `proxies.ts`, `oneproxy.ts`, `upstreamProxy.ts`, `versionManager.ts`, `cliToolState.ts`, `prompts.ts`, `detailedLogs.ts`, `contextHandoffs.ts`, `compression.ts`, `stats.ts` + +Live count: `ls src/lib/db/*.ts | wc -l` (currently 45). +Schema migrations live in `db/migrations/` (55 files) and run via `migrationRunner.ts`. `src/lib/localDb.ts` is a **re-export layer only** — never add logic there. #### DB Internals @@ -142,8 +147,8 @@ Schema migrations live in `db/migrations/` and run via `migrationRunner.ts`. journaling. `SCHEMA_SQL` defines 15 base tables. Helpers: `rowToCamel`, `encryptConnectionFields`. - **`migrationRunner.ts`**: Applies versioned SQL files from `db/migrations/` inside transactions. Tracks applied migrations in `_omniroute_migrations` table. -- **Migrations**: 22 files (`001_initial_schema.sql` → `022_compression_settings.sql`). - Each migration is idempotent and runs in a transaction. +- **Migrations**: 55 files (`001_initial_schema.sql` → `055_command_code_auth_sessions.sql`). + Each migration is idempotent and runs in a transaction. Live count: `ls src/lib/db/migrations/*.sql | wc -l`. - **Domain modules** import `getDbInstance()` from `core.ts` for all CRUD operations. Each module owns a specific table/set of tables (e.g., `providers.ts` → `provider_connections`, `combos.ts` → `combos`). Encryption helpers protect sensitive fields at rest. @@ -212,7 +217,7 @@ Zod schemas, and unit tests aligned when editing. ### Provider Categories - **Free** (4): Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI -- **OAuth** (8): Claude Code, Antigravity, Codex, GitHub Copilot, Cursor, Kimi Coding, Kilo Code, Cline +- **OAuth** (14): Claude Code, Antigravity, Codex, GitHub Copilot, Cursor, Kimi Coding, Kilo Code, Cline, Qwen (⚠️ free tier discontinued 2026-04-15), Kiro, Qoder, Gemini, Windsurf (v3.8), GitLab Duo (v3.8) - **API Key** (120+): OpenAI, Anthropic, Gemini, DeepSeek, Groq, xAI, Mistral, Perplexity, Together, Fireworks, Cerebras, Cohere, NVIDIA, Nebius, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare AI, Scaleway, AI/ML API, Pollinations, @@ -321,7 +326,7 @@ Modular prompt compression that runs proactively before the existing reactive co and iterates through targets in order until one succeeds or all fail. - **`resolveComboTargets()`**: Expands a combo configuration into an ordered array of `ResolvedComboTarget[]`, each specifying provider + model + account + credentials. -- **Strategies** (13): priority, weighted, fill-first, round-robin, P2C, random, least-used, +- **Strategies** (14): priority, weighted, fill-first, round-robin, P2C, random, least-used, reset-aware (v3.8), cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay. - Each target calls **`handleSingleModel()`** which wraps `handleChatCore()` with per-target error handling and circuit breaker checks. @@ -334,7 +339,7 @@ Policy engine modules: `policyEngine.ts`, `comboResolver.ts`, `costRules.ts`, ### MCP Server (`open-sse/mcp-server/`) -37 tools, 3 transports (stdio / SSE / Streamable HTTP). Scoped auth (10 scopes), Zod schemas. +37 tools (30 base + 3 memory + 4 skills), 3 transports (stdio / SSE / Streamable HTTP). Scoped auth (~13 scopes), Zod schemas. See [`docs/frameworks/MCP-SERVER.md`](docs/frameworks/MCP-SERVER.md). **Core tools** (20): get_health, list_combos, get_combo_metrics, switch_combo, check_quota, route_request, cost_report, list_models_catalog, web_search, simulate_route, set_budget_guard, @@ -369,7 +374,7 @@ handler: async (args) => {...} }`. Zod validates inputs before the handler fires JSON-RPC 2.0, SSE streaming, Task Manager with TTL cleanup. Agent Card at `/.well-known/agent.json`. -Skills: `quotaManagement.ts`, `smartRouting.ts`. +Skills (5): `smartRouting.ts`, `quotaManagement.ts`, `providerDiscovery.ts`, `costAnalysis.ts`, `healthReport.ts`. #### A2A Internals @@ -422,6 +427,34 @@ MITM proxy capability with certificate management, DNS handling, and target rout Request middleware including `promptInjectionGuard.ts`. +### Guardrails (`src/lib/guardrails/`) + +Hot-reloadable guardrails framework (3 built-in: pii-masker, prompt-injection, vision-bridge). Fail-open; per-request opt-out via header. See [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md). + +### Cloud Agents (`src/lib/cloudAgent/`) + +`CloudAgentBase` abstract class + 3 agents (codex-cloud, devin, jules). Tasks persisted in `cloud_agent_tasks`; management auth required. See [`docs/frameworks/CLOUD_AGENT.md`](docs/frameworks/CLOUD_AGENT.md). + +### Evals (`src/lib/evals/`) + +Generic eval framework: `evalRunner.ts`, `runtime.ts`. Targets: combo / model / suite-default. See [`docs/frameworks/EVALS.md`](docs/frameworks/EVALS.md). + +### Webhooks (`src/lib/webhookDispatcher.ts`) + +HMAC-signed delivery, exponential backoff, auto-disable after 10 failures. 7 event types. See [`docs/frameworks/WEBHOOKS.md`](docs/frameworks/WEBHOOKS.md). + +### Authorization Pipeline (`src/server/authz/`) + +`classify → policies → enforce`. 3 route classes (PUBLIC / CLIENT_API / MANAGEMENT). See [`docs/architecture/AUTHZ_GUIDE.md`](docs/architecture/AUTHZ_GUIDE.md). + +### Reasoning Replay (`src/lib/db/reasoningCache.ts` + `open-sse/services/reasoningCache.ts`) + +Hybrid in-memory + SQLite cache for `reasoning_content`. Re-injects on multi-turn for strict providers (DeepSeek V4, Kimi K2, Qwen-Thinking, GLM, xiaomi-mimo). See [`docs/routing/REASONING_REPLAY.md`](docs/routing/REASONING_REPLAY.md). + +### Tunnels (`src/lib/{cloudflaredTunnel,ngrokTunnel}.ts` + `src/app/api/tunnels/`) + +Cloudflare Quick/Named, ngrok, Tailscale Funnel. See [`docs/ops/TUNNELS_GUIDE.md`](docs/ops/TUNNELS_GUIDE.md). + ### Adding a New Provider 1. Register in `src/shared/constants/providers.ts` @@ -438,6 +471,36 @@ Request middleware including `promptInjectionGuard.ts`. - **[`src/lib/db/AGENTS.md`](src/lib/db/AGENTS.md)** — SQLite persistence, domain modules, migrations - **[`open-sse/services/AGENTS.md`](open-sse/services/AGENTS.md)** — Routing engine, combo resolution, strategy selection +## Reference Documentation (docs/) + +For any non-trivial change, read the matching deep-dive first: + +| Area | Doc | +| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | +| Repo navigation | [`docs/architecture/REPOSITORY_MAP.md`](docs/architecture/REPOSITORY_MAP.md) | +| Architecture | [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) | +| Engineering reference | [`docs/architecture/CODEBASE_DOCUMENTATION.md`](docs/architecture/CODEBASE_DOCUMENTATION.md) | +| Auto-Combo (9-factor, 14 strategies) | [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) | +| Resilience (3 layers) | [`docs/architecture/RESILIENCE_GUIDE.md`](docs/architecture/RESILIENCE_GUIDE.md) | +| Skills | [`docs/frameworks/SKILLS.md`](docs/frameworks/SKILLS.md) | +| Memory | [`docs/frameworks/MEMORY.md`](docs/frameworks/MEMORY.md) | +| Cloud agents | [`docs/frameworks/CLOUD_AGENT.md`](docs/frameworks/CLOUD_AGENT.md) | +| Guardrails | [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md) | +| Evals | [`docs/frameworks/EVALS.md`](docs/frameworks/EVALS.md) | +| Compliance | [`docs/security/COMPLIANCE.md`](docs/security/COMPLIANCE.md) | +| Webhooks | [`docs/frameworks/WEBHOOKS.md`](docs/frameworks/WEBHOOKS.md) | +| Authz | [`docs/architecture/AUTHZ_GUIDE.md`](docs/architecture/AUTHZ_GUIDE.md) | +| Stealth | [`docs/security/STEALTH_GUIDE.md`](docs/security/STEALTH_GUIDE.md) | +| Reasoning replay | [`docs/routing/REASONING_REPLAY.md`](docs/routing/REASONING_REPLAY.md) | +| Agent protocols (A2A / ACP / Cloud) | [`docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md) | +| MCP server | [`docs/frameworks/MCP-SERVER.md`](docs/frameworks/MCP-SERVER.md) | +| A2A server | [`docs/frameworks/A2A-SERVER.md`](docs/frameworks/A2A-SERVER.md) | +| API reference | [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) + [`docs/reference/openapi.yaml`](docs/reference/openapi.yaml) | +| Provider catalog (auto-generated) | [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md) | +| Tunnels | [`docs/ops/TUNNELS_GUIDE.md`](docs/ops/TUNNELS_GUIDE.md) | +| Electron desktop | [`docs/guides/ELECTRON_GUIDE.md`](docs/guides/ELECTRON_GUIDE.md) | +| Release flow | [`docs/ops/RELEASE_CHECKLIST.md`](docs/ops/RELEASE_CHECKLIST.md) | + --- ## Review Focus diff --git a/CHANGELOG.md b/CHANGELOG.md index 2f713a54e6..7c8ab6f31e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,37 +2,258 @@ ## [Unreleased] +### Changed + +- **BREAKING**: dropped Node 20.x support. Minimum Node version is now 22.22.2 (or 24.0.0+). Required because http-proxy-middleware 4.x requires `node >=22.15.0`. Users on Node 20 must upgrade — see [`package.json` engines field](package.json) and the README Node badge. +- **Platform overhaul (FASES 1-9):** scripts cleanup, `.env` audit, `/docs` restructure, diagrams folder, i18n pipelines (docs + UI), `/src/app/docs` sync, CI gates. + - **Scripts:** `scripts/` reorganized into 6 subfolders (`build/`, `dev/`, `check/`, `docs/`, `i18n/`, `ad-hoc/`); 23 one-shot scripts archived to the `archive/scripts-scratch-pre-3.8` branch. + - **Environment:** `.env.example` cleaned (-11 orphan vars, +63 missing vars, 11 hardcoded URLs/timeouts promoted to env); new strict `scripts/check/check-env-doc-sync.mjs` validates code ↔ `.env.example` ↔ `docs/reference/ENVIRONMENT.md` parity. + - **Docs:** `/docs` restructured into 8 functional subfolders (`architecture/`, `guides/`, `reference/`, `frameworks/`, `routing/`, `security/`, `compression/`, `ops/`); ~899 cross-references rewritten. + - **Diagrams:** new `docs/diagrams/` with 8 canonical Mermaid sources + SVG exports, linked into 9 docs. + - **i18n (docs):** hash-based incremental pipeline (`config/i18n.json`, `scripts/i18n/run-translation.mjs`, `.i18n-state.json`); old `i18n_autotranslate.py` and `generate-multilang.mjs` deprecated. + - **i18n (UI):** `scripts/i18n/sync-ui-keys.mjs` propagates `en.json` keys to all 40 locales (no missing keys; coverage ≥ 85.8%); cosmetic `DocsI18n.tsx` removed (locale handling unified via `next-intl`). + - **`/src/app/docs`:** drift fixes (179 → 177 providers, 13 → 14 strategies, 36 → 37 MCP tools); YAML frontmatter added to all docs; `ApiExplorer` consumes `docs/reference/openapi.yaml` (19 endpoints); `content.ts` updated (37 MCP tool groups, 7 internal deployment guide hrefs). + - **CI gates:** strict env-doc-sync in pre-commit; `check:doc-links` validates internal markdown refs; new `docs-sync-strict` and `i18n-ui-coverage` jobs in `.github/workflows/ci.yml`. + +### Fixed + +- **Docs:** 270 broken internal markdown links repaired (consequence of `/docs` subfolder restructure not relativizing all paths). Categories: 241 `i18n-relative`, 14 `parent-relative`, 9 `screenshots`, 2 deleted-RFC, 4 misc. Now `npm run check:doc-links` PASS with 0 broken links. + ## [3.8.0] — 2026-05-06 ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(providers):** add Command Code provider (#2199 — thanks @ddarkr) +- **feat(providers):** add ModelScope provider-specific 429 handling and retry logic (#2202 — thanks @InkshadeWoods) +- **feat(providers):** update Gemini CLI provider models catalog (#2196 — thanks @nickwizard) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cursor):** surface Cursor Pro plan usage on provider-limits dashboard (#2128 — thanks @payne0420) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(api):** aggregate combo model metadata in catalog endpoint — `buildComboCatalogMetadata()` inlines contextLength, strategy, and target count for combo entries (#2166 — thanks @faisalill) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(oauth):** complete Windsurf and Devin CLI OAuth + API-token flows — WindsurfExecutor (gRPC-web/protobuf), DevinCliExecutor (ACP JSON-RPC 2.0 over stdio), model alias map, OAuth provider config (#2168 — thanks @Zhaba1337228) +- **feat(inworld):** enhance Inworld TTS support (#2123) +- **feat(kiro):** headless auth via kiro-cli SQLite, image support, tool overflow handling, and model list sync (#2129 — thanks @christlau) +- **feat(auto):** zero-config auto-routing with `auto/` prefix — dynamic virtual combo from connected providers with 6 variant profiles (coding, fast, cheap, offline, smart, lkgp), analytics tab, and settings UI (#2131 — thanks @oyi77) +- **feat(resilience):** add model cooldowns dashboard card with real-time list, individual/bulk re-enable, and auto-refresh (#2146 — thanks @rafacpti23) +- **feat(resilience):** `useUpstream429BreakerHints` toggle — per-provider default policy for upstream 429 hint trust at the circuit-breaker cooldown layer with tri-state PATCH semantics (#2133 — thanks @eleata) +- **feat(search):** add Ollama Search as a web search provider with registry integration and validation (#2176 — thanks @andrewmunsell) +- **feat(search):** add Z.AI Coding Plan Search via MCP protocol integration (#2238 — thanks @andrewmunsell) +- **feat(debug):** configurable chat log truncation limits via environment variables (`CHAT_LOG_TEXT_LIMIT`, `CHAT_LOG_ARRAY_TAIL_ITEMS`, `CHAT_LOG_MAX_DEPTH`, `CHAT_LOG_MAX_OBJECT_KEYS`) and `CHAT_DEBUG_FILE` mode for untruncated JSON payloads (#2156 — thanks @bypanghu) +- **feat(responses):** degrade `background: true` to synchronous execution with a warning instead of throwing `unsupportedFeature` (#2164 — thanks @Yosee11) +- **feat(mitm):** dynamic Linux certificate path detection for multi-distro MITM cert trust (Debian, Arch/CachyOS, Fedora/RHEL, openSUSE) with NSS browser database injection (#2134 — thanks @flyingmongoose) +- **feat(1proxy):** add dedicated settings tab with proxy rotation support (#2135 — thanks @oyi77) +- **feat(antigravity):** support custom Google Cloud project ID for Antigravity provider (#2227 — thanks @nickwizard) +- **feat(cli):** CLI Integration Suite — 5 new management commands (`config`, `status`, `logs`, `update`, `provider`), 3 API endpoints, config generators for 6 tools (Claude, Cline, Codex, Continue, KiloCode, OpenCode), zero-config `auto/` routing, and `@omniroute/opencode-provider` npm package (#2240 — thanks @oyi77) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) - **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) - **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) - **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression - **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(authz):** classify `/dashboard/onboarding` as PUBLIC to unblock setup wizard (#2127) +- **fix(chatcore):** stop leaking provider credentials in response headers +- **fix(analytics):** precise SQL matching for `auto/` prefix models +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix(translator):** preserve `body.system` in openai→claude translator when Claude Code sends native Anthropic system array through /chat/completions — fixes v3.7.9 regression where system prompt was silently dropped, triggering Anthropic 429 (#2130) +- **fix(sanitizer):** preserve `reasoning_content` on assistant messages with `tool_calls` or `function_call` — fixes Kimi and other thinking-enabled providers returning 400 errors when reasoning_content was incorrectly stripped (#2140 — thanks @DavyMassoneto) +- **fix(catalog):** ensure individual (non-combo) models expose `context_length` via `getTokenLimit()` fallback chain — prevents OpenCode and other clients from falling back to conservative ~4000 token limit (#2136 — thanks @herjarsa) +- **fix(docker):** remove docs directory from `.dockerignore` so API catalog documentation is available at runtime inside containers (#2137, #2120 — thanks @hartmark) +- **fix(types):** systematic `any` type elimination across 8 core files — `antigravity.ts`, `accountFallback.ts`, `usage.ts`, `geminiHelper.ts`, `error.ts`, `apiKeys.ts`, `settings.ts`, `logger.ts` (#2137 — thanks @hartmark) +- **fix(providers):** restore cloud agent provider exports and logger import (#2138 — thanks @backryun) +- **fix(providers):** remove duplicate `CLOUD_AGENT_PROVIDERS` declaration, move Kiro dash→dot Claude model aliases to `PROVIDER_MODEL_ALIASES`, and trim deprecated Kiro registry entries (#2141 — thanks @backryun) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) +- **fix(cliproxyapi):** probe `/v1/models` for health when CPA 6.x has no `/health` endpoint (#2189 — thanks @Brkic-Nikola) +- **fix(cliproxyapi):** detect Anthropic-shaped request bodies and route to `/v1/messages`, strip Capy extras, and round-trip `mcp_*` tool name rewrites to `Mcp_*` (#2165 — thanks @Brkic-Nikola) +- **fix(cliproxyapi):** detect Anthropic shape on minimal Capy bodies (#2192 — thanks @Brkic-Nikola) +- **fix(stream):** skip `[DONE]` terminator for Claude SSE clients (#2190 — thanks @Brkic-Nikola) +- **fix(claudeHelper):** emit `data` field on `redacted_thinking`, drop bogus signature (#2191 — thanks @Brkic-Nikola) +- **fix(modelSpecs):** cap thinking budget for Claude Opus 4.6 / 4.7 / Sonnet 4.6 (#2197 — thanks @Brkic-Nikola) +- **fix(reasoning-cache):** include xiaomi-mimo in replay provider/model detection (#2198 — thanks @Brkic-Nikola) +- **fix(kiro):** synthesize minimal tools schema when `body.tools` is omitted but message history contains `tool_calls`, preventing 400 errors from Claude Code and OpenCode (#2149 — thanks @Gioxaa) +- **fix(kiro):** avoid treating high-traffic 429s as quota exhaustion — use `classify429FromError` to prevent premature account deactivation (#2153 — thanks @Gioxaa) +- **fix(responses):** propagate `include` array (e.g. `reasoning.encrypted_content`) during Chat→Responses API translation, fixing broken thinking panel in Codex/OpenCode (#2154 — thanks @Gioxaa) +- **fix(responses):** emit reasoning summary as `delta.reasoning_content` (flat) instead of `delta.reasoning.summary` (nested) for Chat Completions client compatibility (#2159 — thanks @Gioxaa) +- **fix(cloudflare):** add state file write serialization lock to prevent race conditions in `cloudflaredTunnel.ts` (#2156 — thanks @bypanghu) +- **fix(providers):** allow optional-key providers to pass connection test (#2169 — thanks @andrewmunsell) +- **fix(providers):** correct pollinations requests and provider dashboard state +- **fix(providers):** fix Azure AI Foundry provider connection handling (#2236 — thanks @one-vs) +- **fix(providers/command-code):** fix validation request format for Command Code API (#2243 — thanks @ddarkr) +- **fix(antigravity):** strip `generationConfig.thinkingConfig` for Claude models routed through Antigravity to prevent upstream errors (#2217 — thanks @NomenAK) +- **fix(antigravity):** bootstrap project via `loadCodeAssist` + `fetchAvailableModels` fallback for robust startup (#2219 — thanks @NomenAK) +- **fix(rateLimit):** never `.stop()` during runtime reset, evict cache instead to prevent stale rate-limit state (#2218 — thanks @NomenAK) +- **fix(ModelSync):** shared loopback readiness gate + IPv4 force to prevent model sync failures on dual-stack hosts (#2221 — thanks @NomenAK) +- **fix(proxyFetch):** retry once on undici dispatcher failure before native fallback (#2222 — thanks @NomenAK) +- **fix(model):** local aliases override cross-proxy provider inference to prevent incorrect model resolution (#2223 — thanks @NomenAK) +- **fix(claudeHelper):** preserve latest assistant thinking blocks verbatim to prevent Anthropic HTTP 400 errors (#2224 — thanks @NomenAK) +- **fix(deepseek):** preserve `reasoning_content` through full pipeline for DeepSeek V4 models — prevents reasoning context loss on multi-turn conversations (#2231 — thanks @kang-heewon) +- **fix(sse-heartbeat):** shape-aware keepalives keep streams alive through stricter proxies (#2233 — thanks @NomenAK) +- **fix(translator):** coerce `submit_pr_review` `functionalChanges`/`findings` to arrays to prevent upstream schema errors (#2242 — thanks @NomenAK) +- **fix(api):** validate model cooldown delete payload +- **fix(ci):** run coverage gate serially, align resilience and thinking checks, align cloud code thinking and model catalog tests ### 🔒 Security +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) +- **fix(security):** sanitize error messages in API routes to prevent stack trace exposure (CodeQL js/stack-trace-exposure) (#2209) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### 📝 Documentation + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) +- **docs:** add Brazilian WhatsApp group link to README (#2201 — thanks @rafacpti23) + +### 🔧 Improvements + +- **refactor(executor):** `sanitizeReasoningEffortForProvider()` hook in `BaseExecutor.execute()` — downgrades `xhigh`→`high` for unsupporting providers, strips effort for mistral/devstral and github claude models (#2162 — thanks @hachimed) +- **refactor(translator):** remove redundant provider guard from Claude thinking placeholder injection — applies to all `targetFormat === FORMATS.CLAUDE` bodies (#2161 — thanks @JohnDoe-oss) +- **refactor(catalog):** remove 11 `.ts` extension imports, eliminate all `as any` casts, add `CustomModelEntry` interface and `ComboModelStep` type predicate, normalize alias resolution with `resolveCanonicalProviderId()` (#2152 — thanks @herjarsa) +- **feat(resilience):** `useUpstream429BreakerHints` tri-state PATCH field — `true`/`false` persists, `null` resets to undefined (omitted from JSON) (#2146 tests — thanks @rafacpti23) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **chore(providers):** improve BazaarLink and Completions.me support (#2177 — thanks @backryun) +- **chore(registry):** refresh `contextLength` and `maxOutputTokens` for claude, kiro, github, kimi-coding, xiaomi-mimo, codex/gpt-5.5 models (#2163 — thanks @brucevoin) +- **chore(models):** tidy up Alibaba Coding Plan base URL, reorganize Cursor model list by family, fix `gpt-4o` model ID, update OpenCode Zen model (#2150 — thanks @backryun) +- **chore(deps):** resolve npm audit moderate vulnerability (hono) +- **chore(deps):** move `gray-matter` from devDependencies to dependencies (runtime requirement) (#2156 — thanks @bypanghu) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2065, #2079) +- **deps:** bump the development group with 6 updates (#2184) +- **deps:** bump `electron-builder` from 26.9.1 to 26.10.0 (#2183) +- **ci:** update build-fork workflow to build from main branch (#2055) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +- **build(deps):** regenerate `package-lock.json` to match `http-proxy-middleware` 4.x bump (#2228 — thanks @NomenAK) +- **fix(requestLogger):** exempt tools field from array truncation for full debug visibility (#2234 — thanks @NomenAK) + +### 🏆 v3.8.0 Community Contributors + +Thank you to all **55+ community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :--------------------------------------------------------------------------------- | +| [@NomenAK](https://github.com/NomenAK) | 12 | #2217, #2218, #2219, #2221, #2222, #2223, #2224, #2228, #2233, #2234, #2242, #2192 | +| [@oyi77](https://github.com/oyi77) | 12 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096, #2131, #2135, #2240 | +| [@backryun](https://github.com/backryun) | 8 | #1992, #2033, #2088, #2123, #2138, #2141, #2150, #2177 | +| [@Brkic-Nikola](https://github.com/Brkic-Nikola) | 6 | #2165, #2189, #2190, #2191, #2192, #2197 | +| [@Gioxaa](https://github.com/Gioxaa) | 5 | #2105, #2149, #2153, #2154, #2159 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@andrewmunsell](https://github.com/andrewmunsell) | 3 | #2169, #2176, #2238 | +| [@ddarkr](https://github.com/ddarkr) | 3 | #2047, #2199, #2243 | +| [@nickwizard](https://github.com/nickwizard) | 3 | #1991, #2196, #2227 | +| [@herjarsa](https://github.com/herjarsa) | 3 | #2030, #2136, #2152 | +| [@rafacpti23](https://github.com/rafacpti23) | 3 | #2086, #2146, #2201 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@hartmark](https://github.com/hartmark) | 2 | #2045, #2137 | +| [@payne0420](https://github.com/payne0420) | 2 | #2082, #2128 | +| [@bypanghu](https://github.com/bypanghu) | 2 | #2027, #2156 | +| [@eleata](https://github.com/eleata) | 2 | #2116, #2133 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@christlau](https://github.com/christlau) | 1 | #2129 | +| [@flyingmongoose](https://github.com/flyingmongoose) | 1 | #2134 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | +| [@DavyMassoneto](https://github.com/DavyMassoneto) | 1 | #2140 | +| [@Zhaba1337228](https://github.com/Zhaba1337228) | 1 | #2168 | +| [@faisalill](https://github.com/faisalill) | 1 | #2166 | +| [@Yosee11](https://github.com/Yosee11) | 1 | #2164 | +| [@hachimed](https://github.com/hachimed) | 1 | #2162 | +| [@JohnDoe-oss](https://github.com/JohnDoe-oss) | 1 | #2161 | +| [@brucevoin](https://github.com/brucevoin) | 1 | #2163 | +| [@InkshadeWoods](https://github.com/InkshadeWoods) | 1 | #2202 | +| [@kang-heewon](https://github.com/kang-heewon) | 1 | #2231 | +| [@one-vs](https://github.com/one-vs) | 1 | #2236 | ## [3.7.9] — 2026-05-03 @@ -1192,7 +1413,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes diff --git a/CLAUDE.md b/CLAUDE.md index 3859b9c779..0e1dd1a49e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -11,7 +11,7 @@ npm run build # Production build (Next.js 16 standalone) npm run lint # ESLint (0 errors expected; warnings are pre-existing) npm run typecheck:core # TypeScript check (should be clean) npm run typecheck:noimplicit:core # Strict check (no implicit any) -npm run test:coverage # Unit tests + coverage gate (60% min) +npm run test:coverage # Unit tests + coverage gate (75/75/75/70 — statements/lines/functions/branches) npm run check # lint + test combined npm run check:cycles # Detect circular dependencies ``` @@ -37,20 +37,20 @@ For full test matrix, see `CONTRIBUTING.md` → "Running Tests". For deep archit **OmniRoute** — unified AI proxy/router. One endpoint, 160+ LLM providers, auto-fallback. -| Layer | Location | Purpose | -| ------------- | ----------------------- | ------------------------------------------ | -| API Routes | `src/app/api/v1/` | Next.js App Router — entry points | -| Handlers | `open-sse/handlers/` | Request processing (chat, embeddings, etc) | -| Executors | `open-sse/executors/` | Provider-specific HTTP dispatch | -| Translators | `open-sse/translator/` | Format conversion (OpenAI↔Claude↔Gemini) | -| Transformer | `open-sse/transformer/` | Responses API ↔ Chat Completions | -| Services | `open-sse/services/` | Combo routing, rate limits, caching, etc | -| Database | `src/lib/db/` | SQLite domain modules (22 files) | -| Domain/Policy | `src/domain/` | Policy engine, cost rules, fallback logic | -| MCP Server | `open-sse/mcp-server/` | 29 tools, 3 transports, 10 scopes | -| A2A Server | `src/lib/a2a/` | JSON-RPC 2.0 agent protocol | -| Skills | `src/lib/skills/` | Extensible skill framework | -| Memory | `src/lib/memory/` | Persistent conversational memory | +| Layer | Location | Purpose | +| ------------- | ----------------------- | ------------------------------------------------------------------ | +| API Routes | `src/app/api/v1/` | Next.js App Router — entry points | +| Handlers | `open-sse/handlers/` | Request processing (chat, embeddings, etc) | +| Executors | `open-sse/executors/` | Provider-specific HTTP dispatch | +| Translators | `open-sse/translator/` | Format conversion (OpenAI↔Claude↔Gemini) | +| Transformer | `open-sse/transformer/` | Responses API ↔ Chat Completions | +| Services | `open-sse/services/` | Combo routing, rate limits, caching, etc | +| Database | `src/lib/db/` | SQLite domain modules (45+ files, 55 migrations) | +| Domain/Policy | `src/domain/` | Policy engine, cost rules, fallback logic | +| MCP Server | `open-sse/mcp-server/` | 37 tools (30 base + 3 memory + 4 skills), 3 transports, ~13 scopes | +| A2A Server | `src/lib/a2a/` | JSON-RPC 2.0 agent protocol | +| Skills | `src/lib/skills/` | Extensible skill framework | +| Memory | `src/lib/memory/` | Persistent conversational memory | Monorepo: `src/` (Next.js 16 app), `open-sse/` (streaming engine workspace), `electron/` (desktop app), `tests/`, `bin/` (CLI entry point). @@ -72,14 +72,17 @@ Client → /v1/chat/completions (Next.js route) API routes follow a consistent pattern: `Route → CORS preflight → Zod body validation → Optional auth (extractApiKey/isValidApiKey) → API key policy enforcement → Handler delegation (open-sse)`. No global Next.js middleware — interception is route-specific. -**Combo routing** (`open-sse/services/combo.ts`): 13 strategies (priority, weighted, fill-first, round-robin, P2C, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay). Each target calls `handleSingleModel()` which wraps `handleChatCore()` with per-target error handling and circuit breaker checks. +**Combo routing** (`open-sse/services/combo.ts`): 14 strategies (priority, weighted, fill-first, round-robin, P2C, random, least-used, cost-optimized, reset-aware, strict-random, auto, lkgp, context-optimized, context-relay). Each target calls `handleSingleModel()` which wraps `handleChatCore()` with per-target error handling and circuit breaker checks. See `docs/routing/AUTO-COMBO.md` for the 9-factor Auto-Combo scoring and `docs/architecture/RESILIENCE_GUIDE.md` for the 3 resilience layers. --- ## Resilience Runtime State OmniRoute has three related but distinct temporary-failure mechanisms. Keep their -scope separate when debugging routing behavior. +scope separate when debugging routing behavior. See the +[3-layer resilience diagram](./docs/diagrams/exported/resilience-3layers.svg) +(source: [docs/diagrams/resilience-3layers.mmd](./docs/diagrams/resilience-3layers.mmd)) +for an at-a-glance map. ### Provider Circuit Breaker @@ -280,31 +283,78 @@ connection continue serving other models. ### Adding a New A2A Skill -1. Create skill in `src/lib/a2a/skills/` +1. Create skill in `src/lib/a2a/skills/` (5 already exist: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) 2. Skill receives task context (messages, metadata) → returns structured result -3. Register in the DB-backed skill registry -4. Write tests +3. Register in `A2A_SKILL_HANDLERS` in `src/lib/a2a/taskExecution.ts` +4. Expose in `src/app/.well-known/agent.json/route.ts` (Agent Card) +5. Write tests in `tests/unit/` +6. Document in `docs/frameworks/A2A-SERVER.md` skill table + +### Adding a New Cloud Agent + +1. Create agent class in `src/lib/cloudAgent/agents/` extending `CloudAgentBase` (3 already exist: codex-cloud, devin, jules) +2. Implement `createTask`, `getStatus`, `approvePlan`, `sendMessage`, `listSources` +3. Register in `src/lib/cloudAgent/registry.ts` +4. Add OAuth/credentials handling if needed (`src/lib/oauth/providers/`) +5. Tests + document in `docs/frameworks/CLOUD_AGENT.md` + +### Adding a New Guardrail / Eval / Skill / Webhook event + +- Guardrail: `src/lib/guardrails/` → docs: `docs/security/GUARDRAILS.md` +- Eval suite: `src/lib/evals/` → docs: `docs/frameworks/EVALS.md` +- Skill (sandbox): `src/lib/skills/` → docs: `docs/frameworks/SKILLS.md` +- Webhook event: `src/lib/webhookDispatcher.ts` → docs: `docs/frameworks/WEBHOOKS.md` + +--- + +## Reference Documentation + +For any non-trivial change, read the matching deep-dive first: + +| Area | Doc | +| -------------------------------------------- | ----------------------------------------------------------------- | +| Repo navigation | `docs/architecture/REPOSITORY_MAP.md` | +| Architecture | `docs/architecture/ARCHITECTURE.md` | +| Engineering reference | `docs/architecture/CODEBASE_DOCUMENTATION.md` | +| Auto-Combo (9-factor scoring, 14 strategies) | `docs/routing/AUTO-COMBO.md` | +| Resilience (3 mechanisms) | `docs/architecture/RESILIENCE_GUIDE.md` | +| Reasoning replay | `docs/routing/REASONING_REPLAY.md` | +| Skills framework | `docs/frameworks/SKILLS.md` | +| Memory system (FTS5 + Qdrant) | `docs/frameworks/MEMORY.md` | +| Cloud agents | `docs/frameworks/CLOUD_AGENT.md` | +| Guardrails (PII / injection / vision) | `docs/security/GUARDRAILS.md` | +| Evals | `docs/frameworks/EVALS.md` | +| Compliance / audit | `docs/security/COMPLIANCE.md` | +| Webhooks | `docs/frameworks/WEBHOOKS.md` | +| Authorization pipeline | `docs/architecture/AUTHZ_GUIDE.md` | +| Stealth (TLS / fingerprint) | `docs/security/STEALTH_GUIDE.md` | +| Agent protocols (A2A / ACP / Cloud) | `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md` | +| MCP server | `docs/frameworks/MCP-SERVER.md` | +| A2A server | `docs/frameworks/A2A-SERVER.md` | +| API reference + OpenAPI | `docs/reference/API_REFERENCE.md` + `docs/reference/openapi.yaml` | +| Provider catalog (auto-generated) | `docs/reference/PROVIDER_REFERENCE.md` | +| Release flow | `docs/ops/RELEASE_CHECKLIST.md` | --- ## Testing -| What | Command | -| ----------------------- | ------------------------------------------------------ | -| Unit tests | `npm run test:unit` | -| Single file | `node --import tsx/esm --test tests/unit/file.test.ts` | -| Vitest (MCP, autoCombo) | `npm run test:vitest` | -| E2E (Playwright) | `npm run test:e2e` | -| Protocol E2E (MCP+A2A) | `npm run test:protocols:e2e` | -| Ecosystem | `npm run test:ecosystem` | -| Coverage gate | `npm run test:coverage` (60% min all metrics) | -| Coverage report | `npm run coverage:report` | +| What | Command | +| ----------------------- | --------------------------------------------------------------------------- | +| Unit tests | `npm run test:unit` | +| Single file | `node --import tsx/esm --test tests/unit/file.test.ts` | +| Vitest (MCP, autoCombo) | `npm run test:vitest` | +| E2E (Playwright) | `npm run test:e2e` | +| Protocol E2E (MCP+A2A) | `npm run test:protocols:e2e` | +| Ecosystem | `npm run test:ecosystem` | +| Coverage gate | `npm run test:coverage` (75/75/75/70 — statements/lines/functions/branches) | +| Coverage report | `npm run coverage:report` | **PR rule**: If you change production code in `src/`, `open-sse/`, `electron/`, or `bin/`, you must include or update tests in the same PR. **Test layer preference**: unit first → integration (multi-module or DB state) → e2e (UI/workflow only). Encode bug reproductions as automated tests before or alongside the fix. -**Copilot coverage policy**: When a PR changes production code and coverage is below 60%, do not just report — add or update tests, rerun the coverage gate, then ask for confirmation. Include commands run, changed test files, and final coverage result in the PR report. +**Copilot coverage policy**: When a PR changes production code and coverage is below 75% (statements/lines/functions) or 70% (branches), do not just report — add or update tests, rerun the coverage gate, then ask for confirmation. Include commands run, changed test files, and final coverage result in the PR report. --- @@ -350,4 +400,5 @@ git push -u origin feat/your-feature 6. Never silently swallow errors in SSE streams 7. Always validate inputs with Zod schemas 8. Always include tests when changing production code -9. Coverage must stay ≥60% (statements, lines, functions, branches) +9. Coverage must stay ≥75% (statements, lines, functions) / ≥70% (branches). Current measured: ~82%. +10. Never bypass Husky hooks (`--no-verify`, `--no-gpg-sign`) without explicit operator approval. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 18c9147181..cd05342036 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -17,23 +17,23 @@ diverse, inclusive, and healthy community. Examples of behavior that contributes to a positive environment for our community include: -* Demonstrating empathy and kindness toward other people -* Being respectful of differing opinions, viewpoints, and experiences -* Giving and gracefully accepting constructive feedback -* Accepting responsibility and apologizing to those affected by our mistakes, +- Demonstrating empathy and kindness toward other people +- Being respectful of differing opinions, viewpoints, and experiences +- Giving and gracefully accepting constructive feedback +- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience -* Focusing on what is best not just for us as individuals, but for the +- Focusing on what is best not just for us as individuals, but for the overall community Examples of unacceptable behavior include: -* The use of sexualized language or imagery, and sexual attention or +- The use of sexualized language or imagery, and sexual attention or advances of any kind -* Trolling, insulting or derogatory comments, and personal or political attacks -* Public or private harassment -* Publishing others' private information, such as a physical or email +- Trolling, insulting or derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or email address, without their explicit permission -* Other conduct which could reasonably be considered inappropriate in a +- Other conduct which could reasonably be considered inappropriate in a professional setting ## Enforcement Responsibilities @@ -59,8 +59,11 @@ representative at an online or offline event. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be -reported to the community leaders responsible for enforcement at -. +reported to the community leaders responsible for enforcement by opening a +private security advisory at +<https://github.com/diegosouzapw/OmniRoute/security/advisories/new> +or by emailing the maintainer at diegosouza.pw@outlook.com. +For security-sensitive incidents, see [`SECURITY.md`](SECURITY.md). All complaints will be reviewed and investigated promptly and fairly. All community leaders are obligated to respect the privacy and security of the @@ -106,7 +109,7 @@ Violating these terms may lead to a permanent ban. ### 4. Permanent Ban **Community Impact**: Demonstrating a pattern of violation of community -standards, including sustained inappropriate behavior, harassment of an +standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals. **Consequence**: A permanent ban from any sort of public interaction within @@ -115,8 +118,8 @@ the community. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], -version 2.0, available at -https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. +version 2.1, available at +https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 345a73bbb3..b81ddc496d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -108,7 +108,7 @@ test: add observability unit tests refactor(db): consolidate rate limit tables ``` -Scopes: `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, `memory`, `skills`. +Scopes (v3.8): `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, `memory`, `skills`, `cloud-agent`, `guardrails`, `compression`, `auto-combo`, `resilience`, `providers`, `executors`, `translator`, `domain`, `authz`. --- @@ -149,7 +149,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -208,7 +208,7 @@ src/ # TypeScript (.ts / .tsx) ├── mitm/ # MITM proxy (cert, DNS, target routing) ├── shared/ │ ├── components/ # React components (.tsx) -│ ├── constants/ # Provider definitions (60+), MCP scopes, routing strategies +│ ├── constants/ # Provider definitions (177), MCP scopes, 14 routing strategies │ ├── utils/ # Circuit breaker, sanitizer, auth helpers │ └── validation/ # Zod v4 schemas └── sse/ # SSE proxy pipeline @@ -301,7 +301,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/Dockerfile b/Dockerfile index ee090131d8..bf41ee8585 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ -FROM node:24.15.0-trixie-slim AS builder +FROM node:26.1.0-trixie-slim AS builder WORKDIR /app RUN apt-get update \ @@ -6,9 +6,9 @@ RUN apt-get update \ && rm -rf /var/lib/apt/lists/* COPY package*.json ./ -COPY scripts/postinstall.mjs ./scripts/postinstall.mjs -COPY scripts/postinstallSupport.mjs ./scripts/postinstallSupport.mjs -COPY scripts/native-binary-compat.mjs ./scripts/native-binary-compat.mjs +COPY scripts/build/postinstall.mjs ./scripts/build/postinstall.mjs +COPY scripts/build/postinstallSupport.mjs ./scripts/build/postinstallSupport.mjs +COPY scripts/build/native-binary-compat.mjs ./scripts/build/native-binary-compat.mjs ENV NPM_CONFIG_LEGACY_PEER_DEPS=true RUN if [ -f package-lock.json ]; then \ npm ci --no-audit --no-fund --legacy-peer-deps; \ @@ -19,7 +19,7 @@ RUN if [ -f package-lock.json ]; then \ COPY . ./ RUN mkdir -p /app/data && npm run build -- --webpack -FROM node:24.15.0-trixie-slim AS runner-base +FROM node:26.1.0-trixie-slim AS runner-base WORKDIR /app LABEL org.opencontainers.image.title="omniroute" \ @@ -56,21 +56,21 @@ COPY --from=builder /app/src/lib/db/migrations ./migrations ENV OMNIROUTE_MIGRATIONS_DIR=/app/migrations # MITM server.cjs is spawned at runtime via child_process — not traced by nft COPY --from=builder /app/src/mitm/server.cjs ./src/mitm/server.cjs -# OpenAPI spec is read from disk by /api/openapi/spec at runtime for the -# Endpoints dashboard. Next.js standalone tracing does not include it. -COPY --from=builder /app/docs/openapi.yaml ./docs/openapi.yaml +# Documentation files and OpenAPI spec are read from disk at runtime. +# Next.js standalone tracing does not include them. +COPY --from=builder /app/docs ./docs -COPY --from=builder /app/scripts/run-standalone.mjs ./run-standalone.mjs -COPY --from=builder /app/scripts/runtime-env.mjs ./runtime-env.mjs -COPY --from=builder /app/scripts/bootstrap-env.mjs ./bootstrap-env.mjs -COPY --from=builder /app/scripts/healthcheck.mjs ./healthcheck.mjs +COPY --from=builder /app/scripts/dev/run-standalone.mjs ./dev/run-standalone.mjs +COPY --from=builder /app/scripts/build/runtime-env.mjs ./build/runtime-env.mjs +COPY --from=builder /app/scripts/build/bootstrap-env.mjs ./build/bootstrap-env.mjs +COPY --from=builder /app/scripts/dev/healthcheck.mjs ./healthcheck.mjs EXPOSE 20128 HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \ CMD ["node", "healthcheck.mjs"] -CMD ["node", "run-standalone.mjs"] +CMD ["node", "dev/run-standalone.mjs"] FROM runner-base AS runner-cli diff --git a/GEMINI.md b/GEMINI.md index 9679e126ad..64525f17e2 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -1,21 +1,50 @@ # Security and Cleanliness Rules for AI Assistants +> **Scope:** rules for Gemini-based agents. For Claude Code, see `CLAUDE.md`. For other AI assistants, see `AGENTS.md`. + ## 1. File Placement & Organization - **Test Files**: ALL unit tests, integration tests, ecosystem tests, or Vitest files MUST strictly be placed within the `tests/` directory (e.g., `tests/unit/`, `tests/integration/`). NEVER create test files in the project root (`/`). -- **Scripts and Utilities**: ALL maintenance, debugging, generation, or experimental scripts (`.cjs`, `.mjs`, `.js`, `.ts`) MUST be placed strictly inside the `scripts/` directory or `scripts/scratch/` for temporary one-offs. NEVER dump loose scripts in the project root (`/`). +- **Scripts and Utilities**: ALL maintenance, debugging, generation, or experimental scripts (`.cjs`, `.mjs`, `.js`, `.ts`) MUST be placed strictly inside one of the `scripts/` subfolders (`build/`, `dev/`, `check/`, `docs/`, `i18n/`, `ad-hoc/`). One-shot or experimental code goes under `scripts/ad-hoc/`. NEVER dump loose scripts in the project root (`/`) or the top-level `scripts/` folder. **The Project Root MUST ONLY CONTAIN:** -- Configuration files (`vitest.config.ts`, `next.config.mjs`, `eslint.config.mjs`, etc.) +- Configuration files (`vitest.config.ts`, `next.config.mjs`, `eslint.config.mjs`, `tsconfig*.json`, `playwright.config.ts`, `prettier.config.mjs`, `postcss.config.mjs`, `sonar-project.properties`, `fly.toml`, `docker-compose*.yml`, `Dockerfile`) - Dependency files (`package.json`, `package-lock.json`) -- Documentation files (`README.md`, `CHANGELOG.md`, `AGENTS.md`) -- CI/CD files and ignore definitions (`.gitignore`, `.dockerignore`) +- Documentation files (`README.md`, `CHANGELOG.md`, `LICENSE`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, `llm.txt`, `Tuto_Qdrant.md`) +- CI/CD files and ignore definitions (`.gitignore`, `.dockerignore`, `.npmignore`, `.npmrc`, `.node-version`, `.nvmrc`, `.env.example`) -When creating _any_ validation tests or one-off logic scripts, default to using `scripts/scratch/` or the `tests/unit/` directories according to your goals. Do not pollute the `/` root context. +When creating _any_ validation tests or one-off logic scripts, default to using `scripts/ad-hoc/` or the `tests/unit/` directories according to your goals. Do not pollute the `/` root context. -## 2. VPS Dashboard Credentials +## 2. Hard Rules (mirror of `CLAUDE.md`) -| Environment | URL | Password | -| ----------- | ------------------------- | -------- | -| Local VPS | http://192.168.0.15:20128 | 123456 | +1. **Never commit secrets or credentials.** Use `.env` (auto-generated from `.env.example`) or a vault. Passwords, OAuth secrets, API keys, and Cookie values must never appear in committed files. +2. **Never add logic to `src/lib/localDb.ts`.** It is a re-export barrel only. +3. **Never use `eval()`, `new Function()`, or any implied eval.** ESLint enforces this. +4. **Never commit directly to `main`.** Use `feat/`, `fix/`, `refactor/`, `docs/`, `test/`, or `chore/` branches. +5. **Never write raw SQL in routes** — always go through `src/lib/db/` domain modules. +6. **Never silently swallow errors in SSE streams** — propagate them or abort the stream cleanly. +7. **Never bypass Husky hooks** (`--no-verify`, `--no-gpg-sign`) without explicit operator approval. +8. **Always validate inputs with Zod schemas** from `src/shared/validation/schemas.ts`. +9. **Always include tests when changing production code** (`src/`, `open-sse/`, `electron/`, `bin/`). +10. **Coverage must stay** ≥ 75 % statements / 75 % lines / 75 % functions / 70 % branches (real measured: ~82 %). + +## 3. Codebase navigation + +| Task | Read this first | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Understand the codebase | `docs/architecture/REPOSITORY_MAP.md` | +| Architecture overview | `docs/architecture/ARCHITECTURE.md` | +| Engineering reference | `docs/architecture/CODEBASE_DOCUMENTATION.md` | +| Add a feature | `CONTRIBUTING.md` + the matching `docs/<area>.md` | +| Per-area deep dives | `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/frameworks/CLOUD_AGENT.md`, `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/architecture/AUTHZ_GUIDE.md`, `docs/architecture/RESILIENCE_GUIDE.md`, `docs/routing/AUTO-COMBO.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md`, `docs/security/STEALTH_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md`, `docs/guides/ELECTRON_GUIDE.md`, `docs/reference/PROVIDER_REFERENCE.md` | +| Release flow | `docs/ops/RELEASE_CHECKLIST.md` | + +## 4. Local development access + +The dashboard is reachable at the operator's chosen URL/port (default `http://localhost:20128`). Credentials are operator-specific: + +- **Initial admin password** is read from the `INITIAL_PASSWORD` env var on first install (defaults to `CHANGEME` in `.env.example`; rotate immediately after first login). +- **Local VPS / shared dev environments**: ask the operator for the URL and current credentials — they live in their personal vault, NOT in this repo. + +> Any credential observed in a previous version of this file was a non-production demo value; treat it as compromised and do not reuse it. diff --git a/README.md b/README.md index d1dca716b4..e8458133b8 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,11 @@ _The most complete open-source AI proxy — **one endpoint**, **160+ providers**, **13 routing strategies**, zero downtime. Multi-platform: **Web**, **Desktop (Electron)**, **Mobile (PWA + Termux)**. Fully extensible via **MCP Server (37 tools)**, **A2A Protocol**, and **Memory/Skills** systems. Available in **40+ languages**._ -**Chat Completions • Responses API • Embeddings • Image Generation • Video • Music • Audio Speech/Transcription • Reranking • Moderations • Web Search • MCP Server • A2A Protocol • 4,600+ Tests • 100% TypeScript** +[![npm](https://img.shields.io/npm/v/omniroute?logo=npm&style=flat-square)](https://www.npmjs.com/package/omniroute) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) +[![Node](https://img.shields.io/badge/node-%E2%89%A522.22.2-brightgreen?style=flat-square)](package.json) +[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) +[![Trendshift](https://trendshift.io/api/badge/repositories/23589)](https://trendshift.io/repositories/23589) <br/> @@ -1031,6 +1035,34 @@ Combo: "my-coding-stack" Format Translation: ## 🎯 Use Cases — Ready-Made Combo Playbooks +### Case 0: "I want zero-config, auto-routing NOW" + +**Problem:** Don't want to create combos manually. Just want AI routing to work immediately. + +```bash +# No combo creation needed! Use auto/ prefix directly: +model: "auto" # Default LKGP routing across all connected providers +model: "auto/coding" # Quality-first weights for code generation +model: "auto/fast" # Low-latency routing (fastest provider first) +model: "auto/cheap" # Cost-optimized (cheapest per token) +model: "auto/offline" # High availability (most quota available) +model: "auto/smart" # Best discovery (10% exploration rate) +``` + +**How it works:** + +1. Add providers in Dashboard → Providers (OAuth or API key) +2. Use `auto/` prefix in any AI tool — **no combo creation needed** +3. OmniRoute dynamically builds a virtual combo from your active connections +4. Routes using LKGP (Last Known Good Provider) + 6-factor scoring +5. Session stickiness ensures consistent provider selection + +**Dashboard indicator:** A blue banner at the top shows "Auto-Routing Active" with a link to `/dashboard/combos` for configuration. + +**Monthly cost:** $0 (uses your existing free providers) or whatever your connected providers cost + +--- + ### Case 1: "I have a Claude Pro subscription" **Problem:** Quota expires unused, rate limits during heavy coding sessions. @@ -1514,8 +1546,10 @@ MIT License - see [LICENSE](LICENSE) for details. --- <div align="center"> - <sub>Built with ❤️ for developers who code 24/7</sub> - <br/> - <sub><a href="https://omniroute.online">omniroute.online</a></sub> + +**[⬆ Back to top](#-omniroute)** · Built with ❤️ for the open-source AI community. + +<sub>OmniRoute v3.8.0 · Node ≥22.22.2 · MIT License · <a href="https://omniroute.online">omniroute.online</a></sub> + </div> <!-- GitHub Discussions enabled for community Q&A --> diff --git a/SECURITY.md b/SECURITY.md index 9b8e8652d8..72c81017d4 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -20,9 +20,9 @@ If you discover a security vulnerability in OmniRoute, please report it responsi | Version | Support Status | | ------- | -------------- | -| 3.6.x | ✅ Active | -| 3.5.x | ✅ Security | -| < 3.5.0 | ❌ Unsupported | +| 3.8.x | ✅ Active | +| 3.7.x | ✅ Security | +| < 3.7.0 | ❌ Unsupported | --- @@ -31,19 +31,22 @@ If you discover a security vulnerability in OmniRoute, please report it responsi OmniRoute implements a multi-layered security model: ``` -Request → CORS → API Key Auth → Prompt Injection Guard → Input Sanitizer → Rate Limiter → Circuit Breaker → Provider +Request → CORS → Authz pipeline (classify → policies → enforce) + → Guardrails (PII masker, prompt injection, vision bridge) + → Rate Limiter → Circuit Breaker → Cooldown → Model Lockout → Provider ``` ### 🔐 Authentication & Authorization -| Feature | Implementation | -| -------------------- | ---------------------------------------------------------- | -| **Dashboard Login** | Password-based auth with JWT tokens (HttpOnly cookies) | -| **API Key Auth** | HMAC-signed keys with CRC validation | -| **OAuth 2.0 + PKCE** | Secure provider auth (Claude, Codex, Gemini, Cursor, etc.) | -| **Token Refresh** | Automatic OAuth token refresh before expiry | -| **Secure Cookies** | `AUTH_COOKIE_SECURE=true` for HTTPS environments | -| **MCP Scopes** | 10 granular scopes for MCP tool access control | +| Feature | Implementation | +| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | +| **Dashboard Login** | Password-based auth with JWT tokens (HttpOnly cookies) | +| **API Key Auth** | HMAC-signed keys with CRC validation | +| **OAuth 2.0 + PKCE** | 14 providers (Claude, Codex, GitHub, Cursor, Antigravity, Gemini, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Windsurf, GitLab Duo) | +| **Token Refresh** | Automatic OAuth token refresh before expiry | +| **Secure Cookies** | `AUTH_COOKIE_SECURE=true` for HTTPS environments | +| **Authz Pipeline** | Route classification (PUBLIC / CLIENT_API / MANAGEMENT) — see `docs/architecture/AUTHZ_GUIDE.md` | +| **MCP Scopes** | ~13 granular scopes (read:health, write:combos, execute:completions, etc.) — see `docs/frameworks/MCP-SERVER.md` | ### 🛡️ Encryption at Rest @@ -58,6 +61,18 @@ All sensitive data stored in SQLite is encrypted using **AES-256-GCM** with scry STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) ``` +### 🛡️ Guardrails Framework + +OmniRoute ships a hot-reloadable **guardrails registry** (`src/lib/guardrails/`) with 3 built-in guardrails ordered by priority: + +| Guardrail | Priority | Purpose | +| ------------------ | -------- | --------------------------------------------------------------------------------------- | +| `vision-bridge` | 5 | Bridges non-vision models with image-aware descriptions; SSRF protection for image URLs | +| `pii-masker` | 10 | Pre+post call PII redaction (emails, phone, CPF, CNPJ, credit cards, SSN) | +| `prompt-injection` | 20 | Detects override/role-hijack/jailbreak/leak patterns | + +Custom guardrails register via `registerGuardrail(new MyGuardrail())`. The model is fail-open (exceptions never block traffic). Per-request opt-out via `x-omniroute-disabled-guardrails` header. → See [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md). + ### 🧠 Prompt Injection Guard Middleware that detects and blocks prompt injection attacks in LLM requests: @@ -168,8 +183,30 @@ docker run -d \ ## Dependencies -- Run `npm audit` regularly +- Run `npm audit` regularly (`npm run audit:deps` covers main + electron) - Keep dependencies updated -- The project uses `husky` + `lint-staged` for pre-commit checks -- CI pipeline runs ESLint security rules on every push -- Provider constants validated at module load via Zod (`src/shared/validation/providerSchema.ts`) +- The project uses `husky` + `lint-staged` for pre-commit checks (lint-staged + check-docs-sync + check:any-budget:t11) +- CI pipeline runs ESLint security rules on every push (`no-eval`, `no-implied-eval`, `no-new-func` = error) +- Provider constants validated at module load via Zod (`src/shared/validation/schemas.ts`) +- Secure-by-default libraries used: `dompurify` / `isomorphic-dompurify` (XSS), `jose` (JWT), `better-sqlite3` (no SQLi risk via parameterized queries), `bcryptjs` (password hashing) + +## Hard Security Rules + +These rules are enforced by tooling and reviewers: + +1. **Never commit secrets** — `.env` is gitignored; `.env.example` is the template +2. **Never use `eval()`, `new Function()`, or implied eval** — ESLint enforces +3. **Never bypass Husky hooks** (`--no-verify`, `--no-gpg-sign`) without explicit operator approval +4. **Never write raw SQL in routes** — always go through `src/lib/db/` (parameterized) +5. **Always validate inputs with Zod** — `src/shared/validation/schemas.ts` +6. **Always sanitize upstream headers** — denylist in `src/shared/constants/upstreamHeaders.ts` +7. **Encrypt credentials at rest** — AES-256-GCM via `src/lib/db/encryption.ts` + +## References + +- [`docs/architecture/AUTHZ_GUIDE.md`](docs/architecture/AUTHZ_GUIDE.md) — authorization pipeline +- [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md) — guardrails framework +- [`docs/security/COMPLIANCE.md`](docs/security/COMPLIANCE.md) — audit log and retention +- [`docs/architecture/RESILIENCE_GUIDE.md`](docs/architecture/RESILIENCE_GUIDE.md) — circuit breaker + cooldown + lockout +- [`docs/security/STEALTH_GUIDE.md`](docs/security/STEALTH_GUIDE.md) — TLS fingerprinting (legal/ethical notice) +- [`CLAUDE.md`](CLAUDE.md) — hard rules for AI agents diff --git a/Tuto_Qdrant.MD b/Tuto_Qdrant.md similarity index 67% rename from Tuto_Qdrant.MD rename to Tuto_Qdrant.md index d38abf1c47..3abe4a4313 100644 --- a/Tuto_Qdrant.MD +++ b/Tuto_Qdrant.md @@ -1,9 +1,19 @@ # Tutorial Qdrant no OmniRoute (Guia para vídeo) +> ⚠️ **Status (v3.8.0):** Integração Qdrant está **dormente** no pipeline. As funções de upsert/search/delete existem em `src/lib/memory/qdrant.ts` e a UI de configuração está pronta (`MemorySkillsTab.tsx` + endpoint `/api/settings/qdrant/embedding-models`), mas: +> +> - `upsertSemanticMemoryPoint`, `searchSemanticMemory` e `deleteSemanticMemoryPoint` **não são chamadas** pelo pipeline de chat — busca semântica corrente usa apenas o store local em SQLite (ver `docs/frameworks/MEMORY.md`). +> - As rotas `/api/settings/qdrant/health`, `/api/settings/qdrant/search` e `/api/settings/qdrant/cleanup` mencionadas neste tutorial **ainda não foram implementadas**. +> - Os botões "Testar conexão" e "Teste de busca" no painel exigem que essas rotas existam; até lá, são placeholders. +> +> Este documento descreve a UX/configuração planejada. Para o sistema de memória ativo hoje, consulte [`docs/frameworks/MEMORY.md`](docs/frameworks/MEMORY.md). Acompanhe o status da ativação em issues marcadas com `area:qdrant`. + ## 1) O que é o Qdrant no OmniRoute + O Qdrant é o banco vetorial usado para memória semântica. No OmniRoute, ele ajuda a: + - Encontrar contexto por significado (não só palavra exata). - Reaproveitar memórias antigas com mais precisão. - Melhorar respostas com base em histórico relevante. @@ -12,38 +22,48 @@ No OmniRoute, ele ajuda a: --- ## 2) Quando o OmniRoute envia dados para o Qdrant + Com Qdrant habilitado e modelo de embedding configurado, o sistema envia vetores quando: + - Memórias são salvas (upsert de memória). - Fluxos de chat recuperam contexto semântico/híbrido. - Testes de busca no painel geram embedding e consultam a coleção. Resumo prático: + - Sem Qdrant: busca mais limitada (texto/chave). - Com Qdrant: busca por similaridade semântica (mais inteligente). --- ## 3) Pré-requisitos + Você precisa de: + - Instância Qdrant acessível (porta 6333). - Coleção criada (ex.: `omniroute_memory`). - Modelo de embedding válido (ex.: OpenRouter). - Credencial do provider do embedding configurada no OmniRoute. Exemplo de modelo OpenRouter: + - `openrouter/nvidia/llama-nemotron-embed-v1-1b-v2:free` Importante: + - O texto do modelo deve estar em formato `provider/model`. - Se usar modelo com dimensão diferente da coleção, a busca falha. --- ## 4) Como configurar no painel do OmniRoute + No menu: + - `Admin > Settings > Qdrant (Memória vetorial)` Preencha: + - `Ativar Qdrant`: ligado. - `Host`: IP ou URL do servidor Qdrant (sem porta no campo Host). - `Porta`: `6333`. @@ -52,6 +72,7 @@ Preencha: - `API Key`: opcional (preencha se seu Qdrant exigir). Depois: + 1. Clique em `Salvar`. 2. Clique em `Testar conexão`. 3. No `Teste de busca`, digite um texto e clique em `Buscar`. @@ -59,7 +80,9 @@ Depois: --- ## 5) Como criar a coleção no Dashboard do Qdrant (sem comando) + No Qdrant Dashboard: + 1. Clique em `Create collection`. 2. Escolha `Global search`. 3. Em tipo de busca, use `Custom`. @@ -70,21 +93,26 @@ No Qdrant Dashboard: 5. Salve a coleção com nome `omniroute_memory`. Se já tinha coleção com dimensão errada: + - Recrie a coleção com dimensão correta. --- ## 6) Como validar se está funcionando + Checklist rápido: + 1. `Testar conexão` no OmniRoute retorna OK. 2. Busca no painel retorna resultados (não “Sem resultados”). 3. No Qdrant Dashboard, aparecem pontos na coleção (payload + vector). 4. Resultados de chat passam a recuperar contexto mais relevante. Sinal clássico de problema: + - Dados entram no Qdrant, mas busca do painel não retorna nada. Causas comuns: + - Dimensão do vetor incompatível. - Nome do vetor diferente do esperado (`omniao`). - Modelo inválido/incompleto no campo de embedding. @@ -93,7 +121,9 @@ Causas comuns: --- ## 7) O que melhorou com esta atualização + Nesta melhoria do OmniRoute: + - Suporte a embeddings de qualquer provider compatível (não só OpenAI fixo). - Endpoint para carregar modelos de embedding na tela de configurações. - Campo manual para modelo custom quando não aparecer na lista. @@ -102,7 +132,9 @@ Nesta melhoria do OmniRoute: --- ## 8) Roteiro curto para seu vídeo + Sugestão de demo (3-5 minutos): + 1. Mostrar problema sem Qdrant (busca simples). 2. Abrir Settings e habilitar Qdrant. 3. Configurar host/porta/collection/modelo. @@ -112,25 +144,33 @@ Sugestão de demo (3-5 minutos): 7. Rodar um chat e mostrar melhoria de recuperação semântica. Mensagem final para a galera: + - "Qdrant no OmniRoute transforma memória de palavra-chave em memória por significado." --- ## 9) Referências de código (para equipe técnica) -- UI de configuração Qdrant: - - `src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx` -- Endpoint de modelos de embedding para Qdrant: - - `src/app/api/settings/qdrant/embedding-models/route.ts` -- Integração backend com Qdrant (health, upsert, search, cleanup): - - `src/lib/memory/qdrant.ts` -- Recuperação de memórias no fluxo de chat: - - `src/lib/memory/retrieval.ts` - - `open-sse/handlers/chatCore.ts` + +**Implementado:** + +- UI de configuração Qdrant: `src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx` +- Endpoint de modelos de embedding: `src/app/api/settings/qdrant/embedding-models/route.ts` +- Funções backend (definidas mas dormentes): `src/lib/memory/qdrant.ts` exporta `upsertSemanticMemoryPoint`, `searchSemanticMemory`, `deleteSemanticMemoryPoint` + +**Pendente para ativar a integração:** + +- Rotas API: `/api/settings/qdrant/health`, `/api/settings/qdrant/search`, `/api/settings/qdrant/cleanup` +- Wire-up no fluxo de chat: `src/lib/memory/retrieval.ts` e `open-sse/handlers/chatCore.ts` precisam chamar `searchSemanticMemory` quando Qdrant estiver habilitado nas settings +- Wire-up no save de memória: `src/lib/memory/extraction.ts` (ou camada equivalente) precisa chamar `upsertSemanticMemoryPoint` após persistir cada memória + +Para o sistema de memória ativo hoje (SQLite-only), ver [`docs/frameworks/MEMORY.md`](docs/frameworks/MEMORY.md). --- ## 10) Observação importante de segurança + Nunca exponha em vídeo: + - API key completa do OpenRouter. - Tokens reais de produção. - Endpoints internos sem proteção. diff --git a/audit-report.json b/audit-report.json deleted file mode 100644 index 0d8c271630..0000000000 --- a/audit-report.json +++ /dev/null @@ -1,48 +0,0 @@ -{ - "auditReportVersion": 2, - "vulnerabilities": { - "follow-redirects": { - "name": "follow-redirects", - "severity": "moderate", - "isDirect": false, - "via": [ - { - "source": 1116560, - "name": "follow-redirects", - "dependency": "follow-redirects", - "title": "follow-redirects leaks Custom Authentication Headers to Cross-Domain Redirect Targets", - "url": "https://github.com/advisories/GHSA-r4q5-vmmm-2653", - "severity": "moderate", - "cwe": ["CWE-200"], - "cvss": { - "score": 0, - "vectorString": null - }, - "range": "<=1.15.11" - } - ], - "effects": [], - "range": "<=1.15.11", - "nodes": ["node_modules/follow-redirects"], - "fixAvailable": true - } - }, - "metadata": { - "vulnerabilities": { - "info": 0, - "low": 0, - "moderate": 1, - "high": 0, - "critical": 0, - "total": 1 - }, - "dependencies": { - "prod": 421, - "dev": 480, - "optional": 158, - "peer": 480, - "peerOptional": 0, - "total": 1462 - } - } -} diff --git a/bin/cli-commands.mjs b/bin/cli-commands.mjs new file mode 100644 index 0000000000..9402eeeb96 --- /dev/null +++ b/bin/cli-commands.mjs @@ -0,0 +1,2853 @@ +#!/usr/bin/env node + +/** + * OmniRoute CLI - Production-grade CLI Integration Suite + * + * Commands: + * setup - Configure CLI tools to use OmniRoute + * doctor - Run health diagnostics + * status - Show comprehensive status + * logs - View application logs + * provider - Add OmniRoute as provider for tools + * config - Show current OmniRoute configuration + * test - Test provider/model connectivity + * update - Check for updates + */ + +import { + existsSync, + readFileSync, + writeFileSync, + mkdirSync, + readdirSync, + statSync, + copyFileSync, +} from "node:fs"; +import { join, dirname } from "node:path"; +import { fileURLToPath } from "node:url"; +import { homedir, platform, release } from "node:os"; +import { execSync, spawn } from "node:child_process"; +import { resolveStoragePath } from "./cli/data-dir.mjs"; +import { + ensureProviderSchema, + getProviderApiKey, + listProviderConnections, + upsertApiKeyProviderConnection, +} from "./cli/provider-store.mjs"; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = dirname(__filename); +const ROOT = join(__dirname, ".."); + +// ============================================================================ +// CONSTANTS +// ============================================================================ + +const DEFAULT_BASE_URL = "http://localhost:20128"; +const API_PORT = 20128; +const DASHBOARD_PORT = 20129; + +const CLI_TOOLS = { + claude: { + id: "claude", + name: "Claude Code", + command: "claude", + configPath: ".claude/settings.json", + type: "json", + }, + codex: { + id: "codex", + name: "Codex CLI", + command: "codex", + configPath: ".codex/config.toml", + type: "toml", + }, + opencode: { + id: "opencode", + name: "OpenCode", + command: "opencode", + configPath: ".config/opencode/opencode.json", + type: "json", + }, + cline: { + id: "cline", + name: "Cline", + command: "cline", + configPath: ".cline/data/globalState.json", + type: "json", + }, + kilo: { + id: "kilo", + name: "Kilo Code", + command: "kilocode", + configPath: ".config/kilocode/settings.json", + type: "json", + }, + continue: { + id: "continue", + name: "Continue", + command: "continue", + configPath: ".continue/config.json", + type: "json", + }, + openclaw: { + id: "openclaw", + name: "OpenClaw", + command: "openclaw", + configPath: ".openclaw/openclaw.json", + type: "json", + }, +}; + +const PROVIDER_HELP = { + opencode: `OpenCode configuration: +1. Add to ~/.config/opencode/opencode.json: +{ + "provider": { + "omniroute": { + "name": "OmniRoute", + "baseURL": "http://localhost:20128/v1" + } + } +} +2. Set environment: export OPENAI_API_KEY=your-key`, + + cursor: `Cursor configuration: +1. Open Cursor Settings +2. Go to Models → Add Model +3. Set Base URL to: http://localhost:20128/v1 +4. Set API Key to your OmniRoute key`, + + cline: `Cline configuration: +1. Open Cline Settings +2. Find "OpenAI Compatible" provider settings +3. Set Base URL: http://localhost:20128/v1 +4. Set API Key: your OmniRoute key`, + + vscode: `VS Code + MCP configuration: +1. Install Cline extension +2. Or use: omniroute --mcp for MCP server`, +}; + +// ============================================================================ +// UTILITY FUNCTIONS +// ============================================================================ + +function getHomeDir() { + return homedir(); +} + +function resolveConfigPath(relativePath) { + return join(getHomeDir(), relativePath); +} + +function execCommand(command, timeout = 3000) { + try { + const output = execSync(command, { + encoding: "utf8", + timeout, + stdio: ["pipe", "pipe", "pipe"], + }); + return { success: true, output: output.trim() }; + } catch (error) { + return { + success: false, + error: error.message, + code: error.status || error.signal, + }; + } +} + +function readJsonFile(filePath) { + try { + if (!existsSync(filePath)) return null; + const content = readFileSync(filePath, "utf8"); + return JSON.parse(content); + } catch (error) { + return null; + } +} + +function writeJsonFile(filePath, data) { + try { + const dir = dirname(filePath); + if (!existsSync(dir)) { + mkdirSync(dir, { recursive: true }); + } + writeFileSync(filePath, JSON.stringify(data, null, 2), "utf8"); + return true; + } catch (error) { + return false; + } +} + +function createBackup(filePath) { + if (!existsSync(filePath)) return null; + const backupPath = filePath + ".backup." + Date.now(); + try { + writeFileSync(backupPath, readFileSync(filePath), "utf8"); + return backupPath; + } catch { + return null; + } +} + +function colorize(text, color) { + const colors = { + green: "\x1b[32m", + red: "\x1b[31m", + yellow: "\x1b[33m", + blue: "\x1b[34m", + cyan: "\x1b[36m", + reset: "\x1b[0m", + dim: "\x1b[2m", + }; + return colors[color] ? `${colors[color]}${text}${colors.reset}` : text; +} + +function log(message, color = "reset") { + console.log(colorize(message, color)); +} + +function logSection(title) { + console.log("\n" + colorize("┌─ " + title + " ".repeat(50), "cyan")); +} + +function logEndSection() { + console.log(colorize("└" + "─".repeat(51), "cyan")); +} + +// ============================================================================ +// TOOL DETECTION +// ============================================================================ + +function detectInstalledTools() { + const results = []; + + for (const [id, tool] of Object.entries(CLI_TOOLS)) { + const result = execCommand(`which ${tool.command}`, 2000); + const installed = result.success; + let version = null; + + if (installed) { + const versionResult = execCommand(`${tool.command} --version`, 2000); + if (versionResult.success) { + version = versionResult.output.slice(0, 20); + } + } + + results.push({ + id, + name: tool.name, + installed, + version, + configPath: resolveConfigPath(tool.configPath), + configured: checkToolConfigured(id), + }); + } + + return results; +} + +function checkToolConfigured(toolId) { + const tool = CLI_TOOLS[toolId]; + if (!tool) return false; + + const configPath = resolveConfigPath(tool.configPath); + + try { + if (!existsSync(configPath)) return false; + + const content = readFileSync(configPath, "utf8").toLowerCase(); + const hasOmniRoute = + content.includes("omniroute") || + content.includes(`localhost:${API_PORT}`) || + content.includes(`127.0.0.1:${API_PORT}`); + return hasOmniRoute; + } catch { + return false; + } +} + +// ============================================================================ +// API FUNCTIONS +// ============================================================================ + +async function checkServerHealth() { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/health`, { + method: "GET", + signal: AbortSignal.timeout(3000), + }); + return res.ok; + } catch { + return false; + } +} + +async function getCliToolsStatusFromApi() { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/cli-tools/status`, { + method: "GET", + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + return await res.json(); + } + } catch {} + return null; +} + +async function getConsoleLogs(limit = 100, level = null) { + try { + const url = new URL(`${DEFAULT_BASE_URL}/api/logs/console`); + url.searchParams.set("limit", String(limit)); + if (level) url.searchParams.set("level", level); + + const res = await fetch(url.toString(), { + method: "GET", + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + return await res.json(); + } + } catch {} + return []; +} + +async function testProviderConnection(provider = "claude", model = "claude-sonnet-4-20250514") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/v1/chat/completions`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: "Bearer sk-omniroute-cli-test", + }, + body: JSON.stringify({ + model, + messages: [{ role: "user", content: "Hi" }], + max_tokens: 10, + }), + signal: AbortSignal.timeout(10000), + }); + + if (res.ok) { + const data = await res.json(); + return { success: true, response: data.choices?.[0]?.message?.content || "OK" }; + } else { + const error = await res.text(); + return { success: false, error: `HTTP ${res.status}: ${error.slice(0, 100)}` }; + } + } catch (error) { + return { success: false, error: error.message }; + } +} + +// ============================================================================ +// CONFIG MANAGEMENT +// ============================================================================ + +function configureTool(toolId, baseUrl, apiKey) { + const tool = CLI_TOOLS[toolId]; + if (!tool) { + return { success: false, error: "Unknown tool: " + toolId }; + } + + const configPath = tool.configPath; + const fullPath = resolveConfigPath(configPath); + + // Create backup first + const backupPath = createBackup(fullPath); + + try { + // Ensure directory exists + const dir = dirname(fullPath); + if (!existsSync(dir)) { + mkdirSync(dir, { recursive: true }); + } + + // Read existing config or create new + let config = {}; + if (existsSync(fullPath)) { + const content = readFileSync(fullPath, "utf8"); + if (tool.type === "json") { + config = JSON.parse(content); + } + } + + // Apply tool-specific configuration + switch (toolId) { + case "claude": + config.api = config.api || {}; + config.api.omniroute = { + baseUrl: `${baseUrl}/v1`, + apiKey: apiKey, + model: "claude-sonnet-4-20250514", + }; + break; + + case "codex": + // For TOML, we need to append/modify + const tomlContent = `[openai] +base_url = "${baseUrl}/v1" +api_key = "${apiKey}" +model = "gpt-4o" +`; + writeFileSync(fullPath, tomlContent, "utf8"); + return { success: true, configPath: fullPath, backupPath }; + + case "opencode": + config.provider = config.provider || {}; + config.provider.omniroute = { + name: "OmniRoute", + baseURL: `${baseUrl}/v1`, + apiKey: apiKey, + }; + break; + + case "cline": + config.openAiBaseUrl = `${baseUrl}/v1`; + config.openAiApiKey = apiKey; + config.actModeApiProvider = "openai"; + config.planModeApiProvider = "openai"; + break; + + case "kilo": + config.apiUrl = `${baseUrl}/v1`; + config.apiKey = apiKey; + break; + + case "continue": + config.models = config.models || []; + config.models.push({ + name: "OmniRoute", + provider: "openai-compatible", + apiKey: apiKey, + baseUrl: `${baseUrl}/v1`, + }); + break; + + case "openclaw": + config.OPENAI_BASE_URL = `${baseUrl}/v1`; + config.OPENAI_API_KEY = apiKey; + break; + } + + // Write JSON configs + if (tool.type === "json") { + writeFileSync(fullPath, JSON.stringify(config, null, 2), "utf8"); + } + + return { success: true, configPath: fullPath, backupPath }; + } catch (error) { + // Restore backup on failure + if (backupPath && existsSync(backupPath)) { + try { + writeFileSync(fullPath, readFileSync(backupPath), "utf8"); + } catch {} + } + return { success: false, error: error.message }; + } +} + +// ============================================================================ +// CONFIG SHOW +// ============================================================================ + +function getOmniRouteConfig() { + const config = { + port: API_PORT, + dashboardPort: DASHBOARD_PORT, + baseUrl: `http://localhost:${API_PORT}`, + dataDir: resolveConfigPath(".omniroute"), + requireApiKey: process.env.REQUIRE_API_KEY === "true", + logLevel: process.env.LOG_LEVEL || "info", + }; + + // Check for existing providers + try { + const dbPath = join(config.dataDir, "storage.sqlite"); + config.hasDatabase = existsSync(dbPath); + } catch { + config.hasDatabase = false; + } + + // Node version + config.nodeVersion = process.version; + config.platform = platform(); + config.osRelease = release(); + + return config; +} + +// ============================================================================ +// COMMAND IMPLEMENTATIONS +// ============================================================================ + +export async function runSubcommand(cmd, args) { + switch (cmd) { + case "setup": + await runSetup(args); + break; + case "doctor": + await runDoctor(args); + break; + case "status": + await runStatus(args); + break; + case "logs": + await runLogs(args); + break; + case "provider": + await runProvider(args); + break; + case "config": + await runConfig(args); + break; + case "test": + await runTest(args); + break; + case "update": + await runUpdate(args); + break; + case "serve": + await runServe(args); + break; + case "stop": + await runStop(args); + break; + case "restart": + await runRestart(args); + break; + case "keys": + await runKeys(args); + break; + case "models": + await runModels(args); + break; + case "combo": + await runCombo(args); + break; + case "completion": + await runCompletion(args); + break; + case "dashboard": + await runDashboard(args); + break; + case "backup": + await runBackup(args); + break; + case "restore": + await runRestore(args); + break; + case "quota": + await runQuota(args); + break; + case "health": + await runHealth(args); + break; + case "cache": + await runCache(args); + break; + case "mcp": + await runMcp(args); + break; + case "a2a": + await runA2a(args); + break; + case "tunnel": + await runTunnel(args); + break; + case "env": + await runEnv(args); + break; + case "open": + await runDashboard(args); + break; + default: + log(`Unknown subcommand: ${cmd}`, "red"); + log("Run 'omniroute --help' for available commands", "dim"); + process.exit(1); + } +} + +async function runSetup(args) { + const toolsArg = args.find((a) => a.startsWith("--tools="))?.split("=")[1]; + const urlArg = args.find((a) => a.startsWith("--url="))?.split("=")[1] || DEFAULT_BASE_URL; + const keyArg = + args.find((a) => a.startsWith("--key="))?.split("=")[1] || "sk-omniroute-cli-configured"; + const listArg = args.includes("--list"); + + const baseUrl = urlArg.endsWith("/") ? urlArg.slice(0, -1) : urlArg; + + if (listArg) { + logSection("Available CLI Tools"); + const tools = detectInstalledTools(); + for (const tool of tools) { + const status = tool.installed + ? tool.configured + ? colorize("✓ configured", "green") + : colorize("✗ not configured", "yellow") + : colorize("✗ not installed", "red"); + log(` ${tool.name.padEnd(14)} ${status}`); + } + logEndSection(); + return; + } + + logSection("OmniRoute CLI Setup"); + + // Detect installed tools + const installed = detectInstalledTools().filter((t) => t.installed); + + if (installed.length === 0) { + log("No CLI tools detected. Install Claude Code, Codex, OpenCode, etc.", "yellow"); + return; + } + + log(`Found ${installed.length} installed tools:`, "dim"); + for (const tool of installed) { + log(` - ${tool.name}`); + } + console.log(); + + // Determine which tools to configure + const toolsToConfigure = toolsArg + ? toolsArg.split(",").filter((t) => CLI_TOOLS[t]) + : installed.map((t) => t.id); + + // Configure each tool + log(`Configuring ${toolsToConfigure.length} tool(s)...\n`, "cyan"); + + let successCount = 0; + let failCount = 0; + + for (const toolId of toolsToConfigure) { + const tool = CLI_TOOLS[toolId]; + log(`Configuring ${tool.name}...`, "dim"); + + const result = configureTool(toolId, baseUrl, keyArg); + + if (result.success) { + log(` ✓ Configured: ${result.configPath}`, "green"); + if (result.backupPath) { + log(` Backup: ${result.backupPath}`, "dim"); + } + successCount++; + } else { + log(` ✗ Failed: ${result.error}`, "red"); + failCount++; + } + } + + logEndSection(); + + console.log(); + if (successCount > 0) { + log(`✓ Successfully configured ${successCount} tool(s)`, "green"); + } + if (failCount > 0) { + log(`✗ Failed to configure ${failCount} tool(s)`, "red"); + } + + console.log(); + log("Next steps:", "cyan"); + log(" 1. Test: omniroute test", "dim"); + log(" 2. Status: omniroute status", "dim"); + log(" 3. Start server: omniroute", "dim"); +} + +async function runDoctor(args) { + const verbose = args.includes("--verbose"); + const serverRunning = await checkServerHealth(); + + logSection("OmniRoute Doctor"); + + // Server status + if (serverRunning) { + log("Server: " + colorize("✓ Running", "green")); + log(`API: http://localhost:${API_PORT}/v1`); + log(`Dashboard: http://localhost:${DASHBOARD_PORT}`); + } else { + log("Server: " + colorize("✗ Not running", "red")); + log("Run 'omniroute' to start the server", "dim"); + } + logEndSection(); + + // CLI Tools status + logSection("CLI Tools Status"); + + let tools; + let dataSource = "local"; + + if (serverRunning) { + const apiStatus = await getCliToolsStatusFromApi(); + if (apiStatus) { + dataSource = "api"; + tools = Object.entries(apiStatus).map(([id, data]) => ({ + id, + name: CLI_TOOLS[id]?.name || id, + installed: data.installed, + configured: data.configStatus === "configured", + runnable: data.runnable, + })); + } + } + + if (!tools) { + tools = detectInstalledTools(); + } + + // Sort: configured first, then installed, then not installed + tools.sort((a, b) => { + if (a.configured && !b.configured) return -1; + if (!a.configured && b.configured) return 1; + if (a.installed && !b.installed) return -1; + if (!a.installed && b.installed) return 1; + return 0; + }); + + for (const tool of tools) { + let status; + if (tool.configured) { + status = colorize("✓ configured", "green"); + } else if (tool.installed) { + status = colorize("○ not configured", "yellow"); + } else { + status = colorize("✗ not installed", "red"); + } + log(` ${tool.name.padEnd(12)} ${status}`); + } + + console.log( + `\n${colorize("Data source:", "dim")} ${dataSource === "api" ? "API (accurate)" : "Local detection"}` + ); + logEndSection(); + + // Recommendations + console.log(); + const notConfigured = tools.filter((t) => t.installed && !t.configured); + if (notConfigured.length > 0) { + log("Recommendations:", "cyan"); + log(` Run 'omniroute setup --tools=${notConfigured.map((t) => t.id).join(",")}' to configure`); + } + + if (!serverRunning) { + log(" Run 'omniroute' to start the server for full diagnostics", "dim"); + } + + if (verbose && serverRunning) { + console.log(); + logSection("System Info"); + log(`Node: ${process.version}`); + log(`Platform: ${platform()} ${release()}`); + log(`Home: ${getHomeDir()}`); + log(`Data Dir: ${resolveConfigPath(".omniroute")}`); + logEndSection(); + } +} + +async function runStatus(args) { + const json = args.includes("--json"); + const serverRunning = await checkServerHealth(); + + const config = getOmniRouteConfig(); + const tools = detectInstalledTools(); + const configuredCount = tools.filter((t) => t.configured).length; + const installedCount = tools.filter((t) => t.installed).length; + + if (json) { + console.log( + JSON.stringify( + { + server: { + running: serverRunning, + port: config.port, + url: config.baseUrl, + }, + dashboard: `http://localhost:${config.dashboardPort}`, + config: { + dataDir: config.dataDir, + requireApiKey: config.requireApiKey, + logLevel: config.logLevel, + }, + tools: { + total: Object.keys(CLI_TOOLS).length, + installed: installedCount, + configured: configuredCount, + }, + }, + null, + 2 + ) + ); + return; + } + + logSection("OmniRoute Status"); + log( + `Server: ${serverRunning ? colorize("✓ Running", "green") : colorize("✗ Stopped", "red")}` + ); + log(`API URL: ${config.baseUrl}/v1`); + log(`Dashboard: http://localhost:${config.dashboardPort}`); + log(`Data Dir: ${config.dataDir}`); + logEndSection(); + + logSection("CLI Tools"); + log(`Installed: ${installedCount}`); + log(`Configured: ${configuredCount}`); + console.log(); + + for (const tool of tools) { + const icon = tool.configured + ? colorize("●", "green") + : tool.installed + ? colorize("○", "yellow") + : colorize("×", "red"); + log(` ${icon} ${tool.name}`); + } + logEndSection(); +} + +async function runLogs(args) { + const linesArg = args.find((a) => a.startsWith("--lines="))?.split("=")[1] || "100"; + const levelArg = args.find((a) => a.startsWith("--level="))?.split("=")[1]; + const followArg = args.includes("--follow"); + const jsonArg = args.includes("--json"); + const searchArg = args.find((a) => a.startsWith("--search="))?.split("=")[1]; + + const limit = Math.min(Math.max(parseInt(linesArg) || 100, 10), 1000); + const level = levelArg || null; + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute'", "red"); + return; + } + + if (jsonArg) { + const logs = await getConsoleLogs(limit, level); + console.log(JSON.stringify(logs, null, 2)); + return; + } + + logSection("Console Logs"); + log(`Fetching last ${limit} lines...`, "dim"); + if (level) log(`Filter: ${level}`, "dim"); + if (searchArg) log(`Search: ${searchArg}`, "dim"); + logEndSection(); + + let logs = await getConsoleLogs(limit, level); + + // Search filter + if (searchArg) { + const search = searchArg.toLowerCase(); + logs = logs.filter( + (l) => + (l.msg || l.message || "").toLowerCase().includes(search) || + (l.level || "").toLowerCase().includes(search) + ); + } + + if (logs.length === 0) { + log("No logs found", "yellow"); + return; + } + + for (const entry of logs) { + const timestamp = entry.time || entry.timestamp || ""; + const lvl = entry.level || entry.severity || "info"; + const msg = entry.msg || entry.message || ""; + + let color = "dim"; + if (lvl === "error" || lvl === "fatal") color = "red"; + else if (lvl === "warn") color = "yellow"; + else if (lvl === "debug") color = "dim"; + else color = "reset"; + + console.log(`${colorize(timestamp.slice(0, 24), "dim")} [${lvl.slice(0, 5).padEnd(5)}] ${msg}`); + } + + if (followArg) { + log("\nFollowing logs (Ctrl+C to exit)...", "cyan"); + // Simple polling implementation + let lastTime = logs[logs.length - 1]?.time || ""; + + const interval = setInterval(async () => { + const newLogs = await getConsoleLogs(50, level); + const filtered = newLogs.filter((l) => l.time > lastTime); + for (const entry of filtered) { + const timestamp = entry.time || ""; + const lvl = entry.level || "info"; + const msg = entry.msg || ""; + let color = lvl === "error" ? "red" : lvl === "warn" ? "yellow" : "dim"; + console.log( + `${colorize(timestamp.slice(0, 24), "dim")} [${lvl.slice(0, 5).padEnd(5)}] ${msg}` + ); + lastTime = entry.time; + } + }, 2000); + + // Handle interrupt + process.on("SIGINT", () => { + clearInterval(interval); + log("\nStopped following", "yellow"); + process.exit(0); + }); + } +} + +async function runProvider(args) { + const action = args[0] || "list"; + + if (action === "list") { + logSection("Available Provider Integrations"); + for (const [id, name] of Object.entries({ + opencode: "OpenCode", + cursor: "Cursor", + cline: "Cline", + vscode: "VS Code", + })) { + log(` ${name}`); + } + logEndSection(); + log("\nUsage: omniroute provider add <name>", "dim"); + return; + } + + if (action === "add") { + const provider = args[1]; + if (!provider || !PROVIDER_HELP[provider]) { + log(`Unknown provider: ${provider}`, "red"); + log("Available: " + Object.keys(PROVIDER_HELP).join(", "), "dim"); + return; + } + + logSection(`Configure ${provider}`); + console.log(PROVIDER_HELP[provider]); + logEndSection(); + return; + } + + log(`Unknown action: ${action}`, "red"); + log("Usage: omniroute provider [list|add <name>]", "dim"); +} + +async function runConfig(args) { + const action = args[0] || "show"; + + if (action === "show") { + const config = getOmniRouteConfig(); + + logSection("OmniRoute Configuration"); + log(`API Port: ${config.port}`); + log(`Dashboard Port: ${config.dashboardPort}`); + log(`Base URL: ${config.baseUrl}`); + log(`Data Directory: ${config.dataDir}`); + log(`Require API Key: ${config.requireApiKey ? "Yes" : "No"}`); + log(`Log Level: ${config.logLevel}`); + log(`Node Version: ${config.nodeVersion}`); + log(`Platform: ${config.platform} ${config.osRelease}`); + logEndSection(); + return; + } + + log(`Unknown action: ${action}`, "red"); + log("Usage: omniroute config show", "dim"); +} + +async function runTest(args) { + const providerArg = args.find((a) => a.startsWith("--provider="))?.split("=")[1]; + const modelArg = args.find((a) => a.startsWith("--model="))?.split("=")[1]; + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute'", "red"); + return; + } + + const provider = providerArg || "claude"; + const model = modelArg || "claude-sonnet-4-20250514"; + + logSection("Testing Provider Connection"); + log(`Provider: ${provider}`); + log(`Model: ${model}`); + log("Connecting...", "dim"); + console.log(); + + const result = await testProviderConnection(provider, model); + + if (result.success) { + log("✓ Connection successful!", "green"); + log(`Response: ${result.response}`, "dim"); + } else { + log("✗ Connection failed!", "red"); + log(`Error: ${result.error}`, "yellow"); + } + + logEndSection(); +} + +async function runUpdate(args) { + logSection("Checking for Updates"); + + // Get current version + try { + const pkgPath = join(ROOT, "package.json"); + const pkg = JSON.parse(readFileSync(pkgPath, "utf8")); + log(`Current version: ${colorize(pkg.version, "cyan")}`); + } catch { + log("Current version: unknown", "yellow"); + } + + // Get latest version from npm + log("Checking npm...", "dim"); + const npmResult = execCommand("npm view omniroute version", 10000); + + if (npmResult.success) { + const latest = npmResult.output.trim(); + // Try to get current version again for comparison + const pkgPath = join(ROOT, "package.json"); + const current = JSON.parse(readFileSync(pkgPath, "utf8")).version; + + console.log(); + if (latest !== current) { + log(`Latest version: ${colorize(latest, "green")}`); + log(`Update available! Run:`, "yellow"); + log(` npm install -g omniroute@latest`, "dim"); + } else { + log(`Latest version: ${colorize(latest, "green")}`); + log("Already on the latest version!", "green"); + } + } else { + log("Could not check for updates (npm not available)", "yellow"); + } + + logEndSection(); +} + +// ============================================================================ +// PID FILE MANAGEMENT +// ============================================================================ + +function getPidFilePath() { + return join(resolveConfigPath(".omniroute"), "server.pid"); +} + +function writePidFile(pid) { + try { + const dir = dirname(getPidFilePath()); + if (!existsSync(dir)) { + mkdirSync(dir, { recursive: true }); + } + writeFileSync(getPidFilePath(), String(pid), "utf8"); + return true; + } catch { + return false; + } +} + +function readPidFile() { + try { + const path = getPidFilePath(); + if (!existsSync(path)) return null; + const content = readFileSync(path, "utf8").trim(); + return content ? parseInt(content, 10) : null; + } catch { + return null; + } +} + +function isPidRunning(pid) { + if (!pid) return false; + try { + process.kill(pid, 0); + return true; + } catch { + return false; + } +} + +function cleanupPidFile() { + try { + const path = getPidFilePath(); + if (existsSync(path)) { + const fs = require("node:fs"); + fs.unlinkSync(path); + } + } catch {} +} + +function sleep(ms) { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +async function waitForServer(port, timeout = 15000) { + const start = Date.now(); + while (Date.now() - start < timeout) { + try { + const res = await fetch(`http://localhost:${port}/api/health`, { + signal: AbortSignal.timeout(2000), + }); + if (res.ok) return true; + } catch {} + await sleep(500); + } + return false; +} + +// ============================================================================ +// SERVER MANAGEMENT COMMANDS +// ============================================================================ + +async function runServe(args) { + const portArg = args.find((a) => a.startsWith("--port="))?.split("=")[1]; + const port = portArg ? parseInt(portArg) : API_PORT; + const daemonArg = args.includes("--daemon"); + + logSection("Starting OmniRoute Server"); + + // Check if already running via PID file + const existingPid = readPidFile(); + if (existingPid && isPidRunning(existingPid)) { + log(`Server already running (PID: ${existingPid})`, "red"); + log(`API: http://localhost:${port}/v1`); + log(`Dashboard: http://localhost:${port + 1}`); + logEndSection(); + return; + } + + // Check if port is in use + const portCheck = execCommand(`lsof -ti:${port} 2>/dev/null || true`, 2000); + if (portCheck.success && portCheck.output.trim()) { + log(`Port ${port} is already in use`, "red"); + log("Stop the existing server or use a different port", "dim"); + logEndSection(); + return; + } + + const appDir = join(ROOT, "app"); + const serverWsJs = join(appDir, "server-ws.mjs"); + const serverJs = existsSync(serverWsJs) ? serverWsJs : join(appDir, "server.js"); + + if (!existsSync(serverJs)) { + log("Server not found. Run 'npm run build' first.", "red"); + logEndSection(); + return; + } + + log(`Starting server on port ${port}...`, "dim"); + + const env = { + ...process.env, + OMNIROUTE_PORT: String(port), + PORT: String(port + 1), + DASHBOARD_PORT: String(port + 1), + API_PORT: String(port), + HOSTNAME: "0.0.0.0", + NODE_ENV: "production", + }; + + const server = spawn("node", [serverJs], { + cwd: appDir, + env, + stdio: daemonArg ? "ignore" : "pipe", + }); + + // Write PID file + writePidFile(server.pid); + + if (daemonArg) { + log(`Server started in background (PID: ${server.pid})`, "green"); + log(`API: http://localhost:${port}/v1`); + log(`Dashboard: http://localhost:${port + 1}`); + } else { + // Wait for server to be ready + const ready = await waitForServer(port); + if (ready) { + log(`Server running!`, "green"); + log(`API: http://localhost:${port}/v1`); + log(`Dashboard: http://localhost:${port + 1}`); + log(""); + log("Press Ctrl+C to stop", "dim"); + } else { + log("Server may not have started properly", "yellow"); + } + } + + logEndSection(); + + if (!daemonArg) { + // Keep process alive, handle shutdown + process.on("SIGINT", () => { + log("\nShutting down...", "yellow"); + server.kill("SIGTERM"); + cleanupPidFile(); + process.exit(0); + }); + + server.on("exit", (code) => { + cleanupPidFile(); + if (code !== 0) { + log(`Server exited with code ${code}`, "red"); + } + process.exit(code || 0); + }); + } +} + +async function runStop(args) { + logSection("Stopping OmniRoute Server"); + + const pid = readPidFile(); + + if (pid && isPidRunning(pid)) { + log(`Sending SIGTERM to PID ${pid}...`, "dim"); + + try { + process.kill(pid, "SIGTERM"); + + // Wait for graceful shutdown + let waited = 0; + while (waited < 5000 && isPidRunning(pid)) { + await sleep(100); + waited += 100; + } + + if (isPidRunning(pid)) { + log("Force killing...", "yellow"); + process.kill(pid, "SIGKILL"); + await sleep(500); + } + + cleanupPidFile(); + log("Server stopped", "green"); + } catch (err) { + log(`Error stopping server: ${err.message}`, "red"); + } + } else { + // Fallback: try to kill by port + log("No PID file, trying port-based cleanup...", "dim"); + + try { + // Send SIGTERM first for graceful shutdown, then SIGKILL if still running + execCommand("lsof -ti:20128 | xargs -r kill -15 2>/dev/null || true", 2000); + execCommand("lsof -ti:20129 | xargs -r kill -15 2>/dev/null || true", 2000); + await sleep(1000); + execCommand("lsof -ti:20128 | xargs -r kill -9 2>/dev/null || true", 2000); + execCommand("lsof -ti:20129 | xargs -r kill -9 2>/dev/null || true", 2000); + cleanupPidFile(); + log("Server stopped (port-based)", "green"); + } catch { + log("No server running", "yellow"); + } + } + + logEndSection(); +} + +async function runRestart(args) { + logSection("Restarting OmniRoute Server"); + + const portArg = args.find((a) => a.startsWith("--port="))?.split("=")[1] || String(API_PORT); + + // Stop first + await runStop([]); + + // Small delay + await sleep(1000); + + // Start with same port + log("Starting server...", "dim"); + await runServe(["--port=" + portArg]); + + logEndSection(); +} + +// ============================================================================ +// API KEY MANAGEMENT +// ============================================================================ + +const VALID_PROVIDERS = [ + "openai", + "anthropic", + "google", + "deepseek", + "groq", + "mistral", + "xai", + "cohere", + "google-generativeai", + "azure", + "aws", + "bedrock", + "perplexity", + "together", + "fireworks", + "huggingface", + "nvidia", + "cerebras", + "siliconflow", + "nebius", + "openrouter", + "ollama", +]; + +async function runKeys(args) { + const action = args[0]; + + if (!action) { + logSection("API Key Management"); + log("Usage:"); + log(" omniroute keys add <provider> <api-key>"); + log(" omniroute keys list"); + log(" omniroute keys remove <provider>"); + log(""); + log(`Valid providers: ${VALID_PROVIDERS.join(", ")}`, "dim"); + logEndSection(); + return; + } + + switch (action) { + case "add": + await runKeysAdd(args.slice(1)); + break; + case "list": + await runKeysList(args.slice(1)); + break; + case "remove": + await runKeysRemove(args.slice(1)); + break; + default: + log(`Unknown action: ${action}`, "red"); + log("Valid actions: add, list, remove", "dim"); + } +} + +async function runKeysAdd(args) { + const provider = args[0]; + const apiKey = args[1]; + + if (!provider || !apiKey) { + log("Usage: omniroute keys add <provider> <api-key>", "red"); + return; + } + + const providerLower = provider.toLowerCase(); + if (!VALID_PROVIDERS.includes(providerLower)) { + log(`Invalid provider. Valid: ${VALID_PROVIDERS.join(", ")}`, "red"); + return; + } + + logSection(`Adding API Key for ${provider}`); + + // Try API first + const serverRunning = await checkServerHealth(); + + if (serverRunning) { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/v1/providers/keys`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ provider: providerLower, apiKey }), + }); + + if (res.ok) { + log(`API key for ${provider} added successfully via API`, "green"); + logEndSection(); + return; + } + } catch {} + } + + // Direct DB fallback + const dbPath = resolveStoragePath(); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "red"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + ensureProviderSchema(db); + + const existing = db + .prepare( + "SELECT id, name FROM provider_connections WHERE provider = ? AND auth_type = 'apikey' ORDER BY priority ASC, updated_at DESC LIMIT 1" + ) + .get(providerLower); + const connectionName = existing?.name || providerLower; + if (existing && !existing.name) { + db.prepare("UPDATE provider_connections SET name = ? WHERE id = ?").run( + connectionName, + existing.id + ); + } + + upsertApiKeyProviderConnection(db, { + provider: providerLower, + name: connectionName, + apiKey, + }); + + log(`API key for ${provider} ${existing ? "updated" : "added"}`, "green"); + + db.close(); + } catch (err) { + log(`Failed to save key: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runKeysList(args) { + logSection("Configured API Keys"); + + const dbPath = resolveStoragePath(); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "yellow"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + ensureProviderSchema(db); + + const keys = listProviderConnections(db).filter( + (connection) => connection.authType === "apikey" && connection.apiKey + ); + + db.close(); + + if (keys.length === 0) { + log("No API keys configured", "yellow"); + } else { + for (const key of keys) { + let rawApiKey = ""; + try { + rawApiKey = getProviderApiKey(key); + } catch { + rawApiKey = key.apiKey || ""; + } + const masked = + rawApiKey && rawApiKey.length > 8 + ? rawApiKey.slice(0, 6) + "***" + rawApiKey.slice(-4) + : "***"; + const status = key.isActive + ? colorize("● enabled", "green") + : colorize("○ disabled", "yellow"); + log(` ${key.provider.padEnd(20)} ${masked.padEnd(20)} ${status}`); + } + } + } catch (err) { + log(`Error reading keys: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runKeysRemove(args) { + const provider = args[0]; + + if (!provider) { + log("Usage: omniroute keys remove <provider>", "red"); + return; + } + + logSection(`Removing API Key for ${provider}`); + + const dbPath = resolveStoragePath(); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "red"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + ensureProviderSchema(db); + + const result = db + .prepare( + "DELETE FROM provider_connections WHERE provider = ? AND (auth_type = 'apikey' OR (api_key IS NOT NULL AND api_key != ''))" + ) + .run(provider.toLowerCase()); + + if (result.changes > 0) { + log(`API key for ${provider} removed`, "green"); + } else { + log(`No API key found for ${provider}`, "yellow"); + } + + db.close(); + } catch (err) { + log(`Failed to remove key: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// MODEL BROWSER +// ============================================================================ + +async function runModels(args) { + const providerFilter = args[0] && !args[0].startsWith("--") ? args[0] : null; + const jsonOutput = args.includes("--json"); + const searchQuery = args.find((a) => a.startsWith("--search="))?.split("=")[1]; + + logSection("Available Models"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve' or 'omniroute'", "red"); + logEndSection(); + return; + } + + try { + // Try various endpoints + let models = []; + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/models`, { + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + const data = await res.json(); + models = data.models || data || []; + } + } catch {} + + // Fallback: try provider registry + if (models.length === 0) { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/v1/models`, { + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + models = await res.json(); + } + } catch {} + } + + // Filter by provider if specified + if (providerFilter) { + const filter = providerFilter.toLowerCase(); + models = models.filter( + (m) => + (m.provider && m.provider.toLowerCase().includes(filter)) || + (m.id && m.id.toLowerCase().startsWith(filter)) || + (m.name && m.name.toLowerCase().includes(filter)) + ); + } + + // Search filter + if (searchQuery) { + const search = searchQuery.toLowerCase(); + models = models.filter( + (m) => + (m.id && m.id.toLowerCase().includes(search)) || + (m.name && m.name.toLowerCase().includes(search)) || + (m.provider && m.provider.toLowerCase().includes(search)) || + (m.description && m.description.toLowerCase().includes(search)) + ); + } + + if (jsonOutput) { + console.log(JSON.stringify(models, null, 2)); + logEndSection(); + return; + } + + if (models.length === 0) { + log("No models found", "yellow"); + logEndSection(); + return; + } + + // Display as formatted table + console.log(); + console.log(colorize(" Model".padEnd(45) + "Provider".padEnd(20) + "Context", "cyan")); + console.log( + colorize(" " + "─".repeat(44) + " " + "─".repeat(19) + " " + "─".repeat(10), "dim") + ); + + const displayModels = models.slice(0, 50); + for (const model of displayModels) { + const name = (model.id || model.name || "unknown").slice(0, 43); + const provider = (model.provider || "unknown").slice(0, 18); + const context = model.context_length || model.max_tokens || model.contextWindow || "-"; + console.log(` ${name.padEnd(45)}${provider.padEnd(20)}${String(context).padEnd(10)}`); + } + + console.log(); + if (models.length > 50) { + log(`... and ${models.length - 50} more models. Use --json for full list.`, "dim"); + } + + log(`Total: ${models.length} models`, "green"); + } catch (err) { + log(`Failed to fetch models: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// COMBO MANAGEMENT +// ============================================================================ + +async function runCombo(args) { + const action = args[0]; + + if (!action) { + logSection("Combo Management"); + log("Usage:"); + log(" omniroute combo list"); + log(" omniroute combo switch <name>"); + log(" omniroute combo create <name> <strategy>"); + log(" omniroute combo delete <name>"); + log(""); + log("Strategies: priority, weighted, round-robin, p2c, random, auto, lkgp", "dim"); + logEndSection(); + return; + } + + switch (action) { + case "list": + await runComboList(args.slice(1)); + break; + case "switch": + await runComboSwitch(args.slice(1)); + break; + case "create": + await runComboCreate(args.slice(1)); + break; + case "delete": + await runComboDelete(args.slice(1)); + break; + default: + log(`Unknown action: ${action}`, "red"); + log("Valid actions: list, switch, create, delete", "dim"); + } +} + +async function runComboList(args) { + const jsonOutput = args.includes("--json"); + + logSection("Routing Combos"); + + const dataDir = resolveConfigPath(".omniroute"); + const dbPath = join(dataDir, "storage.sqlite"); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "yellow"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + + const combos = db + .prepare( + ` + SELECT id, name, strategy, enabled, target_count + FROM combos + ORDER BY name + ` + ) + .all(); + + // Get active combo + let activeCombo = null; + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/combos/active`, { + signal: AbortSignal.timeout(3000), + }); + if (res.ok) { + const data = await res.json(); + activeCombo = data.active || data.name || data.combo; + } + } catch {} + + db.close(); + + if (jsonOutput) { + console.log(JSON.stringify({ combos, active: activeCombo }, null, 2)); + logEndSection(); + return; + } + + if (combos.length === 0) { + log("No combos configured", "yellow"); + } else { + for (const combo of combos) { + const isActive = activeCombo && (combo.name === activeCombo || combo.id === activeCombo); + const icon = isActive ? colorize("●", "green") : colorize("○", "dim"); + const status = combo.enabled ? colorize("enabled", "green") : colorize("disabled", "red"); + const strategy = combo.strategy || "priority"; + console.log(` ${icon} ${combo.name.padEnd(25)} [${strategy.padEnd(12)}] ${status}`); + } + } + } catch (err) { + log(`Error reading combos: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runComboSwitch(args) { + const name = args[0]; + + if (!name) { + log("Usage: omniroute combo switch <name>", "red"); + return; + } + + logSection(`Switching to Combo: ${name}`); + + // Try API first + const serverRunning = await checkServerHealth(); + + if (serverRunning) { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/combos/switch`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ name }), + }); + + if (res.ok) { + log(`Switched to combo '${name}'`, "green"); + logEndSection(); + return; + } + } catch {} + } + + // Direct DB fallback + const dataDir = resolveConfigPath(".omniroute"); + const dbPath = join(dataDir, "storage.sqlite"); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "red"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + + // Check combo exists + const combo = db.prepare("SELECT id FROM combos WHERE name = ?").get(name); + + if (!combo) { + log(`Combo '${name}' not found`, "red"); + db.close(); + logEndSection(); + return; + } + + // Update settings to set active combo + const settingsPath = join(dataDir, "settings.json"); + let settings = {}; + if (existsSync(settingsPath)) { + try { + settings = JSON.parse(readFileSync(settingsPath, "utf8")); + } catch {} + } + + settings.activeCombo = name; + writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf8"); + + log(`Switched to combo '${name}'`, "green"); + db.close(); + } catch (err) { + log(`Failed to switch combo: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runComboCreate(args) { + const name = args[0]; + const strategy = args[1] || "priority"; + + if (!name) { + log("Usage: omniroute combo create <name> [strategy]", "red"); + return; + } + + const validStrategies = [ + "priority", + "weighted", + "round-robin", + "p2c", + "random", + "auto", + "lkgp", + "context-optimized", + "context-relay", + ]; + if (!validStrategies.includes(strategy)) { + log(`Invalid strategy. Valid: ${validStrategies.join(", ")}`, "red"); + return; + } + + logSection(`Creating Combo: ${name}`); + + const dataDir = resolveConfigPath(".omniroute"); + const dbPath = join(dataDir, "storage.sqlite"); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "red"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + + // Check if combo already exists + const existing = db.prepare("SELECT id FROM combos WHERE name = ?").get(name); + + if (existing) { + log(`Combo '${name}' already exists. Use 'combo delete' first.`, "red"); + db.close(); + logEndSection(); + return; + } + + // Insert new combo + db.prepare( + ` + INSERT INTO combos (name, strategy, enabled, target_count) + VALUES (?, ?, 1, 0) + ` + ).run(name, strategy); + + log(`Combo '${name}' created with strategy '${strategy}'`, "green"); + log("Use 'omniroute combo switch " + name + "' to activate", "dim"); + db.close(); + } catch (err) { + log(`Failed to create combo: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runComboDelete(args) { + const name = args[0]; + + if (!name) { + log("Usage: omniroute combo delete <name>", "red"); + return; + } + + logSection(`Deleting Combo: ${name}`); + + const dataDir = resolveConfigPath(".omniroute"); + const dbPath = join(dataDir, "storage.sqlite"); + + if (!existsSync(dbPath)) { + log("Database not found. Start server first.", "red"); + logEndSection(); + return; + } + + try { + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + const Database = require("better-sqlite3"); + const db = new Database(dbPath); + + const result = db.prepare("DELETE FROM combos WHERE name = ?").run(name); + + if (result.changes > 0) { + log(`Combo '${name}' deleted`, "green"); + } else { + log(`Combo '${name}' not found`, "yellow"); + } + + db.close(); + } catch (err) { + log(`Failed to delete combo: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// SHELL COMPLETION +// ============================================================================ + +const VALID_SHELLS = ["bash", "zsh", "fish"]; + +async function runCompletion(args) { + const shell = args[0]; + + if (!shell) { + logSection("Shell Completion"); + log("Usage:"); + log(" omniroute completion bash"); + log(" omniroute completion zsh"); + log(" omniroute completion fish"); + log(""); + log("To install:"); + log(" bash: omniroute completion bash > ~/.bash_completion"); + log(" zsh: omniroute completion zsh > ~/.zsh/completions/_omniroute", "dim"); + logEndSection(); + return; + } + + if (!VALID_SHELLS.includes(shell)) { + log(`Invalid shell. Valid: ${VALID_SHELLS.join(", ")}`, "red"); + return; + } + + switch (shell) { + case "bash": + console.log(generateBashCompletion()); + break; + case "zsh": + console.log(generateZshCompletion()); + break; + case "fish": + console.log(generateFishCompletion()); + break; + } +} + +function generateBashCompletion() { + const script = `#!/bin/bash +# OmniRoute CLI Bash Completion + +_omniroute() { + local cur prev opts cmds + COMPREPLY=() + cur="\${COMP_WORDS[COMP_CWORD]}" + prev="\${COMP_WORDS[COMP_CWORD-1]}" + + opts="--help --version" + cmds="setup doctor status logs provider config test update serve stop restart keys models combo completion dashboard" + + # Command-specific options + case "\${prev}" in + setup) + COMPREPLY=($(compgen -W "--tools --url --key --list" -- \${cur})) + return 0 + ;; + logs) + COMPREPLY=($(compgen -W "--lines --level --follow" -- \${cur})) + return 0 + ;; + doctor) + COMPREPLY=($(compgen -W "--verbose" -- \${cur})) + return 0 + ;; + status) + COMPREPLY=($(compgen -W "--json" -- \${cur})) + return 0 + ;; + keys) + COMPREPLY=($(compgen -W "add list remove" -- \${cur})) + return 0 + ;; + keys add) + COMPREPLY=($(compgen -W "openai anthropic google deepseek groq mistral xai cohere" -- \${cur})) + return 0 + ;; + models) + COMPREPLY=($(compgen -W "--json openai anthropic google deepseek groq" -- \${cur})) + return 0 + ;; + combo) + COMPREPLY=($(compgen -W "list switch create delete" -- \${cur})) + return 0 + ;; + provider) + COMPREPLY=($(compgen -W "list add" -- \${cur})) + return 0 + ;; + completion) + COMPREPLY=($(compgen -W "bash zsh fish" -- \${cur})) + return 0 + ;; + serve) + COMPREPLY=($(compgen -W "--port --daemon" -- \${cur})) + return 0 + ;; + test) + COMPREPLY=($(compgen -W "--provider --model" -- \${cur})) + return 0 + ;; + dashboard) + COMPREPLY=($(compgen -W "--url" -- \${cur})) + return 0 + ;; + config) + COMPREPLY=($(compgen -W "show" -- \${cur})) + return 0 + ;; + *) + COMPREPLY=($(compgen -W "\${cmds} \${opts}" -- \${cur})) + return 0 + ;; + esac +} + +complete -F _omniroute omniroute +`; + return script; +} + +function generateZshCompletion() { + return `#compdef omniroute + +local -a commands +commands=( + 'setup:Configure CLI tools to use OmniRoute' + 'doctor:Run health diagnostics' + 'status:Show server and tools status' + 'logs:View application logs' + 'provider:Add OmniRoute as provider' + 'config:Show configuration' + 'test:Test provider connectivity' + 'update:Check for updates' + 'serve:Start the server' + 'stop:Stop the server' + 'restart:Restart the server' + 'keys:Manage API keys' + 'models:Browse available models' + 'combo:Manage routing combos' + 'completion:Generate shell completion' + 'dashboard:Open dashboard' +) + +_arguments -C \\ + '1: :->command' \\ + '*:: :->arg' \\ + && return 0 + +case $state in + command) + _describe 'command' commands + ;; + arg) + case $words[1] in + setup) + _arguments '--tools[Tools to configure]:tools:(claude codex opencode cline kilo continue openclaw)' '--url[Base URL]:url:' '--key[API Key]:key:' '--list[List available tools' + ;; + keys) + case $words[2] in + add) + _arguments '2:provider:(openai anthropic google deepseek groq mistral xai cohere)' '3:api-key:' + ;; + remove) + _arguments '2:provider:(openai anthropic google deepseek groq mistral xai cohere)' + ;; + *) + _describe 'subcommand' 'add:Add API key' 'list:List keys' 'remove:Remove key' + ;; + esac + ;; + combo) + _describe 'subcommand' 'list:List combos' 'switch:Switch combo' 'create:Create combo' 'delete:Delete combo' + ;; + completion) + _arguments '2:shell:(bash zsh fish)' + ;; + serve) + _arguments '--port[Port number]:port:' '--daemon[Run in background' + ;; + models) + _arguments '--json[JSON output]' '2:provider:(openai anthropic google deepseek groq)' + ;; + logs) + _arguments '--lines[Number of lines]:lines:' '--level[Log level]:level:(debug info warn error)' '--follow[Follow logs]' + ;; + esac + ;; +esac +`; +} + +function generateFishCompletion() { + return `# OmniRoute CLI Fish Completion + +complete -c omniroute -f + +# Main commands +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'setup' -d 'Configure CLI tools' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'doctor' -d 'Run health diagnostics' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'status' -d 'Show status' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'logs' -d 'View logs' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'provider' -d 'Provider management' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'config' -d 'Show config' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'test' -d 'Test connectivity' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'update' -d 'Check updates' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'serve' -d 'Start server' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'stop' -d 'Stop server' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'restart' -d 'Restart server' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'keys' -d 'API key management' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'models' -d 'Browse models' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'combo' -d 'Combo management' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'completion' -d 'Shell completion' +complete -c omniroute -n '__fish_is_nth_arg 1' -a 'dashboard' -d 'Open dashboard' + +# Subcommands +complete -c omniroute -n '__fish_seen_subcommand_from keys' -a 'add' -d 'Add key' +complete -c omniroute -n '__fish_seen_subcommand_from keys' -a 'list' -d 'List keys' +complete -c omniroute -n '__fish_seen_subcommand_from keys' -a 'remove' -d 'Remove key' + +complete -c omniroute -n '__fish_seen_subcommand_from combo' -a 'list' -d 'List combos' +complete -c omniroute -n '__fish_seen_subcommand_from combo' -a 'switch' -d 'Switch combo' +complete -c omniroute -n '__fish_seen_subcommand_from combo' -a 'create' -d 'Create combo' +complete -c omniroute -n '__fish_seen_subcommand_from combo' -a 'delete' -d 'Delete combo' + +complete -c omniroute -n '__fish_seen_subcommand_from completion' -a 'bash' -d 'Bash completion' +complete -c omniroute -n '__fish_seen_subcommand_from completion' -a 'zsh' -d 'Zsh completion' +complete -c omniroute -n '__fish_seen_subcommand_from completion' -a 'fish' -d 'Fish completion' +`; +} + +// ============================================================================ +// DASHBOARD COMMAND +// ============================================================================ + +async function runDashboard(args) { + const urlOnly = args.includes("--url"); + + const dashboardUrl = `http://localhost:${DASHBOARD_PORT}`; + + if (urlOnly) { + console.log(dashboardUrl); + return; + } + + logSection("Opening Dashboard"); + + try { + const { execSync } = require("node:child_process"); + const platform = process.platform; + + let command; + if (platform === "darwin") { + command = `open "${dashboardUrl}"`; + } else if (platform === "win32") { + command = `start "" "${dashboardUrl}"`; + } else { + command = `xdg-open "${dashboardUrl}" 2>/dev/null || sensible-browser "${dashboardUrl}" 2>/dev/null || echo "Cannot open browser. Go to: ${dashboardUrl}"`; + } + + execSync(command, { stdio: "ignore" }); + log(`Opening: ${dashboardUrl}`, "green"); + } catch { + log(`Open in browser: ${dashboardUrl}`, "yellow"); + } + + logEndSection(); +} + +// ============================================================================ +// BACKUP & RESTORE +// ============================================================================ + +async function runBackup(args) { + const dataDir = resolveConfigPath(".omniroute"); + const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19); + const backupDir = join(dataDir, "backups"); + const backupName = `omniroute-backup-${timestamp}`; + const backupPath = join(backupDir, backupName); + + logSection("Creating Backup"); + + try { + // Ensure backup directory exists + if (!existsSync(backupDir)) { + mkdirSync(backupDir, { recursive: true }); + } + + // Files to backup + const filesToBackup = [ + { name: "storage.sqlite", dest: "storage.sqlite" }, + { name: "settings.json", dest: "settings.json" }, + { name: "combos.json", dest: "combos.json" }, + { name: "providers.json", dest: "providers.json" }, + ]; + + let backedUp = 0; + let skipped = 0; + + const { createRequire } = await import("node:module"); + const require = createRequire(import.meta.url); + let Database; + try { + Database = require("better-sqlite3"); + } catch { + Database = null; + } + + for (const file of filesToBackup) { + const sourcePath = join(dataDir, file.name); + if (existsSync(sourcePath)) { + const destPath = join(backupPath, file.dest); + mkdirSync(dirname(destPath), { recursive: true }); + if (file.name.endsWith(".sqlite") && Database) { + // Use better-sqlite3 backup API for a consistent snapshot (safe with WAL) + const db = new Database(sourcePath, { readonly: true }); + await db.backup(destPath); + db.close(); + } else { + copyFileSync(sourcePath, destPath); + } + backedUp++; + } else { + skipped++; + } + } + + if (backedUp > 0) { + // Create backup info + const info = { + timestamp: new Date().toISOString(), + version: "omniroute-cli-v1", + files: filesToBackup.filter((f) => existsSync(join(dataDir, f.name))).map((f) => f.name), + }; + writeFileSync(join(backupPath, "backup-info.json"), JSON.stringify(info, null, 2), "utf8"); + + log(`Backup created: ${backupName}`, "green"); + log(`Files: ${backedUp} backed up, ${skipped} skipped`, "dim"); + log(`Location: ${backupPath}`, "dim"); + } else { + log("No files to backup (database not initialized)", "yellow"); + } + } catch (err) { + log(`Backup failed: ${err.message}`, "red"); + } + + logEndSection(); +} + +async function runRestore(args) { + const backupName = args[0]; + const dataDir = resolveConfigPath(".omniroute"); + const backupDir = join(dataDir, "backups"); + + if (!backupName) { + logSection("Available Backups"); + if (!existsSync(backupDir)) { + log("No backups found", "yellow"); + logEndSection(); + return; + } + + try { + const dirs = readdirSync(backupDir).filter((f) => f.startsWith("omniroute-backup-")); + if (dirs.length === 0) { + log("No backups found", "yellow"); + } else { + for (const dir of dirs.sort().reverse()) { + const infoPath = join(backupDir, dir, "backup-info.json"); + if (existsSync(infoPath)) { + const info = JSON.parse(readFileSync(infoPath, "utf8")); + log(` ${dir.replace("omniroute-backup-", "")}`); + log( + ` ${new Date(info.timestamp).toLocaleString()} - ${info.files?.length || 0} files`, + "dim" + ); + } else { + log(` ${dir.replace("omniroute-backup-", "")}`, "dim"); + } + } + } + } catch (err) { + log(`Error listing backups: ${err.message}`, "red"); + } + logEndSection(); + console.log("Usage: omniroute restore <backup-timestamp>"); + return; + } + + logSection(`Restoring from: ${backupName}`); + + const backupPath = join(backupDir, `omniroute-backup-${backupName}`); + + if (!existsSync(backupPath)) { + log(`Backup not found: ${backupName}`, "red"); + logEndSection(); + return; + } + + try { + // Restore files + const filesToRestore = [ + { name: "storage.sqlite", dest: "storage.sqlite" }, + { name: "settings.json", dest: "settings.json" }, + { name: "combos.json", dest: "combos.json" }, + { name: "providers.json", dest: "providers.json" }, + ]; + + for (const file of filesToRestore) { + const sourcePath = join(backupPath, file.dest); + if (existsSync(sourcePath)) { + const destPath = join(dataDir, file.name); + copyFileSync(sourcePath, destPath); + log(`Restored: ${file.name}`, "dim"); + } + } + + log("Backup restored successfully!", "green"); + log("Restart OmniRoute to load restored data", "dim"); + } catch (err) { + log(`Restore failed: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// QUOTA MANAGEMENT +// ============================================================================ + +async function runQuota(args) { + const jsonOutput = args.includes("--json"); + + logSection("Provider Quota Usage"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "red"); + logEndSection(); + return; + } + + try { + // Try quota endpoint + let quotaData = null; + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/quota`, { + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + quotaData = await res.json(); + } + } catch {} + + // Fallback: get from providers + if (!quotaData) { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/v1/providers`, { + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + const providers = await res.json(); + quotaData = { + providers: providers.map((p) => ({ + provider: p.name || p.id, + quota: p.quota || p.remaining || "N/A", + used: p.used || 0, + reset: p.resetAt || "N/A", + })), + }; + } + } catch {} + } + + if (jsonOutput) { + console.log(JSON.stringify(quotaData || { error: "No quota data" }, null, 2)); + logEndSection(); + return; + } + + if (!quotaData?.providers) { + log("No quota information available", "yellow"); + logEndSection(); + return; + } + + console.log(); + console.log( + colorize( + " Provider".padEnd(25) + "Used".padEnd(15) + "Remaining".padEnd(20) + "Reset", + "cyan" + ) + ); + console.log( + colorize( + " " + "─".repeat(24) + " " + "─".repeat(14) + " " + "─".repeat(19) + " " + "─".repeat(15), + "dim" + ) + ); + + for (const p of quotaData.providers) { + const provider = (p.provider || "unknown").slice(0, 23); + const used = String(p.used || 0).padEnd(14); + const remaining = (p.quota || p.remaining || "N/A").toString().slice(0, 18); + const reset = p.reset || "N/A"; + console.log(` ${provider.padEnd(25)}${used.padEnd(15)}${remaining.padEnd(20)}${reset}`); + } + + log(`Total: ${quotaData.providers.length} providers`, "green"); + } catch (err) { + log(`Failed to fetch quota: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// HEALTH STATUS +// ============================================================================ + +async function runHealth(args) { + const verbose = args.includes("--verbose"); + const jsonOutput = args.includes("--json"); + + logSection("OmniRoute Health"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "red"); + logEndSection(); + return; + } + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/health`, { + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + const health = await res.json(); + + if (jsonOutput) { + console.log(JSON.stringify(health, null, 2)); + logEndSection(); + return; + } + + // Display health info + log(`Status: ${colorize("healthy", "green")}`); + log(`Uptime: ${health.uptime || "N/A"}`); + log(`Version: ${health.version || "N/A"}`); + + if (health.breakers) { + console.log(); + logSection("Circuit Breakers"); + for (const [name, status] of Object.entries(health.breakers)) { + const state = + status.state === "closed" + ? colorize("● closed", "green") + : colorize("○ open", "yellow"); + log(` ${name.padEnd(20)} ${state}`); + } + } + + if (health.cache) { + console.log(); + logSection("Cache Status"); + log(` Semantic: ${health.cache.semanticHits || 0} hits`); + log(` Signature: ${health.cache.signatureHits || 0} hits`); + } + + if (verbose && health.memory) { + console.log(); + logSection("Memory"); + log(` RSS: ${health.memory.rss || "N/A"}`); + log(` Heap Used: ${health.memory.heapUsed || "N/A"}`); + } + } + } catch (err) { + log(`Failed to get health: ${err.message}`, "red"); + } + + logEndSection(); +} + +// ============================================================================ +// CACHE MANAGEMENT +// ============================================================================ + +async function runCache(args) { + const action = args[0]; + + if (!action || action === "status") { + logSection("Cache Status"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "yellow"); + logEndSection(); + return; + } + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/cache/stats`, { + signal: AbortSignal.timeout(5000), + }); + if (res.ok) { + const stats = await res.json(); + log(`Semantic Cache: ${stats.semanticHits || 0} hits`); + log(`Signature Cache: ${stats.signatureHits || 0} hits`); + } else { + log("Cache stats not available", "yellow"); + } + } catch { + log("Cache stats not available", "yellow"); + } + logEndSection(); + return; + } + + if (action === "clear") { + logSection("Clearing Cache"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Cannot clear cache.", "red"); + logEndSection(); + return; + } + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/cache/clear`, { + method: "POST", + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + log("Cache cleared successfully!", "green"); + } else { + log("Failed to clear cache", "red"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + logEndSection(); + return; + } + + log(`Unknown cache action: ${action}`, "red"); + log("Valid actions: status, clear", "dim"); +} + +// ============================================================================ +// MCP SERVER STATUS +// ============================================================================ + +async function runMcp(args) { + const action = args[0] || "status"; + + logSection("MCP Server"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "red"); + logEndSection(); + return; + } + + if (action === "status" || action === "list") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/mcp/status`, { + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + const status = await res.json(); + log( + `Status: ${status.running ? colorize("running", "green") : colorize("stopped", "red")}` + ); + log(`Tools: ${status.toolsCount || 0}`); + log(`Transport: ${status.transport || "stdio"}`); + + if (status.scopes) { + console.log(); + log("Scopes:"); + for (const scope of status.scopes) { + log(` - ${scope}`); + } + } + } else { + log("MCP status not available", "yellow"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else if (action === "restart") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/mcp/restart`, { + method: "POST", + signal: AbortSignal.timeout(10000), + }); + + if (res.ok) { + log("MCP server restarted", "green"); + } else { + log("Failed to restart MCP", "red"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else { + log(`Unknown action: ${action}`, "red"); + log("Valid actions: status, list, restart", "dim"); + } + + logEndSection(); +} + +// ============================================================================ +// A2A SERVER STATUS +// ============================================================================ + +async function runA2a(args) { + const action = args[0] || "status"; + + logSection("A2A Server"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "red"); + logEndSection(); + return; + } + + if (action === "status" || action === "list") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/a2a/status`, { + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + const status = await res.json(); + log( + `Status: ${status.running ? colorize("running", "green") : colorize("stopped", "red")}` + ); + log(`Protocol: ${status.protocol || "JSON-RPC 2.0"}`); + log(`Tasks: ${status.activeTasks || 0} active`); + + if (status.skills) { + console.log(); + log("Skills:"); + for (const skill of status.skills) { + log(` - ${skill.name}: ${skill.description || "N/A"}`, "dim"); + } + } + } else { + log("A2A status not available", "yellow"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else if (action === "card") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/.well-known/agent.json`, { + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + const card = await res.json(); + console.log(JSON.stringify(card, null, 2)); + } else { + log("Agent card not available", "yellow"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else { + log(`Unknown action: ${action}`, "red"); + log("Valid actions: status, list, card", "dim"); + } + + logEndSection(); +} + +// ============================================================================ +// TUNNEL MANAGEMENT +// ============================================================================ + +async function runTunnel(args) { + const action = args[0]; + + logSection("Tunnel Management"); + + const serverRunning = await checkServerHealth(); + + if (!serverRunning) { + log("Server not running. Start with 'omniroute serve'", "red"); + logEndSection(); + return; + } + + if (!action || action === "list") { + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/tunnels`, { + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + const tunnels = await res.json(); + + if (tunnels.length === 0) { + log("No active tunnels", "yellow"); + } else { + for (const t of tunnels) { + const status = t.active ? colorize("● active", "green") : colorize("○ inactive", "dim"); + log(` ${t.type || "unknown"}: ${t.url || "N/A"} ${status}`); + } + } + } else { + log("Tunnel info not available", "yellow"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else if (action === "create" || action === "add") { + const tunnelType = args[1] || "cloudflare"; + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/tunnels`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ type: tunnelType }), + signal: AbortSignal.timeout(15000), + }); + + if (res.ok) { + const result = await res.json(); + log(`Tunnel created: ${result.url}`, "green"); + } else { + log("Failed to create tunnel", "red"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else if (action === "stop" || action === "delete") { + const tunnelType = args[1]; + + try { + const res = await fetch(`${DEFAULT_BASE_URL}/api/tunnels/${tunnelType}`, { + method: "DELETE", + signal: AbortSignal.timeout(5000), + }); + + if (res.ok) { + log(`Tunnel ${tunnelType} stopped`, "green"); + } else { + log("Failed to stop tunnel", "red"); + } + } catch (err) { + log(`Error: ${err.message}`, "red"); + } + } else { + log("Valid actions: list, create <type>, stop <type>"); + log("Types: cloudflare, tailscale, ngrok", "dim"); + } + + logEndSection(); +} + +// ============================================================================ +// ENVIRONMENT VARIABLES +// ============================================================================ + +async function runEnv(args) { + const action = args[0]; + + if (!action || action === "show" || action === "list") { + logSection("Environment Variables"); + + const importantVars = [ + "PORT", + "API_PORT", + "DASHBOARD_PORT", + "DATA_DIR", + "REQUIRE_API_KEY", + "LOG_LEVEL", + "NODE_ENV", + "REQUEST_TIMEOUT_MS", + "ENABLE_SOCKS5_PROXY", + ]; + + log("Current configuration:"); + console.log(); + + for (const key of importantVars) { + const value = process.env[key]; + if (value !== undefined) { + log(` ${key.padEnd(25)} ${value}`, "dim"); + } + } + + console.log(); + log("Defaults:", "dim"); + log(" PORT 20128"); + log(" DASHBOARD_PORT 20129"); + log(" DATA_DIR ~/.omniroute"); + logEndSection(); + return; + } + + if (action === "get") { + const key = args[1]; + if (!key) { + log("Usage: omniroute env get <key>", "red"); + return; + } + console.log(process.env[key] || ""); + return; + } + + if (action === "set") { + const key = args[1]; + const value = args[2]; + + if (!key || value === undefined) { + log("Usage: omniroute env set <key> <value>", "red"); + return; + } + + log(`Setting ${key}=${value} (temporary - only affects current session)`, "yellow"); + process.env[key] = value; + log("Set successfully (note: this is temporary)", "green"); + return; + } + + log("Valid actions: show, get <key>, set <key> <value>", "dim"); +} diff --git a/bin/cli/commands/config.mjs b/bin/cli/commands/config.mjs new file mode 100644 index 0000000000..32d61cba3f --- /dev/null +++ b/bin/cli/commands/config.mjs @@ -0,0 +1,182 @@ +import { parseArgs, getStringFlag, hasFlag } from "../args.mjs"; +import { printHeading, printInfo, printSuccess, printError } from "../io.mjs"; +import { resolveDataDir } from "../data-dir.mjs"; +import path from "node:path"; +import fs from "node:fs"; + +function printConfigHelp() { + console.log(` +Usage: + omniroute config list List all CLI tools and config status + omniroute config get <tool> Show current config for a tool + omniroute config set <tool> [options] Write config for a tool + omniroute config validate <tool> Validate config format without writing + +Options: + --base-url <url> OmniRoute API base URL (default: http://localhost:20128/v1) + --api-key <key> API key for the tool + --model <model> Model identifier (where applicable) + --json Output as JSON + --non-interactive Do not prompt for confirmation + --yes Skip confirmation prompt + --help Show this help + +Tools: claude, codex, opencode, cline, kilocode, continue +`); +} + +function ensureBackup(configPath) { + if (!fs.existsSync(configPath)) return; + const backupDir = path.join(path.dirname(configPath), ".omniroute.bak"); + if (!fs.existsSync(backupDir)) fs.mkdirSync(backupDir, { recursive: true }); + const backupPath = path.join(backupDir, path.basename(configPath) + ".bak"); + fs.copyFileSync(configPath, backupPath); + return backupPath; +} + +export async function runConfigCommand(argv) { + const { flags, positionals } = parseArgs(argv); + + if (hasFlag(flags, "help") || hasFlag(flags, "h") || positionals.length === 0) { + printConfigHelp(); + return 0; + } + + const subcommand = positionals[0]; + const toolId = positionals[1]; + + if (subcommand === "list") { + const { detectAllTools } = await import("../../../src/lib/cli-helper/tool-detector.js"); + const tools = await detectAllTools(); + + if (hasFlag(flags, "json")) { + console.log(JSON.stringify(tools, null, 2)); + } else { + printHeading("CLI Tool Configuration Status"); + for (const t of tools) { + const status = t.configured + ? "✓ Configured" + : t.installed + ? "✗ Not configured" + : "✗ Not installed"; + console.log(` ${t.name.padEnd(14)} ${status}`); + if (t.version) console.log(` version: ${t.version}`); + console.log(` config: ${t.configPath}`); + } + } + return 0; + } + + if (subcommand === "get") { + if (!toolId) { + printError("Tool ID required. Usage: omniroute config get <tool>"); + return 1; + } + const { detectTool } = await import("../../../src/lib/cli-helper/tool-detector.js"); + const tool = await detectTool(toolId); + if (!tool) { + printError(`Unknown tool: ${toolId}`); + return 1; + } + if (hasFlag(flags, "json")) { + console.log(JSON.stringify(tool, null, 2)); + } else { + printHeading(`${tool.name} Configuration`); + console.log(` Installed: ${tool.installed ? "Yes" : "No"}`); + console.log(` Configured: ${tool.configured ? "Yes" : "No"}`); + console.log(` Config: ${tool.configPath}`); + if (tool.version) console.log(` Version: ${tool.version}`); + if (tool.configContents) { + console.log(`\n Contents:`); + console.log(tool.configContents); + } + } + return 0; + } + + if (subcommand === "set") { + if (!toolId) { + printError("Tool ID required. Usage: omniroute config set <tool> [options]"); + return 1; + } + + const baseUrl = + getStringFlag(flags, "base-url", "OMNIROUTE_BASE_URL") || "http://localhost:20128/v1"; + const apiKey = getStringFlag(flags, "api-key", "OMNIROUTE_API_KEY"); + const model = getStringFlag(flags, "model"); + + if (!apiKey) { + printError("API key required. Use --api-key or set OMNIROUTE_API_KEY."); + return 1; + } + + const { generateConfig } = + await import("../../../src/lib/cli-helper/config-generator/index.js"); + const result = await generateConfig(toolId, { baseUrl, apiKey, model }); + + if (!result.success) { + printError(result.error || "Failed to generate config"); + return 1; + } + + const nonInteractive = hasFlag(flags, "non-interactive") || hasFlag(flags, "yes"); + + if (!nonInteractive) { + console.log(`\n About to write config to: ${result.configPath}`); + console.log(` Content preview:\n`); + console.log(result.content); + console.log(""); + + const readline = await import("node:readline"); + const rl = readline.createInterface({ input: process.stdin, output: process.stdout }); + const answer = await new Promise((resolve) => rl.question("Proceed? [y/N] ", resolve)); + rl.close(); + + if (!/^y(es)?$/i.test(answer)) { + console.log("Aborted."); + return 0; + } + } + + const dir = path.dirname(result.configPath); + if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true }); + + const backupPath = ensureBackup(result.configPath); + if (backupPath) printInfo(`Backup saved to: ${backupPath}`); + + fs.writeFileSync(result.configPath, result.content, "utf-8"); + printSuccess(`Config written to ${result.configPath}`); + return 0; + } + + if (subcommand === "validate") { + if (!toolId) { + printError("Tool ID required. Usage: omniroute config validate <tool>"); + return 1; + } + + const baseUrl = + getStringFlag(flags, "base-url", "OMNIROUTE_BASE_URL") || "http://localhost:20128/v1"; + const apiKey = getStringFlag(flags, "api-key", "OMNIROUTE_API_KEY") || "test-key"; + const model = getStringFlag(flags, "model"); + + const { generateConfig } = + await import("../../../src/lib/cli-helper/config-generator/index.js"); + const result = await generateConfig(toolId, { baseUrl, apiKey, model }); + + if (!result.success) { + printError(`Validation failed: ${result.error}`); + return 1; + } + + printSuccess(`Config for ${toolId} is valid`); + if (hasFlag(flags, "json")) { + console.log(JSON.stringify({ valid: true, content: result.content }, null, 2)); + } + return 0; + } + + printError(`Unknown subcommand: ${subcommand}`); + printConfigHelp(); + return 1; +} diff --git a/bin/cli/commands/doctor.mjs b/bin/cli/commands/doctor.mjs index b88f9faa0e..3fe11b1a31 100644 --- a/bin/cli/commands/doctor.mjs +++ b/bin/cli/commands/doctor.mjs @@ -320,14 +320,24 @@ async function checkPorts() { } async function checkNodeRuntime(rootDir) { - const { getNodeRuntimeSupport } = await import( - pathToFileURL(path.join(rootDir, "bin", "nodeRuntimeSupport.mjs")).href - ); - const support = getNodeRuntimeSupport(); - if (!support.nodeCompatible) { - return fail("Node runtime", `${support.nodeVersion} is outside supported policy`, support); + try { + const { getNodeRuntimeSupport } = await import( + pathToFileURL(path.join(rootDir, "bin", "nodeRuntimeSupport.mjs")).href + ); + const support = getNodeRuntimeSupport(); + if (!support.nodeCompatible) { + return fail("Node runtime", `${support.nodeVersion} is outside supported policy`, support); + } + return ok("Node runtime", `${support.nodeVersion} is supported`, support); + } catch { + // nodeRuntimeSupport.mjs is only available in full source installs, not in Docker images + const version = process.version; + return warn( + "Node runtime", + `${version} (runtime support module unavailable in this environment)`, + { nodeVersion: version } + ); } - return ok("Node runtime", `${support.nodeVersion} is supported`, support); } async function checkNativeBinary(rootDir) { @@ -348,14 +358,21 @@ async function checkNativeBinary(rootDir) { return warn("Native binary", "better-sqlite3 native binary was not found", { candidates }); } - const { isNativeBinaryCompatible } = await import( - pathToFileURL(path.join(rootDir, "scripts", "native-binary-compat.mjs")).href - ); - const compatible = isNativeBinaryCompatible(binaryPath); - if (!compatible) { - return fail("Native binary", "better-sqlite3 native binary is incompatible", { binaryPath }); + try { + const { isNativeBinaryCompatible } = await import( + pathToFileURL(path.join(rootDir, "scripts", "native-binary-compat.mjs")).href + ); + const compatible = isNativeBinaryCompatible(binaryPath); + if (!compatible) { + return fail("Native binary", "better-sqlite3 native binary is incompatible", { binaryPath }); + } + return ok("Native binary", "better-sqlite3 native binary is compatible", { binaryPath }); + } catch { + // native-binary-compat.mjs is only available in full source installs, not in Docker images + return warn("Native binary", "Compatibility check unavailable in this environment", { + binaryPath, + }); } - return ok("Native binary", "better-sqlite3 native binary is compatible", { binaryPath }); } function checkMemory() { @@ -449,6 +466,15 @@ export async function collectDoctorChecks(context = {}, options = {}) { checks.push(await checkServerLiveness(options)); } + // CLI tool health checks + try { + const { collectCliToolChecks } = await import("../../../src/lib/cli-helper/doctor/checks.js"); + const cliChecks = await collectCliToolChecks(); + checks.push(...cliChecks); + } catch (err) { + checks.push(warn("CLI Tools", `Could not run CLI tool checks: ${err.message}`)); + } + return { dataDir, dbPath, @@ -476,7 +502,7 @@ Options: --liveness-url <url> Full health endpoint URL override Checks: - config, database, storage/encryption, ports, Node runtime, native binary, memory, server liveness + config, database, storage/encryption, ports, Node runtime, native binary, memory, server liveness, CLI tools `); } diff --git a/bin/cli/commands/logs.mjs b/bin/cli/commands/logs.mjs new file mode 100644 index 0000000000..28763922b1 --- /dev/null +++ b/bin/cli/commands/logs.mjs @@ -0,0 +1,83 @@ +import { parseArgs, getStringFlag, hasFlag } from "../args.mjs"; +import { printHeading, printInfo, printError } from "../io.mjs"; + +function printLogsHelp() { + console.log(` +Usage: + omniroute logs [options] + +Options: + --follow Stream logs in real-time + --filter <level> Filter by level (error, warn, info) — comma-separated + --lines <n> Number of lines to fetch (default: 100) + --timeout <ms> Connection timeout in ms (default: 30000) + --base-url <url> OmniRoute API base URL (default: http://localhost:20128) + --json Output as JSON + --help Show this help +`); +} + +export async function runLogsCommand(argv) { + const { flags } = parseArgs(argv); + + if (hasFlag(flags, "help") || hasFlag(flags, "h")) { + printLogsHelp(); + return 0; + } + + const baseUrl = getStringFlag(flags, "base-url") || "http://localhost:20128"; + const follow = hasFlag(flags, "follow"); + const filter = getStringFlag(flags, "filter"); + const lines = getStringFlag(flags, "lines") || "100"; + const timeout = parseInt(getStringFlag(flags, "timeout") || "30000", 10); + + const filters = filter ? filter.split(",").map((f) => f.trim()) : []; + + const { createLogStream } = await import("../../../src/lib/cli-helper/log-streamer.js"); + const { stream, stop } = createLogStream({ baseUrl, filters, follow, timeout }); + + const reader = stream.getReader(); + const decoder = new TextDecoder(); + let buffer = ""; + + const processLine = (line) => { + if (!line.trim()) return; + if (hasFlag(flags, "json")) { + console.log(line); + return; + } + try { + const parsed = JSON.parse(line); + const level = parsed.level || "info"; + const ts = parsed.timestamp || new Date().toISOString(); + const msg = parsed.message || JSON.stringify(parsed); + const prefix = + { error: "\x1b[31m[ERR]", warn: "\x1b[33m[WRN]", info: "\x1b[36m[INF]" }[level] || "[INF]"; + console.log(`${prefix}\x1b[0m ${ts} ${msg}`); + } catch { + console.log(line); + } + }; + + try { + while (true) { + const { done, value } = await reader.read(); + if (done) break; + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split("\n"); + buffer = lines.pop() || ""; + for (const line of lines) processLine(line); + } + if (buffer) processLine(buffer); + } catch (err) { + if (err.name === "AbortError") { + printInfo("Log stream stopped."); + } else { + printError(`Log stream error: ${err.message}`); + } + } finally { + stop(); + } + + return 0; +} diff --git a/bin/cli/commands/provider-cmd.mjs b/bin/cli/commands/provider-cmd.mjs new file mode 100644 index 0000000000..bbd977d8a3 --- /dev/null +++ b/bin/cli/commands/provider-cmd.mjs @@ -0,0 +1,278 @@ +import { parseArgs, getStringFlag, hasFlag } from "../args.mjs"; +import { printHeading, printInfo, printSuccess, printError } from "../io.mjs"; +import { resolveDataDir, resolveStoragePath } from "../data-dir.mjs"; +import path from "node:path"; +import fs from "node:fs"; + +function printProviderHelp() { + console.log(` +Usage: + omniroute provider add <name> [options] Add a provider connection + omniroute provider list List configured providers + omniroute provider remove <name|id> Remove a provider connection + omniroute provider test <name|id> Test a provider connection + omniroute provider default <name|id> Set default provider + +Options: + --provider <id> Provider id (e.g., openai, anthropic, omniroute) + --api-key <key> API key for the provider + --provider-name <name> Display name for the connection + --default-model <model> Default model to use + --base-url <url> Custom base URL override + --json Output as JSON + --yes Skip confirmation + --help Show this help +`); +} + +export async function runProviderCommand(argv) { + const { flags, positionals } = parseArgs(argv); + + if (hasFlag(flags, "help") || hasFlag(flags, "h") || positionals.length === 0) { + printProviderHelp(); + return 0; + } + + const subcommand = positionals[0]; + + if (subcommand === "add") { + const providerName = positionals[1] || getStringFlag(flags, "provider"); + const apiKey = getStringFlag(flags, "api-key"); + const displayName = getStringFlag(flags, "provider-name"); + const defaultModel = getStringFlag(flags, "default-model"); + const baseUrl = getStringFlag(flags, "base-url"); + + if (!providerName) { + printError("Provider name required. Usage: omniroute provider add <name>"); + return 1; + } + + if (providerName === "omniroute") { + // Special case: add OmniRoute as a provider in OpenCode config + const opencodePath = path.join( + process.env.HOME || os.homedir(), + ".config", + "opencode", + "opencode.json" + ); + const { generateConfig } = + await import("../../../src/lib/cli-helper/config-generator/index.js"); + const result = await generateConfig("opencode", { + baseUrl: baseUrl || "http://localhost:20128/v1", + apiKey: apiKey || "", + }); + + if (!result.success) { + printError(result.error || "Failed to generate config"); + return 1; + } + + if (!hasFlag(flags, "yes")) { + console.log(`\n About to write OpenCode config to: ${opencodePath}`); + console.log(` Content:\n`); + console.log(result.content); + console.log(""); + const readline = await import("node:readline"); + const rl = readline.createInterface({ input: process.stdin, output: process.stdout }); + const answer = await new Promise((resolve) => rl.question("Proceed? [y/N] ", resolve)); + rl.close(); + if (!/^y(es)?$/i.test(answer)) { + printInfo("Aborted."); + return 0; + } + } + + const dir = path.dirname(opencodePath); + if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true }); + fs.writeFileSync(opencodePath, result.content, "utf-8"); + printSuccess(`OpenCode config written to ${opencodePath}`); + return 0; + } + + // Generic provider addition via SQLite + const dbPath = resolveStoragePath(resolveDataDir()); + if (!fs.existsSync(dbPath)) { + printError("Database not found. Run `omniroute setup` first."); + return 1; + } + + const { default: Database } = await import("better-sqlite3"); + const db = new Database(dbPath); + + try { + const stmt = db.prepare(` + INSERT INTO provider_connections (provider, name, api_key, default_model, provider_specific_data) + VALUES (?, ?, ?, ?, ?) + `); + const specificData = baseUrl ? JSON.stringify({ baseUrl }) : null; + stmt.run( + providerName, + displayName || providerName, + apiKey || "", + defaultModel || null, + specificData + ); + printSuccess(`Provider "${displayName || providerName}" added`); + } finally { + db.close(); + } + + return 0; + } + + if (subcommand === "list") { + const dbPath = resolveStoragePath(resolveDataDir()); + if (!fs.existsSync(dbPath)) { + if (isJson()) console.log(JSON.stringify([])); + else printInfo("No database found. Run `omniroute setup` first."); + return 0; + } + + const { default: Database } = await import("better-sqlite3"); + const db = new Database(dbPath); + try { + const rows = db + .prepare("SELECT id, provider, name, default_model FROM provider_connections") + .all(); + if (isJson()) { + console.log(JSON.stringify(rows, null, 2)); + } else { + printHeading("Configured Providers"); + for (const r of rows) { + console.log( + ` [${r.id}] ${r.name} (${r.provider})${r.default_model ? ` — model: ${r.default_model}` : ""}` + ); + } + } + } finally { + db.close(); + } + return 0; + } + + if (subcommand === "remove") { + const target = positionals[1]; + if (!target) { + printError("Provider name or ID required. Usage: omniroute provider remove <name|id>"); + return 1; + } + + const dbPath = resolveStoragePath(resolveDataDir()); + if (!fs.existsSync(dbPath)) { + printError("Database not found."); + return 1; + } + + const { default: Database } = await import("better-sqlite3"); + const db = new Database(dbPath); + try { + const isId = /^\d+$/.test(target); + const stmt = isId + ? db.prepare("DELETE FROM provider_connections WHERE id = ?") + : db.prepare("DELETE FROM provider_connections WHERE name = ? OR provider = ?"); + const result = stmt.run(isId ? parseInt(target, 10) : target); + if (result.changes > 0) { + printSuccess(`Removed ${result.changes} provider(s)`); + } else { + printError("Provider not found"); + } + } finally { + db.close(); + } + return 0; + } + + if (subcommand === "test") { + const target = positionals[1]; + if (!target) { + printError("Provider name or ID required. Usage: omniroute provider test <name|id>"); + return 1; + } + + const dbPath = resolveStoragePath(resolveDataDir()); + if (!fs.existsSync(dbPath)) { + printError("Database not found."); + return 1; + } + + const { default: Database } = await import("better-sqlite3"); + const db = new Database(dbPath); + try { + const isId = /^\d+$/.test(target); + const row = isId + ? db.prepare("SELECT * FROM provider_connections WHERE id = ?").get(parseInt(target, 10)) + : db + .prepare("SELECT * FROM provider_connections WHERE name = ? OR provider = ?") + .get(target); + + if (!row) { + printError("Provider not found"); + return 1; + } + + const { testProviderApiKey } = await import("../provider-test.mjs"); + const result = await testProviderApiKey({ + provider: row.provider, + apiKey: row.api_key, + defaultModel: row.default_model, + baseUrl: row.provider_specific_data ? JSON.parse(row.provider_specific_data).baseUrl : null, + }); + + if (isJson()) { + console.log(JSON.stringify(result, null, 2)); + } else if (result.valid) { + printSuccess(`Provider "${row.name}" is reachable`); + } else { + printError(`Provider test failed: ${result.error || "unknown error"}`); + } + } finally { + db.close(); + } + return 0; + } + + if (subcommand === "default") { + const target = positionals[1]; + if (!target) { + printError("Provider name or ID required. Usage: omniroute provider default <name|id>"); + return 1; + } + + const dbPath = resolveStoragePath(resolveDataDir()); + if (!fs.existsSync(dbPath)) { + printError("Database not found."); + return 1; + } + + const { default: Database } = await import("better-sqlite3"); + const db = new Database(dbPath); + try { + const isId = /^\d+$/.test(target); + const row = isId + ? db.prepare("SELECT * FROM provider_connections WHERE id = ?").get(parseInt(target, 10)) + : db + .prepare("SELECT * FROM provider_connections WHERE name = ? OR provider = ?") + .get(target); + + if (!row) { + printError("Provider not found"); + return 1; + } + + db.prepare("UPDATE provider_connections SET is_default = 0").run(); + db.prepare("UPDATE provider_connections SET is_default = 1 WHERE id = ?").run(row.id); + printSuccess(`Default provider set to "${row.name}"`); + } finally { + db.close(); + } + return 0; + } + + printError(`Unknown subcommand: ${subcommand}`); + printProviderHelp(); + return 1; +} + +function isJson() { + return process.argv.includes("--json"); +} diff --git a/bin/cli/commands/setup.mjs b/bin/cli/commands/setup.mjs index be298ed5a5..2128b0625d 100644 --- a/bin/cli/commands/setup.mjs +++ b/bin/cli/commands/setup.mjs @@ -26,8 +26,8 @@ async function resolvePassword(flags, prompt, nonInteractive) { const answer = await prompt.ask("Set an admin password now? [y/N]", "N"); if (!/^y(es)?$/i.test(answer)) return ""; - const password = await prompt.ask("Admin password"); - const confirm = await prompt.ask("Confirm password"); + const password = await prompt.askSecret("Admin password"); + const confirm = await prompt.askSecret("Confirm password"); if (password !== confirm) { throw new Error("Passwords do not match."); } diff --git a/bin/cli/commands/status.mjs b/bin/cli/commands/status.mjs new file mode 100644 index 0000000000..b7d3446aea --- /dev/null +++ b/bin/cli/commands/status.mjs @@ -0,0 +1,84 @@ +import { parseArgs, getStringFlag, hasFlag } from "../args.mjs"; +import { printHeading, printInfo, printSuccess } from "../io.mjs"; +import { resolveDataDir, resolveStoragePath } from "../data-dir.mjs"; +import path from "node:path"; +import fs from "node:fs"; +import os from "node:os"; + +function getPackageVersion() { + try { + const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), "package.json"), "utf-8")); + return pkg.version || "unknown"; + } catch { + return "unknown"; + } +} + +function formatBytes(bytes) { + if (bytes < 1024) return `${bytes} B`; + if (bytes < 1048576) return `${(bytes / 1024).toFixed(1)} KB`; + return `${(bytes / 1048576).toFixed(1)} MB`; +} + +export async function runStatusCommand(argv) { + const { flags } = parseArgs(argv); + const isJson = hasFlag(flags, "json"); + const isVerbose = hasFlag(flags, "verbose"); + + const dataDir = resolveDataDir(); + const dbPath = resolveStoragePath(dataDir); + const version = getPackageVersion(); + + const status = { + version, + dataDir, + database: { + exists: fs.existsSync(dbPath), + path: dbPath, + size: fs.existsSync(dbPath) ? formatBytes(fs.statSync(dbPath).size) : null, + }, + configDir: path.join(dataDir, "config"), + configExists: fs.existsSync(path.join(dataDir, "config")), + }; + + if (isVerbose || !isJson) { + try { + const { detectAllTools } = await import("../../../src/lib/cli-helper/tool-detector.js"); + const tools = await detectAllTools(); + status.tools = tools.map((t) => ({ + id: t.id, + name: t.name, + installed: t.installed, + configured: t.configured, + version: t.version || null, + })); + } catch { + status.tools = "unavailable"; + } + } + + if (isJson) { + console.log(JSON.stringify(status, null, 2)); + return 0; + } + + printHeading("OmniRoute Status"); + console.log(` Version: ${status.version}`); + console.log(` Data Dir: ${status.dataDir}`); + console.log( + ` Database: ${status.database.exists ? "Found" : "Not found"} (${status.database.size || "N/A"})` + ); + console.log(` Config Dir: ${status.configExists ? "Exists" : "Not found"}`); + + if (status.tools) { + console.log("\n CLI Tools:"); + for (const t of status.tools) { + const icon = t.configured ? "✓" : t.installed ? "~" : "✗"; + console.log( + ` ${icon} ${t.name.padEnd(14)} ${t.installed ? "installed" : "not installed"}${t.version ? ` (${t.version})` : ""}` + ); + } + } + + return 0; +} diff --git a/bin/cli/commands/update.mjs b/bin/cli/commands/update.mjs new file mode 100644 index 0000000000..8b8a394090 --- /dev/null +++ b/bin/cli/commands/update.mjs @@ -0,0 +1,166 @@ +import { parseArgs, getStringFlag, hasFlag } from "../args.mjs"; +import { printHeading, printInfo, printSuccess, printError } from "../io.mjs"; +import { homedir } from "node:os"; +import path from "node:path"; +import { execFile } from "node:child_process"; +import { promisify } from "node:util"; + +const execFileAsync = promisify(execFile); + +function printUpdateHelp() { + console.log(` +Usage: + omniroute update [options] + +Options: + --check Check for available update without applying + --dry-run Show what would be updated without applying + --backup Create backup before updating (default: true) + --no-backup Skip backup creation + --help Show this help + +Environment: + OMNIRoute_AUTO_UPDATE Set to "true" to enable auto-update check on startup +`); +} + +async function getCurrentVersion() { + try { + const { readFileSync } = await import("node:fs"); + const pkg = JSON.parse(readFileSync(path.join(process.cwd(), "package.json"), "utf-8")); + return pkg.version; + } catch { + return null; + } +} + +async function getLatestVersion() { + try { + const { stdout } = await execFileAsync("npm", ["view", "omniroute", "version"], { + timeout: 15000, + }); + return stdout.trim(); + } catch { + return null; + } +} + +function compareVersions(a, b) { + const pa = a.split(".").map(Number); + const pb = b.split(".").map(Number); + for (let i = 0; i < 3; i++) { + if ((pa[i] || 0) > (pb[i] || 0)) return 1; + if ((pa[i] || 0) < (pb[i] || 0)) return -1; + } + return 0; +} + +async function createBackup() { + const binPath = path.join(process.cwd(), "bin"); + const backupDir = path.join(homedir(), ".omniroute", "backups", `omniroute-${Date.now()}`); + + try { + const { mkdirSync, copyFileSync, existsSync } = await import("node:fs"); + if (!existsSync(binPath)) return null; + + mkdirSync(backupDir, { recursive: true }); + const files = ["omniroute.mjs", "cli", "nodeRuntimeSupport.mjs", "mcp-server.mjs"]; + for (const f of files) { + const src = path.join(binPath, f); + if (existsSync(src)) { + copyFileSync(src, path.join(backupDir, f)); + } + } + return backupDir; + } catch { + return null; + } +} + +export async function runUpdateCommand(argv) { + const { flags } = parseArgs(argv); + + if (hasFlag(flags, "help") || hasFlag(flags, "h")) { + printUpdateHelp(); + return 0; + } + + const checkOnly = hasFlag(flags, "check"); + const dryRun = hasFlag(flags, "dry-run"); + const skipBackup = hasFlag(flags, "no-backup"); + + const current = await getCurrentVersion(); + const latest = await getLatestVersion(); + + if (!current) { + printError("Could not determine current version"); + return 1; + } + + if (!latest) { + printError("Could not check latest version. Is npm available?"); + return 1; + } + + printHeading("OmniRoute Update"); + console.log(` Current version: ${current}`); + console.log(` Latest version: ${latest}`); + + const cmp = compareVersions(current, latest); + if (cmp >= 0) { + printSuccess("You are running the latest version!"); + return 0; + } + + console.log(`\n Update available: ${current} → ${latest}`); + + if (checkOnly) { + console.log("\n Run `omniroute update` to apply the update."); + return 0; + } + + if (dryRun) { + console.log("\n [DRY RUN] Would run: npm install -g omniroute@latest"); + if (!skipBackup) console.log(" [DRY RUN] Would create backup in ~/.omniroute/backups/"); + return 0; + } + + if (!skipBackup) { + printInfo("Creating backup..."); + const backupPath = await createBackup(); + if (backupPath) { + printSuccess(`Backup created: ${backupPath}`); + } else { + printError("Failed to create backup. Aborting update."); + return 1; + } + } + + if (!hasFlag(flags, "yes")) { + const readline = await import("node:readline"); + const rl = readline.createInterface({ input: process.stdin, output: process.stdout }); + const answer = await new Promise((resolve) => + rl.question(`Proceed with update to ${latest}? [y/N] `, resolve) + ); + rl.close(); + if (!/^y(es)?$/i.test(answer)) { + printInfo("Update aborted."); + return 0; + } + } + + printInfo("Updating OmniRoute..."); + try { + const { execSync } = await import("child_process"); + execSync("npm install -g omniroute@latest", { stdio: "inherit" }); + printSuccess(`Updated to version ${latest}`); + printInfo("Run `omniroute --version` to verify."); + return 0; + } catch (err) { + printError(`Update failed: ${err.message}`); + printInfo("Restore from backup:"); + const backupDir = path.join(homedir(), ".omniroute", "backups"); + printInfo(` ls ${backupDir}`); + return 1; + } +} diff --git a/bin/cli/index.mjs b/bin/cli/index.mjs index c9c8683016..a908b54745 100644 --- a/bin/cli/index.mjs +++ b/bin/cli/index.mjs @@ -1,6 +1,11 @@ import { runDoctorCommand } from "./commands/doctor.mjs"; import { runProvidersCommand } from "./commands/providers.mjs"; import { runSetupCommand } from "./commands/setup.mjs"; +import { runConfigCommand } from "./commands/config.mjs"; +import { runStatusCommand } from "./commands/status.mjs"; +import { runLogsCommand } from "./commands/logs.mjs"; +import { runUpdateCommand } from "./commands/update.mjs"; +import { runProviderCommand } from "./commands/provider-cmd.mjs"; export async function runCliCommand(command, argv, context = {}) { if (command === "doctor") { @@ -15,5 +20,25 @@ export async function runCliCommand(command, argv, context = {}) { return runSetupCommand(argv, context); } + if (command === "config") { + return runConfigCommand(argv); + } + + if (command === "status") { + return runStatusCommand(argv); + } + + if (command === "logs") { + return runLogsCommand(argv); + } + + if (command === "update") { + return runUpdateCommand(argv); + } + + if (command === "provider") { + return runProviderCommand(argv); + } + throw new Error(`Unknown CLI command: ${command}`); } diff --git a/bin/cli/io.mjs b/bin/cli/io.mjs index ee200b4921..97b419dc77 100644 --- a/bin/cli/io.mjs +++ b/bin/cli/io.mjs @@ -16,11 +16,31 @@ export function createPrompt() { }); } + function askSecret(question) { + return new Promise((resolve) => { + let prompted = false; + const saved = rl._writeToOutput.bind(rl); + rl._writeToOutput = function (str) { + if (!prompted) { + rl.output.write(str); + if (str.endsWith(": ")) prompted = true; + return; + } + // Suppress character echo; allow only newlines through + if (str === "\r\n" || str === "\n" || str === "\r") rl.output.write("\n"); + }; + rl.question(`${question}: `, (answer) => { + rl._writeToOutput = saved; + resolve(answer.trim()); + }); + }); + } + function close() { rl.close(); } - return { ask, close }; + return { ask, askSecret, close }; } export function printHeading(title) { @@ -34,3 +54,7 @@ export function printSuccess(message) { export function printInfo(message) { console.log(`\x1b[2m${message}\x1b[0m`); } + +export function printError(message) { + console.log(`\x1b[31m✖ ${message}\x1b[0m`); +} diff --git a/bin/omniroute.mjs b/bin/omniroute.mjs index 8202818956..b40f63d9ab 100644 --- a/bin/omniroute.mjs +++ b/bin/omniroute.mjs @@ -79,7 +79,16 @@ loadEnvFile(); const args = process.argv.slice(2); const command = args[0]; -const CLI_COMMANDS = new Set(["doctor", "providers", "setup"]); +const CLI_COMMANDS = new Set([ + "doctor", + "providers", + "setup", + "config", + "status", + "logs", + "update", + "provider", +]); if (CLI_COMMANDS.has(command)) { try { @@ -106,6 +115,67 @@ if (args.includes("--help") || args.includes("-h")) { omniroute --no-open Don't open browser automatically omniroute --mcp Start MCP server (stdio transport for IDEs) omniroute reset-encrypted-columns Reset encrypted credentials (recovery) + + \x1b[1mServer Management:\x1b[0m + omniroute serve Start the OmniRoute server + omniroute stop Stop the running server + omniroute restart Restart the server + omniroute dashboard Open dashboard in browser + omniroute open Alias for dashboard (same as dashboard) + + \x1b[1mCLI Integration Suite:\x1b[0m + omniroute setup Interactive wizard to configure CLI tools + omniroute doctor Run health diagnostics + omniroute status Show comprehensive status + omniroute logs Stream request logs (--json, --search, --follow) + omniroute config show Display current configuration + + \x1b[1mProvider & Keys:\x1b[0m + omniroute provider list List available providers + omniroute provider add Add OmniRoute as provider + omniroute keys add Add API key for provider + omniroute keys list List configured API keys + omniroute keys remove Remove API key + + \x1b[1mModels & Combos:\x1b[0m + omniroute models List available models (--json, --search) + omniroute models <prov> Filter models by provider + omniroute combo list List routing combos + omniroute combo switch Switch active combo + omniroute combo create Create new combo + omniroute combo delete Delete a combo + + \x1b[1mBackup & Restore:\x1b[0m + omniroute backup Create backup of config & DB + omniroute restore Restore from backup (list or specify timestamp) + + \x1b[1mMonitoring:\x1b[0m + omniroute health Detailed health (breakers, cache, memory) + omniroute quota Show provider quota usage + omniroute cache Show cache status + omniroute cache clear Clear semantic/signature cache + + \x1b[1mProtocols:\x1b[0m + omniroute mcp status MCP server status + omniroute mcp restart Restart MCP server + omniroute a2a status A2A server status + omniroute a2a card Show A2A agent card + + \x1b[1mTunnels & Network:\x1b[0m + omniroute tunnel list List active tunnels + omniroute tunnel create Create tunnel (cloudflare/tailscale/ngrok) + omniroute tunnel stop Stop a tunnel + + \x1b[1mEnvironment:\x1b[0m + omniroute env show Show environment variables + omniroute env get <key> Get specific env var + omniroute env set <k> <v> Set env var (temporary) + + \x1b[1mTools & Utils:\x1b[0m + omniroute test Test provider connectivity + omniroute update Check for updates + omniroute completion Generate shell completion + omniroute --help Show this help omniroute --version Show version @@ -139,6 +209,18 @@ if (args.includes("--help") || args.includes("-h")) { omniroute providers test-all omniroute providers validate + \x1b[1mCLI Tools:\x1b[0m + omniroute config list List CLI tool configuration status + omniroute config get <tool> Show config for a specific tool + omniroute config set <tool> Write config for a tool + omniroute config validate <tool> Validate config without writing + omniroute status Offline status dashboard + omniroute logs [--follow] [--filter] Stream usage logs + omniroute update [--check] [--dry-run] Check or apply OmniRoute update + omniroute provider add <name> Add a provider connection + omniroute provider list List configured providers + omniroute provider test <name|id> Test a provider connection + \x1b[1mAfter starting:\x1b[0m Dashboard: http://localhost:<dashboard-port> API: http://localhost:<api-port>/v1 @@ -160,6 +242,24 @@ if (args.includes("--version") || args.includes("-v")) { process.exit(0); } +// ── CLI Integration Suite subcommands ─────────────────────────────────────── +const subcommands = [ + "setup", "doctor", "status", "logs", "provider", "config", "test", "update", + "serve", "stop", "restart", + "keys", "models", "combo", + "completion", "dashboard", + "backup", "restore", "quota", "health", + "cache", "mcp", "a2a", "tunnel", + "env", "open" +]; +const subcommand = args[0]; + +if (subcommands.includes(subcommand)) { + const { runSubcommand } = await import("./cli-commands.mjs"); + await runSubcommand(subcommand, args.slice(1)); + process.exit(0); +} + // ── reset-encrypted-columns subcommand ────────────────────────────────────── // Recovery tool for users who lost STORAGE_ENCRYPTION_KEY after upgrade (#1622) if (args.includes("reset-encrypted-columns")) { diff --git a/config/i18n-schema.json b/config/i18n-schema.json new file mode 100644 index 0000000000..fb5ee16664 --- /dev/null +++ b/config/i18n-schema.json @@ -0,0 +1,65 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "OmniRoute i18n config", + "description": "Canonical list of locales used by both the UI (next-intl) and the docs translation pipeline.", + "type": "object", + "required": ["default", "rtl", "locales"], + "additionalProperties": false, + "properties": { + "$schema": { "type": "string" }, + "default": { + "type": "string", + "description": "Default fallback locale code (must exist in `locales`)." + }, + "rtl": { + "type": "array", + "description": "Locale codes that should be rendered right-to-left.", + "items": { "type": "string" } + }, + "uiOnly": { + "type": "array", + "description": "Locale codes shipped in the UI but not produced as a docs translation target.", + "items": { "type": "string" } + }, + "docsExcluded": { + "type": "array", + "description": "Locale codes that should NOT receive docs translations (e.g. the source language).", + "items": { "type": "string" } + }, + "locales": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": ["code", "label", "name", "flag"], + "additionalProperties": false, + "properties": { + "code": { + "type": "string", + "description": "Locale code (ISO-639-1, optionally with region — e.g. `pt-BR`)." + }, + "label": { + "type": "string", + "description": "Short uppercase label for compact UI badges." + }, + "name": { + "type": "string", + "description": "Display name in the locale's native script (kept for compatibility with existing LanguageSelector)." + }, + "native": { + "type": "string", + "description": "Same as `name` — present as an alias so new code can rely on a stable field name." + }, + "english": { + "type": "string", + "description": "English name of the language (used by the docs translator system prompt)." + }, + "flag": { + "type": "string", + "description": "Flag emoji shown next to the locale." + } + } + } + } + } +} diff --git a/config/i18n.json b/config/i18n.json new file mode 100644 index 0000000000..fe548c41ff --- /dev/null +++ b/config/i18n.json @@ -0,0 +1,337 @@ +{ + "$schema": "./i18n-schema.json", + "default": "en", + "rtl": ["ar", "fa", "he", "ur"], + "uiOnly": ["en"], + "docsExcluded": ["en"], + "locales": [ + { + "code": "ar", + "label": "AR", + "name": "العربية", + "native": "العربية", + "english": "Arabic", + "flag": "🇸🇦" + }, + { + "code": "bg", + "label": "BG", + "name": "Български", + "native": "Български", + "english": "Bulgarian", + "flag": "🇧🇬" + }, + { + "code": "bn", + "label": "BN", + "name": "বাংলা", + "native": "বাংলা", + "english": "Bengali", + "flag": "🇧🇩" + }, + { + "code": "cs", + "label": "CS", + "name": "Čeština", + "native": "Čeština", + "english": "Czech", + "flag": "🇨🇿" + }, + { + "code": "da", + "label": "DA", + "name": "Dansk", + "native": "Dansk", + "english": "Danish", + "flag": "🇩🇰" + }, + { + "code": "de", + "label": "DE", + "name": "Deutsch", + "native": "Deutsch", + "english": "German", + "flag": "🇩🇪" + }, + { + "code": "en", + "label": "EN", + "name": "English", + "native": "English", + "english": "English", + "flag": "🇺🇸" + }, + { + "code": "es", + "label": "ES", + "name": "Español", + "native": "Español", + "english": "Spanish", + "flag": "🇪🇸" + }, + { + "code": "fa", + "label": "FA", + "name": "فارسی", + "native": "فارسی", + "english": "Persian", + "flag": "🇮🇷" + }, + { + "code": "fi", + "label": "FI", + "name": "Suomi", + "native": "Suomi", + "english": "Finnish", + "flag": "🇫🇮" + }, + { + "code": "fr", + "label": "FR", + "name": "Français", + "native": "Français", + "english": "French", + "flag": "🇫🇷" + }, + { + "code": "gu", + "label": "GU", + "name": "ગુજરાતી", + "native": "ગુજરાતી", + "english": "Gujarati", + "flag": "🇮🇳" + }, + { + "code": "he", + "label": "HE", + "name": "עברית", + "native": "עברית", + "english": "Hebrew", + "flag": "🇮🇱" + }, + { + "code": "hi", + "label": "HI", + "name": "हिन्दी", + "native": "हिन्दी", + "english": "Hindi", + "flag": "🇮🇳" + }, + { + "code": "hu", + "label": "HU", + "name": "Magyar", + "native": "Magyar", + "english": "Hungarian", + "flag": "🇭🇺" + }, + { + "code": "id", + "label": "ID", + "name": "Bahasa Indonesia", + "native": "Bahasa Indonesia", + "english": "Indonesian", + "flag": "🇮🇩" + }, + { + "code": "in", + "label": "IN", + "name": "Bahasa Indonesia (Alt)", + "native": "Bahasa Indonesia (Alt)", + "english": "Indonesian (Legacy)", + "flag": "🇮🇩" + }, + { + "code": "it", + "label": "IT", + "name": "Italiano", + "native": "Italiano", + "english": "Italian", + "flag": "🇮🇹" + }, + { + "code": "ja", + "label": "JA", + "name": "日本語", + "native": "日本語", + "english": "Japanese", + "flag": "🇯🇵" + }, + { + "code": "ko", + "label": "KO", + "name": "한국어", + "native": "한국어", + "english": "Korean", + "flag": "🇰🇷" + }, + { + "code": "mr", + "label": "MR", + "name": "मराठी", + "native": "मराठी", + "english": "Marathi", + "flag": "🇮🇳" + }, + { + "code": "ms", + "label": "MS", + "name": "Bahasa Melayu", + "native": "Bahasa Melayu", + "english": "Malay", + "flag": "🇲🇾" + }, + { + "code": "nl", + "label": "NL", + "name": "Nederlands", + "native": "Nederlands", + "english": "Dutch", + "flag": "🇳🇱" + }, + { + "code": "no", + "label": "NO", + "name": "Norsk", + "native": "Norsk", + "english": "Norwegian", + "flag": "🇳🇴" + }, + { + "code": "phi", + "label": "PHI", + "name": "Filipino", + "native": "Filipino", + "english": "Filipino", + "flag": "🇵🇭" + }, + { + "code": "pl", + "label": "PL", + "name": "Polski", + "native": "Polski", + "english": "Polish", + "flag": "🇵🇱" + }, + { + "code": "pt", + "label": "PT", + "name": "Português (Portugal)", + "native": "Português (Portugal)", + "english": "Portuguese (Portugal)", + "flag": "🇵🇹" + }, + { + "code": "pt-BR", + "label": "PT-BR", + "name": "Português (Brasil)", + "native": "Português (Brasil)", + "english": "Portuguese (Brazil)", + "flag": "🇧🇷" + }, + { + "code": "ro", + "label": "RO", + "name": "Română", + "native": "Română", + "english": "Romanian", + "flag": "🇷🇴" + }, + { + "code": "ru", + "label": "RU", + "name": "Русский", + "native": "Русский", + "english": "Russian", + "flag": "🇷🇺" + }, + { + "code": "sk", + "label": "SK", + "name": "Slovenčina", + "native": "Slovenčina", + "english": "Slovak", + "flag": "🇸🇰" + }, + { + "code": "sv", + "label": "SV", + "name": "Svenska", + "native": "Svenska", + "english": "Swedish", + "flag": "🇸🇪" + }, + { + "code": "sw", + "label": "SW", + "name": "Kiswahili", + "native": "Kiswahili", + "english": "Swahili", + "flag": "🇰🇪" + }, + { + "code": "ta", + "label": "TA", + "name": "தமிழ்", + "native": "தமிழ்", + "english": "Tamil", + "flag": "🇮🇳" + }, + { + "code": "te", + "label": "TE", + "name": "తెలుగు", + "native": "తెలుగు", + "english": "Telugu", + "flag": "🇮🇳" + }, + { + "code": "th", + "label": "TH", + "name": "ไทย", + "native": "ไทย", + "english": "Thai", + "flag": "🇹🇭" + }, + { + "code": "tr", + "label": "TR", + "name": "Türkçe", + "native": "Türkçe", + "english": "Turkish", + "flag": "🇹🇷" + }, + { + "code": "uk-UA", + "label": "UK-UA", + "name": "Українська", + "native": "Українська", + "english": "Ukrainian", + "flag": "🇺🇦" + }, + { + "code": "ur", + "label": "UR", + "name": "اردو", + "native": "اردو", + "english": "Urdu", + "flag": "🇵🇰" + }, + { + "code": "vi", + "label": "VI", + "name": "Tiếng Việt", + "native": "Tiếng Việt", + "english": "Vietnamese", + "flag": "🇻🇳" + }, + { + "code": "zh-CN", + "label": "ZH-CN", + "name": "中文 (简体)", + "native": "中文 (简体)", + "english": "Chinese (Simplified)", + "flag": "🇨🇳" + } + ] +} diff --git a/docker-compose.yml b/docker-compose.yml index 8c53d290c5..0b5a762837 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -41,7 +41,7 @@ x-common: &common services: # ── Redis (Rate Limiter Backend) ────────────────────────────────── redis: - image: redis:8.6.2 + image: redis:7-alpine container_name: omniroute-redis restart: unless-stopped ports: diff --git a/docs/API_REFERENCE.md b/docs/API_REFERENCE.md deleted file mode 100644 index ea93b8c320..0000000000 --- a/docs/API_REFERENCE.md +++ /dev/null @@ -1,488 +0,0 @@ -# API Reference - -🌐 **Languages:** 🇺🇸 [English](API_REFERENCE.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/API_REFERENCE.md) | 🇪🇸 [Español](i18n/es/API_REFERENCE.md) | 🇫🇷 [Français](i18n/fr/API_REFERENCE.md) | 🇮🇹 [Italiano](i18n/it/API_REFERENCE.md) | 🇷🇺 [Русский](i18n/ru/API_REFERENCE.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/API_REFERENCE.md) | 🇩🇪 [Deutsch](i18n/de/API_REFERENCE.md) | 🇮🇳 [हिन्दी](i18n/in/API_REFERENCE.md) | 🇹🇭 [ไทย](i18n/th/API_REFERENCE.md) | 🇺🇦 [Українська](i18n/uk-UA/API_REFERENCE.md) | 🇸🇦 [العربية](i18n/ar/API_REFERENCE.md) | 🇯🇵 [日本語](i18n/ja/API_REFERENCE.md) | 🇻🇳 [Tiếng Việt](i18n/vi/API_REFERENCE.md) | 🇧🇬 [Български](i18n/bg/API_REFERENCE.md) | 🇩🇰 [Dansk](i18n/da/API_REFERENCE.md) | 🇫🇮 [Suomi](i18n/fi/API_REFERENCE.md) | 🇮🇱 [עברית](i18n/he/API_REFERENCE.md) | 🇭🇺 [Magyar](i18n/hu/API_REFERENCE.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/API_REFERENCE.md) | 🇰🇷 [한국어](i18n/ko/API_REFERENCE.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/API_REFERENCE.md) | 🇳🇱 [Nederlands](i18n/nl/API_REFERENCE.md) | 🇳🇴 [Norsk](i18n/no/API_REFERENCE.md) | 🇵🇹 [Português (Portugal)](i18n/pt/API_REFERENCE.md) | 🇷🇴 [Română](i18n/ro/API_REFERENCE.md) | 🇵🇱 [Polski](i18n/pl/API_REFERENCE.md) | 🇸🇰 [Slovenčina](i18n/sk/API_REFERENCE.md) | 🇸🇪 [Svenska](i18n/sv/API_REFERENCE.md) | 🇵🇭 [Filipino](i18n/phi/API_REFERENCE.md) | 🇨🇿 [Čeština](i18n/cs/API_REFERENCE.md) - -Complete reference for all OmniRoute API endpoints. - ---- - -## Table of Contents - -- [Chat Completions](#chat-completions) -- [Embeddings](#embeddings) -- [Image Generation](#image-generation) -- [List Models](#list-models) -- [Compatibility Endpoints](#compatibility-endpoints) -- [Semantic Cache](#semantic-cache) -- [Dashboard & Management](#dashboard--management) -- [Request Processing](#request-processing) -- [Authentication](#authentication) - ---- - -## Chat Completions - -```bash -POST /v1/chat/completions -Authorization: Bearer your-api-key -Content-Type: application/json - -{ - "model": "cc/claude-opus-4-6", - "messages": [ - {"role": "user", "content": "Write a function to..."} - ], - "stream": true -} -``` - -### Custom Headers - -| Header | Direction | Description | -| ------------------------ | --------- | ------------------------------------------------ | -| `X-OmniRoute-No-Cache` | Request | Set to `true` to bypass cache | -| `X-OmniRoute-Progress` | Request | Set to `true` for progress events | -| `X-Session-Id` | Request | Sticky session key for external session affinity | -| `x_session_id` | Request | Underscore variant also accepted (direct HTTP) | -| `Idempotency-Key` | Request | Dedup key (5s window) | -| `X-Request-Id` | Request | Alternative dedup key | -| `X-OmniRoute-Cache` | Response | `HIT` or `MISS` (non-streaming) | -| `X-OmniRoute-Idempotent` | Response | `true` if deduplicated | -| `X-OmniRoute-Progress` | Response | `enabled` if progress tracking on | -| `X-OmniRoute-Session-Id` | Response | Effective session ID used by OmniRoute | - -> Nginx note: if you rely on underscore headers (for example `x_session_id`), enable `underscores_in_headers on;`. - ---- - -## Embeddings - -```bash -POST /v1/embeddings -Authorization: Bearer your-api-key -Content-Type: application/json - -{ - "model": "nebius/Qwen/Qwen3-Embedding-8B", - "input": "The food was delicious" -} -``` - -Available providers: Nebius, OpenAI, Mistral, Together AI, Fireworks, NVIDIA, **OpenRouter**, **GitHub Models**. - -```bash -# List all embedding models -GET /v1/embeddings -``` - ---- - -## Image Generation - -```bash -POST /v1/images/generations -Authorization: Bearer your-api-key -Content-Type: application/json - -{ - "model": "openai/gpt-image-2", - "prompt": "A beautiful sunset over mountains", - "size": "1024x1024" -} -``` - -Available providers: OpenAI (GPT Image 2), xAI (Grok Image), Together AI (FLUX), Fireworks AI, Nebius (FLUX), Hyperbolic, NanoBanana, **OpenRouter**, SD WebUI (local), ComfyUI (local). - -```bash -# List all image models -GET /v1/images/generations -``` - ---- - -## List Models - -```bash -GET /v1/models -Authorization: Bearer your-api-key - -→ Returns all chat, embedding, and image models + combos in OpenAI format -``` - ---- - -## Compatibility Endpoints - -| Method | Path | Format | -| ------ | --------------------------- | ---------------------- | -| POST | `/v1/chat/completions` | OpenAI | -| POST | `/v1/messages` | Anthropic | -| POST | `/v1/responses` | OpenAI Responses | -| POST | `/v1/embeddings` | OpenAI | -| POST | `/v1/images/generations` | OpenAI | -| GET | `/v1/models` | OpenAI | -| POST | `/v1/messages/count_tokens` | Anthropic | -| GET | `/v1beta/models` | Gemini | -| POST | `/v1beta/models/{...path}` | Gemini generateContent | -| POST | `/v1/api/chat` | Ollama | - -### Dedicated Provider Routes - -```bash -POST /v1/providers/{provider}/chat/completions -POST /v1/providers/{provider}/embeddings -POST /v1/providers/{provider}/images/generations -``` - -The provider prefix is auto-added if missing. Mismatched models return `400`. - ---- - -## Semantic Cache - -```bash -# Get cache stats -GET /api/cache/stats - -# Clear all caches -DELETE /api/cache/stats -``` - -Response example: - -```json -{ - "semanticCache": { - "memorySize": 42, - "memoryMaxSize": 500, - "dbSize": 128, - "hitRate": 0.65 - }, - "idempotency": { - "activeKeys": 3, - "windowMs": 5000 - } -} -``` - ---- - -## Dashboard & Management - -### Authentication - -| Endpoint | Method | Description | -| ----------------------------- | ------- | --------------------- | -| `/api/auth/login` | POST | Login | -| `/api/auth/logout` | POST | Logout | -| `/api/settings/require-login` | GET/PUT | Toggle login required | - -### Provider Management - -| Endpoint | Method | Description | -| ---------------------------- | --------------------- | ---------------------------------------------- | -| `/api/providers` | GET/POST | List / create providers | -| `/api/providers/[id]` | GET/PUT/DELETE | Manage a provider | -| `/api/providers/[id]/test` | POST | Test provider connection | -| `/api/providers/[id]/models` | GET | List provider models | -| `/api/providers/validate` | POST | Validate provider config | -| `/api/provider-nodes*` | Various | Provider node management | -| `/api/provider-models` | GET/POST/PATCH/DELETE | Custom models (add, update, hide/show, delete) | - -### OAuth Flows - -| Endpoint | Method | Description | -| -------------------------------- | ------- | ----------------------- | -| `/api/oauth/[provider]/[action]` | Various | Provider-specific OAuth | - -### Routing & Config - -| Endpoint | Method | Description | -| --------------------- | -------- | ----------------------------- | -| `/api/models/alias` | GET/POST | Model aliases | -| `/api/models/catalog` | GET | All models by provider + type | -| `/api/combos*` | Various | Combo management | -| `/api/keys*` | Various | API key management | -| `/api/pricing` | GET | Model pricing | - -### Usage & Analytics - -| Endpoint | Method | Description | -| --------------------------- | ------ | -------------------- | -| `/api/usage/history` | GET | Usage history | -| `/api/usage/logs` | GET | Usage logs | -| `/api/usage/request-logs` | GET | Request-level logs | -| `/api/usage/[connectionId]` | GET | Per-connection usage | - -### Settings - -| Endpoint | Method | Description | -| ------------------------------- | ------------- | ------------------------- | -| `/api/settings` | GET/PUT/PATCH | General settings | -| `/api/settings/proxy` | GET/PUT | Network proxy config | -| `/api/settings/proxy/test` | POST | Test proxy connection | -| `/api/settings/ip-filter` | GET/PUT | IP allowlist/blocklist | -| `/api/settings/thinking-budget` | GET/PUT | Reasoning token budget | -| `/api/settings/system-prompt` | GET/PUT | Global system prompt | -| `/api/settings/compression` | GET/PUT | Global compression config | - -### Context & Compression - -| Endpoint | Method | Description | -| -------------------------------------- | -------------- | ------------------------------------------------------------------------ | -| `/api/compression/preview` | POST | Preview off/lite/standard/aggressive/ultra/RTK/stacked compression | -| `/api/compression/language-packs` | GET | List available Caveman language packs | -| `/api/compression/rules` | GET | List Caveman rule metadata | -| `/api/context/caveman/config` | GET/PUT | Caveman-specific settings alias | -| `/api/context/rtk/config` | GET/PUT | RTK-specific settings, including custom filters and raw-output retention | -| `/api/context/rtk/filters` | GET | RTK filter catalog and custom-filter diagnostics | -| `/api/context/rtk/test` | POST | Run RTK preview/test against a text payload | -| `/api/context/rtk/raw-output/[id]` | GET | Read retained redacted raw output by pointer id | -| `/api/context/combos` | GET/POST | Compression combo list/create | -| `/api/context/combos/[id]` | GET/PUT/DELETE | Compression combo detail/update/delete | -| `/api/context/combos/[id]/assignments` | GET/PUT | Assign compression combos to routing combos | -| `/api/context/analytics` | GET | Compression analytics alias | - -### Monitoring - -| Endpoint | Method | Description | -| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------- | -| `/api/sessions` | GET | Active session tracking | -| `/api/rate-limits` | GET | Per-account rate limits | -| `/api/monitoring/health` | GET | Health check + provider summary (`catalogCount`, `configuredCount`, `activeCount`, `monitoredCount`) | -| `/api/cache/stats` | 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 | -| ---------------------- | ------- | --------------------- | -| `/api/sync/cloud` | Various | Cloud sync operations | -| `/api/sync/initialize` | POST | Initialize sync | -| `/api/cloud/*` | Various | Cloud management | - -### Tunnels - -| Endpoint | Method | Description | -| -------------------------- | ------ | ----------------------------------------------------------------------- | -| `/api/tunnels/cloudflared` | GET | Read Cloudflare Quick Tunnel install/runtime status for the dashboard | -| `/api/tunnels/cloudflared` | POST | Enable or disable the Cloudflare Quick Tunnel (`action=enable/disable`) | -| `/api/tunnels/ngrok` | GET | Read ngrok Tunnel runtime status for the dashboard | -| `/api/tunnels/ngrok` | POST | Enable or disable the ngrok Tunnel (`action=enable/disable`) | - -### CLI Tools - -| Endpoint | Method | Description | -| ---------------------------------- | ------ | ------------------- | -| `/api/cli-tools/claude-settings` | GET | Claude CLI status | -| `/api/cli-tools/codex-settings` | GET | Codex CLI status | -| `/api/cli-tools/droid-settings` | GET | Droid CLI status | -| `/api/cli-tools/openclaw-settings` | GET | OpenClaw CLI status | -| `/api/cli-tools/runtime/[toolId]` | GET | Generic CLI runtime | - -CLI responses include: `installed`, `runnable`, `command`, `commandPath`, `runtimeMode`, `reason`. - -### ACP Agents - -| Endpoint | Method | Description | -| ----------------- | ------ | -------------------------------------------------------- | -| `/api/acp/agents` | GET | List all detected agents (built-in + custom) with status | -| `/api/acp/agents` | POST | Add custom agent or refresh detection cache | -| `/api/acp/agents` | DELETE | Remove a custom agent by `id` query param | - -GET response includes `agents[]` (id, name, binary, version, installed, protocol, isCustom) and `summary` (total, installed, notFound, builtIn, custom). - -### Resilience & Rate Limits - -| Endpoint | Method | Description | -| ----------------------- | --------- | ---------------------------------------------------------------------------------- | -| `/api/resilience` | GET/PATCH | Get/update request queue, connection cooldown, provider breaker, and wait settings | -| `/api/resilience/reset` | POST | Reset provider circuit breakers | -| `/api/rate-limits` | GET | Per-account rate limit status | -| `/api/rate-limit` | GET | Global rate limit configuration | - -### Evals - -| Endpoint | Method | Description | -| ------------ | -------- | --------------------------------- | -| `/api/evals` | GET/POST | List eval suites / run evaluation | - -### Policies - -| Endpoint | Method | Description | -| --------------- | --------------- | ----------------------- | -| `/api/policies` | GET/POST/DELETE | Manage routing policies | - -### Compliance - -| Endpoint | Method | Description | -| --------------------------- | ------ | ----------------------------- | -| `/api/compliance/audit-log` | GET | Compliance audit log (last N) | - -### v1beta (Gemini-Compatible) - -| Endpoint | Method | Description | -| -------------------------- | ------ | --------------------------------- | -| `/v1beta/models` | GET | List models in Gemini format | -| `/v1beta/models/{...path}` | POST | Gemini `generateContent` endpoint | - -These endpoints mirror Gemini's API format for clients that expect native Gemini SDK compatibility. - -### Internal / System APIs - -| Endpoint | Method | Description | -| ------------------------ | ------ | ---------------------------------------------------- | -| `/api/init` | GET | Application initialization check (used on first run) | -| `/api/tags` | GET | Ollama-compatible model tags (for Ollama clients) | -| `/api/restart` | POST | Trigger graceful server restart | -| `/api/shutdown` | POST | Trigger graceful server shutdown | -| `/api/system/env/repair` | POST | Repair OAuth provider environment variables | -| `/api/system-info` | GET | Generate system diagnostics report | - -> **Note:** These endpoints are used internally by the system or for Ollama client compatibility. They are not typically called by end users. - -### OAuth Environment Repair _(v3.6.1+)_ - -```bash -POST /api/system/env/repair -Content-Type: application/json - -{ - "provider": "claude-code" -} -``` - -Repairs missing or corrupted OAuth environment variables for a specific provider. Returns: - -```json -{ - "success": true, - "repaired": ["CLAUDE_CODE_OAUTH_CLIENT_ID", "CLAUDE_CODE_OAUTH_CLIENT_SECRET"], - "backupPath": "/home/user/.omniroute/backups/env-repair-2026-04-11.bak" -} -``` - ---- - -## Audio Transcription - -```bash -POST /v1/audio/transcriptions -Authorization: Bearer your-api-key -Content-Type: multipart/form-data -``` - -Transcribe audio files using Deepgram or AssemblyAI. - -**Request:** - -```bash -curl -X POST http://localhost:20128/v1/audio/transcriptions \ - -H "Authorization: Bearer your-api-key" \ - -F "file=@recording.mp3" \ - -F "model=deepgram/nova-3" -``` - -**Response:** - -```json -{ - "text": "Hello, this is the transcribed audio content.", - "task": "transcribe", - "language": "en", - "duration": 12.5 -} -``` - -**Supported providers:** `deepgram/nova-3`, `assemblyai/best`. - -**Supported formats:** `mp3`, `wav`, `m4a`, `flac`, `ogg`, `webm`. - ---- - -## Ollama Compatibility - -For clients that use Ollama's API format: - -```bash -# Chat endpoint (Ollama format) -POST /v1/api/chat - -# Model listing (Ollama format) -GET /api/tags -``` - -Requests are automatically translated between Ollama and internal formats. - ---- - -## Telemetry - -```bash -# Get latency telemetry summary (p50/p95/p99 per provider) -GET /api/telemetry/summary -``` - -**Response:** - -```json -{ - "providers": { - "claudeCode": { "p50": 245, "p95": 890, "p99": 1200, "count": 150 }, - "github": { "p50": 180, "p95": 620, "p99": 950, "count": 320 } - } -} -``` - ---- - -## Budget - -```bash -# Get budget status for all API keys -GET /api/usage/budget - -# Set or update a budget -POST /api/usage/budget -Content-Type: application/json - -{ - "keyId": "key-123", - "limit": 50.00, - "period": "monthly" -} -``` - -## Request Processing - -1. Client sends request to `/v1/*` -2. Route handler calls `handleChat`, `handleEmbedding`, `handleAudioTranscription`, or `handleImageGeneration` -3. Model is resolved (direct provider/model or alias/combo) -4. Credentials selected from local DB with account availability filtering -5. For chat: `handleChatCore` checks semantic/signature cache and resolves combo compression settings -6. Proactive compression runs before provider translation when enabled (`lite`, Caveman, RTK, or stacked) -7. Provider executor sends upstream request -8. Response translated back to client format (chat) or returned as-is (embeddings/images/audio) -9. Usage, compression analytics, and request logs are recorded -10. Fallback applies on errors according to combo rules - -Full architecture reference: [`ARCHITECTURE.md`](ARCHITECTURE.md) - ---- - -## Authentication - -- Dashboard routes (`/dashboard/*`) use `auth_token` cookie -- Login uses saved password hash; fallback to `INITIAL_PASSWORD` -- `requireLogin` toggleable via `/api/settings/require-login` -- `/v1/*` routes optionally require Bearer API key when `REQUIRE_API_KEY=true` diff --git a/docs/AUTO-COMBO.md b/docs/AUTO-COMBO.md index afa5463279..c042204b81 100644 --- a/docs/AUTO-COMBO.md +++ b/docs/AUTO-COMBO.md @@ -1,8 +1,79 @@ # OmniRoute Auto-Combo Engine -> Self-managing model chains with adaptive scoring +> Self-managing model chains with adaptive scoring + zero-config auto-routing -## How It Works +## Zero-Config Auto-Routing (`auto/` prefix) + +> **NEW:** No combo creation required. Use `auto/` prefix directly in any client. + +### Quick Examples + +| Model ID | Variant | Behavior | +| -------------- | ------- | ------------------------------------------------------------------------ | +| `auto` | default | All connected providers, LKGP strategy, balanced weights | +| `auto/coding` | coding | Quality-first weights, suitable for code generation | +| `auto/fast` | fast | Low-latency weighted selection | +| `auto/cheap` | cheap | Cost-optimized routing (lowest cost first) | +| `auto/offline` | offline | Favors providers with highest quota availability | +| `auto/smart` | smart | Quality-first + higher exploration rate (10%) for better model discovery | +| `auto/lkgp` | lkgp | Explicit LKGP (same as default `auto`) | + +**How to use:** + +```bash +# Any IDE or CLI tool that supports OpenAI format +Base URL: http://localhost:20128/v1 +API Key: <your-endpoint-key> + +# In your code/config, set model to: +model: "auto" # balanced default +model: "auto/coding" # best for coding tasks +model: "auto/fast" # fastest available +model: "auto/cheap" # cheapest per token +``` + +**What happens:** + +1. OmniRoute detects `auto/` prefix in `src/sse/handlers/chat.ts` +2. Queries all **active provider connections** from the database +3. Filters to those with valid credentials (API key or OAuth token) +4. Determines the model per connection (`connection.defaultModel` or provider's first model) +5. Builds a **virtual combo** in-memory (not stored in DB) +6. Routes using the selected variant's weight profile + LKGP strategy + +**Key properties:** + +- ✅ **Always-on:** No toggle, no combo creation, no configuration needed +- ✅ **Dynamic:** Reflects current connected providers automatically +- ✅ **Session stickiness:** LKGP ensures last successful provider is prioritized +- ✅ **Multi-account aware:** Each provider connection becomes a separate candidate +- ✅ **No DB writes:** Virtual combo exists only for the request, zero persistence overhead + +**Behind the scenes:** + +```txt +Request: { model: "auto/coding" } + ↓ +src/sse/handlers/chat.ts detects prefix + ↓ +createVirtualAutoCombo('coding') → candidatePool from active connections + ↓ +handleComboChat (same engine as persisted combos) + ↓ +Auto-scoring selects best provider/model per request +``` + +**Implementation files:** + +| File | Purpose | +| --------------------------------------------------------- | ----------------------------------------- | +| `open-sse/services/autoCombo/autoPrefix.ts` | Prefix parser (`parseAutoPrefix`) | +| `open-sse/services/autoCombo/virtualFactory.ts` | Creates virtual `AutoComboConfig` objects | +| `open-sse/services/autoCombo/providerRegistryAccessor.ts` | Test hook for mocking provider registry | +| `src/sse/handlers/chat.ts` | Integration: auto prefix short-circuit | +| `src/shared/constants/providers.ts` | `SYSTEM_PROVIDERS.auto` system entry | + +## How It Works (Persisted Auto-Combos) The Auto-Combo Engine dynamically selects the best provider/model for each request using a **6-factor scoring function**: diff --git a/docs/CLI-TOOLS.md b/docs/CLI-TOOLS.md index ad17ee2a89..b04aac3893 100644 --- a/docs/CLI-TOOLS.md +++ b/docs/CLI-TOOLS.md @@ -351,23 +351,119 @@ They run as internal routes and use OmniRoute's model routing automatically. | `/v1/audio/speech` | Text-to-speech | ElevenLabs, OpenAI TTS | | `/v1/audio/transcriptions` | Speech-to-text | Deepgram, AssemblyAI | +### CLI Tools API (New in v3.8) + +| Endpoint | Method | Description | +| ------------------------------- | ------ | ------------------------------------------------ | +| `/api/cli-tools/detect` | GET | Detect all installed CLI tools and config status | +| `/api/cli-tools/detect?tool=ID` | GET | Detect a specific tool by ID | +| `/api/cli-tools/config` | GET | List generated configs for all tools | +| `/api/cli-tools/config` | POST | Generate config for a specific tool | +| `/api/cli-tools/apply` | POST | Apply config to a tool (with backup) | + --- -## Troubleshooting +## CLI Commands Reference (New in v3.8) -| Error | Cause | Fix | -| ------------------------- | ----------------------- | ------------------------------------------ | -| `Connection refused` | OmniRoute not running | `pm2 start omniroute` | -| `401 Unauthorized` | Wrong API key | Check in `/dashboard/api-manager` | -| `No combo configured` | No active routing combo | Set up in `/dashboard/combos` | -| `invalid model` | Model not in catalog | Use `auto` or check `/dashboard/providers` | -| CLI shows "not installed" | Binary not in PATH | Check `which <command>` | -| `kiro-cli: not found` | Not in PATH | `export PATH="$HOME/.local/bin:$PATH"` | +### `omniroute config` + +Manage CLI tool configurations directly from the terminal. + +```bash +omniroute config list # List all tools and config status +omniroute config get <tool> # Show config for a specific tool +omniroute config set <tool> \ # Generate and write config + --api-key sk-your-key \ + [--base-url http://localhost:20128/v1] \ + [--model auto] +omniroute config validate <tool> # Validate config without writing +``` + +**Options:** `--base-url`, `--api-key`, `--model`, `--json`, `--non-interactive`, `--yes`, `--help` + +### `omniroute status` + +Show offline status dashboard with version, database, and tool info. + +```bash +omniroute status # Human-readable status +omniroute status --json # JSON output +omniroute status --verbose # Include tool detection details +``` + +### `omniroute logs` + +Stream usage logs from the API endpoint. + +```bash +omniroute logs # Fetch last 100 log lines +omniroute logs --follow # Stream in real-time +omniroute logs --filter error,warn # Filter by level +omniroute logs --lines 500 # Fetch more lines +omniroute logs --base-url http://localhost:20128 +``` + +**Options:** `--follow`, `--filter`, `--lines`, `--timeout`, `--base-url`, `--json`, `--help` + +### `omniroute update` + +Check for or apply OmniRoute updates. + +```bash +omniroute update --check # Check for updates only +omniroute update --dry-run # Preview update without applying +omniroute update --yes # Apply update without prompt +omniroute update --no-backup # Skip backup creation +``` + +**Options:** `--check`, `--dry-run`, `--backup`, `--no-backup`, `--yes`, `--help` + +### `omniroute provider` + +Manage provider connections from the CLI. + +```bash +omniroute provider add openai --api-key sk-xxx # Add a provider +omniroute provider list # List all providers +omniroute provider remove <name|id> # Remove a provider +omniroute provider test <name|id> # Test connectivity +omniroute provider default <name|id> # Set default provider +``` + +**Options:** `--provider`, `--api-key`, `--provider-name`, `--default-model`, `--base-url`, `--json`, `--yes`, `--help` --- ## Quick Setup Script (One Command) +Set up all CLI tools and configure for OmniRoute: + +```bash +OMNIROUTE_URL="http://localhost:20128/v1" +OMNIROUTE_ANTHROPIC_URL="http://localhost:20128" +OMNIROUTE_KEY="sk-your-omniroute-key" + +npm install -g @anthropic-ai/claude-code @openai/codex opencode-ai cline kilocode @qwen-code/qwen-code + +# Kiro CLI +apt-get install -y unzip 2>/dev/null; curl -fsSL https://cli.kiro.dev/install | bash + +# Write configs +mkdir -p ~/.claude ~/.codex ~/.config/opencode ~/.continue + +cat > ~/.claude/settings.json <<< "{\"env\":{\"ANTHROPIC_BASE_URL\":\"$OMNIROUTE_ANTHROPIC_URL\",\"ANTHROPIC_AUTH_TOKEN\":\"$OMNIROUTE_KEY\"}}" +cat > ~/.codex/config.yaml <<< "model: auto\napiKey: $OMNIROUTE_KEY\napiBaseUrl: $OMNIROUTE_URL" +cat >> ~/.bashrc << EOF +export OPENAI_BASE_URL="$OMNIROUTE_URL" +export OPENAI_API_KEY="$OMNIROUTE_KEY" +export ANTHROPIC_BASE_URL="$OMNIROUTE_ANTHROPIC_URL" +export ANTHROPIC_AUTH_TOKEN="$OMNIROUTE_KEY" +EOF + +source ~/.bashrc +echo "✅ All CLIs installed and configured for OmniRoute" +``` + ```bash # Install all CLIs and configure for OmniRoute (replace with your key and server URL) OMNIROUTE_URL="http://localhost:20128/v1" diff --git a/docs/CODEBASE_DOCUMENTATION.md b/docs/CODEBASE_DOCUMENTATION.md deleted file mode 100644 index 1b16d67844..0000000000 --- a/docs/CODEBASE_DOCUMENTATION.md +++ /dev/null @@ -1,589 +0,0 @@ -# omniroute — Codebase Documentation - -🌐 **Languages:** 🇺🇸 [English](CODEBASE_DOCUMENTATION.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/CODEBASE_DOCUMENTATION.md) | 🇪🇸 [Español](i18n/es/CODEBASE_DOCUMENTATION.md) | 🇫🇷 [Français](i18n/fr/CODEBASE_DOCUMENTATION.md) | 🇮🇹 [Italiano](i18n/it/CODEBASE_DOCUMENTATION.md) | 🇷🇺 [Русский](i18n/ru/CODEBASE_DOCUMENTATION.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/CODEBASE_DOCUMENTATION.md) | 🇩🇪 [Deutsch](i18n/de/CODEBASE_DOCUMENTATION.md) | 🇮🇳 [हिन्दी](i18n/in/CODEBASE_DOCUMENTATION.md) | 🇹🇭 [ไทย](i18n/th/CODEBASE_DOCUMENTATION.md) | 🇺🇦 [Українська](i18n/uk-UA/CODEBASE_DOCUMENTATION.md) | 🇸🇦 [العربية](i18n/ar/CODEBASE_DOCUMENTATION.md) | 🇯🇵 [日本語](i18n/ja/CODEBASE_DOCUMENTATION.md) | 🇻🇳 [Tiếng Việt](i18n/vi/CODEBASE_DOCUMENTATION.md) | 🇧🇬 [Български](i18n/bg/CODEBASE_DOCUMENTATION.md) | 🇩🇰 [Dansk](i18n/da/CODEBASE_DOCUMENTATION.md) | 🇫🇮 [Suomi](i18n/fi/CODEBASE_DOCUMENTATION.md) | 🇮🇱 [עברית](i18n/he/CODEBASE_DOCUMENTATION.md) | 🇭🇺 [Magyar](i18n/hu/CODEBASE_DOCUMENTATION.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/CODEBASE_DOCUMENTATION.md) | 🇰🇷 [한국어](i18n/ko/CODEBASE_DOCUMENTATION.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/CODEBASE_DOCUMENTATION.md) | 🇳🇱 [Nederlands](i18n/nl/CODEBASE_DOCUMENTATION.md) | 🇳🇴 [Norsk](i18n/no/CODEBASE_DOCUMENTATION.md) | 🇵🇹 [Português (Portugal)](i18n/pt/CODEBASE_DOCUMENTATION.md) | 🇷🇴 [Română](i18n/ro/CODEBASE_DOCUMENTATION.md) | 🇵🇱 [Polski](i18n/pl/CODEBASE_DOCUMENTATION.md) | 🇸🇰 [Slovenčina](i18n/sk/CODEBASE_DOCUMENTATION.md) | 🇸🇪 [Svenska](i18n/sv/CODEBASE_DOCUMENTATION.md) | 🇵🇭 [Filipino](i18n/phi/CODEBASE_DOCUMENTATION.md) | 🇨🇿 [Čeština](i18n/cs/CODEBASE_DOCUMENTATION.md) - -> A comprehensive, beginner-friendly guide to the **omniroute** multi-provider AI proxy router. - ---- - -## 1. What Is omniroute? - -omniroute is a **proxy router** that sits between AI clients (Claude CLI, Codex, Cursor IDE, etc.) and AI providers (Anthropic, Google, OpenAI, AWS, GitHub, etc.). It solves one big problem: - -> **Different AI clients speak different "languages" (API formats), and different AI providers expect different "languages" too.** omniroute translates between them automatically. - -Think of it like a universal translator at the United Nations — any delegate can speak any language, and the translator converts it for any other delegate. - ---- - -## 2. Architecture Overview - -```mermaid -graph LR - subgraph Clients - A[Claude CLI] - B[Codex] - C[Cursor IDE] - D[OpenAI-compatible] - end - - subgraph omniroute - E[Handler Layer] - F[Translator Layer] - G[Executor Layer] - H[Services Layer] - end - - subgraph Providers - I[Anthropic Claude] - J[Google Gemini] - K[OpenAI / Codex] - L[GitHub Copilot] - M[AWS Kiro] - N[Antigravity] - O[Cursor API] - end - - A --> E - B --> E - C --> E - D --> E - E --> F - F --> G - G --> I - G --> J - G --> K - G --> L - G --> M - G --> N - G --> O - H -.-> E - H -.-> G -``` - -### Core Principle: Hub-and-Spoke Translation - -All format translation passes through **OpenAI format as the hub**: - -``` -Client Format → [OpenAI Hub] → Provider Format (request) -Provider Format → [OpenAI Hub] → Client Format (response) -``` - -This means you only need **N translators** (one per format) instead of **N²** (every pair). - ---- - -## 3. Project Structure - -``` -omniroute/ -├── open-sse/ ← Core proxy library (portable, framework-agnostic) -│ ├── index.js ← Main entry point, exports everything -│ ├── config/ ← Configuration & constants -│ ├── executors/ ← Provider-specific request execution -│ ├── handlers/ ← Request handling orchestration -│ ├── services/ ← Business logic (auth, models, fallback, usage) -│ ├── translator/ ← Format translation engine -│ │ ├── request/ ← Request translators (8 files) -│ │ ├── response/ ← Response translators (7 files) -│ │ └── helpers/ ← Shared translation utilities (6 files) -│ └── utils/ ← Utility functions -├── src/ ← Application layer (Express/Worker runtime) -│ ├── app/ ← Web UI, API routes, middleware -│ ├── lib/ ← Database, auth, and shared library code -│ ├── mitm/ ← Man-in-the-middle proxy utilities -│ ├── models/ ← Database models -│ ├── shared/ ← Shared utilities (wrappers around open-sse) -│ ├── sse/ ← SSE endpoint handlers -│ └── store/ ← State management -├── data/ ← Runtime data (credentials, logs) -│ └── provider-credentials.json (external credentials override, gitignored) -└── tester/ ← Test utilities -``` - ---- - -## 4. Module-by-Module Breakdown - -### 4.1 Config (`open-sse/config/`) - -The **single source of truth** for all provider configuration. - -| File | Purpose | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `constants.ts` | `PROVIDERS` object with base URLs, OAuth credentials (defaults), headers, and default system prompts for every provider. Also defines `HTTP_STATUS`, `ERROR_TYPES`, `COOLDOWN_MS`, `BACKOFF_CONFIG`, and `SKIP_PATTERNS`. | -| `credentialLoader.ts` | Loads external credentials from `data/provider-credentials.json` and merges them over the hardcoded defaults in `PROVIDERS`. Keeps secrets out of source control while maintaining backwards compatibility. | -| `providerModels.ts` | Central model registry: maps provider aliases → model IDs. Functions like `getModels()`, `getProviderByAlias()`. | -| `codexInstructions.ts` | System instructions injected into Codex requests (editing constraints, sandbox rules, approval policies). | -| `defaultThinkingSignature.ts` | Default "thinking" signatures for Claude and Gemini models. | -| `ollamaModels.ts` | Schema definition for local Ollama models (name, size, family, quantization). | - -#### Credential Loading Flow - -```mermaid -flowchart TD - A["App starts"] --> B["constants.ts defines PROVIDERS\nwith hardcoded defaults"] - B --> C{"data/provider-credentials.json\nexists?"} - C -->|Yes| D["credentialLoader reads JSON"] - C -->|No| E["Use hardcoded defaults"] - D --> F{"For each provider in JSON"} - F --> G{"Provider exists\nin PROVIDERS?"} - G -->|No| H["Log warning, skip"] - G -->|Yes| I{"Value is object?"} - I -->|No| J["Log warning, skip"] - I -->|Yes| K["Merge clientId, clientSecret,\ntokenUrl, authUrl, refreshUrl"] - K --> F - H --> F - J --> F - F -->|Done| L["PROVIDERS ready with\nmerged credentials"] - E --> L -``` - ---- - -### 4.2 Executors (`open-sse/executors/`) - -Executors encapsulate **provider-specific logic** using the **Strategy Pattern**. Each executor overrides base methods as needed. - -```mermaid -classDiagram - class BaseExecutor { - +buildUrl(model, stream, options) - +buildHeaders(credentials, stream, body) - +transformRequest(body, model, stream, credentials) - +execute(url, options) - +shouldRetry(status, error) - +refreshCredentials(credentials, log) - } - - class DefaultExecutor { - +refreshCredentials() - } - - class AntigravityExecutor { - +buildUrl() - +buildHeaders() - +transformRequest() - +shouldRetry() - +refreshCredentials() - } - - class CursorExecutor { - +buildUrl() - +buildHeaders() - +transformRequest() - +parseResponse() - +generateChecksum() - } - - class KiroExecutor { - +buildUrl() - +buildHeaders() - +transformRequest() - +parseEventStream() - +refreshCredentials() - } - - BaseExecutor <|-- DefaultExecutor - BaseExecutor <|-- AntigravityExecutor - BaseExecutor <|-- CursorExecutor - BaseExecutor <|-- KiroExecutor - BaseExecutor <|-- CodexExecutor - BaseExecutor <|-- GeminiCLIExecutor - BaseExecutor <|-- GithubExecutor -``` - -| Executor | Provider | Key Specializations | -| ---------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -| `base.ts` | — | Abstract base: URL building, headers, retry logic, credential refresh | -| `default.ts` | Claude, Gemini, OpenAI, GLM, Kimi, MiniMax | Generic OAuth token refresh for standard providers | -| `antigravity.ts` | Google Cloud Code | Project/session ID generation, multi-URL fallback, custom retry parsing from error messages ("reset after 2h7m23s") | -| `cursor.ts` | Cursor IDE | **Most complex**: SHA-256 checksum auth, Protobuf request encoding, binary EventStream → SSE response parsing | -| `codex.ts` | OpenAI Codex | Injects system instructions, manages thinking levels, removes unsupported parameters | -| `gemini-cli.ts` | Google Gemini CLI | Custom URL building (`streamGenerateContent`), Google OAuth token refresh | -| `github.ts` | GitHub Copilot | Dual token system (GitHub OAuth + Copilot token), VSCode header mimicking | -| `kiro.ts` | AWS CodeWhisperer | AWS EventStream binary parsing, AMZN event frames, token estimation | -| `index.ts` | — | Factory: maps provider name → executor class, with default fallback | - ---- - -### 4.3 Handlers (`open-sse/handlers/`) - -The **orchestration layer** — coordinates translation, execution, streaming, and error handling. - -| File | Purpose | -| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `chatCore.ts` | **Central orchestrator** (~600 lines). Handles the complete request lifecycle: format detection → translation → executor dispatch → streaming/non-streaming response → token refresh → error handling → usage logging. | -| `responsesHandler.ts` | Adapter for OpenAI's Responses API: converts Responses format → Chat Completions → sends to `chatCore` → converts SSE back to Responses format. | -| `embeddings.ts` | Embedding generation handler: resolves embedding model → provider, dispatches to provider API, returns OpenAI-compatible embedding response. Supports 6+ providers. | -| `imageGeneration.ts` | Image generation handler: resolves image model → provider, supports OpenAI-compatible, Gemini-image (Antigravity), and fallback (Nebius) modes. Returns base64 or URL images. | - -#### Request Lifecycle (chatCore.ts) - -```mermaid -sequenceDiagram - participant Client - participant chatCore - participant Translator - participant Executor - participant Provider - - Client->>chatCore: Request (any format) - chatCore->>chatCore: Detect source format - chatCore->>chatCore: Check bypass patterns - chatCore->>chatCore: Resolve model & provider - chatCore->>Translator: Translate request (source → OpenAI → target) - chatCore->>Executor: Get executor for provider - Executor->>Executor: Build URL, headers, transform request - Executor->>Executor: Refresh credentials if needed - Executor->>Provider: HTTP fetch (streaming or non-streaming) - - alt Streaming - Provider-->>chatCore: SSE stream - chatCore->>chatCore: Pipe through SSE transform stream - Note over chatCore: Transform stream translates<br/>each chunk: target → OpenAI → source - chatCore-->>Client: Translated SSE stream - else Non-streaming - Provider-->>chatCore: JSON response - chatCore->>Translator: Translate response - chatCore-->>Client: Translated JSON - end - - alt Error (401, 429, 500...) - chatCore->>Executor: Retry with credential refresh - chatCore->>chatCore: Account fallback logic - end -``` - ---- - -### 4.4 Services (`open-sse/services/`) - -Business logic that supports the handlers and executors. - -| File | Purpose | -| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `provider.ts` | **Format detection** (`detectFormat`): analyzes request body structure to identify Claude/OpenAI/Gemini/Antigravity/Responses formats (includes `max_tokens` heuristic for Claude). Also: URL building, header building, thinking config normalization. Supports `openai-compatible-*` and `anthropic-compatible-*` dynamic providers. | -| `model.ts` | Model string parsing (`claude/model-name` → `{provider: "claude", model: "model-name"}`), alias resolution with collision detection, input sanitization (rejects path traversal/control chars), and model info resolution with async alias getter support. | -| `accountFallback.ts` | Rate-limit handling: exponential backoff (1s → 2s → 4s → max 2min), account cooldown management, error classification (which errors trigger fallback vs. not). | -| `tokenRefresh.ts` | OAuth token refresh for **every provider**: Google (Gemini, Antigravity), Claude, Codex, Qwen, Qoder, GitHub (OAuth + Copilot dual-token), Kiro (AWS SSO OIDC + Social Auth). Includes in-flight promise deduplication cache and retry with exponential backoff. | -| `combo.ts` | **Combo models**: chains of fallback models. If model A fails with a fallback-eligible error, try model B, then C, etc. Returns actual upstream status codes. | -| `usage.ts` | Fetches quota/usage data from provider APIs (GitHub Copilot quotas, Antigravity model quotas, Codex rate limits, Kiro usage breakdowns, Claude settings). | -| `accountSelector.ts` | Smart account selection with scoring algorithm: considers priority, health status, round-robin position, and cooldown state to pick the optimal account for each request. | -| `contextManager.ts` | Request context lifecycle management: creates and tracks per-request context objects with metadata (request ID, timestamps, provider info) for debugging and logging. | -| `ipFilter.ts` | IP-based access control: supports allowlist and blocklist modes. Validates client IP against configured rules before processing API requests. | -| `sessionManager.ts` | Session tracking with client fingerprinting: tracks active sessions using hashed client identifiers, monitors request counts, and provides session metrics. | -| `signatureCache.ts` | Request signature-based deduplication cache: prevents duplicate requests by caching recent request signatures and returning cached responses for identical requests within a time window. | -| `systemPrompt.ts` | Global system prompt injection: prepends or appends a configurable system prompt to all requests, with per-provider compatibility handling. | -| `thinkingBudget.ts` | Reasoning token budget management: supports passthrough, auto (strip thinking config), custom (fixed budget), and adaptive (complexity-scaled) modes for controlling thinking/reasoning tokens. | -| `wildcardRouter.ts` | Wildcard model pattern routing: resolves wildcard patterns (e.g., `*/claude-*`) to concrete provider/model pairs based on availability and priority. | - -#### Token Refresh Deduplication - -```mermaid -sequenceDiagram - participant R1 as Request 1 - participant R2 as Request 2 - participant Cache as refreshPromiseCache - participant OAuth as OAuth Provider - - R1->>Cache: getAccessToken("gemini", token) - Cache->>Cache: No in-flight promise - Cache->>OAuth: Start refresh - R2->>Cache: getAccessToken("gemini", token) - Cache->>Cache: Found in-flight promise - Cache-->>R2: Return existing promise - OAuth-->>Cache: New access token - Cache-->>R1: New access token - Cache-->>R2: Same access token (shared) - Cache->>Cache: Delete cache entry -``` - -#### Account Fallback State Machine - -```mermaid -stateDiagram-v2 - [*] --> Active - Active --> Error: Request fails (401/429/500) - Error --> Cooldown: Apply backoff - Cooldown --> Active: Cooldown expires - Active --> Active: Request succeeds (reset backoff) - - state Error { - [*] --> ClassifyError - ClassifyError --> ShouldFallback: Rate limit / Auth / Transient - ClassifyError --> NoFallback: 400 Bad Request - } - - state Cooldown { - [*] --> ExponentialBackoff - ExponentialBackoff: Level 0 = 1s - ExponentialBackoff: Level 1 = 2s - ExponentialBackoff: Level 2 = 4s - ExponentialBackoff: Max = 2min - } -``` - -#### Combo Model Chain - -```mermaid -flowchart LR - A["Request with\ncombo model"] --> B["Model A"] - B -->|"2xx Success"| C["Return response"] - B -->|"429/401/500"| D{"Fallback\neligible?"} - D -->|Yes| E["Model B"] - D -->|No| F["Return error"] - E -->|"2xx Success"| C - E -->|"429/401/500"| G{"Fallback\neligible?"} - G -->|Yes| H["Model C"] - G -->|No| F - H -->|"2xx Success"| C - H -->|"Fail"| I["All failed →\nReturn last status"] -``` - ---- - -### 4.5 Translator (`open-sse/translator/`) - -The **format translation engine** using a self-registering plugin system. - -#### Architecture - -```mermaid -graph TD - subgraph "Request Translation" - A["Claude → OpenAI"] - B["Gemini → OpenAI"] - C["Antigravity → OpenAI"] - D["OpenAI Responses → OpenAI"] - E["OpenAI → Claude"] - F["OpenAI → Gemini"] - G["OpenAI → Kiro"] - H["OpenAI → Cursor"] - end - - subgraph "Response Translation" - I["Claude → OpenAI"] - J["Gemini → OpenAI"] - K["Kiro → OpenAI"] - L["Cursor → OpenAI"] - M["OpenAI → Claude"] - N["OpenAI → Antigravity"] - O["OpenAI → Responses"] - end -``` - -| Directory | Files | Description | -| ------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `request/` | 8 translators | Convert request bodies between formats. Each file self-registers via `register(from, to, fn)` on import. | -| `response/` | 7 translators | Convert streaming response chunks between formats. Handles SSE event types, thinking blocks, tool calls. | -| `helpers/` | 6 helpers | Shared utilities: `claudeHelper` (system prompt extraction, thinking config), `geminiHelper` (parts/contents mapping), `openaiHelper` (format filtering), `toolCallHelper` (ID generation, missing response injection), `maxTokensHelper`, `responsesApiHelper`. | -| `index.ts` | — | Translation engine: `translateRequest()`, `translateResponse()`, state management, registry. | -| `formats.ts` | — | Format constants: `OPENAI`, `CLAUDE`, `GEMINI`, `ANTIGRAVITY`, `KIRO`, `CURSOR`, `OPENAI_RESPONSES`. | - -#### Key Design: Self-Registering Plugins - -```javascript -// Each translator file calls register() on import: -import { register } from "../index.js"; -register("claude", "openai", translateClaudeToOpenAI); - -// The index.js imports all translator files, triggering registration: -import "./request/claude-to-openai.js"; // ← self-registers -``` - ---- - -### 4.6 Utils (`open-sse/utils/`) - -| File | Purpose | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `error.ts` | Error response building (OpenAI-compatible format), upstream error parsing, Antigravity retry-time extraction from error messages, SSE error streaming. | -| `stream.ts` | **SSE Transform Stream** — the core streaming pipeline. Two modes: `TRANSLATE` (full format translation) and `PASSTHROUGH` (normalize + extract usage). Handles chunk buffering, usage estimation, content length tracking. Per-stream encoder/decoder instances avoid shared state. | -| `streamHelpers.ts` | Low-level SSE utilities: `parseSSELine` (whitespace-tolerant), `hasValuableContent` (filters empty chunks for OpenAI/Claude/Gemini), `fixInvalidId`, `formatSSE` (format-aware SSE serialization with `perf_metrics` cleanup). | -| `usageTracking.ts` | Token usage extraction from any format (Claude/OpenAI/Gemini/Responses), estimation with separate tool/message char-per-token ratios, buffer addition (2000 tokens safety margin), format-specific field filtering, console logging with ANSI colors. | -| `requestLogger.ts` | Legacy file-based request logging helper kept for compatibility. Current deployments should prefer `APP_LOG_TO_FILE` for application logs and the call log pipeline for persisted request artifacts. | -| `bypassHandler.ts` | Intercepts specific patterns from Claude CLI (title extraction, warmup, count) and returns fake responses without calling any provider. Supports both streaming and non-streaming. Intentionally limited to Claude CLI scope. | -| `networkProxy.ts` | Resolves outbound proxy URL for a given provider with precedence: provider-specific config → global config → environment variables (`HTTPS_PROXY`/`HTTP_PROXY`/`ALL_PROXY`). Supports `NO_PROXY` exclusions. Caches config for 30s. | - -#### SSE Streaming Pipeline - -```mermaid -flowchart TD - A["Provider SSE stream"] --> B["TextDecoder\n(per-stream instance)"] - B --> C["Buffer lines\n(split on newline)"] - C --> D["parseSSELine()\n(trim whitespace, parse JSON)"] - D --> E{"Mode?"} - E -->|TRANSLATE| F["translateResponse()\ntarget → OpenAI → source"] - E -->|PASSTHROUGH| G["fixInvalidId()\nnormalize chunk"] - F --> H["hasValuableContent()\nfilter empty chunks"] - G --> H - H -->|"Has content"| I["extractUsage()\ntrack token counts"] - H -->|"Empty"| J["Skip chunk"] - I --> K["formatSSE()\nserialize + clean perf_metrics"] - K --> L["TextEncoder\n(per-stream instance)"] - L --> M["Enqueue to\nclient stream"] - - style A fill:#f9f,stroke:#333 - style M fill:#9f9,stroke:#333 -``` - -#### Request Logger Session Structure - -``` -logs/ -└── claude_gemini_claude-sonnet_20260208_143045/ - ├── 1_req_client.json ← Raw client request - ├── 2_req_source.json ← After initial conversion - ├── 3_req_openai.json ← OpenAI intermediate format - ├── 4_req_target.json ← Final target format - ├── 5_res_provider.txt ← Provider SSE chunks (streaming) - ├── 5_res_provider.json ← Provider response (non-streaming) - ├── 6_res_openai.txt ← OpenAI intermediate chunks - ├── 7_res_client.txt ← Client-facing SSE chunks - └── 6_error.json ← Error details (if any) -``` - ---- - -### 4.7 Application Layer (`src/`) - -| Directory | Purpose | -| ------------- | ---------------------------------------------------------------------- | -| `src/app/` | Web UI, API routes, Express middleware, OAuth callback handlers | -| `src/lib/` | Database access (`localDb.ts`, `usageDb.ts`), authentication, shared | -| `src/mitm/` | Man-in-the-middle proxy utilities for intercepting provider traffic | -| `src/models/` | Database model definitions | -| `src/shared/` | Wrappers around open-sse functions (provider, stream, error, etc.) | -| `src/sse/` | SSE endpoint handlers that wire the open-sse library to Express routes | -| `src/store/` | Application state management | - -#### Notable API Routes - -| Route | Methods | Purpose | -| --------------------------------------------- | --------------- | ------------------------------------------------------------------------------------- | -| `/api/provider-models` | GET/POST/DELETE | CRUD for custom models per provider | -| `/api/models/catalog` | GET | Aggregated catalog of all models (chat, embedding, image, custom) grouped by provider | -| `/api/settings/proxy` | GET/PUT/DELETE | Hierarchical outbound proxy configuration (`global/providers/combos/keys`) | -| `/api/settings/proxy/test` | POST | Validates proxy connectivity and returns public IP/latency | -| `/v1/providers/[provider]/chat/completions` | POST | Dedicated per-provider chat completions with model validation | -| `/v1/providers/[provider]/embeddings` | POST | Dedicated per-provider embeddings with model validation | -| `/v1/providers/[provider]/images/generations` | POST | Dedicated per-provider image generation with model validation | -| `/api/settings/ip-filter` | GET/PUT | IP allowlist/blocklist management | -| `/api/settings/thinking-budget` | GET/PUT | Reasoning token budget configuration (passthrough/auto/custom/adaptive) | -| `/api/settings/system-prompt` | GET/PUT | Global system prompt injection for all requests | -| `/api/sessions` | GET | Active session tracking and metrics | -| `/api/rate-limits` | GET | Per-account rate limit status | - ---- - -## 5. Key Design Patterns - -### 5.1 Hub-and-Spoke Translation - -All formats translate through **OpenAI format as the hub**. Adding a new provider only requires writing **one pair** of translators (to/from OpenAI), not N pairs. - -### 5.2 Executor Strategy Pattern - -Each provider has a dedicated executor class inheriting from `BaseExecutor`. The factory in `executors/index.ts` selects the right one at runtime. - -### 5.3 Self-Registering Plugin System - -Translator modules register themselves on import via `register()`. Adding a new translator is just creating a file and importing it. - -### 5.4 Account Fallback with Exponential Backoff - -When a provider returns 429/401/500, the system can switch to the next account, applying exponential cooldowns (1s → 2s → 4s → max 2min). - -### 5.5 Combo Model Chains - -A "combo" groups multiple `provider/model` strings. If the first fails, fallback to the next automatically. - -### 5.6 Stateful Streaming Translation - -Response translation maintains state across SSE chunks (thinking block tracking, tool call accumulation, content block indexing) via the `initState()` mechanism. - -### 5.7 Usage Safety Buffer - -A 2000-token buffer is added to reported usage to prevent clients from hitting context window limits due to overhead from system prompts and format translation. - ---- - -## 6. Supported Formats - -| Format | Direction | Identifier | -| ----------------------- | --------------- | ------------------ | -| OpenAI Chat Completions | source + target | `openai` | -| OpenAI Responses API | source + target | `openai-responses` | -| Anthropic Claude | source + target | `claude` | -| Google Gemini | source + target | `gemini` | -| Google Gemini CLI | target only | `gemini-cli` | -| Antigravity | source + target | `antigravity` | -| AWS Kiro | target only | `kiro` | -| Cursor | target only | `cursor` | - ---- - -## 7. Supported Providers - -| Provider | Auth Method | Executor | Key Notes | -| ------------------------ | ---------------------- | ----------- | --------------------------------------------- | -| Anthropic Claude | API key or OAuth | Default | Uses `x-api-key` header | -| Google Gemini | API key or OAuth | Default | Uses `x-goog-api-key` header | -| Google Gemini CLI | OAuth | GeminiCLI | Uses `streamGenerateContent` endpoint | -| Antigravity | OAuth | Antigravity | Multi-URL fallback, custom retry parsing | -| OpenAI | API key | Default | Standard Bearer auth | -| Codex | OAuth | Codex | Injects system instructions, manages thinking | -| GitHub Copilot | OAuth + Copilot token | Github | Dual token, VSCode header mimicking | -| Kiro (AWS) | AWS SSO OIDC or Social | Kiro | Binary EventStream parsing | -| Cursor IDE | Checksum auth | Cursor | Protobuf encoding, SHA-256 checksums | -| Qwen | OAuth | Default | Standard auth | -| Qoder | OAuth (Basic + Bearer) | Default | Dual auth header | -| OpenRouter | API key | Default | Standard Bearer auth | -| GLM, Kimi, MiniMax | API key | Default | Claude-compatible, use `x-api-key` | -| `openai-compatible-*` | API key | Default | Dynamic: any OpenAI-compatible endpoint | -| `anthropic-compatible-*` | API key | Default | Dynamic: any Claude-compatible endpoint | - ---- - -## 8. Data Flow Summary - -### Streaming Request - -```mermaid -flowchart LR - A["Client"] --> B["detectFormat()"] - B --> C["translateRequest()\nsource → OpenAI → target"] - C --> D["Executor\nbuildUrl + buildHeaders"] - D --> E["fetch(providerURL)"] - E --> F["createSSEStream()\nTRANSLATE mode"] - F --> G["parseSSELine()"] - G --> H["translateResponse()\ntarget → OpenAI → source"] - H --> I["extractUsage()\n+ addBuffer"] - I --> J["formatSSE()"] - J --> K["Client receives\ntranslated SSE"] - K --> L["logUsage()\nsaveRequestUsage()"] -``` - -### Non-Streaming Request - -```mermaid -flowchart LR - A["Client"] --> B["detectFormat()"] - B --> C["translateRequest()\nsource → OpenAI → target"] - C --> D["Executor.execute()"] - D --> E["translateResponse()\ntarget → OpenAI → source"] - E --> F["Return JSON\nresponse"] -``` - -### Bypass Flow (Claude CLI) - -```mermaid -flowchart LR - A["Claude CLI request"] --> B{"Match bypass\npattern?"} - B -->|"Title/Warmup/Count"| C["Generate fake\nOpenAI response"] - B -->|"No match"| D["Normal flow"] - C --> E["Translate to\nsource format"] - E --> F["Return without\ncalling provider"] -``` diff --git a/docs/DOCKER_GUIDE.md b/docs/DOCKER_GUIDE.md deleted file mode 100644 index 771cf819d4..0000000000 --- a/docs/DOCKER_GUIDE.md +++ /dev/null @@ -1,119 +0,0 @@ -# 🐳 Docker Guide — OmniRoute - -> Complete Docker deployment reference. For a quick start, see the [README Docker section](../README.md#-docker). - -## Table of Contents - -- [Quick Run](#quick-run) -- [With Environment File](#with-environment-file) -- [Docker Compose](#docker-compose) -- [Docker Compose with Caddy (HTTPS)](#docker-compose-with-caddy-https-auto-tls) -- [Cloudflare Quick Tunnel](#cloudflare-quick-tunnel) -- [Image Tags](#image-tags) -- [Important Notes](#important-notes) - ---- - -## Quick Run - -```bash -docker run -d \ - --name omniroute \ - --restart unless-stopped \ - --stop-timeout 40 \ - -p 20128:20128 \ - -v omniroute-data:/app/data \ - diegosouzapw/omniroute:latest -``` - -## With Environment File - -```bash -# Copy and edit .env first -cp .env.example .env - -docker run -d \ - --name omniroute \ - --restart unless-stopped \ - --stop-timeout 40 \ - --env-file .env \ - -p 20128:20128 \ - -v omniroute-data:/app/data \ - diegosouzapw/omniroute:latest -``` - -## Docker Compose - -```bash -# Base profile (no CLI tools) -docker compose --profile base up -d - -# CLI profile (Claude Code, Codex, OpenClaw built-in) -docker compose --profile cli up -d -``` - -## Docker Compose with Caddy (HTTPS Auto-TLS) - -OmniRoute can be securely exposed using Caddy's automatic SSL provisioning. Ensure your domain's DNS A record points to your server's IP. - -```yaml -services: - omniroute: - image: diegosouzapw/omniroute:latest - container_name: omniroute - restart: unless-stopped - volumes: - - omniroute-data:/app/data - environment: - - PORT=20128 - - NEXT_PUBLIC_BASE_URL=https://your-domain.com - - caddy: - image: caddy:latest - container_name: caddy - restart: unless-stopped - ports: - - "80:80" - - "443:443" - command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128 - -volumes: - omniroute-data: -``` - -## Cloudflare Quick Tunnel - -Dashboard support for Docker deployments includes a one-click **Cloudflare Quick Tunnel** on `Dashboard → Endpoints`. The first enable downloads `cloudflared` only when needed, starts a temporary tunnel to your current `/v1` endpoint, and shows the generated `https://*.trycloudflare.com/v1` URL directly below your normal public URL. - -Endpoint tunnel panels (Cloudflare, Tailscale, ngrok) can be shown or hidden from `Settings → Appearance` without changing active tunnel state. - -### Tunnel Notes - -- Quick Tunnel URLs are temporary and change after every restart. -- Quick Tunnels are not auto-restored after an OmniRoute or container restart. Re-enable them from the dashboard when needed. -- Managed install currently supports Linux, macOS, and Windows on `x64` / `arm64`. -- Managed Quick Tunnels default to HTTP/2 transport to avoid noisy QUIC UDP buffer warnings in constrained container environments. Set `CLOUDFLARED_PROTOCOL=quic` or `auto` if you want a different transport. -- Docker images bundle system CA roots and pass them to managed `cloudflared`, which avoids TLS trust failures when the tunnel bootstraps inside the container. -- Set `CLOUDFLARED_BIN=/absolute/path/to/cloudflared` if you want OmniRoute to use an existing binary instead of downloading one. - -## Image Tags - -| Image | Tag | Size | Description | -| ------------------------ | -------- | ------ | --------------------- | -| `diegosouzapw/omniroute` | `latest` | ~250MB | Latest stable release | -| `diegosouzapw/omniroute` | `3.7.8` | ~250MB | Current version | - -Multi-platform: AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi). - -## Important Notes - -- **SQLite WAL Mode:** `docker stop` should be allowed to finish so OmniRoute can checkpoint the latest changes back into `storage.sqlite`. The bundled Compose files already set a 40s stop grace period. If you run the image directly, keep `--stop-timeout 40`. -- **`DISABLE_SQLITE_AUTO_BACKUP`:** Set to `true` if backups are managed externally. -- **Data Persistence:** Always mount a volume to `/app/data` to persist your database, keys, and configurations across container restarts. -- **Port Configuration:** Override `PORT` environment variable to change the default `20128` port. - -## See Also - -- [VM Deployment Guide](VM_DEPLOYMENT_GUIDE.md) — VM + nginx + Cloudflare setup -- [Fly.io Deployment Guide](FLY_IO_DEPLOYMENT_GUIDE.md) — Deploy to Fly.io -- [Environment Config](ENVIRONMENT.md) — Complete `.env` reference diff --git a/docs/ENVIRONMENT.md b/docs/ENVIRONMENT.md deleted file mode 100644 index 066d800705..0000000000 --- a/docs/ENVIRONMENT.md +++ /dev/null @@ -1,679 +0,0 @@ -# Environment Variables Reference - -> Complete reference for every environment variable recognized by OmniRoute. -> For a quick-start template, see [`.env.example`](../.env.example). - ---- - -## Table of Contents - -- [1. Required Secrets](#1-required-secrets) -- [2. Storage & Database](#2-storage--database) -- [3. Network & Ports](#3-network--ports) -- [4. Security & Authentication](#4-security--authentication) -- [5. Input Sanitization & PII Protection](#5-input-sanitization--pii-protection) -- [6. Tool & Routing Policies](#6-tool--routing-policies) -- [7. URLs & Cloud Sync](#7-urls--cloud-sync) -- [8. Outbound Proxy](#8-outbound-proxy) -- [9. CLI Tool Integration](#9-cli-tool-integration) -- [10. Internal Agent & MCP Integrations](#10-internal-agent--mcp-integrations) -- [11. OAuth Provider Credentials](#11-oauth-provider-credentials) -- [12. Provider User-Agent Overrides](#12-provider-user-agent-overrides) -- [13. CLI Fingerprint Compatibility](#13-cli-fingerprint-compatibility) -- [14. API Key Providers](#14-api-key-providers) -- [15. Timeout Settings](#15-timeout-settings) -- [16. Logging](#16-logging) -- [17. Memory Optimization](#17-memory-optimization) -- [18. Pricing Sync](#18-pricing-sync) -- [19. Model Sync (Dev)](#19-model-sync-dev) -- [20. Provider-Specific Settings](#20-provider-specific-settings) -- [21. Proxy Health](#21-proxy-health) -- [22. Debugging](#22-debugging) -- [23. GitHub Integration](#23-github-integration) -- [Deployment Scenarios](#deployment-scenarios) -- [Audit: Removed / Dead Variables](#audit-removed--dead-variables) - ---- - -## 1. Required Secrets - -These **must** be set before the first run. Without them, the application will either refuse to start or operate with insecure defaults. - -| Variable | Required | Default | Source File | Description | -| ------------------ | -------- | -------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| `JWT_SECRET` | **Yes** | _(none)_ | `src/lib/auth` | Signs/verifies all dashboard session cookies (JWT). Generate with `openssl rand -base64 48`. | -| `API_KEY_SECRET` | **Yes** | _(none)_ | `src/lib/db/apiKeys.ts` | AES encryption key for API key values at rest in SQLite. Generate with `openssl rand -hex 32`. | -| `INITIAL_PASSWORD` | **Yes** | `123456` | Bootstrap script | Sets the initial admin dashboard password. **Change before first use.** After login, change via Dashboard → Settings → Security. | - -### Generation Commands - -```bash -# Generate all three secrets at once: -echo "JWT_SECRET=$(openssl rand -base64 48)" -echo "API_KEY_SECRET=$(openssl rand -hex 32)" -echo "INITIAL_PASSWORD=$(openssl rand -base64 16)" -``` - -> [!CAUTION] -> Never commit `.env` files with real secrets to version control. The `.gitignore` already excludes `.env`, but verify before pushing. - ---- - -## 2. Storage & Database - -OmniRoute uses **SQLite** (via `better-sqlite3`) for all persistence. These variables control data location, encryption, and lifecycle. - -| Variable | Default | Source File | Description | -| -------------------------------- | -------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| `DATA_DIR` | `~/.omniroute/` | `src/lib/db/core.ts` | Root directory for SQLite DB, backups, and data files. Override for Docker volumes or custom paths. | -| `STORAGE_ENCRYPTION_KEY` | _(empty = disabled)_ | `src/lib/db/encryption.ts` | AES key for full SQLite database encryption at rest. Generate with `openssl rand -hex 32`. | -| `STORAGE_ENCRYPTION_KEY_VERSION` | `v1` | `scripts/bootstrap-env.mjs`, `electron/main.js` | Version label for the encryption key. Increment when performing key rotation to support decryption of old backups. | -| `DISABLE_SQLITE_AUTO_BACKUP` | `false` | `src/lib/db/backup.ts` | When `true`, skips the automatic database backup that runs before migrations on every startup. | -| `OMNIROUTE_CRYPT_KEY` | _(unset)_ | `src/lib/db/encryption.ts` | **Legacy alias** for `STORAGE_ENCRYPTION_KEY`. Accepted as a fallback when the primary variable is absent. | -| `OMNIROUTE_API_KEY_BASE64` | _(unset)_ | `src/lib/db/encryption.ts` | **Legacy alias** (Base64-encoded form) accepted as a fallback. Decoded automatically before use. | - -### Scenarios - -| Scenario | Configuration | -| --------------------- | -------------------------------------------------------------------------------- | -| **Local development** | Leave all defaults. DB lives at `~/.omniroute/omniroute.db`. | -| **Docker** | `DATA_DIR=/data` + mount a volume at `/data`. | -| **Encrypted at rest** | Set `STORAGE_ENCRYPTION_KEY` + keep backups of the key! Losing it = losing data. | -| **CI/Testing** | `DATA_DIR=/tmp/omniroute-test` — ephemeral, no encryption needed. | - ---- - -## 3. Network & Ports - -| Variable | Default | Source File | Description | -| --------------------- | ------------ | -------------------------- | -------------------------------------------------------------------------------------- | -| `PORT` | `20128` | `src/lib/runtime/ports.ts` | Primary port for both Dashboard UI and API endpoints (single-port mode). | -| `API_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | When set, serves the `/v1/*` proxy API on this separate port. | -| `API_HOST` | `0.0.0.0` | `src/lib/runtime/ports.ts` | Bind address for the API port. | -| `DASHBOARD_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | When set, serves the Dashboard UI on this separate port. | -| `PROD_DASHBOARD_PORT` | `20130` | `docker-compose.prod.yml` | Host-side published port for the Dashboard in Docker production mode. | -| `PROD_API_PORT` | `20131` | `docker-compose.prod.yml` | Host-side published port for the API in Docker production mode. | -| `OMNIROUTE_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | Takes precedence over `PORT` when running inside Electron or other wrappers. | -| `NODE_ENV` | `production` | Next.js core | Controls logging verbosity, caching, error detail exposure, and Next.js optimizations. | - -### Port Modes - -``` -┌─────────────────────────── Single Port (default) ──────────────────────────┐ -│ PORT=20128 │ -│ → Dashboard: http://localhost:20128 │ -│ → API: http://localhost:20128/v1/chat/completions │ -└─────────────────────────────────────────────────────────────────────────────┘ - -┌─────────────────────────── Split Ports ─────────────────────────────────────┐ -│ DASHBOARD_PORT=20128 │ -│ API_PORT=20129 │ -│ API_HOST=0.0.0.0 │ -│ → Dashboard: http://localhost:20128 │ -│ → API: http://0.0.0.0:20129/v1/chat/completions │ -│ Use case: Expose API to LAN while restricting Dashboard to localhost. │ -└─────────────────────────────────────────────────────────────────────────────┘ - -┌─────────────────────────── Docker Production ──────────────────────────────┐ -│ PROD_DASHBOARD_PORT=443 PROD_API_PORT=8443 │ -│ → Maps container ports to host ports in docker-compose.prod.yml. │ -└─────────────────────────────────────────────────────────────────────────────┘ -``` - ---- - -## 4. Security & Authentication - -| Variable | Default | Source File | Description | -| ----------------------------- | --------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| `MACHINE_ID_SALT` | `endpoint-proxy-salt` | `src/lib/auth` | Salt combined with hardware identifiers for machine fingerprinting. Change per-deployment for isolation. | -| `AUTH_COOKIE_SECURE` | `false` | `src/lib/auth` | Sets the `Secure` flag on session cookies. **Must be `true`** when running behind HTTPS. | -| `REQUIRE_API_KEY` | `false` | API middleware | When `true`, all `/v1/*` proxy requests must include a valid API key. | -| `ALLOW_API_KEY_REVEAL` | `false` | Dashboard providers page | Allows revealing full API key values in the Dashboard UI. Security risk on shared instances. | -| `NO_LOG_API_KEY_IDS` | _(empty)_ | `src/lib/compliance/index.ts` | Comma-separated API key IDs that bypass request logging (GDPR compliance). | -| `MAX_BODY_SIZE_BYTES` | `10485760` (10 MB) | `src/shared/middleware/bodySizeGuard.ts` | Maximum allowed request body size. Rejects payloads exceeding this limit. | -| `CORS_ORIGIN` | `*` | Next.js middleware | CORS `Access-Control-Allow-Origin` value. Restrict for production. | -| `OUTBOUND_SSRF_GUARD_ENABLED` | `true` | `src/shared/network/outboundUrlGuard.ts` | Block provider calls targeting private/loopback/link-local IP ranges. Disable only in isolated test envs. | - -### Hardening Checklist - -```bash -# Production security minimum: -AUTH_COOKIE_SECURE=true # Requires HTTPS -REQUIRE_API_KEY=true # Authenticate all proxy calls -ALLOW_API_KEY_REVEAL=false # Never expose keys in UI -CORS_ORIGIN=https://your.domain.com -MAX_BODY_SIZE_BYTES=5242880 # 5 MB limit -``` - ---- - -## 5. Input Sanitization & PII Protection - -OmniRoute provides a two-layer defense: request-side injection scanning and response-side PII stripping. - -### Request-Side: Prompt Injection Guard - -| Variable | Default | Source File | Description | -| ------------------------- | --------- | ---------------------------------------- | ------------------------------------------------------------------------------------------- | -| `INPUT_SANITIZER_ENABLED` | `false` | `src/middleware/promptInjectionGuard.ts` | Enable scanning of incoming messages for prompt injection patterns. | -| `INPUT_SANITIZER_MODE` | `warn` | `src/middleware/promptInjectionGuard.ts` | `warn` = log only, `block` = reject request with 400, `redact` = strip suspicious patterns. | -| `INJECTION_GUARD_MODE` | _(unset)_ | `src/middleware/promptInjectionGuard.ts` | Legacy alias for `INPUT_SANITIZER_MODE` — same behavior. | -| `PII_REDACTION_ENABLED` | `false` | `src/middleware/promptInjectionGuard.ts` | Detect PII (emails, phones, SSNs) in incoming requests. | - -### Response-Side: PII Sanitizer - -| Variable | Default | Source File | Description | -| -------------------------------- | -------- | ------------------------- | ----------------------------------------------------------------------- | -| `PII_RESPONSE_SANITIZATION` | `false` | `src/lib/piiSanitizer.ts` | Scan LLM responses for leaked PII before returning to client. | -| `PII_RESPONSE_SANITIZATION_MODE` | `redact` | `src/lib/piiSanitizer.ts` | `redact` = mask PII, `warn` = log only, `block` = drop entire response. | - -### Scenarios - -| Scenario | Configuration | -| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| **Enterprise compliance** | `INPUT_SANITIZER_ENABLED=true`, `INPUT_SANITIZER_MODE=block`, `PII_REDACTION_ENABLED=true`, `PII_RESPONSE_SANITIZATION=true` | -| **Monitoring only** | `INPUT_SANITIZER_ENABLED=true`, `INPUT_SANITIZER_MODE=warn` — logs but never blocks | -| **Personal use** | Leave all disabled — zero overhead | - ---- - -## 6. Tool & Routing Policies - -| Variable | Default | Source File | Description | -| ------------------ | ---------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| `TOOL_POLICY_MODE` | `disabled` | `src/lib/toolPolicy.ts` | Controls LLM tool/function-calling access. `allowlist` = only listed tools, `denylist` = all except listed, `disabled` = no restrictions. | - ---- - -## 7. URLs & Cloud Sync - -| Variable | Default | Source File | Description | -| ----------------------- | ------------------------ | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| `BASE_URL` | `http://localhost:20128` | `src/lib/cloudSync.ts` | Server-side URL for internal sync jobs to call `/api/sync/cloud`. | -| `CLOUD_URL` | _(empty)_ | `src/lib/cloudSync.ts` | Cloud relay endpoint URL (premium feature). | -| `CLOUD_SYNC_TIMEOUT_MS` | `12000` | `src/lib/cloudSync.ts` | HTTP timeout for cloud sync requests. | -| `NEXT_PUBLIC_BASE_URL` | `http://localhost:20128` | OAuth, Dashboard, sync | Public-facing URL for OAuth redirect_uri, Dashboard links. **Must match your public URL behind reverse proxy.** | -| `NEXT_PUBLIC_CLOUD_URL` | _(empty)_ | Client-side | Client-side mirror of `CLOUD_URL`. | -| `NEXT_PUBLIC_APP_URL` | _(unset)_ | `src/shared/services/cloudSyncScheduler.ts` | Legacy fallback for `NEXT_PUBLIC_BASE_URL`. | - -> [!IMPORTANT] -> When deploying behind a reverse proxy (nginx, Caddy), `NEXT_PUBLIC_BASE_URL` **must** be set to your public URL (e.g., `https://omniroute.example.com`). Without this, OAuth callbacks will fail because the redirect_uri won't match. - ---- - -## 8. Outbound Proxy - -Route upstream LLM provider calls through an HTTP or SOCKS5 proxy for egress control, geo-routing, or IP masking. - -| Variable | Default | Source File | Description | -| --------------------------------- | --------- | -------------------- | ----------------------------------------------------------------------------------- | -| `ENABLE_SOCKS5_PROXY` | `true` | `open-sse/executors` | Enable SOCKS5 proxy agent for upstream calls. | -| `NEXT_PUBLIC_ENABLE_SOCKS5_PROXY` | `true` | Client-side | Client-side awareness of SOCKS5 availability. | -| `HTTP_PROXY` | _(unset)_ | Node.js standard | HTTP proxy for upstream calls. | -| `HTTPS_PROXY` | _(unset)_ | Node.js standard | HTTPS proxy for upstream calls. | -| `ALL_PROXY` | _(unset)_ | Node.js standard | Universal proxy (supports `socks5://`). | -| `NO_PROXY` | _(unset)_ | Node.js standard | Comma-separated hostnames/IPs to bypass the proxy. | -| `ENABLE_TLS_FINGERPRINT` | `false` | `open-sse/executors` | Spoof TLS fingerprint using wreq-js (mimics Chrome 124). Counters JA3/JA4 blocking. | - -### Scenarios - -| Scenario | Configuration | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| **SOCKS5 through SSH tunnel** | `ALL_PROXY=socks5://127.0.0.1:7890`, `ENABLE_SOCKS5_PROXY=true` | -| **Corporate HTTP proxy** | `HTTP_PROXY=http://proxy.corp.com:3128`, `HTTPS_PROXY=http://proxy.corp.com:3128`, `NO_PROXY=localhost,internal.corp.com` | -| **Anti-fingerprint** | `ENABLE_TLS_FINGERPRINT=true` — requires `wreq-js` (included) | - ---- - -## 9. CLI Tool Integration - -Controls how OmniRoute discovers and launches CLI sidecars (Claude Code, Codex, etc.). - -| Variable | Default | Source File | Description | -| ------------------------- | ---------- | ----------------------------------- | -------------------------------------------------------------------------- | -| `CLI_MODE` | `auto` | `src/shared/services/cliRuntime.ts` | `auto` = search system PATH; `manual` = use explicit paths only. | -| `CLI_EXTRA_PATHS` | _(unset)_ | `src/shared/services/cliRuntime.ts` | Additional PATH entries for CLI binary discovery (colon-separated). | -| `CLI_CONFIG_HOME` | _(unset)_ | `src/shared/services/cliRuntime.ts` | Override home directory for reading CLI configs (`~/.claude`, `~/.codex`). | -| `CLI_ALLOW_CONFIG_WRITES` | `false` | `src/shared/services/cliRuntime.ts` | Allow OmniRoute to write CLI config files (token refresh, session data). | -| `CLI_CLAUDE_BIN` | `claude` | `src/shared/services/cliRuntime.ts` | Custom path to Claude CLI binary. | -| `CLI_CODEX_BIN` | `codex` | `src/shared/services/cliRuntime.ts` | Custom path to Codex CLI binary. | -| `CLI_DROID_BIN` | `droid` | `src/shared/services/cliRuntime.ts` | Custom path to Droid CLI binary. | -| `CLI_OPENCLAW_BIN` | `openclaw` | `src/shared/services/cliRuntime.ts` | Custom path to OpenClaw CLI binary. | -| `CLI_CURSOR_BIN` | `agent` | `src/shared/services/cliRuntime.ts` | Custom path to Cursor agent binary. | -| `CLI_CLINE_BIN` | `cline` | `src/shared/services/cliRuntime.ts` | Custom path to Cline CLI binary. | -| `CLI_CONTINUE_BIN` | `cn` | `src/shared/services/cliRuntime.ts` | Custom path to Continue CLI binary. | -| `CLI_QODER_BIN` | `qoder` | `src/shared/services/cliRuntime.ts` | Custom path to Qoder CLI binary. | - -### Docker Example - -```bash -# Mount host binaries into the container and tell OmniRoute where they are: -CLI_EXTRA_PATHS=/host-cli/bin -CLI_CONFIG_HOME=/root -CLI_ALLOW_CONFIG_WRITES=true -CLI_CLAUDE_BIN=/host-cli/bin/claude -``` - ---- - -## 10. Internal Agent & MCP Integrations - -| Variable | Default | Source File | Description | -| --------------------------------------- | ----------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -| `OMNIROUTE_BASE_URL` | auto-detect | `open-sse/mcp-server/server.ts` | Explicit URL for MCP/A2A tools to reach OmniRoute. Overrides localhost auto-detection. | -| `OMNIROUTE_API_KEY` | _(unset)_ | MCP/A2A modules | API key for internal MCP tool and A2A skill calls. | -| `OMNIROUTE_API_KEY_ID` | _(unset)_ | `open-sse/mcp-server/audit.ts` | Key ID for MCP audit log attribution. | -| `ROUTER_API_KEY` | _(unset)_ | Legacy | Legacy alias for `OMNIROUTE_API_KEY`. | -| `OMNIROUTE_MCP_ENFORCE_SCOPES` | `false` | `open-sse/mcp-server/server.ts` | Enforce scope-based access control on MCP tool calls. | -| `OMNIROUTE_MCP_SCOPES` | _(all)_ | `open-sse/mcp-server/server.ts` | Comma-separated scopes: `admin`, `combos`, `health`, `models`, `routing`, `budget`, `metrics`, `pricing`, `memory`, `skills`. | -| `MODEL_SYNC_INTERVAL_HOURS` | `24` | `src/shared/services/modelSyncScheduler.ts` | Model catalog sync interval in hours. | -| `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES` | `70` | `src/server-init.ts` | Provider rate-limit and quota polling interval. | -| `OMNIROUTE_DISABLE_BACKGROUND_SERVICES` | `false` | `src/instrumentation-node.ts` | Disable all background services (sync, pricing, model refresh). Useful for CI/test. | -| `OMNIROUTE_BOOTSTRAPPED` | `false` | `src/app/(dashboard)/dashboard/page.tsx` | Set `true` by bootstrap script after initial setup. Controls setup wizard visibility. | -| `OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE` | `0` | `open-sse/executors/antigravity.ts` | Escape hatch: allow request body to override the Antigravity project field. | - -### OAuth CLI Bridge (Internal) - -| Variable | Default | Source File | Description | -| ------------------- | ----------- | ------------------------------- | ----------------------------------------- | -| `OMNIROUTE_SERVER` | auto-detect | `src/lib/oauth/config/index.ts` | Server URL for CLI↔OmniRoute auth bridge. | -| `OMNIROUTE_TOKEN` | _(unset)_ | `src/lib/oauth/config/index.ts` | Auth token for CLI bridge. | -| `OMNIROUTE_USER_ID` | `cli` | `src/lib/oauth/config/index.ts` | User ID for CLI bridge sessions. | -| `SERVER_URL` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_SERVER`. | -| `CLI_TOKEN` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_TOKEN`. | -| `CLI_USER_ID` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_USER_ID`. | - ---- - -## 11. OAuth Provider Credentials - -Built-in credentials for **localhost development**. For remote deployments, register your own at each provider's developer console. - -| Variable | Provider | Notes | -| --------------------------------- | ----------------------- | --------------------------------------------------------------------------------- | -| `CLAUDE_OAUTH_CLIENT_ID` | Claude Code (Anthropic) | Public client — no secret needed. | -| `CLAUDE_CODE_REDIRECT_URI` | Claude Code | Override redirect URI. Default: `https://platform.claude.com/oauth/code/callback` | -| `CODEX_OAUTH_CLIENT_ID` | Codex / OpenAI | Public client. | -| `GEMINI_OAUTH_CLIENT_ID` | Gemini (Google) | Requires matching `_SECRET`. | -| `GEMINI_OAUTH_CLIENT_SECRET` | Gemini (Google) | — | -| `GEMINI_CLI_OAUTH_CLIENT_ID` | Gemini CLI | Usually same as Gemini. | -| `GEMINI_CLI_OAUTH_CLIENT_SECRET` | Gemini CLI | — | -| `QWEN_OAUTH_CLIENT_ID` | Qwen (Alibaba) | Public client. | -| `KIMI_CODING_OAUTH_CLIENT_ID` | Kimi Coding (Moonshot) | Public client. | -| `ANTIGRAVITY_OAUTH_CLIENT_ID` | Antigravity (Google) | Requires matching `_SECRET`. | -| `ANTIGRAVITY_OAUTH_CLIENT_SECRET` | Antigravity (Google) | — | -| `GITHUB_OAUTH_CLIENT_ID` | GitHub Copilot | Public client. | -| `QODER_OAUTH_CLIENT_SECRET` | Qoder | — | -| `QODER_OAUTH_AUTHORIZE_URL` | Qoder | Set to enable Qoder OAuth. | -| `QODER_OAUTH_TOKEN_URL` | Qoder | — | -| `QODER_OAUTH_USERINFO_URL` | Qoder | — | -| `QODER_OAUTH_CLIENT_ID` | Qoder | — | -| `QODER_PERSONAL_ACCESS_TOKEN` | Qoder | Direct API key fallback (bypasses OAuth). | -| `QODER_CLI_WORKSPACE` | Qoder | Workspace ID for Qoder CLI. | -| `OMNIROUTE_QODER_WORKSPACE` | Qoder | Alias for `QODER_CLI_WORKSPACE`. | - -> [!WARNING] -> **Google OAuth** (Antigravity, Gemini CLI) credentials **only work on localhost**. For remote servers: -> -> 1. Go to [Google Cloud Console → Credentials](https://console.cloud.google.com/apis/credentials) -> 2. Create an OAuth 2.0 Client ID (type: "Web application") -> 3. Add your server URL as Authorized redirect URI -> 4. Replace the credential values in `.env`. - ---- - -## 12. Provider User-Agent Overrides - -Override the `User-Agent` header sent to each upstream provider. This is dynamically resolved at runtime by the executor base class: - -``` -process.env[`${PROVIDER_ID}_USER_AGENT`] -``` - -> **Source:** `open-sse/executors/base.ts` → `buildHeaders()` - -| Variable | Default Value | When to Update | -| ------------------------ | --------------------------------------------- | ------------------------------------------------------------- | -| `CLAUDE_USER_AGENT` | `claude-cli/2.1.121 (external, cli)` | When Anthropic releases a new CLI version | -| `CODEX_USER_AGENT` | `codex-cli/0.125.0 (Windows 10.0.26100; x64)` | When OpenAI updates the Codex CLI | -| `CODEX_CLIENT_VERSION` | `0.125.0` | Override Codex client version independently of full UA string | -| `GITHUB_USER_AGENT` | `GitHubCopilotChat/0.45.1` | When GitHub Copilot Chat updates | -| `ANTIGRAVITY_USER_AGENT` | `antigravity/1.107.0 darwin/arm64` | When Antigravity IDE updates | -| `KIRO_USER_AGENT` | `AWS-SDK-JS/3.0.0 kiro-ide/1.0.0` | When Kiro IDE updates | -| `QODER_USER_AGENT` | `Qoder-Cli` | When Qoder CLI updates | -| `QWEN_USER_AGENT` | `QwenCode/0.15.3 (linux; x64)` | When Qwen Code updates | -| `CURSOR_USER_AGENT` | `connect-es/1.6.1` | When Cursor updates | -| `GEMINI_CLI_USER_AGENT` | `google-api-nodejs-client/10.3.0` | When Google API client updates | - -> [!TIP] -> You can add User-Agent overrides for **any** provider using the pattern `{PROVIDER_ID}_USER_AGENT`. The executor dynamically constructs the env var name. - ---- - -## 13. CLI Fingerprint Compatibility - -When enabled, OmniRoute reorders HTTP headers and JSON body fields to match the exact signature of official CLI tools. This reduces the risk of account flagging while preserving your proxy IP. - -**Source:** `open-sse/config/cliFingerprints.ts`, `open-sse/executors/base.ts` - -### Per-Provider - -| Variable | Effect | -| -------------------------- | --------------------------------------- | -| `CLI_COMPAT_CODEX=1` | Mimics Codex CLI request signature | -| `CLI_COMPAT_CLAUDE=1` | Mimics Claude Code request signature | -| `CLI_COMPAT_GITHUB=1` | Mimics GitHub Copilot request signature | -| `CLI_COMPAT_ANTIGRAVITY=1` | Mimics Antigravity request signature | -| `CLI_COMPAT_KIRO=1` | Mimics Kiro IDE request signature | -| `CLI_COMPAT_CURSOR=1` | Mimics Cursor request signature | -| `CLI_COMPAT_KIMI_CODING=1` | Mimics Kimi Coding request signature | -| `CLI_COMPAT_KILOCODE=1` | Mimics Kilo Code request signature | -| `CLI_COMPAT_CLINE=1` | Mimics Cline request signature | -| `CLI_COMPAT_QWEN=1` | Mimics Qwen Code request signature | - -### Global - -| Variable | Effect | -| ------------------ | --------------------------------------------------------------- | -| `CLI_COMPAT_ALL=1` | Enable fingerprint compatibility for **all** providers at once. | - -> [!NOTE] -> This feature works alongside the User-Agent overrides (§12). The fingerprint system handles header ordering and body field ordering, while User-Agent overrides handle the specific UA string. Both can be enabled independently. - ---- - -## 14. API Key Providers - -API keys for providers that use direct authentication. **Preferred setup:** Dashboard → Providers → Add API Key. - -Setting via environment variables is an alternative for Docker or headless deployments. - -Recognized pattern: `{PROVIDER_ID}_API_KEY` - -| Variable | Provider | -| -------------------- | ------------------- | -| `DEEPSEEK_API_KEY` | DeepSeek | -| `GROQ_API_KEY` | Groq | -| `XAI_API_KEY` | xAI (Grok) | -| `MISTRAL_API_KEY` | Mistral AI | -| `PERPLEXITY_API_KEY` | Perplexity | -| `TOGETHER_API_KEY` | Together AI | -| `FIREWORKS_API_KEY` | Fireworks AI | -| `CEREBRAS_API_KEY` | Cerebras | -| `COHERE_API_KEY` | Cohere | -| `NVIDIA_API_KEY` | NVIDIA NIM | -| `NEBIUS_API_KEY` | Nebius (embeddings) | -| `QIANFAN_API_KEY` | Baidu Qianfan | - -> [!TIP] -> Keys set via the Dashboard are stored encrypted in SQLite and take precedence over environment variables. - ---- - -## 15. Timeout Settings - -All values are in **milliseconds**. Centralized resolution in `src/shared/utils/runtimeTimeouts.ts`. - -### Timeout Hierarchy - -``` -REQUEST_TIMEOUT_MS (global override) -├─→ FETCH_TIMEOUT_MS (upstream provider calls, default: 600000) -│ ├─→ FETCH_HEADERS_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) -│ ├─→ FETCH_BODY_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) -│ ├─→ TLS_CLIENT_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) -│ ├── FETCH_CONNECT_TIMEOUT_MS (independent, default: 30000) -│ └── FETCH_KEEPALIVE_TIMEOUT_MS (independent, default: 4000) -├─→ STREAM_IDLE_TIMEOUT_MS (inherits from REQUEST_TIMEOUT_MS, default: 600000) -└─→ API_BRIDGE_PROXY_TIMEOUT_MS (inherits from REQUEST_TIMEOUT_MS, default: 30000) - ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (derived, default: 300000) - ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (default: 60000) - ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (default: 5000) - └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (default: 0 = disabled) -``` - -| Variable | Default | Description | -| ---------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------- | -| `REQUEST_TIMEOUT_MS` | _(unset)_ | Global shortcut — overrides both `FETCH_TIMEOUT_MS` and `STREAM_IDLE_TIMEOUT_MS` defaults. | -| `FETCH_TIMEOUT_MS` | `600000` | Total HTTP request timeout for upstream provider calls. | -| `STREAM_IDLE_TIMEOUT_MS` | `600000` | Max silence between SSE chunks before aborting. Extended-thinking models rarely pause >90s. | -| `FETCH_HEADERS_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | Time to receive response headers. | -| `FETCH_BODY_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | Time to receive the full response body. | -| `FETCH_CONNECT_TIMEOUT_MS` | `30000` | TCP connection establishment timeout. | -| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Keep-alive socket idle timeout. | -| `TLS_CLIENT_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | TLS fingerprint proxy (wreq-js) timeout. | -| `API_BRIDGE_PROXY_TIMEOUT_MS` | `30000` | Proxy hop timeout for `/v1` bridge requests. | -| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `300000` | Overall server request timeout for the bridge. | -| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | Time to send response headers via the bridge. | -| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | Bridge keep-alive idle timeout. | -| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | Raw socket timeout (0 = disabled). | -| `SHUTDOWN_TIMEOUT_MS` | `30000` | Grace period on SIGTERM/SIGINT before force-exit. | - -### Scenarios - -| Scenario | Configuration | -| -------------------------------- | ------------------------------------------------------ | -| **Long-running code generation** | `REQUEST_TIMEOUT_MS=900000` (15 min) | -| **Fast-fail for production API** | `API_BRIDGE_PROXY_TIMEOUT_MS=10000` | -| **Extended thinking models** | `STREAM_IDLE_TIMEOUT_MS=300000` (5 min between chunks) | - ---- - -## 16. Logging - -The logging system writes to both stdout and rotated log files. All configuration is read by `src/lib/logEnv.ts`. - -| Variable | Default | Description | -| ----------------------------------------- | -------------------------- | -------------------------------------------------------------------------------- | -| `APP_LOG_LEVEL` | `info` | Minimum log level: `debug`, `info`, `warn`, `error`. | -| `APP_LOG_FORMAT` | `text` | Output format: `text` (human-readable) or `json` (structured). | -| `APP_LOG_TO_FILE` | `true` | Write logs to file alongside stdout. | -| `APP_LOG_FILE_PATH` | `logs/application/app.log` | Log file path (relative to project root or `DATA_DIR`). | -| `APP_LOG_MAX_FILE_SIZE` | `50M` | Max file size before rotation. Accepts: `50M`, `1G`, `512K`, or plain bytes. | -| `APP_LOG_RETENTION_DAYS` | `7` | Days to keep rotated application log files. | -| `APP_LOG_MAX_FILES` | `20` | Maximum rotated log file backups. | -| `CALL_LOG_RETENTION_DAYS` | `7` | Days to keep request/call log entries in the database. | -| `CALL_LOG_MAX_ENTRIES` | `10000` | Max call log entries in the in-memory buffer. | -| `CALL_LOGS_TABLE_MAX_ROWS` | `100000` | Max rows in the `call_logs` SQLite table before pruning. | -| `CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS` | `true` | Store stream chunks in pipeline artifacts when `call_log_pipeline_enabled=true`. | -| `CALL_LOG_PIPELINE_MAX_SIZE_KB` | `512` | Max pipeline call log artifact size in KB when `call_log_pipeline_enabled=true`. | -| `PROXY_LOGS_TABLE_MAX_ROWS` | `100000` | Max rows in the `proxy_logs` SQLite table before pruning. | - ---- - -## 17. Memory Optimization - -| Variable | Default | Description | -| -------------------------- | ------------------------------- | ---------------------------------------------------------------------- | -| `OMNIROUTE_MEMORY_MB` | `256` (Docker) / system default | V8 heap limit. Sets `--max-old-space-size`. | -| `PROMPT_CACHE_MAX_SIZE` | `50` | Max cached system prompt entries. | -| `PROMPT_CACHE_MAX_BYTES` | `2097152` (2 MB) | Max total prompt cache size. | -| `PROMPT_CACHE_TTL_MS` | `300000` (5 min) | Prompt cache entry TTL. | -| `SEMANTIC_CACHE_MAX_SIZE` | `100` | Max cached temperature=0 responses. | -| `SEMANTIC_CACHE_MAX_BYTES` | `4194304` (4 MB) | Max total semantic cache size. | -| `SEMANTIC_CACHE_TTL_MS` | `1800000` (30 min) | Semantic cache entry TTL. | -| `STREAM_HISTORY_MAX` | `50` | Max recent stream events in the Dashboard live view buffer. | -| `CONTEXT_LENGTH_DEFAULT` | `128000` | Global fallback max context length for models without explicit config. | -| `USAGE_TOKEN_BUFFER` | `100` | Extra token headroom reserved when tracking usage quotas. | - -### Compression - -| Variable | Default | Description | -| ------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- | -| `OMNIROUTE_RTK_TRUST_PROJECT_FILTERS` | unset | Trust project `.rtk/filters.json` without a `.rtk/trust.json` hash. Use only in controlled local development. | - -### Low-RAM Docker Example - -```bash -OMNIROUTE_MEMORY_MB=128 -PROMPT_CACHE_MAX_SIZE=20 -PROMPT_CACHE_MAX_BYTES=524288 # 512 KB -SEMANTIC_CACHE_MAX_SIZE=25 -SEMANTIC_CACHE_MAX_BYTES=1048576 # 1 MB -STREAM_HISTORY_MAX=10 -``` - ---- - -## 18. Pricing Sync - -Automatic model pricing data synchronization from external sources. - -| Variable | Default | Source File | Description | -| ----------------------- | ------------- | ------------------------ | ----------------------------- | -| `PRICING_SYNC_ENABLED` | `false` | `src/lib/pricingSync.ts` | Opt-in periodic pricing sync. | -| `PRICING_SYNC_INTERVAL` | `86400` (24h) | `src/lib/pricingSync.ts` | Sync interval in seconds. | -| `PRICING_SYNC_SOURCES` | `litellm` | `src/lib/pricingSync.ts` | Comma-separated data sources. | - ---- - -## 19. Model Sync (Dev) - -| Variable | Default | Source File | Description | -| -------------------------- | ------------- | -------------------------- | -------------------------------------------------------- | -| `MODELS_DEV_SYNC_INTERVAL` | `86400` (24h) | `src/lib/modelsDevSync.ts` | Development-time model catalog sync interval in seconds. | - ---- - -## 20. Provider-Specific Settings - -| Variable | Default | Source File | Description | -| ----------------------------------------- | ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------- | -| `OPENROUTER_CATALOG_TTL_MS` | `86400000` (24h) | `src/lib/catalog/openrouterCatalog.ts` | OpenRouter model catalog cache TTL. | -| `NANOBANANA_POLL_TIMEOUT_MS` | `120000` | `open-sse/handlers/imageGeneration.ts` | Max wait for NanoBanana image generation jobs. | -| `NANOBANANA_POLL_INTERVAL_MS` | `2500` | `open-sse/handlers/imageGeneration.ts` | NanoBanana job polling frequency. | -| `CLOUDFLARE_ACCOUNT_ID` | _(unset)_ | `open-sse/executors/cloudflare-ai.ts` | Account ID for Cloudflare Workers AI. | -| `CLOUDFLARED_BIN` | auto-detect | `src/lib/cloudflaredTunnel.ts` | Custom path to `cloudflared` binary. | -| `SEARCH_CACHE_TTL_MS` | `300000` (5 min) | `open-sse/services/searchCache.ts` | TTL for search API (Perplexity, Brave, etc.) response caching. | -| `ALLOW_MULTI_CONNECTIONS_PER_COMPAT_NODE` | `false` | `src/app/api/providers/route.ts` | Allow multiple simultaneous connections per OpenAI-compatible provider. | -| `ENABLE_CC_COMPATIBLE_PROVIDER` | `false` | `src/shared/utils/featureFlags.ts` | Reveal the experimental CC-compatible provider UI for Claude Code-only relays. | -| `CLIPROXYAPI_HOST` | `127.0.0.1` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI bridge host (legacy integration). | -| `CLIPROXYAPI_PORT` | `5544` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI bridge port. | -| `CLIPROXYAPI_CONFIG_DIR` | `~/.cli-proxy-api` | `src/lib/versionManager/processManager.ts` | CLIProxyAPI config directory. | -| `LOCAL_HOSTNAMES` | _(empty)_ | `open-sse/config/providerRegistry.ts` | Comma-separated additional hostnames treated as "local" (Docker service names, etc.). | - -`ENABLE_CC_COMPATIBLE_PROVIDER` is only for third-party relays that accept Claude Code clients -exclusively. OmniRoute rewrites requests so those relays accept them. If you only want to use -Claude Code CLI, or you are not sure what these relays are, keep this disabled and add a regular -Anthropic-compatible provider instead. - ---- - -## 21. Proxy Health - -| Variable | Default | Source File | Description | -| ---------------------------- | ---------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -| `PROXY_FAST_FAIL_TIMEOUT_MS` | `2000` | `src/lib/proxyHealth.ts` | Fast-fail health check timeout. | -| `PROXY_HEALTH_CACHE_TTL_MS` | `30000` | `src/lib/proxyHealth.ts` | Health check result cache TTL. | -| `RATE_LIMIT_MAX_WAIT_MS` | `120000` (2 min) | `open-sse/services/rateLimitManager.ts` | Max time to wait on a 429 before failing the request. | -| `REQUEST_RETRY` | `2` | `src/sse/services/cooldownAwareRetry.ts` | Number of automatic retries on model-scoped cooldown responses before returning error to client. | -| `MAX_RETRY_INTERVAL_SEC` | `30` | `src/sse/services/cooldownAwareRetry.ts` | Max backoff interval (seconds) between cooldown retries. Capped by this value regardless of upstream `Retry-After`. | - ---- - -## 22. Debugging - -> [!CAUTION] -> These variables produce **verbose output** and may leak sensitive data. **Never enable in production.** - -| Variable | Default | Source File | Description | -| -------------------------------- | --------- | ----------------------------------------- | -------------------------------------------------------------- | -| `CURSOR_PROTOBUF_DEBUG` | _(unset)_ | `open-sse/utils/cursorProtobuf.ts` | Set `1` to dump Cursor protobuf decode/encode details. | -| `CURSOR_STREAM_DEBUG` | _(unset)_ | `open-sse/executors/cursor.ts` | Set `1` to dump raw Cursor SSE stream data. | -| `DEBUG_RESPONSES_SSE_TO_JSON` | _(unset)_ | `open-sse/handlers/responseTranslator.ts` | Set `true` to log Responses API SSE→JSON translation details. | -| `NEXT_PUBLIC_OMNIROUTE_E2E_MODE` | _(unset)_ | E2E test harness | Set `true` to enable E2E test mode (relaxed auth, test hooks). | - ---- - -## 23. GitHub Integration - -Allow users to report issues directly from the Dashboard. - -| Variable | Default | Source File | Description | -| --------------------- | --------- | --------------------------------------- | ------------------------------------------------------- | -| `GITHUB_ISSUES_REPO` | _(unset)_ | `src/app/api/v1/issues/report/route.ts` | Repository in `owner/repo` format. | -| `GITHUB_ISSUES_TOKEN` | _(unset)_ | `src/app/api/v1/issues/report/route.ts` | GitHub Personal Access Token with `issues:write` scope. | - ---- - -## Deployment Scenarios - -### Minimal Local Development - -```bash -JWT_SECRET=$(openssl rand -base64 48) -API_KEY_SECRET=$(openssl rand -hex 32) -INITIAL_PASSWORD=dev123 -PORT=20128 -NODE_ENV=development -``` - -### Docker Production - -```bash -JWT_SECRET=<generated> -API_KEY_SECRET=<generated> -INITIAL_PASSWORD=<generated> -STORAGE_ENCRYPTION_KEY=<generated> -DATA_DIR=/data -PORT=20128 -API_PORT=20129 -NODE_ENV=production -AUTH_COOKIE_SECURE=true -REQUIRE_API_KEY=true -NEXT_PUBLIC_BASE_URL=https://omniroute.example.com -BASE_URL=http://localhost:20128 -OMNIROUTE_MEMORY_MB=512 -CORS_ORIGIN=https://your-frontend.example.com -``` - -### Air-Gapped / CI - -```bash -JWT_SECRET=test-jwt-secret-for-ci -API_KEY_SECRET=test-api-key-secret-for-ci -INITIAL_PASSWORD=testpass -NODE_ENV=production -OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true -APP_LOG_TO_FILE=false -``` - -### VPS with Reverse Proxy (nginx + Cloudflare) - -```bash -JWT_SECRET=<generated> -API_KEY_SECRET=<generated> -STORAGE_ENCRYPTION_KEY=<generated> -PORT=20128 -AUTH_COOKIE_SECURE=true -REQUIRE_API_KEY=true -NEXT_PUBLIC_BASE_URL=https://omniroute.example.com -BASE_URL=http://127.0.0.1:20128 -CORS_ORIGIN=https://omniroute.example.com -ENABLE_TLS_FINGERPRINT=true -CLI_COMPAT_ALL=1 -``` - ---- - -## Audit: Removed / Dead Variables - -The following variables appeared in previous versions of `.env.example` but have **no runtime references** in the current codebase. They have been removed: - -| Variable | Reason | -| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -| `STORAGE_DRIVER=sqlite` | Never read by any source file. SQLite is the only supported driver — no selection needed. | -| `INSTANCE_NAME=omniroute` | Present in old docs/env templates but unused at runtime. May return in a future multi-instance feature. | -| `SQLITE_MAX_SIZE_MB=2048` | Not referenced in source code. Database size is not artificially limited. | -| `SQLITE_CLEAN_LEGACY_FILES=true` | Not referenced in source code. Legacy cleanup was likely removed. | -| `CLI_ROO_BIN` | Not registered in `src/shared/services/cliRuntime.ts`. | -| `CLI_KIMI_CODING_BIN` | Not registered in `src/shared/services/cliRuntime.ts` (Kimi Coding uses OAuth, not a CLI binary). | -| `IFLOW_OAUTH_CLIENT_ID` / `IFLOW_OAUTH_CLIENT_SECRET` | Not referenced anywhere in source code. | - -### Default Value Corrections - -| Variable | Old `.env.example` Value | Actual Code Default | Fixed | -| ------------------------- | ------------------------ | ------------------- | ------------------------------------------------------ | -| `APP_LOG_RETENTION_DAYS` | `90` | `7` | ✅ Removed misleading value; documented `7` as default | -| `CALL_LOG_RETENTION_DAYS` | `90` | `7` | ✅ Removed misleading value; documented `7` as default | diff --git a/docs/FREE_TIERS.md b/docs/FREE_TIERS.md deleted file mode 100644 index 2b422f0dfa..0000000000 --- a/docs/FREE_TIERS.md +++ /dev/null @@ -1,407 +0,0 @@ -# 🆓 Free LLM API Providers — Consolidated Directory - -> **The ultimate aggregated reference for all permanently free LLM API providers.** -> Consolidated from 6 community repositories. Use with OmniRoute to route through 25+ free providers simultaneously. - -_Last consolidated: May 2026 · Sources: awesome-free-llm-apis, awesome-free-llm-apis2, free-llm-api-resources, Free-LLM-Collection, FREE-LLM-API-Provider, gpt4free_ - ---- - -## Table of Contents - -- [Quick Comparison](#quick-comparison) -- [Provider APIs (First-Party)](#provider-apis-first-party) -- [Inference Providers (Third-Party)](#inference-providers-third-party) -- [China-Based Providers](#china-based-providers) -- [Trial Credit Providers](#trial-credit-providers) -- [Using with OmniRoute](#using-with-omniroute) -- [Glossary](#glossary) - ---- - -## Quick Comparison - -All free providers at a glance, sorted by generosity of free tier: - -| Provider | Type | Best Free Model | RPM | RPD | Tokens | OpenAI Compat | Speed | -| ----------------- | --------- | ---------------------- | ------- | ------------ | ---------------- | --------------- | --------- | -| **Groq** | Inference | Llama 3.3 70B | 30 | 14,400 | 6K TPM | ✅ | 🟢 Fast | -| **Cerebras** | Inference | Qwen3 235B | 30 | 14,400 | 1M TPD | ✅ | 🟢 Fast | -| **Mistral AI** | Provider | Mistral Large 3 | 60 | Unlimited | 1B/month | ✅ | 🟡 Medium | -| **Google Gemini** | Provider | Gemini 2.5 Flash | 5–15 | 20–1,500 | 250K TPM | ✅ | 🟢 Fast | -| **NVIDIA NIM** | Inference | 129 models | 40 | — | — | ✅ | 🟡 Medium | -| **Ollama Cloud** | Inference | 400+ models | — | — | Session limits | ❌ (Ollama API) | 🟡 Medium | -| **OpenRouter** | Inference | 35+ free models | 20 | 50–1,000 | — | ✅ | 🟡 Medium | -| **GitHub Models** | Inference | GPT-4.1, GPT-5 | 10–15 | 50–150 | 8K in/4K out | ✅ | 🟡 Medium | -| **Cloudflare AI** | Inference | 50+ models | — | 10K neurons | — | ⚠️ Partial | 🟡 Medium | -| **Hugging Face** | Inference | Thousands | — | — | $0.10/mo credits | ✅ | 🔴 Slow | -| **Cohere** | Provider | Command A (111B) | 20 | — | 1K calls/month | ⚠️ Partial | 🟡 Medium | -| **Pollinations** | Inference | Text+Image+Video+Audio | — | Hourly reset | — | ✅ | 🟡 Medium | -| **Z.AI (Zhipu)** | Provider | GLM-4.7-Flash | — | — | Undocumented | ✅ | 🟡 Medium | -| **SiliconFlow** | Inference | Qwen3-8B | 1,000 | — | 50K TPM | ✅ | 🟡 Medium | -| **Kilo Code** | Inference | Free auto-router | ~200/hr | — | — | ✅ | 🟡 Medium | -| **LLM7.io** | Inference | 30+ models | 15–30 | — | — | ✅ | 🟡 Medium | -| **Kluster AI** | Inference | DeepSeek-R1 | — | — | Undocumented | ✅ | 🟡 Medium | -| **ModelScope** | Inference | Qwen, DeepSeek | — | 2,000 | ≤500/model/day | ✅ | 🟡 Medium | -| **IBM watsonx** | Provider | Granite models | 2/sec | — | 300K/month | ❌ | 🟡 Medium | - ---- - -## Provider APIs (First-Party) - -APIs from the companies that train or fine-tune the models. - -### Google Gemini 🇺🇸 - -🔗 [Get API Key](https://aistudio.google.com/app/apikey) · Base URL: `https://generativelanguage.googleapis.com/v1beta` - -> ⚠️ Free tier NOT available in EU/UK/Switzerland. Prompts may be used by Google to improve products. - -| Model | Context | Max Output | Modality | RPM | RPD | -| --------------------------------- | ------- | ---------- | ---------------------- | --- | ------ | -| Gemini 2.5 Flash / Gemini 3 Flash | 1M | 65K | Text+Image+Audio+Video | 5 | 20 | -| Gemini 2.5 Flash-Lite | 1M | 65K | Text+Image+Audio+Video | 10 | 20 | -| Gemini 3.1 Flash-Lite | 1M | 65K | Text+Image+Audio+Video | 15 | 1,500 | -| Gemma 4 26B/31B | — | — | Text | 15 | 1,500 | -| Gemma 3 (1B/4B/12B/27B) | — | — | Text | 30 | 14,400 | - -### Mistral AI 🇫🇷 - -🔗 [Get API Key](https://console.mistral.ai/api-keys) · Base URL: `https://api.mistral.ai/v1` - -Free "Experiment" plan, no credit card. ~1B tokens/month. Requires phone verification. - -| Model | Context | Max Output | Modality | Rate Limit | -| ------------------ | ------- | ---------- | --------------- | --------------- | -| Mistral Small 4 | 256K | 256K | Text+Image+Code | 1 RPS, 500K TPM | -| Mistral Medium 3 | 128K | 128K | Text | 1 RPS, 500K TPM | -| Mistral Large 3 | 256K | 256K | Text | 1 RPS, 500K TPM | -| Mistral Nemo (12B) | 128K | 128K | Text | 1 RPS, 500K TPM | -| Codestral | 256K | 256K | Code | 30 RPM, 2K RPD | -| Pixtral Large | 128K | 128K | Text+Image | 1 RPS, 500K TPM | - -### Cohere 🇨🇦 - -🔗 [Get API Key](https://dashboard.cohere.com/api-keys) · Base URL: `https://api.cohere.com/v2` - -Free "Trial" key. 1,000 API calls/month. Non-commercial use only. 20 RPM. - -| Model | Context | Max Output | Modality | -| ------------------- | ------- | ---------- | ----------------------- | -| Command A (111B) | 256K | 4K | Text | -| Command A Reasoning | 256K | 4K | Text (reasoning) | -| Command A Vision | 256K | 4K | Text+Image | -| Command A Translate | 256K | 4K | Translation | -| Command R+ | 128K | 4K | Text | -| Command R | 128K | 4K | Text | -| Command R7B | 128K | 4K | Text | -| Embed 4 | — | — | Embeddings (Text+Image) | -| Rerank 3.5 | — | — | Reranking | - -### Z.AI (Zhipu AI) 🇨🇳 - -🔗 [Get API Key](https://open.bigmodel.cn/usercenter/apikeys) · Base URL: `https://open.bigmodel.cn/api/paas/v4` - -Permanent free models, no credit card. No published rate limits. - -| Model | Context | Max Output | Modality | -| --------------- | ------- | ---------- | ---------- | -| GLM-4.7-Flash | 200K | 128K | Text | -| GLM-4.5-Flash | 128K | ~8K | Text | -| GLM-4.6V-Flash | 128K | ~4K | Text+Image | -| GLM-5 / GLM-5.1 | — | — | Text | - -### IBM watsonx 🇺🇸 - -🔗 [Pricing](https://www.ibm.com/products/watsonx-ai/pricing) - -Free tier: 2 RPS, 300K tokens/month. Granite foundation models. - ---- - -## Inference Providers (Third-Party) - -### Groq 🇺🇸 - -🔗 [Get API Key](https://console.groq.com/keys) · Base URL: `https://api.groq.com/openai/v1` - -Ultra-fast LPU inference (~300–500 tok/s). No credit card required. - -| Model | RPM | RPD | TPM | Modality | -| ---------------------------------- | --- | ------ | --- | ---------------- | -| llama-3.3-70b-versatile | 30 | 1,000 | 12K | Text | -| llama-3.1-8b-instant | 30 | 14,400 | 6K | Text | -| llama-4-scout-17b-16e-instruct | 30 | 1,000 | 30K | Text+Vision | -| llama-4-maverick-17b-128e-instruct | 30 | 1,000 | 6K | Text+Vision | -| qwen3-32b | 60 | 1,000 | 6K | Text | -| kimi-k2-instruct | 60 | 1,000 | 10K | Text | -| gpt-oss-120b / gpt-oss-20b | 30 | 1,000 | 8K | Text | -| deepseek-r1-distill-70b | 30 | 14,400 | — | Text (reasoning) | -| whisper-large-v3 / v3-turbo | 20 | 2,000 | — | Audio→Text | - -### Cerebras 🇺🇸 - -🔗 [Get API Key](https://cloud.cerebras.ai/) · Base URL: `https://api.cerebras.ai/v1` - -Wafer-scale chip inference (~2,600 tok/s). 1M tokens/day cap. - -| Model | RPM | RPH | RPD | TPM | TPD | -| ------------------------------ | --- | --- | ------ | --- | --- | -| gpt-oss-120b | 30 | 900 | 14,400 | 64K | 1M | -| llama3.1-8b | 30 | 900 | 14,400 | 60K | 1M | -| qwen-3-235b-a22b-instruct-2507 | 30 | 900 | 14,400 | 60K | 1M | -| zai-glm-4.7 | 10 | 100 | 100 | 60K | 1M | - -### NVIDIA NIM 🇺🇸 - -🔗 [Explore Models](https://build.nvidia.com/explore/discover) · Base URL: `https://integrate.api.nvidia.com/v1` - -Free with NVIDIA Developer Program. **129 models**, 40 RPM. Phone verification required. - -**Notable models:** DeepSeek-R1, DeepSeek-V3.2, Nemotron Ultra 253B, Llama 3.1 405B, Qwen3 Coder 480B, Mistral Large 3, Kimi K2, GLM-5.1, MiniMax M2.7, Gemma 4 31B, + 100 more. - -### OpenRouter 🇺🇸 - -🔗 [Get API Key](https://openrouter.ai/keys) · Base URL: `https://openrouter.ai/api/v1` - -35+ free models (suffix `:free`). 20 RPM. - -| Credits Purchased | RPD | -| ----------------- | ----- | -| < $10 | 50 | -| ≥ $10 (one-time) | 1,000 | - -**Notable free models:** DeepSeek R1, DeepSeek V3, Qwen3 Coder 480B, Llama 4 Scout/Maverick, GPT-OSS 120B, Nemotron 3 Super 120B, MiniMax M2.5, Gemma 4 31B, Devstral, + 23 more. - -### GitHub Models 🇺🇸 - -🔗 [Marketplace](https://github.com/marketplace/models) · Base URL: `https://models.inference.ai.azure.com` - -Free for all GitHub users. 45+ models including frontier models. - -| Tier | RPM | RPD | Tokens/Request | -| ----------------------- | --- | --- | -------------- | -| Low tier models | 15 | 150 | 8K in / 4K out | -| High tier models | 10 | 50 | 8K in / 4K out | -| DeepSeek-R1 / MAI-DS-R1 | 1 | 8 | 4K in / 4K out | -| Grok-3 | 1 | 15 | 4K in / 4K out | - -**Notable models:** GPT-4.1, GPT-4o, GPT-5, GPT-5-mini, o3-mini, o4-mini, DeepSeek-R1, Llama 4 Scout/Maverick, Codestral, Mistral Medium 3, Phi-4, Grok-3. - -### Cloudflare Workers AI 🇺🇸 - -🔗 [Get Token](https://dash.cloudflare.com/profile/api-tokens) · 10,000 Neurons/day free. 50+ models. - -**Notable models:** Llama 3.3 70B, Llama 4 Scout, Qwen3 30B-A3B, QwQ 32B, DeepSeek R1 Distill, Gemma 4 26B, GLM 4.7 Flash, Nemotron 3 120B, Kimi K2.5/K2.6, Mistral Small 3.1, GPT-OSS 120B/20B, + 40 more. - -### Hugging Face 🇺🇸 - -🔗 [Get Token](https://huggingface.co/settings/tokens) · Base URL: `https://api-inference.huggingface.co/v1` - -$0.10/month free credits (auto-replenished). Thousands of models. Serverless limited to <10GB models. - -### Ollama Cloud 🇺🇸 - -🔗 [Get Key](https://ollama.com/settings/keys) · Base URL: `https://api.ollama.com` - -400+ models. Session/weekly limits (unpublished). NOT OpenAI SDK-compatible. - -**Notable models:** GPT-OSS 120B, DeepSeek V3.2/V4, Kimi K2/K2.5/K2.6, GLM-5/5.1, Qwen3 Coder 480B, Gemini 3 Flash, MiniMax M2.7, Cogito 2.1 671B, Nemotron 3 Super 120B. - -### Pollinations AI 🇩🇪 - -🔗 [Get Key](https://enter.pollinations.ai) · Base URL: `https://gen.pollinations.ai/v1` - -No sign-up required for basic use. Unique: **text + image + video + audio** all free. - -**Text models:** openai, openai-large, openai-reasoning, gemini, mistral, llama. -**Image models:** flux, gpt-image, seedream, kontext. -**Video:** wan-fast. **Audio:** tts-1, 30+ ElevenLabs voices. - -### SiliconFlow 🇨🇳 - -🔗 [Get Key](https://cloud.siliconflow.cn/account/ak) · Base URL: `https://api.siliconflow.cn/v1` - -14 CNY signup credits. Permanently free models: 1,000 RPM, 50K TPM. - -| Model | Context | Modality | -| --------------------------- | ------- | ---------------- | -| Qwen/Qwen3-8B | 131K | Text | -| DeepSeek-R1-0528-Qwen3-8B | ~33K | Text (reasoning) | -| DeepSeek-R1-Distill-Qwen-7B | 131K | Text (reasoning) | -| THUDM/glm-4-9b-chat | 32K | Text | -| THUDM/GLM-4.1V-9B-Thinking | 66K | Vision+Text | -| DeepSeek-OCR | — | Vision (OCR) | - -### Kilo Code 🇺🇸 - -🔗 [Get Key](https://kilo.ai) · Base URL: `https://api.kilo.ai/api/gateway` - -Free models, no credit card. ~200 req/hr. Auto-router `kilo-auto/free`. - -### LLM7.io 🇬🇧 - -🔗 [Get Token](https://token.llm7.io) · Base URL: `https://api.llm7.io/v1` - -30+ models. 15 RPM (30 RPM with free token). No registration for basic access. - -### Kluster AI 🇺🇸 - -🔗 [Get Key](https://platform.kluster.ai/apikeys) · DeepSeek-R1, Llama 4 Maverick, Qwen3-235B + more. - -### OpenCode Zen - -🔗 [Docs](https://opencode.ai/docs/zen/) · Free models (Big Pickle Stealth, MiniMax M2.5 Free, Arcee Large). - -### Vercel AI Gateway - -🔗 [Docs](https://vercel.com/docs/ai-gateway) · $5/month free credits. Routes to various providers. - ---- - -## China-Based Providers - -### ModelScope (魔搭社区) 🇨🇳 - -🔗 [Get Token](https://modelscope.cn/my/myaccesstoken) · Base URL: `https://api-inference.modelscope.cn/v1` - -2,000 req/day total, ≤500/model/day. Requires Alibaba Cloud account + real-name verification. - -**Models:** DeepSeek V4 Pro/Flash, DeepSeek V3.2, GLM-5/5.1, MiniMax M2.5, Qwen3-235B, Qwen3 Coder 480B, Ling-2.6-1T. - -### Tencent Hunyuan (腾讯混元) - -Hunyuan-Lite: free. Other models: 100M tokens free (1-year expiry). - -### Volcengine (火山引擎) - -500 resource points/day. Tongyi Qwen free (100 calls/day). Doubao models with tiered pricing. - -### ChatAnywhere - -🔗 Base URL: `https://api.chatanywhere.tech` · GPT-5.4-mini, DeepSeek-V4, and more. - -### InternAI (书生) - -🔗 Base URL: `https://chat.intern-ai.org.cn/api/v1` · 10 RPM. Keys valid 6 months. - -**Models:** intern-latest, intern-s1-pro, internvl3.5-241b-a28b. - -### Bigmodel (智谱) - -🔗 Base URL: `https://open.bigmodel.cn/api/paas/v4/` · 30 concurrent requests. - -**Models:** GLM-4-Flash, GLM-4V-Flash, GLM-4.1V-Thinking-Flash, GLM-4.6V-Flash, GLM-4.7-Flash. - ---- - -## Trial Credit Providers - -These offer one-time or time-limited credits (not permanent free tiers): - -| Provider | Credits | Expiry | Notable Models | -| ---------------------------------------------------------- | ---------------- | -------- | ----------------------------- | -| [Baseten](https://app.baseten.co/) | $30 | — | Any model (pay by compute) | -| [NLP Cloud](https://nlpcloud.com) | $15 | — | Various open models | -| [AI21](https://studio.ai21.com/) | $10 | 3 months | Jamba family | -| [Upstage](https://console.upstage.ai/) | $10 | 3 months | Solar Pro/Mini | -| [Modal](https://modal.com) | $5/mo | Monthly | Any model (compute time) | -| [SambaNova](https://cloud.sambanova.ai/) | $5 | 3 months | Llama 3.3, Qwen3, DeepSeek R1 | -| [Scaleway](https://console.scaleway.com/generative-api) | 1M tokens | One-time | Llama 3.3, Gemma 3, GPT-OSS | -| [Alibaba Cloud](https://bailian.console.alibabacloud.com/) | 1M tokens/model | — | Qwen family | -| [Fireworks](https://fireworks.ai/) | $1 | — | Various open models | -| [Nebius](https://tokenfactory.nebius.com/) | $1 | — | Various open models | -| [Inference.net](https://inference.net) | $1 (+$25 survey) | — | Various open models | -| [Hyperbolic](https://app.hyperbolic.ai/) | $1 | — | DeepSeek V3, Llama 3.3 | -| [Novita](https://novita.ai/) | $0.50 | 1 year | Various open models | - ---- - -## Using with OmniRoute - -OmniRoute supports **all providers listed above** as connections. Here's how to maximize free usage: - -### 1. Add Multiple Free Providers - -``` -Dashboard → Providers → Add Connection -``` - -Add API keys for Groq, Cerebras, Mistral, Google Gemini, OpenRouter, GitHub Models, etc. - -### 2. Create a Free-Tier Combo - -``` -Dashboard → Combos → Create Combo → Add all free providers as targets -``` - -Use the **"priority"** or **"round-robin"** strategy to distribute load across free tiers. - -### 3. Recommended Free Combo Strategy - -| Priority | Provider | Why | -| -------- | ----------------- | --------------------------------------------- | -| 1 | **Groq** | Fastest inference, 14,400 RPD on small models | -| 2 | **Cerebras** | 1M TPD, fast wafer-scale chips | -| 3 | **Mistral** | 1B tokens/month, large model selection | -| 4 | **Google Gemini** | 1M context, multimodal | -| 5 | **NVIDIA NIM** | 129 models, 40 RPM | -| 6 | **OpenRouter** | 35+ free models as final fallback | - -### 4. Environment Variables - -```bash -# These providers work out of the box with OmniRoute: -GROQ_API_KEY=your-key -CEREBRAS_API_KEY=your-key -MISTRAL_API_KEY=your-key -GOOGLE_AI_API_KEY=your-key -NVIDIA_API_KEY=your-key -OPENROUTER_API_KEY=your-key -GITHUB_TOKEN=your-token -CLOUDFLARE_API_TOKEN=your-token -COHERE_API_KEY=your-key -SILICONFLOW_API_KEY=your-key -``` - -### 5. Estimated Free Capacity - -With all top-6 providers combined in a combo: - -| Metric | Combined Free Capacity | -| -------------------- | ---------------------- | -| **Requests/Day** | ~31,000+ RPD | -| **Tokens/Month** | ~32B+ tokens | -| **Models Available** | 200+ unique models | -| **Cost** | $0.00 | - ---- - -## Glossary - -| Term | Meaning | -| ----------- | ------------------------------------------- | -| **RPM** | Requests per minute | -| **RPD** | Requests per day | -| **RPH** | Requests per hour | -| **RPS** | Requests per second | -| **TPM** | Tokens per minute | -| **TPD** | Tokens per day | -| **Neurons** | Cloudflare's compute unit (~1 output token) | - ---- - -## Sources - -This document consolidates data from 6 community repositories: - -| Repository | Focus | -| -------------------------------------------------------------------------- | ------------------------------------------------ | -| [awesome-free-llm-apis](https://github.com/mnfst/awesome-free-llm-apis) | Curated list with detailed model tables | -| [awesome-free-llm-apis2](https://github.com/) | Extended list with speed tiers and code snippets | -| [free-llm-api-resources](https://github.com/) | Auto-generated model lists with trial credits | -| [Free-LLM-Collection](https://github.com/for-the-zero/Free-LLM-Collection) | Chinese + global providers with rate limits | -| [FREE-LLM-API-Provider](https://github.com/CYBIRD-D/FREE-LLM-API-Provider) | Deep provider analysis with CN platforms | -| [gpt4free](https://github.com/xtekky/gpt4free) | Config-based routing with quota awareness | - -> ⚠️ **Disclaimer:** Rate limits change frequently. Always verify with the provider's official documentation before relying on specific limits. Trial credits and time-limited promotions are separated from permanent free tiers. diff --git a/docs/I18N.md b/docs/I18N.md deleted file mode 100644 index 50525515fc..0000000000 --- a/docs/I18N.md +++ /dev/null @@ -1,409 +0,0 @@ -# i18n — Internationalization Guide - -OmniRoute supports **30 languages** with full dashboard UI translation, translated documentation, and RTL support for Arabic and Hebrew. - -🌐 **Languages:** 🇺🇸 [English](../I18N.md) | 🇧🇷 [Português (Brasil)](./pt-BR/I18N.md) | 🇪🇸 [Español](./es/I18N.md) | 🇫🇷 [Français](./fr/I18N.md) | 🇩🇪 [Deutsch](./de/I18N.md) | 🇮🇹 [Italiano](./it/I18N.md) | 🇷🇺 [Русский](./ru/I18N.md) | 🇨🇳 [中文 (简体)](./zh-CN/I18N.md) | 🇯🇵 [日本語](./ja/I18N.md) | 🇰🇷 [한국어](./ko/I18N.md) | 🇸🇦 [العربية](./ar/I18N.md) | 🇮🇳 [हिन्दी](./hi/I18N.md) | 🇹🇭 [ไทย](./th/I18N.md) | 🇹🇷 [Türkçe](./tr/I18N.md) | 🇺🇦 [Українська](./uk-UA/I18N.md) | 🇻🇳 [Tiếng Việt](./vi/I18N.md) | 🇧🇬 [Български](./bg/I18N.md) | 🇩🇰 [Dansk](./da/I18N.md) | 🇫🇮 [Suomi](./fi/I18N.md) | 🇮🇱 [עברית](./he/I18N.md) | 🇭🇺 [Magyar](./hu/I18N.md) | 🇮🇩 [Bahasa Indonesia](./id/I18N.md) | 🇲🇾 [Bahasa Melayu](./ms/I18N.md) | 🇳🇱 [Nederlands](./nl/I18N.md) | 🇳🇴 [Norsk](./no/I18N.md) | 🇵🇹 [Português (Portugal)](./pt/I18N.md) | 🇷🇴 [Română](./ro/I18N.md) | 🇵🇱 [Polski](./pl/I18N.md) | 🇸🇰 [Slovenčina](./sk/I18N.md) | 🇸🇪 [Svenska](./sv/I18N.md) | 🇵🇭 [Filipino](./phi/I18N.md) | 🇨🇿 [Čeština](./cs/I18N.md) - -## Quick Reference - -| Task | Command | -|------|---------| -| Generate translations | `node scripts/i18n/generate-multilang.mjs messages` | -| Translate docs (LLM) | `python3 scripts/i18n_autotranslate.py --api-url <url> --api-key <key> --model <model>` | -| Validate a locale | `python3 scripts/validate_translation.py quick -l cs` | -| Check code keys | `python3 scripts/check_translations.py` | -| Generate QA report | `node scripts/i18n/generate-qa-checklist.mjs` | -| Visual QA (Playwright) | `node scripts/i18n/run-visual-qa.mjs` | - -## Architecture - -### Source of Truth -- **UI strings**: `src/i18n/messages/en.json` (English source, ~2800 keys) -- **Locale files**: `src/i18n/messages/{locale}.json` (30 translations) -- **Framework**: `next-intl` with cookie-based locale resolution -- **Config**: `src/i18n/config.ts` — defines all 30 locales, language names, flags - -### Runtime Flow -1. User selects language → `NEXT_LOCALE` cookie set -2. `src/i18n/request.ts` resolves locale: cookie → `Accept-Language` header → fallback `en` -3. Dynamic import loads `messages/{locale}.json` -4. Components use `useTranslations("namespace")` and `t("key")` - -### Supported Locales - -| Code | Language | RTL | Google Translate Code | -|------|----------|-----|----------------------| -| `ar` | العربية | Yes | `ar` | -| `bg` | Български | No | `bg` | -| `cs` | Čeština | No | `cs` | -| `da` | Dansk | No | `da` | -| `de` | Deutsch | No | `de` | -| `es` | Español | No | `es` | -| `fi` | Suomi | No | `fi` | -| `fr` | Français | No | `fr` | -| `he` | עברית | Yes | `iw` | -| `hi` | हिन्दी | No | `hi` | -| `hu` | Magyar | No | `hu` | -| `id` | Bahasa Indonesia | No | `id` | -| `it` | Italiano | No | `it` | -| `ja` | 日本語 | No | `ja` | -| `ko` | 한국어 | No | `ko` | -| `ms` | Bahasa Melayu | No | `ms` | -| `nl` | Nederlands | No | `nl` | -| `no` | Norsk | No | `no` | -| `phi` | Filipino | No | `tl` | -| `pl` | Polski | No | `pl` | -| `pt` | Português (Portugal) | No | `pt` | -| `pt-BR` | Português (Brasil) | No | `pt` | -| `ro` | Română | No | `ro` | -| `ru` | Русский | No | `ru` | -| `sk` | Slovenčina | No | `sk` | -| `sv` | Svenska | No | `sv` | -| `th` | ไทย | No | `th` | -| `tr` | Türkçe | No | `tr` | -| `uk-UA` | Українська | No | `uk` | -| `vi` | Tiếng Việt | No | `vi` | -| `zh-CN` | 中文 (简体) | No | `zh-CN` | - -## Adding a New Language - -### 1. Register the Locale -Edit `src/i18n/config.ts`: -```ts -// Add to LOCALES array -"xx", -// Add to LANGUAGES array -{ code: "xx", label: "XX", name: "Language Name", flag: "🏳️" }, -``` - -### 2. Add to Generator -Edit `scripts/i18n/generate-multilang.mjs` — add entry to `LOCALE_SPECS`: -```js -{ - code: "xx", - googleTl: "xx", - label: "XX", - flag: "🏳️", - languageName: "Language Name", - readmeName: "Language Name", - docsName: "Language Name", -}, -``` - -### 3. Generate Initial Translation -```bash -node scripts/i18n/generate-multilang.mjs messages -``` -This creates `src/i18n/messages/xx.json` auto-translated from `en.json` via Google Translate. - -### 4. Review & Fix Auto-Translations -Auto-translations are a starting point. Review manually for: -- Technical accuracy -- Context-appropriate terminology -- Proper handling of placeholders (`{count}`, `{value}`, etc.) - -### 5. Validate -```bash -python3 scripts/validate_translation.py quick -l xx -python3 scripts/validate_translation.py diff common -l xx -``` - -### 6. Generate Translated Documentation -```bash -node scripts/i18n/generate-multilang.mjs docs -``` - -## Auto-Translation Pipeline - -### generate-multilang.mjs (Google Translate) - -**Primary auto-translation engine** — uses Google Translate free API to generate translations for UI strings, READMEs, and documentation. - -```bash -node scripts/i18n/generate-multilang.mjs [messages|readme|docs|all] -``` - -| Mode | What it does | -|------|-------------| -| `messages` | Translates missing keys in `src/i18n/messages/{locale}.json` from `en.json` | -| `readme` | Translates `README.md` into all locales as `README.{code}.md` in project root | -| `docs` | Translates `DOC_SOURCE_FILES` into `docs/i18n/{locale}/{docName}` | -| `all` | Runs all three modes | - -**Features:** -- **Text protection**: Masks code blocks (```` ``` ````), inline code (`` ` ``), markdown links/images (`[text](url)`), HTML tags, tables, and ICU placeholders (`{count}`, `{value}`, `{total}`, etc.) before translation, then restores them -- **Chunked batching**: Joins multiple strings with `__OMNIROUTE_I18N_SEPARATOR__` delimiters to minimize API calls (max 1800 chars per request) -- **In-memory cache**: Avoids redundant API calls for repeated strings within a session -- **Retry logic**: Exponential backoff (up to 5 attempts with 300ms × attempt delay) for 429/5xx errors -- **Timeout**: 20 seconds per request -- **Skip existing**: If target file already exists, it is NOT overwritten - -**Important behaviors:** -- `docs/i18n/README.md` is **regenerated** each run — it's an auto-generated index of all docs -- Root `README.{code}.md` files are only created if they don't exist (skips locales in `EXISTING_README_CODES`) -- Language bars (`🌐 **Languages:** ...`) are automatically inserted/updated in all translated docs - -### i18n_autotranslate.py (LLM-based) - -**Secondary translator** — uses any OpenAI-compatible LLM API (including OmniRoute itself) to translate existing `docs/i18n/` markdown files. Best for polishing or re-translating docs with better quality than Google Translate. - -```bash -python3 scripts/i18n_autotranslate.py \ - --api-url http://localhost:20128/v1 \ - --api-key sk-your-key \ - --model gpt-4o -``` - -**Features:** -- Scans `docs/i18n/` markdown files for English paragraphs -- Skips code blocks, tables, and already-translated content -- Sends paragraphs to LLM with technical translation system prompt -- Supports all 30 languages - -## Validation & QA - -### validate_translation.py - -**Translation validator** — compares any locale JSON against `en.json` and reports issues. - -```bash -# Quick check (counts only) -python3 scripts/validate_translation.py quick -l cs -# Output: -# Missing: 0 -# Untranslated: 0 -# Ignored (UNTRANSLATABLE_KEYS): 236 - -# Detailed diff by category -python3 scripts/validate_translation.py diff common -l cs -python3 scripts/validate_translation.py diff settings -l cs - -# Export to CSV -python3 scripts/validate_translation.py csv -l cs > report.csv - -# Export to Markdown -python3 scripts/validate_translation.py md -l cs > report.md - -# Full report (default) -python3 scripts/validate_translation.py -l cs -``` - -**Detects:** -- **Missing keys** — keys in `en.json` but not in locale file -- **Extra keys** — keys in locale file but not in `en.json` -- **Untranslated keys** — keys where locale value equals English source (excluding allowlist) -- **Placeholder mismatches** — ICU placeholders that don't match between source and translation - -**Exit codes:** -| Code | Meaning | -|------|---------| -| 0 | OK | -| 1 | Generic error | -| 2 | Missing strings (hard error) | -| 3 | Untranslated warning (soft) | - -**Environment:** Set `TRANSLATION_LANG=cs` or use `-l cs` flag. - -### check_translations.py - -**Code-to-JSON key checker** — scans `src/**/*.tsx` and `src/**/*.ts` for `useTranslations()` calls and verifies all referenced keys exist in `en.json`. - -```bash -# Basic check -python3 scripts/check_translations.py - -# Verbose output -python3 scripts/check_translations.py --verbose - -# Auto-fix (adds missing keys to en.json) -python3 scripts/check_translations.py --fix -``` - -### generate-qa-checklist.mjs - -**Static analysis QA** — scans Next.js page files for i18n risk metrics and generates a Markdown report. - -```bash -node scripts/i18n/generate-qa-checklist.mjs -``` - -**Checks:** -- Fixed-width class usage (overflow risk) -- Directional left/right classes (RTL risk) -- Clipping-prone patterns -- Locale parity (missing/extra keys vs `en.json`) -- README language selector bars in priority locales (`es`, `fr`, `de`, `ja`, `ar`) - -**Output:** `docs/reports/i18n-qa-checklist-{date}.md` - -### run-visual-qa.mjs - -**Visual QA via Playwright** — takes screenshots of all dashboard routes in multiple locales and viewports, then evaluates page health. - -```bash -# Default: es, fr, de, ja, ar on localhost:20128 -node scripts/i18n/run-visual-qa.mjs - -# Custom base URL and locales -QA_BASE_URL=http://staging.example.com QA_LOCALES=de,fr node scripts/i18n/run-visual-qa.mjs - -# Custom routes -QA_ROUTES=/dashboard/settings,/dashboard/providers node scripts/i18n/run-visual-qa.mjs -``` - -**Detects:** -- Text overflow -- Element clipping -- RTL layout mismatches - -**Output:** `docs/reports/i18n-visual-qa-{date}.md` + JSON report - -## Managing Untranslatable Keys - -### untranslatable-keys.json - -**File:** `scripts/i18n/untranslatable-keys.json` - -Allowlist of keys that should remain identical to English source. Used by `validate_translation.py` to avoid false-positive "untranslated" warnings. - -```json -{ - "description": "Keys that should remain untranslated...", - "keys": [ - "common.model", - "common.oauth", - "health.cpu", - ... - ] -} -``` - -**What belongs here:** -- Brand/product names: `landing.brandName`, `common.social-github` -- Technical terms/acronyms: `health.cpu`, `mcpDashboard.pid`, `settings.ai` -- ICU/format strings: `apiManager.modelsCount`, `health.millisecondsShort` -- Placeholder values: `providers.openaiBaseUrlPlaceholder`, `cliTools.baseUrlPlaceholder` -- Protocol names: `common.http`, `common.oauth`, `providers.oauth2Label` -- Navigation sections: `sidebar.primarySection`, `sidebar.cliSection` - -**To add a key:** Edit the `keys` array in `scripts/i18n/untranslatable-keys.json` and re-run validation. - -## CI Integration - -### GitHub Actions (`.github/workflows/ci.yml`) - -The CI pipeline validates all locales on every push and PR: - -1. **`i18n-matrix` job** — dynamically discovers all locale files (excluding `en.json`) -2. **`i18n` job** — runs `validate_translation.py quick -l '<lang>'` for each locale in parallel -3. **`ci-summary` job** — aggregates results into a dashboard summary - -```yaml -# i18n-matrix: discovers languages -LANGS=$(ls src/i18n/messages/*.json | xargs -n1 basename | sed 's/.json$//' | grep -v '^en$') - -# i18n: validates each language -python3 scripts/validate_translation.py quick -l '${{ matrix.lang }}' -``` - -**Dashboard output:** -``` -## 🌍 Translations -| Metric | Value | -|--------|------| -| Languages checked | 30 | -| Total untranslated | 0 | - -✅ All translations complete -``` - -## File Structure - -``` -src/i18n/ -├── config.ts # Locale definitions (30 locales, RTL config) -├── request.ts # Runtime locale resolution -└── messages/ - ├── en.json # Source of truth (~2800 keys) - ├── cs.json # Czech translation - ├── de.json # German translation - └── ... # 30 locale files total - -scripts/ -├── i18n/ -│ ├── generate-multilang.mjs # Auto-translation engine (Google Translate, 888 lines) -│ ├── generate-qa-checklist.mjs # Static analysis QA -│ ├── run-visual-qa.mjs # Playwright visual QA -│ └── untranslatable-keys.json # Allowlist for validation (236 keys) -├── validate_translation.py # Translation validator -├── check_translations.py # Code-to-JSON key checker -└── i18n_autotranslate.py # LLM-based doc translator - -.github/workflows/ -└── ci.yml # i18n validation in CI matrix - -docs/ -├── I18N.md # This file — i18n toolchain documentation -├── i18n/ -│ ├── README.md # Auto-generated language index -│ ├── cs/ # Czech docs -│ │ └── docs/ -│ │ ├── I18N.md # Czech translation of this file -│ │ └── ... -│ ├── de/ # German docs -│ └── ... # 30 locale directories -└── reports/ - ├── i18n-qa-checklist-*.md # Static analysis reports - └── i18n-visual-qa-*.md # Visual QA reports -``` - -## Best Practices - -### When Editing Translations -1. **Always edit `en.json` first** — it's the source of truth -2. **Run `generate-multilang.mjs messages`** to propagate new keys to all locales -3. **Review auto-translations** — Google Translate is a starting point, not final -4. **Validate before committing** — `python3 scripts/validate_translation.py quick -l <lang>` -5. **Update `untranslatable-keys.json`** if a key should remain in English - -### Placeholder Safety -- ICU placeholders (`{count}`, `{value}`, `{total}`, `{seconds}`) must be preserved exactly -- Plural formats (`{count, plural, one {# model} other {# models}}`) must maintain structure -- The validator detects placeholder mismatches automatically - -### Adding New Translation Keys in Code -```tsx -// Use namespaced keys -const t = useTranslations("settings"); -t("cacheSettings"); // maps to settings.cacheSettings in JSON - -// Run check_translations.py to verify keys exist -python3 scripts/check_translations.py --verbose -``` - -### RTL Considerations -- Arabic (`ar`) and Hebrew (`he`) are RTL locales -- Avoid hardcoded `left`/`right` CSS — use `start`/`end` logical properties -- Visual QA catches RTL layout mismatches via `run-visual-qa.mjs` - -## Known Issues & History - -### `in.json` → `hi.json` Fix -The generator originally used `code: "in"` (deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 `hi`. This created an orphaned `in.json` duplicate of `hi.json`. Fixed by changing `code: "in"` to `code: "hi"` in `generate-multilang.mjs` and removing the orphaned file. - -### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. - -### External Untranslatable Keys List -The `untranslatable-keys.json` allowlist was moved from an inline Python set in `validate_translation.py` to an external JSON file for easier maintenance. The validator loads it at runtime. - -### `generate-multilang.mjs` Hindi Code Fix -The generator originally used `code: "in"` (deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 `hi`. This was introduced in upstream commit `952b0b22c` by `diegosouzapw`. Fixed by changing `code: "in"` to `code: "hi"` in the `LOCALE_SPECS` array and removing the orphaned `in.json` file. - -### `validate_translation.py` Ignored Count Output -The `quick` check now displays the count of ignored keys from `untranslatable-keys.json`: -``` -Missing: 0 -Untranslated: 0 -Ignored (UNTRANSLATABLE_KEYS): 236 -``` diff --git a/docs/MCP-SERVER.md b/docs/MCP-SERVER.md deleted file mode 100644 index 4312fb0f12..0000000000 --- a/docs/MCP-SERVER.md +++ /dev/null @@ -1,119 +0,0 @@ -# OmniRoute MCP Server Documentation - -> Model Context Protocol server with 37 tools across routing, cache, compression, memory, skills, and proxy operations - -## Installation - -OmniRoute MCP is built-in. Start it with: - -```bash -omniroute --mcp -``` - -Or via the open-sse transport: - -```bash -# HTTP streamable transport (port 20130) -omniroute --dev # MCP auto-starts on /mcp endpoint -``` - -## IDE Configuration - -See [MCP Client Configuration](SETUP_GUIDE.md#mcp-client-configuration) for Claude Desktop, -Cursor, Cline, and compatible MCP client setup. - ---- - -## Essential Tools (8) - -| Tool | Description | -| :------------------------------ | :--------------------------------------- | -| `omniroute_get_health` | Gateway health, circuit breakers, uptime | -| `omniroute_list_combos` | All configured combos with models | -| `omniroute_get_combo_metrics` | Performance metrics for a specific combo | -| `omniroute_switch_combo` | Switch active combo by ID/name | -| `omniroute_check_quota` | Quota status per provider or all | -| `omniroute_route_request` | Send a chat completion through OmniRoute | -| `omniroute_cost_report` | Cost analytics for a time period | -| `omniroute_list_models_catalog` | Full model catalog with capabilities | - -## Advanced Tools (8) - -| Tool | Description | -| :--------------------------------- | :---------------------------------------------------------- | -| `omniroute_simulate_route` | Dry-run routing simulation with fallback tree | -| `omniroute_set_budget_guard` | Session budget with degrade/block/alert actions | -| `omniroute_set_resilience_profile` | Apply conservative/balanced/aggressive preset | -| `omniroute_test_combo` | Live-test all models in a combo via a real upstream request | -| `omniroute_get_provider_metrics` | Detailed metrics for one provider | -| `omniroute_best_combo_for_task` | Task-fitness recommendation with alternatives | -| `omniroute_explain_route` | Explain a past routing decision | -| `omniroute_get_session_snapshot` | Full session state: costs, tokens, errors | - -## Cache Tools (2) - -| Tool | Description | -| :---------------------- | :-------------------------------------------------- | -| `omniroute_cache_stats` | Semantic cache, prompt-cache, and idempotency stats | -| `omniroute_cache_flush` | Flush cache globally or by signature/model | - -## Compression Tools (5) - -| Tool | Description | -| :---------------------------------- | :------------------------------------------------------------- | -| `omniroute_compression_status` | Compression settings, analytics summary, and cache-aware stats | -| `omniroute_compression_configure` | Configure compression mode, threshold, and runtime options | -| `omniroute_set_compression_engine` | Set Caveman, RTK, or stacked compression mode and pipeline | -| `omniroute_list_compression_combos` | List named compression combos and routing assignments | -| `omniroute_compression_combo_stats` | Analytics grouped by compression combo and engine | - -`omniroute_compression_status` reports MCP description compression separately under -`analytics.mcpDescriptionCompression`. Those values are metadata-size estimates for MCP listable -descriptions (`tools`, `prompts`, `resources`, and `resourceTemplates`); they are not provider usage -receipts and are marked with `source: "mcp_metadata_estimate"`. - -See [Compression Engines](COMPRESSION_ENGINES.md) and [RTK Compression](RTK_COMPRESSION.md) for -the runtime compression model behind these tools. - -## Other Tool Groups - -The remaining MCP surface includes 1proxy tools, memory tools, and skill tools. The live source of -truth is `open-sse/mcp-server/tools/` and `open-sse/mcp-server/schemas/tools.ts`. - -## Authentication - -MCP tools are authenticated via API key scopes. Each tool requires specific scopes: - -| Scope | Tools | -| :-------------------- | :------------------------------------------------------------------- | -| `read:health` | get_health, get_provider_metrics | -| `read:combos` | list_combos, get_combo_metrics | -| `write:combos` | switch_combo | -| `read:quota` | check_quota | -| `write:route` | route_request, simulate_route, test_combo | -| `read:usage` | cost_report, get_session_snapshot, explain_route | -| `write:config` | set_budget_guard, set_resilience_profile | -| `read:models` | list_models_catalog, best_combo_for_task | -| `read:cache` | cache_stats | -| `write:cache` | cache_flush | -| `read:compression` | compression_status, list_compression_combos, compression_combo_stats | -| `write:compression` | compression_configure, set_compression_engine | -| `execute:completions` | route_request, test_combo | - -## Audit Logging - -Every tool call is logged to `mcp_tool_audit` with: - -- Tool name, arguments, result -- Duration (ms), success/failure -- API key hash, timestamp - -## Files - -| File | Purpose | -| :------------------------------------------- | :------------------------------------------------ | -| `open-sse/mcp-server/server.ts` | MCP server creation and scoped tool registrations | -| `open-sse/mcp-server/transport.ts` | Stdio + HTTP transport | -| `open-sse/mcp-server/auth.ts` | API key + scope validation | -| `open-sse/mcp-server/audit.ts` | Tool call audit logging | -| `open-sse/mcp-server/tools/advancedTools.ts` | 8 advanced tool handlers | diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000000..35218d9ccc --- /dev/null +++ b/docs/README.md @@ -0,0 +1,117 @@ +--- +title: "OmniRoute Documentation" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# OmniRoute Documentation + +Navigable index of the OmniRoute documentation set. Topics are grouped by intent so you can find what you need quickly. + +> Looking for the project overview, install steps, or release notes? See the root [README.md](../README.md), [CHANGELOG.md](../CHANGELOG.md), and [CONTRIBUTING.md](../CONTRIBUTING.md). + +--- + +## architecture/ + +How the system is put together — read these to understand the runtime, code layout, and resilience model. + +- [ARCHITECTURE.md](architecture/ARCHITECTURE.md) — high-level system architecture (request pipeline, layers, modules). +- [CODEBASE_DOCUMENTATION.md](architecture/CODEBASE_DOCUMENTATION.md) — engineering reference for the codebase. +- [REPOSITORY_MAP.md](architecture/REPOSITORY_MAP.md) — directory-by-directory navigation guide. +- [AUTHZ_GUIDE.md](architecture/AUTHZ_GUIDE.md) — authorization pipeline (route classifier + policy engine). +- [RESILIENCE_GUIDE.md](architecture/RESILIENCE_GUIDE.md) — provider circuit breaker, connection cooldown, and model lockout. + +## guides/ + +Task-focused walkthroughs for operators and end users. + +- [SETUP_GUIDE.md](guides/SETUP_GUIDE.md) — first-time setup of OmniRoute. +- [USER_GUIDE.md](guides/USER_GUIDE.md) — daily usage of the dashboard and API. +- [DOCKER_GUIDE.md](guides/DOCKER_GUIDE.md) — running OmniRoute under Docker. +- [ELECTRON_GUIDE.md](guides/ELECTRON_GUIDE.md) — desktop (Electron) builds. +- [TERMUX_GUIDE.md](guides/TERMUX_GUIDE.md) — running on Android via Termux. +- [PWA_GUIDE.md](guides/PWA_GUIDE.md) — installing the dashboard as a PWA. +- [TROUBLESHOOTING.md](guides/TROUBLESHOOTING.md) — common issues and fixes. +- [UNINSTALL.md](guides/UNINSTALL.md) — clean removal steps. +- [I18N.md](guides/I18N.md) — translation and locale workflow. +- [FEATURES.md](guides/FEATURES.md) — dashboard feature gallery. + +## reference/ + +Lookup material — API surface, environment variables, CLI flags, provider catalog. + +- [API_REFERENCE.md](reference/API_REFERENCE.md) — REST API endpoints and shapes. +- [PROVIDER_REFERENCE.md](reference/PROVIDER_REFERENCE.md) — auto-generated provider catalog. +- [openapi.yaml](reference/openapi.yaml) — OpenAPI 3.1 spec for the public API. +- [ENVIRONMENT.md](reference/ENVIRONMENT.md) — environment variables reference. +- [CLI-TOOLS.md](reference/CLI-TOOLS.md) — bundled CLI commands. +- [FREE_TIERS.md](reference/FREE_TIERS.md) — free-tier LLM provider directory. + +## frameworks/ + +Pluggable subsystems exposed to clients, agents, and operators. + +- [MCP-SERVER.md](frameworks/MCP-SERVER.md) — Model Context Protocol server. +- [A2A-SERVER.md](frameworks/A2A-SERVER.md) — Agent-to-Agent (A2A) JSON-RPC server. +- [AGENT_PROTOCOLS_GUIDE.md](frameworks/AGENT_PROTOCOLS_GUIDE.md) — A2A / ACP / Cloud agent overview. +- [CLOUD_AGENT.md](frameworks/CLOUD_AGENT.md) — cloud agent runtime and providers. +- [SKILLS.md](frameworks/SKILLS.md) — Skills framework (sandboxed extension). +- [MEMORY.md](frameworks/MEMORY.md) — persistent memory (FTS5 + Qdrant). +- [WEBHOOKS.md](frameworks/WEBHOOKS.md) — webhook events and dispatch. +- [EVALS.md](frameworks/EVALS.md) — eval suites. + +## routing/ + +Combo routing, scoring, and replay. + +- [AUTO-COMBO.md](routing/AUTO-COMBO.md) — Auto-Combo (9-factor scoring, 14 strategies). +- [REASONING_REPLAY.md](routing/REASONING_REPLAY.md) — reasoning replay flow. + +## security/ + +Guardrails, compliance, and stealth. + +- [GUARDRAILS.md](security/GUARDRAILS.md) — PII, prompt injection, vision guardrails. +- [COMPLIANCE.md](security/COMPLIANCE.md) — audit trails and compliance. +- [STEALTH_GUIDE.md](security/STEALTH_GUIDE.md) — TLS / fingerprint stealth. + +## compression/ + +Prompt compression engines, rules, and language packs. + +- [COMPRESSION_GUIDE.md](compression/COMPRESSION_GUIDE.md) — top-level compression overview. +- [COMPRESSION_ENGINES.md](compression/COMPRESSION_ENGINES.md) — available compression engines. +- [COMPRESSION_RULES_FORMAT.md](compression/COMPRESSION_RULES_FORMAT.md) — rule file format. +- [COMPRESSION_LANGUAGE_PACKS.md](compression/COMPRESSION_LANGUAGE_PACKS.md) — language packs. +- [RTK_COMPRESSION.md](compression/RTK_COMPRESSION.md) — RTK engine deep dive. + +## ops/ + +Release, deployment, proxies, tunnels, coverage. + +- [RELEASE_CHECKLIST.md](ops/RELEASE_CHECKLIST.md) — release flow checklist. +- [COVERAGE_PLAN.md](ops/COVERAGE_PLAN.md) — test coverage plan. +- [FLY_IO_DEPLOYMENT_GUIDE.md](ops/FLY_IO_DEPLOYMENT_GUIDE.md) — Fly.io deployment. +- [VM_DEPLOYMENT_GUIDE.md](ops/VM_DEPLOYMENT_GUIDE.md) — generic VM deployment. +- [PROXY_GUIDE.md](ops/PROXY_GUIDE.md) — upstream proxy configuration. +- [TUNNELS_GUIDE.md](ops/TUNNELS_GUIDE.md) — Cloudflare tunnel and friends. + +## diagrams/ + +Mermaid sources and exported SVG/PNG diagrams referenced from the docs above. Populated incrementally — see [diagrams/README.md](diagrams/README.md). + +## i18n/ + +Translated mirrors of the documentation in 40 locales. See [i18n/README.md](i18n/README.md) for the supported language list. + +## screenshots/ + +Static screenshots used by the dashboard and the README. Not part of the doc body. + +--- + +## Auto-generated artifacts + +- [reference/PROVIDER_REFERENCE.md](reference/PROVIDER_REFERENCE.md) is generated by `scripts/gen-provider-reference.ts` from `src/shared/constants/providers.ts`. Do not edit by hand. +- The dashboard sidebar (`/docs` UI) is generated by `scripts/generate-docs-index.mjs`, which walks the subfolders above. diff --git a/docs/RELEASE_CHECKLIST.md b/docs/RELEASE_CHECKLIST.md deleted file mode 100644 index cc39b5a07a..0000000000 --- a/docs/RELEASE_CHECKLIST.md +++ /dev/null @@ -1,40 +0,0 @@ -# Release Checklist - -Use this checklist before tagging or publishing a new OmniRoute release. - -## Version and Changelog - -1. Bump `package.json` version (`x.y.z`) in the release branch. -2. Move release notes from `## [Unreleased]` in `CHANGELOG.md` to a dated section: - - `## [x.y.z] — YYYY-MM-DD` -3. Keep `## [Unreleased]` as the first changelog section for upcoming work. -4. Ensure the latest semver section in `CHANGELOG.md` equals `package.json` version. - -## API Docs - -1. Update `docs/openapi.yaml`: - - `info.version` must equal `package.json` version. -2. Validate endpoint examples if API contracts changed. - -## Runtime Docs - -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. -3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - - `>=20.20.2 <21`, `>=22.22.2 <23`, or `>=24.0.0 <25` - - `npm run check:node-runtime` -4. Validate the npm publish artifact after building the standalone package: - - `npm run build:cli` - - `npm run check:pack-artifact` - - confirm no `app.__qa_backup`, `scripts/scratch`, `package-lock.json`, or other local residue -5. Update localized docs if source docs changed significantly. - -## Automated Check - -Run the sync guard locally before opening PR: - -```bash -npm run check:docs-sync -``` - -CI also runs this check in `.github/workflows/ci.yml` (lint job). diff --git a/docs/RESILIENCE_GUIDE.md b/docs/RESILIENCE_GUIDE.md deleted file mode 100644 index 6c36add7ec..0000000000 --- a/docs/RESILIENCE_GUIDE.md +++ /dev/null @@ -1,145 +0,0 @@ -# 🛡️ Resilience Guide — OmniRoute - -> How OmniRoute keeps your AI coding workflow running when providers fail. - -## Overview - -OmniRoute implements a multi-layered resilience system that ensures zero downtime: - -``` -Client Request - → Rate Limit Check (per-IP, per-connection) - → Combo Routing (13 strategies) - → Connection Selection (P2C, round-robin, etc.) - → Request Queue & Pacing - → Execute (provider-specific executor) - → On Failure: - → Connection Cooldown (exponential backoff) - → Circuit Breaker (provider-level) - → Wait For Cooldown (auto-retry) - → Next Combo Target (fallback chain) - → Response -``` - ---- - -## Request Queue & Pacing - -Per-connection request buckets smooth bursts before they hit upstream rate caps. - -Configure in `Dashboard → Settings → Resilience`: - -| Setting | Default | Description | -| --------------- | ------- | ------------------------------------ | -| Queue Size | `10` | Max queued requests per connection | -| Pacing Interval | `0ms` | Minimum gap between requests | -| Max Concurrent | `5` | Simultaneous requests per connection | - ---- - -## Connection Cooldown - -A single connection cools down after retryable failures. Features: - -- **Exponential Backoff** — progressively longer cooldowns after each failure -- **`Retry-After` Header Support** — respects upstream hints -- **Configurable Base/Max** — tune cooldown duration per use case -- **Auto-Recovery** — connection automatically becomes available after cooldown expires - ---- - -## Circuit Breaker - -Provider-level protection against cascading failures: - -1. **Connection-scoped `429` rate limits** stay in Connection Cooldown (don't trip the breaker) -2. **Provider-wide transient errors** (5xx, network timeouts) increment the failure counter -3. **Breaker trips** only after fallback is exhausted AND the provider still fails -4. **Recovery** — breaker automatically moves to half-open state after timeout, tests with probe request - -Configure thresholds in `Dashboard → Settings → Resilience`. - ---- - -## Wait For Cooldown - -Instead of immediately failing when all connections are in cooldown, OmniRoute can wait for the earliest connection to expire and retry: - -- **Automatic** — server waits for the earliest cooldown to expire -- **Transparent** — client sees a slightly delayed response instead of an error -- **Configurable** — enable/disable per combo or globally - ---- - -## Anti-Thundering Herd - -When multiple concurrent requests hit a failing provider simultaneously: - -- **Mutex Protection** — only one retry attempt at a time per connection -- **Semaphore** — limits concurrent retry storms across connections -- **Deduplication** — identical requests within 5s window are deduplicated - ---- - -## Combo Fallback Chains - -The primary resilience mechanism. Configure in `Dashboard → Combos`: - -```txt -Combo: "always-on" - 1. cc/claude-opus-4-7 ← Primary (subscription) - 2. cx/gpt-5.2-codex ← Secondary (subscription) - 3. glm/glm-4.7 ← Cheap backup ($0.5/1M) - 4. if/kimi-k2-thinking ← Free fallback (unlimited) -``` - -When provider #1 fails (quota, rate, or health), OmniRoute automatically routes to #2, then #3, then #4 — with zero manual intervention. - -### 13 Routing Strategies - -| Strategy | Description | -| ------------------- | ---------------------------------- | -| `priority` | First available in order | -| `weighted` | Weighted distribution | -| `fill-first` | Fill primary before moving | -| `round-robin` | Rotate through all targets | -| `p2c` | Power-of-two choices (quota-aware) | -| `random` | Random selection | -| `least-used` | Least recently used | -| `cost-optimized` | Cheapest available | -| `strict-random` | True random (no tracking) | -| `auto` | OmniRoute selects based on context | -| `lkgp` | Last Known Good Provider | -| `context-optimized` | Best for current context window | -| `context-relay` | Session handoff during rotation | - ---- - -## TLS Fingerprint Spoofing - -OmniRoute makes proxied traffic look like legitimate browser/CLI requests: - -- **Browser-like TLS** via `wreq-js` — prevents bot detection -- **CLI Fingerprint Matching** — reorders headers and body fields to match native CLI binary signatures (Claude Code, Codex, etc.) -- **Proxy IP Preservation** — stealth features work on top of proxy IP masking - ---- - -## Health Dashboard - -Monitor all resilience components in real-time at `Dashboard → Health`: - -- **Uptime** — server uptime and last restart -- **Provider Breaker States** — open/closed/half-open per provider -- **Connection Cooldowns** — active cooldowns with expiry times -- **Cache Stats** — signature + semantic cache hit rates -- **Lockouts** — API key lockouts and IP bans -- **Latency** — p50/p95/p99 percentiles - ---- - -## See Also - -- [Architecture Guide](ARCHITECTURE.md) — System architecture and internals -- [User Guide](USER_GUIDE.md) — Providers, combos, CLI integration -- [Auto-Combo Engine](AUTO-COMBO.md) — 6-factor scoring, mode packs diff --git a/docs/RFC-AUTO-ASSESSMENT.md b/docs/RFC-AUTO-ASSESSMENT.md deleted file mode 100644 index 604fb9501d..0000000000 --- a/docs/RFC-AUTO-ASSESSMENT.md +++ /dev/null @@ -1,518 +0,0 @@ -# RFC: Auto-Assessment & Self-Healing Combo Engine - -## Summary - -Omniroute's combo system currently requires manual configuration: users must know which providers and models are actually working, then manually wire them into combo chains. When providers fail (rate limits, auth errors, model deprecation), combos silently degrade — routing to dead endpoints that timeout or return errors. There is no automated way to: - -1. **Discover** which provider/model pairs actually respond to chat completions -2. **Categorize** models by capability (coding, reasoning, vision, speed, etc.) -3. **Self-heal** combos by removing dead models and promoting working ones -4. **Auto-generate** sensible combo configurations from available providers - -This proposes an **Auto-Assessment Engine** that continuously tests, categorizes, and self-heals combo configurations — making omniroute truly "plug and play" for non-technical users. - ---- - -## Problem Statement - -### What we encountered (real production incident) - -While configuring omniroute for production use, we discovered: - -- **44 combos had models from providers that returned "`Invalid model`" errors** — `kiro/claude-opus-4.6`, `kiro/claude-sonnet-4.6`, `gh/claude-sonnet-4.5` all fail with 400/404 -- **No automated way to know which models actually work** — the `/v1/models` endpoint lists 1,236 models, but `/v1/chat/completions` fails for most of them -- **Weight-based routing sends traffic to dead models** — a model weighted at 30% that returns errors wastes 30% of requests -- **Manual diagnosis took hours** — we had to curl each model individually, categorize results, then update the SQLite DB -- **Provider `test_status` field exists but isn't used for routing** — `provider_connections` has `test_status` (active/banned/expired/credits_exhausted) but the combo resolver ignores it - -### Current flow (broken) - -``` -User adds providers → Manually creates combos → Manually assigns models → ??? - ↓ - Some models work, - some return errors, - some timeout... - BUT routing doesn't know! -``` - -### Proposed flow (self-healing) - -``` -User adds providers → Auto-Assessment runs → Working models discovered - ↓ - Capability categorization - ↓ - Combos auto-generated/updated with working models - ↓ - Continuous health monitoring keeps combos healthy -``` - ---- - -## Architecture - -### New Components - -``` -┌────────────────────────────────────────────────────────┐ -│ Auto-Assessment Engine │ -├────────────────────────────────────────────────────────┤ -│ │ -│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ -│ │ Assessor │ │ Categorizer │ │ Self-Healer │ │ -│ │ │ │ │ │ │ │ -│ │ • Probe all │ │ • Classify │ │ • Remove │ │ -│ │ models │ │ models by │ │ dead │ │ -│ │ • Measure │ │ capability │ │ models │ │ -│ │ latency │ │ • Assign │ │ • Promote │ │ -│ │ • Track │ │ tier tags │ │ working │ │ -│ │ success │ │ • Build │ │ models │ │ -│ │ rates │ │ fitness │ │ • Re-weight │ │ -│ │ │ │ scores │ │ combos │ │ -│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ -│ │ │ │ │ -│ ▼ ▼ ▼ │ -│ ┌──────────────────────────────────────────────────┐ │ -│ │ Assessment Database │ │ -│ │ │ │ -│ │ model_assessments: │ │ -│ │ model_id | provider | status | latency_p50 │ │ -│ │ latency_p95 | success_rate | last_tested │ │ -│ │ error_type | tier | categories[] | fitness │ │ -│ │ context_window | output_tokens | vision | tbc │ │ -│ │ │ │ -│ │ assessment_runs: │ │ -│ │ run_id | started_at | completed_at │ │ -│ │ models_tested | models_passed | models_failed │ │ -│ │ │ │ -│ │ combo_health: │ │ -│ │ combo_id | healthy_models | dead_models │ │ -│ │ last_auto_fix | auto_fix_count │ │ -│ └──────────────────────────────────────────────────┘ │ -│ │ -└──────────────────────────────┬─────────────────────────┘ - │ - ▼ - Existing combo system (weighted-fallback, priority, etc.) - + Enhanced comboResolver that skips dead models -``` - ---- - -## Detailed Design - -### 1. Assessor — `src/domain/assessor.ts` - -**Purpose**: Probe every provider/model pair with a lightweight chat completion to determine if it works and measure performance. - -```typescript -interface ModelAssessment { - modelId: string; - providerId: string; - status: "working" | "broken" | "rate_limited" | "timeout" | "auth_error" | "unknown"; - - // Performance metrics - latencyP50: number; // milliseconds - latencyP95: number; // milliseconds - successRate: number; // 0..1 over last N probes - - // Capability detection - supportsVision: boolean; - supportsToolCall: boolean; - supportsStreaming: boolean; - maxContextWindow: number; - maxOutputTokens: number; - categories: ModelCategory[]; // 'coding' | 'reasoning' | 'chat' | 'fast' | 'vision' | 'reasoning_deep' - tier: "premium" | "balanced" | "fast" | "free"; - - // Metadata - lastTested: string; // ISO timestamp - lastError: string | null; - consecutiveFails: number; - probeCount: number; -} - -type ModelCategory = - | "coding" // Good at code generation, debugging, refactoring - | "reasoning" // Strong logical reasoning, math, analysis - | "reasoning_deep" // Extended thinking, complex multi-step reasoning - | "chat" // Good conversational ability - | "fast" // Sub-2s response time - | "vision" // Image input support - | "tool_call" // Function/tool calling support - | "structured_output"; // JSON mode / structured output -``` - -**Assessment Probes** — three tiers of testing: - -| Probe | Prompt | Max Tokens | Purpose | -| ------------ | ------------------------------------------ | ---------- | ---------------------------------------------- | -| **Quick** | `"ok"` | 1 | Does it respond at all? | -| **Standard** | `"Write a function that adds two numbers"` | 50 | Coding, tool call, structured output detection | -| **Deep** | Vision input + multi-turn | 100 | Vision, streaming, context window | - -**Scheduling**: - -- Full assessment on startup (or first provider addition) -- Quick probe every 5 minutes for working models -- Standard probe every 30 minutes -- Deep probe every 6 hours (or on demand) -- Immediate probe after any model returns an error -- Exponential backoff: 1 min → 5 min → 15 min → 30 min for consistently failing models - -### 2. Categorizer — `src/domain/categorizer.ts` - -**Purpose**: Classify each working model into capability categories and assign fitness scores per category. - -**Category Detection Logic**: - -```typescript -function categorizeModel(assessment: ModelAssessment): ModelCategory[] { - const categories: ModelCategory[] = []; - - // Speed classification - if (assessment.latencyP50 < 2000) categories.push("fast"); - - // Capability from probe responses - if (assessment.supportsToolCall) categories.push("tool_call"); - if (assessment.supportsVision) categories.push("vision"); - if (assessment.supportsStreaming) categories.push("structured_output"); // if supports JSON mode - - // Tier-based reasoning classification - if (assessment.tier === "premium") { - categories.push("reasoning_deep", "coding", "reasoning"); - } else if (assessment.tier === "balanced") { - categories.push("coding", "reasoning"); - } else if (assessment.tier === "fast") { - categories.push("chat"); - } - - return categories; -} -``` - -**Fitness Scores** (0..1 per category): - -| Category | Scoring Formula | -| ---------------- | -------------------------------------------------------------------- | -| `coding` | `0.4 * successRate + 0.3 * (1 - latencyP95/10000) + 0.3 * tierScore` | -| `reasoning` | `0.5 * tierScore + 0.3 * successRate + 0.2 * (1 - latencyP95/15000)` | -| `reasoning_deep` | `0.7 * tierScore + 0.3 * successRate` (only premium tier eligible) | -| `chat` | `0.4 * successRate + 0.4 * (1 - latencyP95/5000) + 0.2 * tierScore` | -| `fast` | `0.6 * (1 - latencyP50/3000) + 0.3 * successRate + 0.1 * costInv` | -| `vision` | `0.5 * successRate + 0.3 * (1 - latencyP95/15000) + 0.2 * tierScore` | - -### 3. Self-Healer — `src/domain/selfHealer.ts` - -**Purpose**: Automatically update combo model lists based on assessment results. - -**Auto-Heal Rules**: - -``` -IF model.status == 'broken' OR model.consecutiveFails >= 3: - REMOVE model from all combos - LOG "Auto-heal: removed {model} from {combo} (status: {status}, fails: {n})" - -IF model.status == 'rate_limited' OR model.status == 'timeout': - REDUCE model weight by 50% (minimum weight: 5) - LOG "Auto-heal: reduced weight of {model} in {combo} (status: {status})" - -IF combo has 0 working models: - FIND best working model for combo's category - ADD to combo with weight 100 - LOG "Auto-heal: emergency added {model} to {combo} (was empty)" - -IF combo has fewer than 3 working models: - FIND additional working models in same category - ADD with proportional weights - LOG "Auto-heal: expanded {combo} with {n} models" - -IF model.status transitions from 'broken' → 'working': - RESTORE original weight (or proportional weight) - LOG "Auto-heal: restored {model} in {combo}" -``` - -**Auto-Generation of Combos**: - -When a new provider is added, or on first startup, auto-generate standard combos: - -```typescript -const AUTO_COMBOS = [ - { name: "auto/best-coding", categories: ["coding"], tier: ["premium", "balanced"] }, - { name: "auto/best-reasoning", categories: ["reasoning_deep"], tier: ["premium"] }, - { name: "auto/best-fast", categories: ["fast"], tier: ["fast", "balanced"] }, - { name: "auto/best-vision", categories: ["vision"], tier: ["premium", "balanced"] }, - { name: "auto/best-chat", categories: ["chat"], tier: ["balanced", "premium"] }, - { name: "auto/coding", categories: ["coding"], tier: ["balanced", "fast", "premium"] }, - { name: "auto/fast", categories: ["fast"], tier: ["fast"] }, - { name: "auto/pro-coding", categories: ["coding"], tier: ["premium"] }, - { name: "auto/pro-reasoning", categories: ["reasoning_deep"], tier: ["premium"] }, - { name: "auto/pro-vision", categories: ["vision"], tier: ["premium"] }, - { name: "auto/pro-chat", categories: ["chat"], tier: ["premium"] }, - { name: "auto/pro-fast", categories: ["fast"], tier: ["fast"] }, -]; -``` - -### 4. Database Schema - -```sql --- New tables for assessment engine - -CREATE TABLE IF NOT EXISTS model_assessments ( - id TEXT PRIMARY KEY, - model_id TEXT NOT NULL, - provider_id TEXT NOT NULL, - status TEXT NOT NULL DEFAULT 'unknown', -- working|broken|rate_limited|timeout|auth_error|unknown - latency_p50 INTEGER, -- milliseconds - latency_p95 INTEGER, -- milliseconds - success_rate REAL DEFAULT 0, -- 0..1 - supports_vision INTEGER DEFAULT 0, - supports_tool_call INTEGER DEFAULT 0, - supports_streaming INTEGER DEFAULT 0, - supports_structured_output INTEGER DEFAULT 0, - max_context_window INTEGER, - max_output_tokens INTEGER, - categories TEXT DEFAULT '[]', -- JSON array of ModelCategory - fitness_scores TEXT DEFAULT '{}', -- JSON object: {category: score} - tier TEXT DEFAULT 'balanced', -- premium|balanced|fast|free - last_tested TEXT, - last_error TEXT, - consecutive_fails INTEGER DEFAULT 0, - probe_count INTEGER DEFAULT 0, - created_at TEXT NOT NULL DEFAULT (datetime('now')), - updated_at TEXT NOT NULL DEFAULT (datetime('now')), - UNIQUE(model_id, provider_id) -); - -CREATE TABLE IF NOT EXISTS assessment_runs ( - id TEXT PRIMARY KEY, - started_at TEXT NOT NULL, - completed_at TEXT, - models_tested INTEGER DEFAULT 0, - models_passed INTEGER DEFAULT 0, - models_failed INTEGER DEFAULT 0, - models_rate_limited INTEGER DEFAULT 0, - duration_ms INTEGER, - trigger TEXT DEFAULT 'scheduled', -- scheduled|on_demand|on_provider_change|on_error - created_at TEXT NOT NULL DEFAULT (datetime('now')) -); - -CREATE TABLE IF NOT EXISTS combo_health ( - combo_id TEXT PRIMARY KEY, - healthy_model_count INTEGER DEFAULT 0, - dead_model_count INTEGER DEFAULT 0, - total_model_count INTEGER DEFAULT 0, - last_auto_fix TEXT, - auto_fix_count INTEGER DEFAULT 0, - health_score REAL DEFAULT 0, -- 0..1, weighted by model health - updated_at TEXT NOT NULL DEFAULT (datetime('now')), - FOREIGN KEY (combo_id) REFERENCES combos(id) -); - -CREATE INDEX IF NOT EXISTS idx_model_assessments_status ON model_assessments(status); -CREATE INDEX IF NOT EXISTS idx_model_assessments_provider ON model_assessments(provider_id); -CREATE INDEX IF NOT EXISTS idx_model_assessments_tier ON model_assessments(tier); -CREATE INDEX IF NOT EXISTS idx_combo_health_health_score ON combo_health(health_score); -``` - -### 5. API Endpoints - -```bash -# Trigger assessment (blocking or background) -POST /api/assess/models - Body: { "scope": "all" | "provider:<id>" | "model:<id>", "tier": "quick" | "standard" | "deep" } - Response: { "run_id": "...", "status": "started" } - -# Get assessment results -GET /api/assess/results - Query: ?status=working|broken|rate_limited&provider=kiro&category=coding - Response: { "models": [...] } - -# Get combo health dashboard -GET /api/assess/combo-health - Response: { "combos": [{ "id": "...", "name": "...", "healthy_models": 5, "dead_models": 2, "health_score": 0.71 }] } - -# Auto-fix all combos -POST /api/assess/auto-fix - Response: { "fixed_combos": 3, "removed_models": ["ollamacloud/glm-5.1", "..."], "added_models": [...] } - -# Auto-generate combos from assessments -POST /api/assess/auto-generate - Response: { "generated_combos": ["auto/best-coding", "..."], "models_per_combo": { "auto/best-coding": 5 } } - -# Get assessment run history -GET /api/assess/runs - Response: { "runs": [...] } -``` - -### 6. Integration with Existing comboResolver - -The existing `comboResolver.ts` already handles `priority`, `weighted`, `round-robin`, `random`, and `least-used` strategies. The enhancement: - -```typescript -// In comboResolver.ts — add health-aware filtering -export function resolveComboModel(combo, context = {}) { - const models = combo.models || []; - if (models.length === 0) { - throw new Error(`Combo "${combo.name}" has no models configured`); - } - - const normalized = models - .map((entry) => ({ - model: getComboStepTarget(entry) || "", - weight: getComboStepWeight(entry) || 1, - })) - .filter((entry) => entry.model); - - // NEW: Filter out models known to be broken/rate_limited - const healthy = normalized.filter((entry) => { - const assessment = getAssessment(entry.model); - if (!assessment) return true; // Unknown → allow (haven't tested yet) - return assessment.status === "working" || assessment.status === "unknown"; - }); - - // If all models are unhealthy, fall back to full list (better to try than to fail) - const pool = healthy.length > 0 ? healthy : normalized; - - const strategy = combo.strategy || "priority"; - // ... existing resolution logic using `pool` instead of `normalized` -} -``` - -### 7. Integration with Existing Auto-Combo Scoring (`open-sse/services/autoCombo/scoring.ts`) - -The existing scoring function already uses 6 factors + tier. The assessment engine enriches these: - -| Existing Factor | Current Source | Enhanced Source | -| ------------------- | ------------------------ | ----------------------------------------- | -| Quota (0.20) | Provider connection data | Same + assessment success_rate | -| Health (0.25) | Circuit breaker state | Same + assessment status (working/broken) | -| CostInv (0.20) | Static cost data | Same + live cost measurement | -| LatencyInv (0.15) | P95 latency from logs | Same + assessment probe latency | -| TaskFit (0.10) | Static fitness table | **NEW: from assessment categories** | -| Stability (0.05) | Latency stddev | Same + assessment consecutive_fails | -| TierPriority (0.05) | Account tier | Same | - -The key enhancement: `taskFit` currently uses a **static** fitness lookup (`taskFitness.ts`). With assessments, we derive fitness from **live probe results** — a model that actually passes coding probes gets a high `coding` fitness, not just because its name contains "coder". - -### 8. Dashboard UI (Future PR) - -The assessment state should be visible in the omniroute dashboard: - -- **Model Health Grid**: table showing each provider/model with colored status indicators -- **Combo Health Summary**: per-combo health score with expandable model details -- **Assessment History**: timeline of assessment runs with pass/fail counts -- **Auto-Fix Log**: history of automatic combo modifications - ---- - -## Migration Path - -### Phase 1: Assessment Engine (This PR) - -- New `model_assessments`, `assessment_runs`, `combo_health` tables -- Assessor service with quick/standard/deep probes -- Categorizer with fitness scoring -- Self-healer with auto-fix rules -- REST API endpoints -- Integration with comboResolver to skip broken models - -### Phase 2: Auto-Generation (Follow-up PR) - -- Auto-generate combos from assessed models -- Smart combo naming and categorization -- Cross-provider fallback chains -- Dashboard UI for assessment results - -### Phase 3: Continuous Learning (Follow-up PR) - -- Feeds assessment results back into auto-combo scoring weights -- Adapts fitness scores based on real request outcomes -- A/B testing across providers to find optimal routing -- Automatic mode pack switching (ship-fast during peak, cost-saver off-peak) - ---- - -## Implementation Files - -| File | Purpose | New/Modified | -| ---------------------------------------- | ---------------------------------------- | ------------ | -| `src/domain/assessor.ts` | Probe engine (quick/standard/deep) | **NEW** | -| `src/domain/categorizer.ts` | Model categorization & fitness | **NEW** | -| `src/domain/selfHealer.ts` | Auto-fix combos, remove dead models | **NEW** | -| `src/domain/comboResolver.ts` | Add health-aware filtering | **MODIFIED** | -| `src/domain/types.ts` | Add ModelAssessment, ModelCategory types | **MODIFIED** | -| `src/lib/db/assessments.ts` | DB access for assessment tables | **NEW** | -| `open-sse/services/autoCombo/scoring.ts` | Use assessment data for taskFit | **MODIFIED** | -| `src/app/api/assess/route.ts` | REST API routes | **NEW** | -| `scripts/assess-models.mjs` | CLI script for on-demand assessment | **NEW** | -| `scripts/migrate-assessments.mjs` | DB migration script | **NEW** | - ---- - -## Testing Plan - -### Unit Tests - -- Assessor probe logic (mock provider responses) -- Categorizer fitness score calculations -- Self-healer rules (remove, reduce, restore, emergency add) -- comboResolver integration (skip broken models) - -### Integration Tests - -- Full assessment cycle: add provider → probe models → categorize → auto-fix combos -- Health-aware routing: broken model skipped, restored model re-included -- Assessment run persistence and recovery - -### Manual Testing (our experience as reference) - -```bash -# Our actual test sequence that should be automated: -# 1. Start omniroute with 406 provider connections (51 providers) -# 2. Discover only 8 models actually work from 2 providers (kiro, ollamacloud) -# 3. Manually update 44 combos with working models only -# 4. Verify all 15 key combos pass end-to-end -# 5. Set up auto-sync cron for model list updates - -# With auto-assessment, this entire process should be: -# 1. Start omniroute -# 2. Run: curl -X POST http://localhost:20128/api/assess/models -d '{"scope":"all"}' -# 3. Wait for assessment to complete -# 4. Run: curl -X POST http://localhost:20128/api/assess/auto-fix -# 5. All combos are now healthy -``` - ---- - -## Success Metrics - -| Metric | Current (Manual) | Target (Auto-Assessment) | -| -------------------------------- | --------------------------------- | ------------------------------- | -| Time to configure working combos | 2-4 hours | < 5 minutes | -| Dead model detection | Manual curl testing | Automatic, continuous | -| Combo health visibility | None | Dashboard + API | -| Provider failure recovery | Manual DB updates | Auto-heal within 5 minutes | -| New provider onboarding | Manual combo editing | Auto-discover + auto-categorize | -| Model deprecation handling | Manual detection (users complain) | Proactive removal + alerting | - ---- - -## Backwards Compatibility - -- All new tables are additive — no schema changes to existing tables -- comboResolver filtering is opt-in via config flag (default: enabled) -- Existing combo configurations are preserved — self-healer only modifies them, doesn't replace -- Assessment can be disabled with `OMNIRoute_DISABLE_ASSESSMENT=1` env var -- All API endpoints are new — no existing endpoints changed - ---- - -## Open Questions - -1. **Probe cost**: Who pays for assessment probes? Should we limit to free-tier models or use a separate assessment budget? -2. **Assessment frequency**: How often should deep probes run? Current proposal: 6h, but some users may want more/less frequent. -3. **Auto-fix aggression**: Should self-healer remove models immediately on first failure, or wait for N consecutive failures? -4. **Cross-provider model equivalence**: Should `kiro/claude-sonnet-4.5` and `gh/claude-sonnet-4.5` be treated as the same model for combo purposes? -5. **Assessment during startup**: Should assessment block startup or run in background? diff --git a/docs/ARCHITECTURE.md b/docs/architecture/ARCHITECTURE.md similarity index 57% rename from docs/ARCHITECTURE.md rename to docs/architecture/ARCHITECTURE.md index cd08c672d7..17ea85c749 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/architecture/ARCHITECTURE.md @@ -1,8 +1,14 @@ +--- +title: "OmniRoute Architecture" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute Architecture -🌐 **Languages:** 🇺🇸 [English](ARCHITECTURE.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/ARCHITECTURE.md) | 🇪🇸 [Español](i18n/es/ARCHITECTURE.md) | 🇫🇷 [Français](i18n/fr/ARCHITECTURE.md) | 🇮🇹 [Italiano](i18n/it/ARCHITECTURE.md) | 🇷🇺 [Русский](i18n/ru/ARCHITECTURE.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/ARCHITECTURE.md) | 🇩🇪 [Deutsch](i18n/de/ARCHITECTURE.md) | 🇮🇳 [हिन्दी](i18n/in/ARCHITECTURE.md) | 🇹🇭 [ไทย](i18n/th/ARCHITECTURE.md) | 🇺🇦 [Українська](i18n/uk-UA/ARCHITECTURE.md) | 🇸🇦 [العربية](i18n/ar/ARCHITECTURE.md) | 🇯🇵 [日本語](i18n/ja/ARCHITECTURE.md) | 🇻🇳 [Tiếng Việt](i18n/vi/ARCHITECTURE.md) | 🇧🇬 [Български](i18n/bg/ARCHITECTURE.md) | 🇩🇰 [Dansk](i18n/da/ARCHITECTURE.md) | 🇫🇮 [Suomi](i18n/fi/ARCHITECTURE.md) | 🇮🇱 [עברית](i18n/he/ARCHITECTURE.md) | 🇭🇺 [Magyar](i18n/hu/ARCHITECTURE.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/ARCHITECTURE.md) | 🇰🇷 [한국어](i18n/ko/ARCHITECTURE.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/ARCHITECTURE.md) | 🇳🇱 [Nederlands](i18n/nl/ARCHITECTURE.md) | 🇳🇴 [Norsk](i18n/no/ARCHITECTURE.md) | 🇵🇹 [Português (Portugal)](i18n/pt/ARCHITECTURE.md) | 🇷🇴 [Română](i18n/ro/ARCHITECTURE.md) | 🇵🇱 [Polski](i18n/pl/ARCHITECTURE.md) | 🇸🇰 [Slovenčina](i18n/sk/ARCHITECTURE.md) | 🇸🇪 [Svenska](i18n/sv/ARCHITECTURE.md) | 🇵🇭 [Filipino](i18n/phi/ARCHITECTURE.md) | 🇨🇿 [Čeština](i18n/cs/ARCHITECTURE.md) +🌐 **Languages:** 🇺🇸 [English](./ARCHITECTURE.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/architecture/ARCHITECTURE.md) | 🇪🇸 [Español](../i18n/es/docs/architecture/ARCHITECTURE.md) | 🇫🇷 [Français](../i18n/fr/docs/architecture/ARCHITECTURE.md) | 🇮🇹 [Italiano](../i18n/it/docs/architecture/ARCHITECTURE.md) | 🇷🇺 [Русский](../i18n/ru/docs/architecture/ARCHITECTURE.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/architecture/ARCHITECTURE.md) | 🇩🇪 [Deutsch](../i18n/de/docs/architecture/ARCHITECTURE.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/architecture/ARCHITECTURE.md) | 🇹🇭 [ไทย](../i18n/th/docs/architecture/ARCHITECTURE.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/architecture/ARCHITECTURE.md) | 🇸🇦 [العربية](../i18n/ar/docs/architecture/ARCHITECTURE.md) | 🇯🇵 [日本語](../i18n/ja/docs/architecture/ARCHITECTURE.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/architecture/ARCHITECTURE.md) | 🇧🇬 [Български](../i18n/bg/docs/architecture/ARCHITECTURE.md) | 🇩🇰 [Dansk](../i18n/da/docs/architecture/ARCHITECTURE.md) | 🇫🇮 [Suomi](../i18n/fi/docs/architecture/ARCHITECTURE.md) | 🇮🇱 [עברית](../i18n/he/docs/architecture/ARCHITECTURE.md) | 🇭🇺 [Magyar](../i18n/hu/docs/architecture/ARCHITECTURE.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/architecture/ARCHITECTURE.md) | 🇰🇷 [한국어](../i18n/ko/docs/architecture/ARCHITECTURE.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/architecture/ARCHITECTURE.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/architecture/ARCHITECTURE.md) | 🇳🇴 [Norsk](../i18n/no/docs/architecture/ARCHITECTURE.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/architecture/ARCHITECTURE.md) | 🇷🇴 [Română](../i18n/ro/docs/architecture/ARCHITECTURE.md) | 🇵🇱 [Polski](../i18n/pl/docs/architecture/ARCHITECTURE.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/architecture/ARCHITECTURE.md) | 🇸🇪 [Svenska](../i18n/sv/docs/architecture/ARCHITECTURE.md) | 🇵🇭 [Filipino](../i18n/phi/docs/architecture/ARCHITECTURE.md) | 🇨🇿 [Čeština](../i18n/cs/docs/architecture/ARCHITECTURE.md) -_Last updated: 2026-05-02_ +_Last updated: 2026-05-13_ ## Executive Summary @@ -11,13 +17,13 @@ It provides a single OpenAI-compatible endpoint (`/v1/*`) and routes traffic acr Core capabilities: -- OpenAI-compatible API surface for CLI/tools (160+ providers, 16 executors) +- OpenAI-compatible API surface for CLI/tools (177 providers, 31 executors) - Request/response translation across provider formats - Model combo fallback (multi-model sequence) - Structured combo steps (`provider + model + connection`) with runtime ordering by `compositeTiers` - Account-level fallback (multi-account per provider) - Quota preflight and quota-aware P2C account selection in the main chat path -- OAuth + API-key provider connection management (13 OAuth modules) +- OAuth + API-key provider connection management (14 OAuth modules) - Embedding generation via `/v1/embeddings` (6 providers, 9 models) - Image generation via `/v1/images/generations` (10+ providers, 20+ models) - Audio transcription via `/v1/audio/transcriptions` (7 providers) @@ -60,7 +66,7 @@ Core capabilities: - Prompt injection guard middleware - Prompt compression pipeline with Caveman, RTK, stacked pipelines, compression combos, language packs, and analytics - ACP (Agent Communication Protocol) registry -- Modular OAuth providers (13 individual modules under `src/lib/oauth/providers/`) +- Modular OAuth providers (14 individual modules under `src/lib/oauth/providers/`) - Uninstall/full-uninstall scripts - OAuth environment repair action - WebSocket bridge for OpenAI-compatible WS clients (`/v1/ws`) @@ -78,6 +84,21 @@ Primary runtime model: - Next.js app routes under `src/app/api/*` implement both dashboard APIs and compatibility APIs - A shared SSE/routing core in `src/sse/*` + `open-sse/*` handles provider execution, translation, streaming, fallback, and usage +## Reference Diagrams + +Canonical, version-controlled Mermaid sources for the v3.8.0 platform live in +[`docs/diagrams/`](../diagrams/README.md). Two are reproduced below for orientation; +the rest are linked from their domain-specific guides. + +![Request pipeline (/v1/chat/completions)](../diagrams/exported/request-pipeline.svg) + +> Source: [diagrams/request-pipeline.mmd](../diagrams/request-pipeline.mmd) + +![3-layer resilience model](../diagrams/exported/resilience-3layers.svg) + +> Source: [diagrams/resilience-3layers.mmd](../diagrams/resilience-3layers.mmd) — also linked from +> [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) and the `CLAUDE.md` resilience reference. + ## Scope and Boundaries ### In Scope @@ -103,11 +124,22 @@ Main pages under `src/app/(dashboard)/dashboard/`: - `/dashboard/endpoint` — endpoint proxy + MCP + A2A + API endpoint tabs - `/dashboard/providers` — provider connections and credentials - `/dashboard/combos` — combo strategies, templates, step-based builder, model routing rules, manual persisted ordering +- `/dashboard/auto-combo` — Auto Combo Engine: scoring weights, mode packs, virtual factory presets, telemetry - `/dashboard/costs` — cost aggregation and pricing visibility - `/dashboard/analytics` — usage analytics, evaluations, combo target health - `/dashboard/limits` — quota/rate controls - `/dashboard/cli-tools` — CLI onboarding, runtime detection, config generation - `/dashboard/agents` — detected ACP agents + custom agent registration +- `/dashboard/cloud-agents` — cloud-hosted agent tasks (Codex Cloud, Devin, Jules) and task lifecycle +- `/dashboard/skills` — A2A skill registry, sandbox execution, built-in skill catalog +- `/dashboard/memory` — persistent conversational memory inspection and retrieval +- `/dashboard/webhooks` — outbound webhook subscriptions, secret rotation, retry stats +- `/dashboard/batch` — batch job submission and progress +- `/dashboard/cache` — read-through and reasoning cache statistics, eviction controls +- `/dashboard/playground` — interactive chat playground against any configured combo/model +- `/dashboard/changelog` — in-app changelog viewer (renders `CHANGELOG.md`) +- `/dashboard/system` — runtime diagnostics, version info, environment validation surface +- `/dashboard/onboarding` — first-run setup wizard for new installations - `/dashboard/media` — image/video/music playground - `/dashboard/search-tools` — search provider testing and history - `/dashboard/health` — uptime, circuit breakers, rate limits, quota-monitored sessions @@ -116,6 +148,10 @@ Main pages under `src/app/(dashboard)/dashboard/`: - `/dashboard/context/caveman` — Caveman compression rules, language packs, preview, and output mode - `/dashboard/context/rtk` — RTK command-output filters, preview, and runtime safety settings - `/dashboard/context/combos` — named compression pipelines assigned to routing combos +- `/dashboard/translator` — translator inspection and request format conversion preview +- `/dashboard/audit` — compliance audit log browser with pagination and structured metadata +- `/dashboard/usage` — per-request usage browser tied to `usage_history` +- `/dashboard/compression` — compression analytics, statistics, and pipeline assignment - `/dashboard/api-manager` — API key lifecycle and model permissions ## High-Level System Context @@ -285,12 +321,172 @@ Domain layer modules: - Eval runner: `src/lib/domain/evalRunner.ts` - Domain state persistence: `src/lib/db/domainState.ts` — SQLite CRUD for fallback chains, budgets, cost history, lockout state, circuit breakers -OAuth provider modules (13 individual files under `src/lib/oauth/providers/`): +OAuth provider modules (14 individual files under `src/lib/oauth/providers/`): - Registry index: `src/lib/oauth/providers/index.ts` -- Individual providers: `claude.ts`, `codex.ts`, `gemini.ts`, `antigravity.ts`, `qoder.ts`, `qwen.ts`, `kimi-coding.ts`, `github.ts`, `kiro.ts`, `cursor.ts`, `kilocode.ts`, `cline.ts` +- Individual providers: `claude.ts`, `codex.ts`, `gemini.ts`, `antigravity.ts`, `qoder.ts`, `qwen.ts`, `kimi-coding.ts`, `github.ts`, `kiro.ts`, `cursor.ts`, `kilocode.ts`, `cline.ts`, `windsurf.ts`, `gitlab-duo.ts` - Thin wrapper: `src/lib/oauth/providers.ts` — re-exports from individual modules +## Major Subsystems (v3.8.0) + +### A. Auto Combo Engine + +Auto Combo dynamically scores and picks routing targets at request time, rather than +relying on a static combo definition. It powers the `auto/*` model prefix family. + +- Engine entry: `open-sse/services/autoCombo/` (`autoComboEngine.ts`, + `scoringEngine.ts`, `virtualFactory.ts`, `modePacks.ts`) +- Resolver: `src/domain/comboResolver.ts` (auto-detection of `auto/` prefix) +- Dashboard: `/dashboard/auto-combo` +- Telemetry: `auto_combo_decisions` SQLite table + +Key capabilities: + +- **14 routing strategies** (priority, weighted, fill-first, round-robin, P2C, random, + least-used, cost-optimized, strict-random, **auto**, lkgp, context-optimized, + context-relay, plus a fallback path) — auto is the headline addition in v3.8.0. +- **9-factor scoring**: cost, latency p95, success rate, quota headroom, lockout + proximity, breaker state, recent failures, model availability, and tag affinity. +- **Virtual factory** materializes ephemeral combos when no matching named combo + exists, sourcing candidates from healthy active provider connections. +- **Auto prefixes**: `auto/coding`, `auto/cheap`, `auto/fast`, `auto/offline`, + `auto/smart`, `auto/lkgp` — each backed by a tuned weight profile. +- **4 mode packs**: coding, fast, cheap, smart — shipped as preset weight + configurations callable from the dashboard. + +For full algorithmic detail (factor formulas, weight tuning), see +[`docs/routing/AUTO-COMBO.md`](../routing/AUTO-COMBO.md). + +### B. Cloud Agents + +Cloud Agents wraps third-party hosted code-agent platforms (Codex Cloud, Devin, +Jules) behind a uniform DB-backed task lifecycle. All task creation/inspection +endpoints require management authentication. + +- Module root: `src/lib/cloudAgent/` (`baseAgent.ts`, `registry.ts`, `api.ts`, + `types.ts`, `db.ts`, plus per-agent subdirectories under `agents/`) +- Per-agent implementations: `agents/codex/`, `agents/devin/`, `agents/jules/` +- Public endpoints: `/api/v1/agents/tasks/*` (list/create/get/cancel) +- Management endpoints: `/api/cloud/*` (provisioning, status, batch) +- Dashboard: `/dashboard/cloud-agents` +- Storage: `cloud_agent_tasks` table + +For per-agent provisioning and OAuth specifics, see +[`docs/frameworks/CLOUD_AGENT.md`](../frameworks/CLOUD_AGENT.md). + +### C. Guardrails + +The guardrails module is a hot-reloadable middleware layer that inspects requests +and responses for PII, prompt injection, and unsafe vision content. Violations +short-circuit the request with HTTP **503** plus a structured error code, allowing +downstream callers to retry or branch. + +- Module root: `src/lib/guardrails/` (`base.ts`, `registry.ts`, `piiMasker.ts`, + `promptInjection.ts`, `visionBridge.ts`, `visionBridgeHelpers.ts`) +- Hot reload: registry watches for config changes and rebuilds the chain in place +- Wire-in points: chat handler entry, image generation handler, response sanitizer +- HTTP contract: violations surface as `503` with `error.code = "GUARDRAIL_VIOLATION"` + +For ruleset authoring and threshold tuning, see +[`docs/security/GUARDRAILS.md`](../security/GUARDRAILS.md). + +### D. Domain Layer + +The `src/domain/` namespace centralizes policy decisions so route handlers do not +have to assemble lockout/budget/fallback logic themselves. + +- Policy engine: `src/domain/policyEngine.ts` — single entry point for + pre-execution evaluation (lockout → budget → fallback ordering) +- Cost rules: `src/domain/costRules.ts` +- Fallback policy: `src/domain/fallbackPolicy.ts` +- Lockout policy: `src/domain/lockoutPolicy.ts` +- Tag-based routing: `src/domain/tagRouter.ts` +- Combo resolver: `src/domain/comboResolver.ts` — resolves combo names, auto/\* + prefixes, and wildcard model targets to concrete execution plans +- Connection/model rule joiner: `src/domain/connectionModelRules.ts` +- Model availability snapshots: `src/domain/modelAvailability.ts` +- Provider expiration tracking: `src/domain/providerExpiration.ts` +- Quota cache: `src/domain/quotaCache.ts` +- Degradation state: `src/domain/degradation.ts` +- Configuration audit: `src/domain/configAudit.ts` +- OmniRoute response metadata builder: `src/domain/omnirouteResponseMeta.ts` +- Assessment subsystem: `src/domain/assessment/` — periodic evaluation jobs + +### E. Authorization Pipeline + +The authorization pipeline classifies every incoming request and applies the +appropriate policy chain before dispatch. + +- Pipeline entry: `src/server/authz/pipeline.ts` +- Request classifier: `src/server/authz/classify.ts` — distinguishes public + compatibility routes from management routes +- Public route inventory: `src/shared/constants/publicApiRoutes.ts` +- Policies: `src/server/authz/policies/` — composable predicates + (`requireApiKey`, `requireManagement`, `requireFreshAuth`, etc.) +- Header utilities: `src/server/authz/headers.ts` +- Assertion helper: `src/server/authz/assertAuth.ts` +- Request context: `src/server/authz/context.ts` + +Public vs management routes are a hard boundary: agent/cooldown APIs and +provider mutations require management auth (HTTP 401 if missing). + +For the full route classification rules, see +[`docs/architecture/AUTHZ_GUIDE.md`](./AUTHZ_GUIDE.md). + +### F. Workflow FSM and Task-Aware Router + +A finite-state-machine driven router layered above combo selection to direct +traffic based on the detected workflow stage (planning, execution, +review) and background-task affinity. + +- Workflow FSM: `open-sse/services/workflowFSM.ts` +- Task-aware router: `open-sse/services/taskAwareRouter.ts` +- Background task detector: `open-sse/services/backgroundTaskDetector.ts` +- Intent classifier: `open-sse/services/intentClassifier.ts` + +The FSM transitions feed into Auto Combo's scoring, biasing toward cheaper models +for background/automation tasks and toward stronger models for interactive +planning/review turns. + +### G. Provider-Specific Resilience + +Several providers ship dedicated resilience and stealth modules that piggy-back on +the global circuit breaker / connection cooldown / model lockout layers: + +- Antigravity 429 engine: `open-sse/services/antigravity429Engine.ts` (rotates + identity, scrubs response headers, drives credits/version tracking via + `antigravityCredits.ts`, `antigravityHeaderScrub.ts`, `antigravityHeaders.ts`, + `antigravityIdentity.ts`, `antigravityObfuscation.ts`, `antigravityVersion.ts`) +- ModelScope quota policy: `open-sse/services/modelscopePolicy.ts` +- Claude Code CCH (Compatibility Channel Handshake): `open-sse/services/claudeCodeCCH.ts`, + plus `claudeCodeCompatible.ts`, `claudeCodeConstraints.ts`, `claudeCodeExtraRemap.ts`, + `claudeCodeToolRemapper.ts` +- Claude Code fingerprint shaping: `open-sse/services/claudeCodeFingerprint.ts` +- Claude Code obfuscation: `open-sse/services/claudeCodeObfuscation.ts` +- ChatGPT TLS client: `open-sse/services/chatgptTlsClient.ts` (curl-impersonate + style for ChatGPT-Web sessions) +- ChatGPT image cache: `open-sse/services/chatgptImageCache.ts` + +For the full stealth playbook and operational guidance, see +[`docs/security/STEALTH_GUIDE.md`](../security/STEALTH_GUIDE.md). + +### H. Webhooks, Reasoning Cache, Read Cache + +- **Webhooks** — outbound dispatch for provider/account/task events. + - Dispatcher: `src/lib/webhookDispatcher.ts` + - Storage: `webhooks` SQLite table (via `src/lib/db/webhooks.ts`) + - Dashboard: `/dashboard/webhooks` (subscriptions, secrets, retry history) + - For event taxonomy and retry semantics, see [`docs/frameworks/WEBHOOKS.md`](../frameworks/WEBHOOKS.md). +- **Reasoning Cache** — replayable reasoning blocks for providers that emit + thinking tokens (Claude, GLMT, etc.) so consecutive turns can skip re-thinking. + - DB layer: `src/lib/db/reasoningCache.ts` + - Service layer: `open-sse/services/reasoningCache.ts` + - For replay semantics, see [`docs/routing/REASONING_REPLAY.md`](../routing/REASONING_REPLAY.md). +- **Read Cache** — short-lived response cache keyed by signature and used to + collapse identical retries from broken upstream SDKs. + - DB layer: `src/lib/db/readCache.ts` + - Stats endpoint: `GET /api/cache/stats`, dashboard at `/dashboard/cache` + ## 3) Persistence Layer Primary state DB (SQLite): @@ -660,9 +856,12 @@ flowchart LR ### Translation Registry and Format Converters - `open-sse/translator/index.ts`: translator registry and orchestration -- Request translators: `open-sse/translator/request/*` -- Response translators: `open-sse/translator/response/*` +- Request translators: `open-sse/translator/request/*` (9 modules — `antigravity-to-openai`, `claude-to-gemini`, `claude-to-openai`, `gemini-to-openai`, `openai-responses`, `openai-to-claude`, `openai-to-cursor`, `openai-to-gemini`, `openai-to-kiro`) +- Response translators: `open-sse/translator/response/*` (8 modules — `claude-to-openai`, `cursor-to-openai`, `gemini-to-claude`, `gemini-to-openai`, `kiro-to-openai`, `openai-responses`, `openai-to-antigravity`, `openai-to-claude`) +- Helpers: `open-sse/translator/helpers/*` (8 modules — `claudeHelper`, `geminiHelper`, `geminiToolsSanitizer`, `maxTokensHelper`, `openaiHelper`, `responsesApiHelper`, `schemaCoercion`, `toolCallHelper`) - Format constants: `open-sse/translator/formats.ts` +- Bootstrap and registry: `open-sse/translator/bootstrap.ts`, `open-sse/translator/registry.ts` +- Image-format helpers: `open-sse/translator/image/` ### Persistence @@ -674,66 +873,108 @@ flowchart LR Each provider has a specialized executor extending `BaseExecutor` (in `open-sse/executors/base.ts`), which provides URL building, header construction, retry with exponential backoff, credential refresh hooks, and the `execute()` orchestration method. -| Executor | Provider(s) | Special Handling | -| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -| `DefaultExecutor` | OpenAI, Claude, Gemini, Qwen, OpenRouter, GLM, Kimi, MiniMax, DeepSeek, Groq, xAI, Mistral, Perplexity, Together, Fireworks, Cerebras, Cohere, NVIDIA, etc. | Dynamic URL/header config per provider | -| `AntigravityExecutor` | Google Antigravity | Custom project/session IDs, Retry-After parsing | -| `CliProxyApiExecutor` | CLIProxyAPI-compatible providers | Custom auth and protocol handling | -| `CloudflareAiExecutor` | Cloudflare Workers AI | Account ID injection, Neurons-based usage tracking | -| `CodexExecutor` | OpenAI Codex | Injects system instructions, forces reasoning effort | -| `CursorExecutor` | Cursor IDE | ConnectRPC protocol, Protobuf encoding, request signing via checksum | -| `GithubExecutor` | GitHub Copilot | Copilot token refresh, VSCode-mimicking headers | -| `GeminiCLIExecutor` | Gemini CLI | Google OAuth token refresh cycle | -| `KiroExecutor` | AWS CodeWhisperer/Kiro | AWS EventStream binary format → SSE conversion | -| `OpenCodeExecutor` | OpenCode | AI SDK compatible provider setup | -| `PollinationsExecutor` | Pollinations AI | No API key required, rate-limited requests | -| `PuterExecutor` | Puter | Browser-based provider integration | -| `QoderExecutor` | Qoder AI | PAT and OAuth support, multi-model free tier | -| `VertexExecutor` | Google Vertex AI | Service account auth, region-based endpoints | +| Executor | Provider(s) | Special Handling | +| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | +| `DefaultExecutor` | OpenAI, Claude, Gemini, Qwen, OpenRouter, GLM, Kimi, MiniMax, DeepSeek, Groq, xAI, Mistral, Perplexity, Together, Fireworks, Cerebras, Cohere, NVIDIA, etc. | Dynamic URL/header config per provider | +| `AntigravityExecutor` | Google Antigravity | Custom project/session IDs, Retry-After parsing, 429 obfuscation | +| `AzureOpenAIExecutor` | Azure OpenAI | Deployment-based routing, api-version query enforcement | +| `BlackboxWebExecutor` | Blackbox AI (web-mode) | Web-session reverse with TLS fingerprint emulation | +| `ChatGPTWebExecutor` | ChatGPT web | TLS client + session cookie management (`chatgptTlsClient.ts`) | +| `ClaudeIdentityExecutor` | Claude.ai (CCH path) | Constraint + tool-remap pipelines, fingerprint shaping | +| `CliProxyApiExecutor` | CLIProxyAPI-compatible providers | Custom auth and protocol handling | +| `CloudflareAiExecutor` | Cloudflare Workers AI | Account ID injection, Neurons-based usage tracking | +| `CodexExecutor` | OpenAI Codex | Injects system instructions, forces reasoning effort | +| `CommandCodeExecutor` | Command Code | OAuth + per-session header rotation | +| `CursorExecutor` | Cursor IDE | ConnectRPC protocol, Protobuf encoding, request signing via checksum | +| `DevinCliExecutor` | Devin CLI | Devin task lifecycle bridging via cloud agent module | +| `GeminiCLIExecutor` | Gemini CLI | Google OAuth token refresh cycle | +| `GithubExecutor` | GitHub Copilot | Copilot token refresh, VSCode-mimicking headers | +| `GitlabExecutor` | GitLab Duo | GitLab OAuth + project-scoped routing | +| `GlmExecutor` | Z.AI GLM (incl. `glmt` preset) | Thinking-budget aware, GLMT preset constants | +| `GrokWebExecutor` | xAI Grok web | Web-session reverse, mode selection (think/standard) | +| `KieExecutor` | KIE | Custom token issuance with rotating session anchors | +| `KiroExecutor` | AWS CodeWhisperer/Kiro | AWS EventStream binary format → SSE conversion | +| `MuseSparkWebExecutor` | Muse Spark (web) | Web-session reverse with image-message bridging | +| `NlpCloudExecutor` | NLP Cloud | Provider-specific request body shape | +| `OpenCodeExecutor` | OpenCode | AI SDK compatible provider setup | +| `PerplexityWebExecutor` | Perplexity web | Web-session reverse for chat continuation | +| `PetalsExecutor` | Petals distributed inference | Decentralized swarm routing | +| `PollinationsExecutor` | Pollinations AI | No API key required, rate-limited requests | +| `PuterExecutor` | Puter | Browser-based provider integration | +| `QoderExecutor` | Qoder AI | PAT and OAuth support, multi-model free tier | +| `VertexExecutor` | Google Vertex AI | Service account auth, region-based endpoints | +| `WindsurfExecutor` | Windsurf (Codeium) | Codeium OAuth + session token refresh | All other providers (including custom compatible nodes) use the `DefaultExecutor`. ## Provider Compatibility Matrix -| Provider | Format | Auth | Stream | Non-Stream | Token Refresh | Usage API | -| ---------------- | ---------------- | --------------------- | ---------------- | ---------- | ------------- | ------------------ | -| Claude | claude | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Admin only | -| Gemini | gemini | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Gemini CLI | gemini-cli | OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Antigravity | antigravity | OAuth | ✅ | ✅ | ✅ | ✅ Full quota API | -| OpenAI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Codex | openai-responses | OAuth | ✅ forced | ❌ | ✅ | ✅ Rate limits | -| GitHub Copilot | openai | OAuth + Copilot Token | ✅ | ✅ | ✅ | ✅ Quota snapshots | -| Cursor | cursor | Custom checksum | ✅ | ✅ | ❌ | ❌ | -| Kiro | kiro | AWS SSO OIDC | ✅ (EventStream) | ❌ | ✅ | ✅ Usage limits | -| Qwen | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Per request | -| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Per request | -| Kilo Code | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| Cline | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| Kimi Coding | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| OpenRouter | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| GLM/Kimi/MiniMax | claude | API Key | ✅ | ✅ | ❌ | ❌ | -| DeepSeek | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Groq | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| xAI (Grok) | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Mistral | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Perplexity | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Together AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Fireworks AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cerebras | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cohere | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| NVIDIA NIM | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cloudflare AI | openai | API Token + Acct ID | ✅ | ✅ | ❌ | ❌ | -| Pollinations | openai | None (no key) | ✅ | ✅ | ❌ | ❌ | -| Scaleway AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| LongCat | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Ollama Cloud | openai | API Key (optional) | ✅ | ✅ | ❌ | ❌ | -| HuggingFace | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Nebius | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| SiliconFlow | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Hyperbolic | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Vertex AI | gemini | Service Account | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Puter | openai | API Key | ✅ | ✅ | ❌ | ❌ | +> **Note:** The matrix below is a representative sample of the 177 registered providers in +> OmniRoute v3.8.0. For the canonical and continuously-updated list, refer to +> [`docs/reference/PROVIDER_REFERENCE.md`](../reference/PROVIDER_REFERENCE.md) (auto-generated) or the source of +> truth at `src/shared/constants/providers.ts` (Zod-validated at load). + +| Provider | Format | Auth | Stream | Non-Stream | Token Refresh | Usage API | +| ----------------- | ---------------- | --------------------- | ---------------- | ---------- | ------------- | ------------------ | +| Claude | claude | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Admin only | +| Gemini | gemini | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | +| Gemini CLI | gemini-cli | OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | +| Antigravity | antigravity | OAuth | ✅ | ✅ | ✅ | ✅ Full quota API | +| OpenAI | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Codex | openai-responses | OAuth | ✅ forced | ❌ | ✅ | ✅ Rate limits | +| GitHub Copilot | openai | OAuth + Copilot Token | ✅ | ✅ | ✅ | ✅ Quota snapshots | +| Cursor | cursor | Custom checksum | ✅ | ✅ | ❌ | ❌ | +| Kiro | kiro | AWS SSO OIDC | ✅ (EventStream) | ❌ | ✅ | ✅ Usage limits | +| Qwen | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Per request | +| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Per request | +| Kilo Code | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| Cline | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| Kimi Coding | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| OpenRouter | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| GLM/Kimi/MiniMax | claude | API Key | ✅ | ✅ | ❌ | ❌ | +| DeepSeek | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Groq | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| xAI (Grok) | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Mistral | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Perplexity | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Together AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Fireworks AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Cerebras | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Cohere | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| NVIDIA NIM | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Cloudflare AI | openai | API Token + Acct ID | ✅ | ✅ | ❌ | ❌ | +| Pollinations | openai | None (no key) | ✅ | ✅ | ❌ | ❌ | +| Scaleway AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| LongCat | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Ollama Cloud | openai | API Key (optional) | ✅ | ✅ | ❌ | ❌ | +| HuggingFace | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Nebius | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| SiliconFlow | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Hyperbolic | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Vertex AI | gemini | Service Account | ✅ | ✅ | ✅ | ⚠️ Cloud Console | +| Puter | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Command Code | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Per request | +| Z.AI / GLM | openai | API Key / OAuth | ✅ | ✅ | ❌ | ❌ | +| GLMT (preset) | claude | API Key | ✅ | ✅ | ❌ | ⚠️ Per request | +| Kimi Coding | openai | OAuth / API Key | ✅ | ✅ | ✅ | ❌ | +| KIE | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Windsurf | openai | OAuth (Codeium) | ✅ | ✅ | ✅ | ⚠️ Per request | +| GitLab Duo | openai | OAuth (GitLab) | ✅ | ✅ | ✅ | ❌ | +| Devin CLI | openai | OAuth | ✅ | ✅ | ✅ | ✅ Task API | +| Codex Cloud | openai-responses | OAuth | ✅ | ❌ | ✅ | ✅ Rate limits | +| Jules | openai | OAuth | ✅ | ✅ | ✅ | ✅ Task API | +| AgentRouter | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| ChatGPT-Web | openai | Session cookie + TLS | ✅ | ✅ | ❌ | ❌ | +| Grok-Web | openai | Session cookie | ✅ | ✅ | ❌ | ❌ | +| Perplexity-Web | openai | Session cookie | ✅ | ✅ | ❌ | ❌ | +| BlackBox-Web | openai | Session cookie + TLS | ✅ | ✅ | ❌ | ❌ | +| Muse-Spark-Web | openai | Session cookie | ✅ | ✅ | ❌ | ❌ | +| ModelScope | openai | API Key | ✅ | ✅ | ❌ | ⚠️ Quota policy | +| BazaarLink | openai | API Key | ✅ | ✅ | ❌ | ❌ | +| Petals | openai | None | ✅ | ✅ | ❌ | ❌ | +| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Per request | +| OpenCode (Go/Zen) | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| CLIProxyAPI | openai | Custom | ✅ | ✅ | ❌ | ❌ | ## Format Translation Coverage diff --git a/docs/architecture/AUTHZ_GUIDE.md b/docs/architecture/AUTHZ_GUIDE.md new file mode 100644 index 0000000000..588364948e --- /dev/null +++ b/docs/architecture/AUTHZ_GUIDE.md @@ -0,0 +1,211 @@ +--- +title: "Authorization Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Authorization Guide + +> **Source of truth:** `src/server/authz/`, `src/shared/constants/publicApiRoutes.ts`, `src/lib/api/requireManagementAuth.ts`, `src/shared/utils/apiAuth.ts` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute has a route-aware authorization pipeline that gates every API request. Classification is **deterministic** and **fail-closed** — anything that cannot be classified ends up as `MANAGEMENT` and demands a session or management-grade token. This page explains the model for engineers maintaining routes or designing new endpoints. + +![AuthZ pipeline (3 route classes + policy evaluation)](../diagrams/exported/authz-pipeline.svg) + +> Source: [diagrams/authz-pipeline.mmd](../diagrams/authz-pipeline.mmd) + +## Two Auth Modes + +### 1. API Key (Bearer) + +Used for the OpenAI/Anthropic/Gemini-compatible client APIs and a few management routes when the key has the `manage` scope. + +``` +Authorization: Bearer <api-key> +``` + +Validated by `isValidApiKey()` / `extractApiKey()` in `src/sse/services/auth.ts` and re-exported through `src/shared/utils/apiAuth.ts`. The validator also accepts the `OMNIROUTE_API_KEY` / `ROUTER_API_KEY` env vars as persistent passthrough keys (issue #1350). + +### 2. Dashboard Session (auth_token cookie) + +For dashboard pages and admin operations. + +``` +Cookie: auth_token=<JWT signed with JWT_SECRET> +``` + +Verified by `isDashboardSessionAuthenticated()` in `src/shared/utils/apiAuth.ts`. The pipeline auto-refreshes the JWT when it has fewer than 7 days left in its 30-day lifetime. + +Some management routes accept **either** mode: cookie OR `Bearer <key>` when the API key has the `manage` (or `admin`) scope. This is what enables the "configurable via API calls" workflow added in v3.8. + +## Route Classes + +`src/server/authz/types.ts` defines three classes; any route that cannot be classified deterministically falls back to `MANAGEMENT`. + +| Class | Description | Auth required | +| ------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | +| `PUBLIC` | Explicitly safe routes — login, logout, status, init, health, onboarding bootstrap. | None | +| `CLIENT_API` | Model-serving endpoints — `/api/v1/*`, plus aliases `/v1/*`, `/chat/completions`, `/responses`, `/models`, `/codex/*`. | Bearer key (unless `REQUIRE_API_KEY != "true"`) | +| `MANAGEMENT` | Dashboard pages, settings, providers, keys, admin and diagnostics endpoints. | Dashboard session OR Bearer with `manage` scope | + +## Pipeline + +``` +Incoming request → src/middleware.ts + → runAuthzPipeline() in src/server/authz/pipeline.ts + 1. Strip trusted internal headers (x-omniroute-auth-*, x-omniroute-route-class) + 2. Generate request id, classify route via classifyRoute() + 3. If pathname == "/" → redirect /dashboard + 4. If draining (graceful shutdown) and /api/* → 503 + 5. If non-GET /api/* → checkBodySize() guard + 6. If OPTIONS → CORS preflight 204 + 7. If options.enforce == false → pass-through with route-class headers + 8. Otherwise: POLICIES[routeClass].evaluate(ctx) + - allow → stamp x-omniroute-auth-{kind,id,label,scopes} → NextResponse.next() + - reject → JSON error w/ correlation_id (dashboard pages → 302 /login) +``` + +Trusted internal headers (defined in `src/server/authz/headers.ts`) are **stripped from incoming requests** before classification — clients cannot pre-populate `x-omniroute-auth-*` to impersonate a subject. + +### Policy contracts + +Each route class has a policy in `src/server/authz/policies/`: + +- **`publicPolicy`** (`policies/public.ts`) — always returns `allow({ kind: "anonymous", id: "anonymous" })`. +- **`clientApiPolicy`** (`policies/clientApi.ts`) — extracts Bearer, validates via `validateApiKey()`. Falls through to anonymous if `REQUIRE_API_KEY != "true"`. Allows dashboard-session GET on `/api/v1/models` (used by the dashboard model catalog). +- **`managementPolicy`** (`policies/management.ts`) — accepts dashboard session, internal model-sync requests (matched against `/api/providers/[name]/(sync-models|models)`), or skips entirely if `isAuthRequired()` returns false. Returns 403 (`AUTH_001`) when a Bearer token is present but invalid, 401 otherwise. + +A successful policy returns `AuthSubject` with `kind ∈ { client_api_key, dashboard_session, management_key, anonymous }`. Downstream handlers can read it via `assertAuth(request, "CLIENT_API")` in `src/server/authz/assertAuth.ts` instead of re-running auth logic. + +## Public Routes List + +`src/shared/constants/publicApiRoutes.ts` is the explicit allowlist: + +```ts +PUBLIC_API_ROUTE_PREFIXES = [ + "/api/auth/login", + "/api/auth/logout", + "/api/auth/status", + "/api/init", + "/api/v1/", // treated as CLIENT_API in classify, not as "no-auth public" + "/api/cloud/", + "/api/sync/bundle", + "/api/oauth/", +]; + +PUBLIC_READONLY_API_ROUTE_PREFIXES = ["/api/monitoring/health", "/api/settings/require-login"]; + +PUBLIC_READONLY_METHODS = new Set(["GET", "HEAD", "OPTIONS"]); +``` + +Read-only prefixes are public **only** for safe methods. Note: `classifyRoute()` excludes `/api/v1/*` from the PUBLIC fall-through — those are always `CLIENT_API` so the Bearer-key policy still applies. + +## Adding a New Route + +### Pattern 1 — Public client API endpoint (Bearer-auth) + +Routes under `/api/v1/` are classified `CLIENT_API` automatically. The middleware enforces the Bearer check; route handlers don't need to redo it but can read the subject if useful. + +```typescript +// src/app/api/v1/your-route/route.ts +import { NextRequest, NextResponse } from "next/server"; +import { assertAuth } from "@/server/authz/assertAuth"; + +export async function POST(req: NextRequest) { + const subject = assertAuth(req, "CLIENT_API"); + // subject.kind === "client_api_key" | "anonymous" | "dashboard_session" + // ... handler logic +} +``` + +### Pattern 2 — Management endpoint (session or Bearer + manage) + +Use `requireManagementAuth()` from `src/lib/api/requireManagementAuth.ts`: + +```typescript +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; + +export async function POST(request: Request) { + const rejection = await requireManagementAuth(request); + if (rejection) return rejection; + // ... handler logic +} +``` + +`requireManagementAuth()` returns `null` on success or a JSON error `Response`: + +- 401 `AUTH_001` "Authentication required" — no credentials at all +- 403 — invalid Bearer **or** Bearer present but key lacks the `manage` / `admin` scope + +`hasManageScope(scopes)` returns true for `"manage"` or `"admin"`. + +### Pattern 3 — Adding to the public allowlist + +Add the prefix to `PUBLIC_API_ROUTE_PREFIXES` (or `PUBLIC_READONLY_API_ROUTE_PREFIXES` for GET-only). Update unit tests at `tests/unit/public-api-routes.test.ts` and `tests/unit/authz/classify.test.ts`. + +## Scopes + +API keys carry a `scopes` array (stored as JSON in `api_keys.scopes`, see `src/lib/db/apiKeys.ts`). + +### Management scope + +- `manage` / `admin` — grants the key access to management API endpoints when sent as Bearer. + +### MCP scopes (`src/shared/constants/mcpScopes.ts`) + +Each MCP tool requires specific scopes via `MCP_TOOL_SCOPES`. Full list (`MCP_SCOPE_LIST`): + +``` +read:health, read:combos, write:combos, read:quota, read:usage, +read:models, execute:completions, execute:search, write:budget, +write:resilience, pricing:write, read:cache, write:cache, +read:compression, write:compression, read:proxies +``` + +Preset bundles (`MCP_SCOPE_PRESETS`): `readonly`, `full`, `monitor`, `agent`. Use `hasRequiredScopes(granted, toolName)` and `getMissingScopes()` for enforcement inside MCP handlers. + +## Auth Required Toggle + +`isAuthRequired()` in `src/shared/utils/apiAuth.ts` decides whether **any** auth is enforced for a request: + +- `settings.requireLogin === false` → auth is globally disabled. +- No password configured **and** no `INITIAL_PASSWORD` env var → bootstrap mode allows the onboarding wizard and loopback requests, but exposed network requests still need credentials. +- Any DB error → fails closed (secure-by-default). + +## Breaking Change — v3.8.0 + +The `/api/v1/agents/tasks/*` and `/api/resilience/model-cooldowns` endpoints **now require management auth** (commit `588a0333`). Clients previously sending a normal API key without the `manage` scope receive `403`. Migration: either issue the key the `manage` scope in the API Manager dashboard, or use a logged-in dashboard session. + +## Testing + +- Unit tests: `tests/unit/authz/` — `classify.test.ts`, `pipeline.test.ts`, `client-api-policy.test.ts`, `management-policy.test.ts`, `public-policy.test.ts`. +- Public allowlist: `tests/unit/public-api-routes.test.ts`. +- Run focused: `node --import tsx/esm --test tests/unit/authz/classify.test.ts`. + +## Debugging + +The pipeline always stamps responses with: + +``` +x-request-id: <correlation id, echoed in error bodies> +x-omniroute-route-class: PUBLIC | CLIENT_API | MANAGEMENT +``` + +For authenticated requests the upstream (handler-side) request headers also include: + +``` +x-omniroute-auth-kind: client_api_key | dashboard_session | management_key | anonymous +x-omniroute-auth-id: key_<last-4> | "dashboard" | "anonymous" +x-omniroute-auth-label: (optional) +x-omniroute-auth-scopes: comma-separated list +``` + +Use `assertAuth(req, expectedClass)` inside handlers — it throws `AuthzAssertionError` with code `AUTHZ_NOT_INITIALIZED` if the middleware was bypassed (helpful for catching configuration regressions in tests). + +## See Also + +- [API_REFERENCE.md](../reference/API_REFERENCE.md) — auth marker per endpoint +- [COMPLIANCE.md](../security/COMPLIANCE.md) — audit log for auth events +- [MCP-SERVER.md](../frameworks/MCP-SERVER.md) — MCP scope enforcement details +- Source: `src/server/authz/`, `src/lib/api/requireManagementAuth.ts` diff --git a/docs/architecture/CODEBASE_DOCUMENTATION.md b/docs/architecture/CODEBASE_DOCUMENTATION.md new file mode 100644 index 0000000000..69ba9fd8ea --- /dev/null +++ b/docs/architecture/CODEBASE_DOCUMENTATION.md @@ -0,0 +1,806 @@ +--- +title: "OmniRoute Codebase Documentation" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# OmniRoute Codebase Documentation + +> **Version:** v3.8.0 +> **Last updated:** 2026-05-13 +> **Audience:** Engineers contributing to OmniRoute or building integrations on top of it. +> +> For high-level architecture diagrams and the reasoning behind each subsystem, read +> [ARCHITECTURE.md](./ARCHITECTURE.md). For deep dives on individual subsystems +> (Auto Combo, MCP server, A2A server, Skills, Memory, Cloud Agents, Resilience, +> Compression, etc.) see their dedicated files in this `docs/` directory. + +This file describes **what exists in the repository today** so that a new engineer +can navigate the tree, understand the runtime layering, and know where to add code +without inventing new modules. + +--- + +## 1. Tech Stack + +| Concern | Choice | +| ------------- | ------------------------------------------------------------------------------------------------------------------------ | --- | ------------- | --- | ------------------------------------ | +| Web framework | **Next.js 16** (App Router, standalone output, no global middleware) | +| Language | **TypeScript 5.9+** — target `ES2022`, `module: esnext`, `moduleResolution: bundler`, `strict: false` | +| Runtime | **Node.js** `>=20.20.2 <21 | | >=22.22.2 <23 | | >=24.0.0 <27`(enforced via`engines`) | +| Database | **SQLite** via `better-sqlite3` (singleton, WAL journaling) | +| Desktop | **Electron 41** + `electron-builder` 26.10 (separate workspace at `electron/`) | +| Tests | **Node native test runner** (unit/integration), **Vitest** (MCP, autoCombo, cache), **Playwright** (e2e + protocols-e2e) | +| Build | Next.js standalone via `scripts/build/build-next-isolated.mjs` | +| Lint/format | ESLint flat config + Prettier (`lint-staged` via Husky pre-commit) | +| Module system | ESM everywhere (`"type": "module"`) | +| Workspaces | npm workspace — `open-sse` is the only sub-workspace | + +Path aliases (`tsconfig.json`): + +- `@/*` → `src/*` +- `@omniroute/open-sse` → `open-sse/index.ts` +- `@omniroute/open-sse/*` → `open-sse/*` + +Default HTTP port: **`20128`** (API and dashboard share the same process). Data +directory is `DATA_DIR` env var, defaulting to `~/.omniroute/`. + +--- + +## 2. Repository Layout + +``` +OmniRoute/ +├── src/ Next.js application (App Router, libs, domain, server, shared) +├── open-sse/ Streaming engine workspace (@omniroute/open-sse) +├── electron/ Desktop wrapper (Electron 41 main + preload) +├── bin/ CLI entry points (omniroute, reset-password) +├── tests/ Unit, integration, e2e, protocols-e2e, translator, security, fixtures +├── scripts/ Build, sync, check, migration, and runtime helper scripts +├── docs/ Public documentation (this directory) +├── public/ Static assets, PWA manifest, service worker +├── config/ Runtime config samples +├── images/ Marketing/screenshot assets +├── _ideia/, _references/, _mono_repo/, _tasks/ Internal scratch / planning (not shipped) +├── CLAUDE.md Repo rules for Claude Code +├── AGENTS.md Deeper architecture reference for agents +├── package.json v3.8.0, workspace root +└── tsconfig.json Path aliases + core compiler options +``` + +--- + +## 3. `src/` — Next.js Application + +``` +src/ +├── app/ App Router pages + API routes +├── lib/ Core libraries (DB, auth, OAuth, skills, memory, …) +├── domain/ Pure domain layer (policy, fallback, cost, lockout, …) +├── server/ Server-only modules (authz, cors, auth) +├── shared/ Types, constants, validation, contracts, utils (cross-boundary safe) +├── mitm/ Man-in-the-middle proxy helpers for CLI integration +├── models/ Local model metadata / aliasing +├── sse/ Legacy SSE handlers that still live under src/ (not open-sse/) +├── store/ Client-side state stores +├── middleware/ Route-level middleware utilities (not Next.js global middleware) +├── scripts/ In-tree scripts importable by app code +├── types/ Ambient and shared TS types +├── i18n/ Locale bundles +├── instrumentation.ts Next.js instrumentation hook +├── instrumentation-node.ts +├── server-init.ts Process-level bootstrap (env, DB, jobs, sync) +└── proxy.ts Top-level proxy bootstrap helper +``` + +### 3.1 `src/app/` — App Router + +The App Router exposes both the dashboard UI and the public/management HTTP API. +There is **no global middleware** — interception is done per-route. + +Top-level segments under `src/app/`: + +| Path | Purpose | +| ----------------------------------------------------------------------------- | ----------------------------------------- | +| `api/` | All HTTP API routes (see breakdown below) | +| `a2a/` | A2A JSON-RPC 2.0 endpoint (`POST /a2a`) | +| `.well-known/agent.json/` | A2A Agent Card discovery document | +| `(dashboard)/` | Dashboard UI (route group, no URL prefix) | +| `auth/`, `login/`, `forgot-password/`, `callback/` | Auth flows | +| `landing/` | Marketing/landing page | +| `docs/` | Embedded API docs viewer | +| `status/`, `maintenance/`, `offline/` | Operational pages | +| `privacy/`, `terms/` | Legal pages | +| `400/`, `401/`, `403/`, `408/`, `429/`, `500/`, `502/`, `503/` | Static error pages | +| `error.tsx`, `global-error.tsx`, `not-found.tsx`, `forbidden/`, `loading.tsx` | Framework error/loading boundaries | +| `layout.tsx`, `page.tsx`, `globals.css`, `manifest.ts` | Root shell | + +#### 3.1.1 `src/app/(dashboard)/dashboard/` — UI pages + +`agents`, `analytics`, `api-manager`, `audit`, `auto-combo`, `batch`, `cache`, +`changelog`, `cli-tools`, `cloud-agents`, `combos`, `compression`, `context`, +`costs`, `endpoint`, `health`, `limits`, `logs`, `memory`, `onboarding`, +`playground`, `providers`, `search-tools`, `settings`, `skills`, `system`, +`translator`, `usage`, `webhooks`, plus root `page.tsx`, `HomePageClient.tsx`, +`BootstrapBanner.tsx`. + +#### 3.1.2 `src/app/api/` — Top-level API groups + +``` +src/app/api/ +├── a2a/{status, tasks} +├── acp/ +├── admin/ +├── analytics/ +├── assess/ +├── auth/ +├── batches/ +├── cache/ +├── cli-tools/ +├── cloud/{codex-responses-ws} +├── combos/ +├── compliance/ +├── compression/ +├── context/ +├── db/, db-backups/ +├── evals/ +├── fallback/ +├── files/ +├── health/ +├── init/ +├── internal/{concurrency} +├── keys/ +├── logs/ +├── mcp/{audit, sse, status, stream, tools} +├── memory/{health, [id]/, route.ts} +├── model-combo-mappings/ +├── models/ +├── monitoring/ +├── oauth/ +├── openapi/ +├── policies/ +├── pricing/ +├── provider-metrics/, provider-models/, provider-nodes/ +├── providers/ +├── rate-limit/, rate-limits/ +├── resilience/ +├── restart/, shutdown/ +├── search/ +├── sessions/ +├── settings/ +├── skills/{executions, [id], install, marketplace, route.ts, skillssh} +├── storage/ +├── sync/, synced-available-models/ +├── system/ +├── tags/ +├── telemetry/ +├── token-health/ +├── translator/ +├── tunnels/ +├── upstream-proxy/ +├── usage/ +├── v1/ OpenAI-compatible public API +├── v1beta/ Gemini-style compat +├── version-manager/ +└── webhooks/ +``` + +#### 3.1.3 `src/app/api/v1/` — OpenAI-compatible public API + +``` +v1/ +├── accounts/[id]/ account lookup +├── agents/tasks/[id]/, agents/tasks/ A2A-flavored task endpoints +├── api/ internal API helpers exposed under v1/api +├── audio/{speech, transcriptions}/ TTS + STT +├── batches/[id]/{cancel}, batches/ OpenAI Batches API +├── chat/completions/ Chat Completions (the main endpoint) +├── chatgpt-web/ ChatGPT-Web compat +├── completions/ Legacy text completions +├── embeddings/ Embeddings +├── files/[id]/, files/ Files API +├── _helpers/ Shared route helpers (no public URL) +├── images/{edits, generations}/ Image gen + edit +├── issues/ Triage helper endpoints +├── management/{proxies}/ Management-scoped routes inside v1 +├── messages/{count_tokens}/ Anthropic-style messages compat +├── models/ Model listing (`route.ts`, `catalog.ts`) +├── moderations/ Moderation +├── music/ Music gen +├── providers/[provider]/ Per-provider operations +├── quotas/{check} Quota probes +├── registered-keys/ Registered key admin +├── rerank/ Reranking +├── responses/[...path]/ OpenAI Responses API (catch-all) +├── search/ Web search +├── videos/ Video gen +├── ws/ WebSocket bridge +└── route.ts Index handler +``` + +Every route file follows the same pattern: + +``` +Route → CORS preflight → Zod body validation → optional auth + → API key policy enforcement → handler delegation (open-sse) +``` + +`v1beta/` is the Gemini-style compat surface (a thin wrapper that translates into +the same `open-sse/handlers/` pipeline). + +### 3.2 `src/lib/` — Core libraries + +Always import data, sync, OAuth, skill, memory, etc. through these modules. The +table groups the actual directories and notable top-level files. + +| Module | Purpose | +| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `a2a/` | A2A protocol server: `taskManager.ts`, `streaming.ts`, `taskExecution.ts`, `routingLogger.ts`, `skills/` (5 skills: cost analysis, health report, provider discovery, quota management, smart routing) | +| `acp/` | Agent-Control-Protocol: `index.ts`, `manager.ts`, `registry.ts` | +| `api/` | Internal API helpers: `requireManagementAuth.ts`, `requireCliToolsAuth.ts`, `errorResponse.ts` | +| `auth/` | `managementPassword.ts` (password reset / hashing) | +| `batches/` | OpenAI Batches API service (`service.ts`) | +| `catalog/` | OpenRouter catalog sync (`openrouterCatalog.ts`) | +| `cloudAgent/` | Cloud agent registry: `api.ts`, `baseAgent.ts`, `db.ts`, `index.ts`, `registry.ts`, `types.ts`, `agents/{codex, devin, jules}.ts` | +| `combos/` | Combo resolution helpers | +| `compliance/` | Audit + provider audit: `index.ts`, `providerAudit.ts` | +| `config/` | Runtime config glue | +| `db/` | SQLite domain modules (see §3.2.1) | +| `display/` | UI/display helpers used by API responses | +| `embeddings/` | Embedding service registry | +| `env/` | Env loading + introspection | +| `evals/` | Eval runtime | +| `guardrails/` | `piiMasker.ts`, `promptInjection.ts`, `visionBridge.ts`, `visionBridgeHelpers.ts`, `registry.ts`, `base.ts` | +| `jobs/` | Background jobs (`autoUpdate.ts`, …) | +| `memory/` | Persistent memory: `store.ts`, `cache.ts`, `retrieval.ts`, `summarization.ts`, `extraction.ts`, `injection.ts`, `qdrant.ts`, `settings.ts`, `verify.ts`, `schemas.ts`, `types.ts` | +| `monitoring/` | `observability.ts` | +| `oauth/` | OAuth providers (14): `antigravity`, `claude`, `cline`, `codex`, `cursor`, `gemini`, `github`, `gitlab-duo`, `kilocode`, `kimi-coding`, `kiro`, `qoder`, `qwen`, `windsurf` plus `services/`, `utils/{pkce, server, banner, codexAuthFile, ui}`, `constants/oauth.ts` | +| `plugins/` | Plugin loader (`index.ts`) | +| `promptCache/` | `prefixAnalyzer.ts`, `index.ts` | +| `providerModels/` | Managed model lifecycle: `modelDiscovery.ts`, `managedModelImport.ts`, `managedAvailableModels.ts`, `cursorAgent.ts` | +| `providers/` | Provider helpers: `catalog.ts`, `validation.ts`, `imageValidation.ts`, `claudeExtraUsage.ts`, `codexConnectionDefaults.ts`, `codexFastTier.ts`, `webCookieAuth.ts`, `managedAvailableModels.ts`, `requestDefaults.ts` | +| `resilience/` | `settings.ts` — settings for circuit breaker, cooldown, lockout | +| `runtime/` | Runtime feature detection | +| `search/` | `executeWebSearch.ts` | +| `skills/` | Skill framework: `registry.ts`, `executor.ts`, `interception.ts`, `injection.ts`, `sandbox.ts`, `custom.ts`, `hybrid.ts`, `builtins.ts`, `a2a.ts`, `providerSettings.ts`, `schemas.ts`, `skillssh.ts`, `types.ts`, plus `builtin/browser.ts` | +| `spend/` | `batchWriter.ts` (write-behind buffer) | +| `sync/` | `bundle.ts`, `tokens.ts` (Cloud Sync) | +| `system/` | System-level helpers | +| `translator/` | Top-level translator glue (delegates into `open-sse/translator/`) | +| `usage/` | Usage accounting: `costCalculator.ts`, `tokenAccounting.ts`, `usageHistory.ts`, `aggregateHistory.ts`, `usageStats.ts`, `callLogs.ts`, `callLogArtifacts.ts`, `fetcher.ts`, `providerLimits.ts`, `migrations.ts` | +| `versionManager/` | Auto-update + version manifest | +| `ws/` | WebSocket bridge | +| `zed-oauth/` | Zed editor OAuth flow | + +Top-level files in `src/lib/`: + +- `localDb.ts` — re-export layer only. **Never** add logic here. +- `proxyHealth.ts`, `proxyLogger.ts`, `tokenHealthCheck.ts`, `localHealthCheck.ts` +- `oneproxyRotator.ts`, `oneproxySync.ts` +- `apiBridgeServer.ts`, `cacheLayer.ts`, `semanticCache.ts`, `settingsCache.ts` +- `cloudSync.ts`, `initCloudSync.ts` +- `cloudflaredTunnel.ts`, `ngrokTunnel.ts`, `tailscaleTunnel.ts` +- `consoleInterceptor.ts`, `container.ts`, `gracefulShutdown.ts`, `idempotencyLayer.ts` +- `ipUtils.ts`, `logEnv.ts`, `logPayloads.ts`, `logRotation.ts` +- `modelAliasSeed.ts`, `modelCapabilities.ts`, `modelMetadataRegistry.ts`, `modelsDevSync.ts` +- `piiSanitizer.ts`, `pricingSync.ts` +- `apiKeyExposure.ts`, `cacheControlSettings.ts`, `dataPaths.ts`, `toolPolicy.ts` +- `translatorEvents.ts`, `usageDb.ts`, `usageAnalytics.ts`, `webhookDispatcher.ts` + +#### 3.2.1 `src/lib/db/` + +Singleton SQLite database (`getDbInstance()` in `core.ts`, WAL journaling). +**Never write raw SQL in routes or handlers** — go through these modules. + +![Database schema overview (selected core tables)](../diagrams/exported/db-schema-overview.svg) + +> Source: [diagrams/db-schema-overview.mmd](../diagrams/db-schema-overview.mmd) + +Domain modules (each owns one or more tables): `apiKeys.ts`, `backup.ts`, +`batches.ts`, `cleanup.ts`, `cliToolState.ts`, `combos.ts`, +`commandCodeAuth.ts`, `compression.ts`, `compressionAnalytics.ts`, +`compressionCacheStats.ts`, `compressionCombos.ts`, `compressionScheduler.ts`, +`contextHandoffs.ts`, `core.ts`, `creditBalance.ts`, `databaseSettings.ts`, +`detailedLogs.ts`, `domainState.ts`, `encryption.ts`, `evals.ts`, `files.ts`, +`healthCheck.ts`, `jsonMigration.ts`, `migrationRunner.ts`, +`modelComboMappings.ts`, `models.ts`, `oneproxy.ts`, `prompts.ts`, +`providers.ts`, `providerLimits.ts`, `proxies.ts`, `quotaSnapshots.ts`, +`readCache.ts`, `reasoningCache.ts`, `registeredKeys.ts`, `secrets.ts`, +`sessionAccountAffinity.ts`, `settings.ts`, `stateReset.ts`, `stats.ts`, +`syncTokens.ts`, `tierConfig.ts`, `upstreamProxy.ts`, `versionManager.ts`, +`webhooks.ts`. + +`migrations/` holds 55 versioned `.sql` files (idempotent, transactional) and is +executed by `migrationRunner.ts` at boot. + +Tables created across the migrations (52 total): + +`a`, `account_key_limits`, `api_keys`, `batches`, `call_logs`, +`combo_adaptation_state`, `combos`, `command_code_auth_sessions`, +`compression_analytics`, `compression_cache_stats`, +`compression_combo_assignments`, `compression_combos`, `context_handoffs`, +`daily_usage_summary`, `db_meta`, `domain_budgets`, `domain_circuit_breakers`, +`domain_cost_history`, `domain_fallback_chains`, `domain_lockout_state`, +`eval_cases`, `eval_runs`, `eval_suites`, `files`, `hourly_usage_summary`, +`key_value`, `mcp_tool_audit`, `memories`, `model_combo_mappings`, +`provider_connections`, `provider_key_limits`, `provider_nodes`, +`proxy_assignments`, `proxy_logs`, `proxy_registry`, `quota_snapshots`, +`reasoning_cache`, `registered_keys`, `request_detail_logs`, +`routing_decisions`, `semantic_cache`, `session_account_affinity`, +`skill_executions`, `skills`, `sync_tokens`, `tier_assignments`, +`tier_config`, `upstream_proxy_config`, `usage_history`, `version_manager`, +`webhooks` (plus FTS5 virtual tables for memory search). + +### 3.3 `src/domain/` — Domain layer + +Pure business logic, no I/O. Imported by routes and handlers. + +| File | Purpose | +| ------------------------------------------ | ------------------------------------------------- | +| `policyEngine.ts` | Top-level policy resolver | +| `fallbackPolicy.ts` | Fallback decision tree | +| `costRules.ts` | Cost calculation rules | +| `lockoutPolicy.ts` | Model lockout decisions | +| `tagRouter.ts` | Tag-based routing | +| `comboResolver.ts` | Combo resolution from request → target list | +| `connectionModelRules.ts` | Per-connection model filters | +| `modelAvailability.ts` | Model availability check | +| `degradation.ts` | Degraded-mode transitions | +| `providerExpiration.ts` | Expired account/key detection | +| `quotaCache.ts` | Cached quota decisions | +| `responses.ts`, `omnirouteResponseMeta.ts` | Response shape helpers | +| `configAudit.ts` | Config change audit | +| `assessment/` | Model assessment (per RFC, partially implemented) | +| `types.ts` | Shared domain types | + +### 3.4 `src/server/` — Server-only + +Cannot be imported from client components. + +``` +server/ +├── auth/loginGuard.ts +├── authz/ +│ ├── classify.ts Classifies routes as public vs management +│ ├── assertAuth.ts Assertion helper +│ ├── context.ts Per-request authz context +│ ├── headers.ts +│ ├── pipeline.ts Authz pipeline +│ ├── policies/ Concrete policies +│ └── types.ts +└── cors/origins.ts CORS origin allowlist +``` + +### 3.5 `src/shared/` — Safe-to-share + +Split into focused subdirectories: + +- `constants/` — `providers.ts` (Zod-validated provider catalog), `models.ts`, + `modelSpecs.ts`, `modelCompat.ts`, `pricing.ts`, `cliTools.ts`, + `cliCompatProviders.ts`, `routingStrategies.ts`, `comboConfigMode.ts`, + `headers.ts`, `upstreamHeaders.ts` (denylist), `mcpScopes.ts`, + `errorCodes.ts`, `publicApiRoutes.ts`, `batch.ts`, `batchEndpoints.ts`, + `bodySize.ts`, `colors.ts`, `appConfig.ts`, `config.ts`, + `sidebarVisibility.ts`, `visionBridgeDefaults.ts`. +- `validation/` — `schemas.ts` (~80 Zod schemas), `compressionConfigSchemas.ts`, + `oneproxySchemas.ts`, `providerSchema.ts`, `settingsSchemas.ts`, `helpers.ts`. +- `contracts/` — public API contracts shipped to npm. +- `types/` — shared TS types. +- `utils/` — `circuitBreaker.ts`, `apiAuth.ts`, `apiKey.ts`, `apiKeyPolicy.ts`, + `apiResponse.ts`, `api.ts`, `classify429.ts`, `cliCompat.ts`, `clipboard.ts`, + `cloud.ts`, `cn.ts`, `cors.ts`, `costEstimator.ts`, `featureFlags.ts`, + `fetchTimeout.ts`, `formatting.ts`, `inputSanitizer.ts`, `logger.ts`, + `machine.ts`, `machineId.ts`, `maskEmail.ts`, `modelCatalogSearch.ts`, + `nodeRuntimeSupport.ts`, `parseApiKeys.ts`, `providerHints.ts`, + `providerModelAliases.ts`, `rateLimiter.ts`, `releaseNotes.ts`, + `a11yAudit.ts`, plus dashboard hooks/components under `services/`, `network/`, + `middleware/`, `schemas/`, `hooks/`, `components/`. + +--- + +## 4. `open-sse/` — Streaming engine workspace + +Separate npm workspace published as `@omniroute/open-sse`. Owns request +processing, executors, translators, services, transformer, and the MCP server. + +``` +open-sse/ +├── index.ts Public exports +├── package.json Workspace manifest +├── tsconfig.json +├── types.d.ts +├── config/ Provider registries, header profiles, identity, … +├── handlers/ Request handlers (chat, embeddings, audio, image, …) +├── executors/ 31 provider-specific HTTP executors +├── translator/ Format conversion (OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro) +├── transformer/ Responses API ↔ Chat Completions stream transformer +├── services/ 80+ service modules (combos, fallback, quotas, identity, …) +├── utils/ Streaming helpers, TLS client, AWS SigV4, proxy fetch, … +└── mcp-server/ MCP server (3 transports, 13 scopes, 42 tools) +``` + +### 4.1 `open-sse/handlers/` + +| Handler | Purpose | +| ----------------------- | ------------------------------------------------------------------------ | +| `chatCore.ts` | Main chat pipeline (cache, rate limit, combo routing, executor dispatch) | +| `responsesHandler.ts` | OpenAI Responses API entry point | +| `embeddings.ts` | Embeddings | +| `imageGeneration.ts` | Image generation | +| `audioSpeech.ts` | Text-to-speech | +| `audioTranscription.ts` | Speech-to-text | +| `videoGeneration.ts` | Video generation | +| `musicGeneration.ts` | Music generation | +| `rerank.ts` | Reranking | +| `moderations.ts` | Moderation | +| `search.ts` | Web search | +| `sseParser.ts` | SSE event parser | +| `usageExtractor.ts` | Pull token counts out of upstream streams | +| `responseSanitizer.ts` | Strip provider-specific noise | +| `responseTranslator.ts` | Glue between provider response and translator layer | + +### 4.2 `open-sse/executors/` + +31 provider executors, each extending `BaseExecutor` (`base.ts`): + +`antigravity`, `azure-openai`, `blackbox-web`, `chatgpt-web`, `cliproxyapi`, +`cloudflare-ai`, `codex`, `commandCode`, `cursor`, `default`, `devin-cli`, +`gemini-cli`, `github`, `gitlab`, `glm`, `grok-web`, `kie`, `kiro`, +`muse-spark-web`, `nlpcloud`, `opencode`, `perplexity-web`, `petals`, +`pollinations`, `puter`, `qoder`, `vertex`, `windsurf`, plus `claudeIdentity.ts` +(shared identity helper) and `index.ts` (registry). + +> Note: providers not listed here are served by `default.ts` using the generic +> OpenAI-compatible executor. The full provider catalog (177+ entries) lives in +> `src/shared/constants/providers.ts`. + +### 4.3 `open-sse/translator/` + +Hub-and-spoke translation (OpenAI is the hub). + +- **9 request translators** (`translator/request/`): + `antigravity-to-openai`, `claude-to-gemini`, `claude-to-openai`, + `gemini-to-openai`, `openai-responses`, `openai-to-claude`, + `openai-to-cursor`, `openai-to-gemini`, `openai-to-kiro`. +- **8 response translators** (`translator/response/`): + `claude-to-openai`, `cursor-to-openai`, `gemini-to-claude`, `gemini-to-openai`, + `kiro-to-openai`, `openai-responses`, `openai-to-antigravity`, + `openai-to-claude`. +- **9 helpers** (`translator/helpers/`): + `claudeHelper`, `geminiHelper`, `geminiToolsSanitizer`, `maxTokensHelper`, + `openaiHelper`, `responsesApiHelper`, `schemaCoercion`, `toolCallHelper`, plus + helper tests. +- **Image helpers** (`translator/image/sizeMapper.ts`). +- Top-level: `bootstrap.ts`, `formats.ts`, `registry.ts`, `index.ts`. + +### 4.4 `open-sse/transformer/` + +- `responsesTransformer.ts` — `TransformStream`-based Responses API ↔ Chat + Completions converter (used by the `responses/` route catch-all). + +### 4.5 `open-sse/services/` + +Highlights (full list under `open-sse/services/`): + +| Concern | Files | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Combo routing | `combo.ts` (14 strategies), `comboConfig.ts`, `comboMetrics.ts`, `comboManifestMetrics.ts`, `comboAgentMiddleware.ts` | +| Auto Combo engine | `autoCombo/` — `engine.ts`, `scoring.ts`, `taskFitness.ts`, `virtualFactory.ts`, `modePacks.ts`, `autoPrefix.ts`, `persistence.ts`, `providerDiversity.ts`, `providerRegistryAccessor.ts`, `routerStrategy.ts`, `selfHealing.ts`, `index.ts` | +| Resilience | `accountFallback.ts` (cooldown + lockout), `errorClassifier.ts`, `emergencyFallback.ts`, `rateLimitManager.ts`, `rateLimitSemaphore.ts`, `accountSemaphore.ts`, `accountSelector.ts` | +| Quotas | `quotaMonitor.ts`, `quotaPreflight.ts`, `bailianQuotaFetcher.ts`, `codexQuotaFetcher.ts`, `deepseekQuotaFetcher.ts`, `crofUsageFetcher.ts`, `antigravityCredits.ts` | +| Provider-specific shaping | `claudeCodeCCH.ts`, `claudeCodeCompatible.ts`, `claudeCodeConstraints.ts`, `claudeCodeExtraRemap.ts`, `claudeCodeFingerprint.ts`, `claudeCodeObfuscation.ts`, `claudeCodeToolRemapper.ts`, `cloudCodeHeaders.ts`, `cloudCodeThinking.ts`, `geminiCliHeaders.ts`, `geminiThoughtSignatureStore.ts`, `gigachatAuth.ts`, `antigravityHeaders.ts`, `antigravityHeaderScrub.ts`, `antigravityIdentity.ts`, `antigravityObfuscation.ts`, `antigravityVersion.ts`, `antigravity429Engine.ts`, `chatgptTlsClient.ts`, `chatgptImageCache.ts`, `cursorSessionManager.ts`, `qoderCli.ts`, `qwenThinking.ts`, `modelscopePolicy.ts` | +| Caching | `reasoningCache.ts`, `searchCache.ts`, `signatureCache.ts`, `requestDedup.ts` | +| Routing intelligence | `intentClassifier.ts`, `taskAwareRouter.ts`, `backgroundTaskDetector.ts`, `volumeDetector.ts`, `wildcardRouter.ts`, `workflowFSM.ts`, `specificityDetector.ts`, `specificityRules.ts`, `specificityTypes.ts` | +| Model handling | `modelCapabilities.ts`, `modelDeprecation.ts`, `modelFamilyFallback.ts`, `modelStrip.ts`, `model.ts`, `provider.ts`, `providerRequestDefaults.ts`, `providerCostData.ts`, `payloadRules.ts` | +| Compression | `compression/` — full compression engine wiring | +| Token + session | `tokenRefresh.ts`, `sessionManager.ts`, `apiKeyRotator.ts`, `contextManager.ts`, `contextHandoff.ts`, `systemPrompt.ts`, `roleNormalizer.ts`, `responsesInputSanitizer.ts`, `responsesToolCallState.ts`, `toolSchemaSanitizer.ts`, `toolLimitDetector.ts`, `thinkingBudget.ts` | +| Tier / manifest | `tierResolver.ts`, `tierConfig.ts`, `tierDefaults.json`, `tierTypes.ts`, `manifestAdapter.ts` | +| IP / network | `ipFilter.ts`, `webSearchFallback.ts` | +| Batches | `batchProcessor.ts` | +| Usage | `usage.ts` | + +### 4.6 `open-sse/mcp-server/` + +- **31 registered tools** wired in `server.ts` (12 scoped under `schemas/tools.ts`, + 5 compression tools, 3 memory tools, 4 skills tools, plus advanced tools added + through `advancedTools.ts`). +- **3 transports**: stdio, HTTP Streamable, SSE. +- **13 scopes** declared in `src/shared/constants/mcpScopes.ts`. +- Audit table: `mcp_tool_audit` (populated by `audit.ts`). +- Files: `server.ts`, `index.ts`, `httpTransport.ts`, `audit.ts`, `scopeEnforcement.ts`, + `runtimeHeartbeat.ts`, `descriptionCompressor.ts`, `schemas/{tools, a2a, audit, index}.ts`, + `tools/{advancedTools, compressionTools, memoryTools, skillTools}.ts`, + plus tests under `__tests__/`. +- See [MCP-SERVER.md](../frameworks/MCP-SERVER.md) for the full tool catalog. + +### 4.7 `open-sse/config/` + +Provider registries (`providerRegistry.ts`, `providerModels.ts`, +`providerHeaderProfiles.ts`), per-format model registries (`audioRegistry.ts`, +`embeddingRegistry.ts`, `imageRegistry.ts`, `moderationRegistry.ts`, +`musicRegistry.ts`, `rerankRegistry.ts`, `searchRegistry.ts`, `videoRegistry.ts`), +identity helpers (`codexIdentity.ts`, `codexInstructions.ts`, +`anthropicHeaders.ts`, `antigravityUpstream.ts`, `antigravityModelAliases.ts`, +`cliFingerprints.ts`, `toolCloaking.ts`, `defaultThinkingSignature.ts`), +credential helpers (`credentialLoader.ts`, `codexClient.ts`), and cloud +adapters (`azureAi.ts`, `bedrock.ts`, `datarobot.ts`, `glmProvider.ts`, +`maritalk.ts`, `oci.ts`, `petals.ts`, `runway.ts`, `sap.ts`, `watsonx.ts`, +`ollamaModels.ts`, `errorConfig.ts`, `constants.ts`, `registryUtils.ts`). + +### 4.8 `open-sse/utils/` + +Streaming primitives and provider helpers: `stream.ts`, `streamHandler.ts`, +`streamHelpers.ts`, `streamPayloadCollector.ts`, `streamReadiness.ts`, +`sseHeartbeat.ts`, `proxyFetch.ts`, `proxyDispatcher.ts`, `tlsClient.ts`, +`networkProxy.ts`, `awsSigV4.ts`, `cacheControlPolicy.ts`, +`cursorChecksum.ts`, `cursorAgentProtobuf.ts`, `cursorVersionDetector.ts`, +`comfyuiClient.ts`, `kieTask.ts`, `bypassHandler.ts`, `aiSdkCompat.ts`, +`thinkTagParser.ts`, `urlSanitize.ts`, `usageTracking.ts`, `requestLogger.ts`, +`progressTracker.ts`, `cors.ts`, `error.ts`, `logger.ts`, `sleep.ts`, +`ollamaTransform.ts`. + +--- + +## 5. `electron/` — Desktop wrapper + +``` +electron/ +├── main.js Electron main process +├── preload.js Preload bridge (contextIsolation enabled) +├── types.d.ts +├── package.json electron-builder config, version 3.8.0 +├── README.md +├── assets/ Build resources (icons, entitlements, …) +├── node_modules/ Dedicated node_modules (better-sqlite3, electron-updater) +└── dist-electron/ Build output (not committed) +``` + +Five npm scripts at the workspace root: `electron:dev`, `electron:build`, +`electron:build:{win,mac,linux}`, `electron:smoke:packaged`. Auto-update is via +`electron-updater` pointing at the GitHub release feed. + +--- + +## 6. `bin/` — CLI + +``` +bin/ +├── omniroute.mjs Main CLI entry (Node ESM) +├── reset-password.mjs Reset the management password from CLI +├── mcp-server.mjs MCP server launcher (stdio) +├── cli-commands.mjs Command dispatcher +├── nodeRuntimeSupport.mjs Node version guard +└── cli/ + ├── index.mjs + ├── args.mjs + ├── data-dir.mjs + ├── encryption.mjs + ├── io.mjs + ├── provider-catalog.mjs + ├── provider-store.mjs + ├── provider-test.mjs + ├── settings-store.mjs + ├── sqlite.mjs + └── commands/ + ├── setup.mjs + ├── doctor.mjs + └── providers.mjs +``` + +Two binaries are exposed in `package.json` → `bin`: + +- `omniroute` → `bin/omniroute.mjs` +- `omniroute-reset-password` → `bin/reset-password.mjs` + +--- + +## 7. `tests/` + +| Directory | Type | +| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | +| `tests/unit/` | Unit tests via Node native test runner (506 files, plus `api/`, `auth/`, `authz/` subdirs) | +| `tests/integration/` | Cross-module + DB-state tests | +| `tests/e2e/` | Playwright UI tests | +| `tests/protocols-e2e/` | MCP/A2A protocol e2e | +| `tests/translator/` | Translator-specific tests | +| `tests/security/` | Security regressions | +| `tests/load/` | Load / stress tests | +| `tests/golden-set/` | Reference outputs for translator regressions | +| `tests/helpers/`, `tests/fixtures/`, `tests/manual/`, `tests/scratch_test.mjs` | Support | + +Common commands: + +| Command | What it runs | +| -------------------------------------------------------- | ---------------------------------------------------------------- | +| `npm run test:unit` | All `tests/unit/*.test.ts` via Node test runner (concurrency 10) | +| `npm run test:vitest` | Vitest suite (MCP, autoCombo, cache) | +| `npm run test:e2e` | Playwright UI suite | +| `npm run test:protocols:e2e` | MCP + A2A protocol e2e | +| `npm run test:coverage` | Coverage gate (≥60% lines/statements/functions/branches) | +| `node --import tsx/esm --test tests/unit/<file>.test.ts` | Single file run | + +--- + +## 8. `scripts/` + +Organized into 6 subfolders by purpose. + +- **`scripts/build/`** — `build-next-isolated.mjs`, `prepublish.ts`, + `prepare-electron-standalone.mjs`, `pack-artifact-policy.ts`, + `validate-pack-artifact.ts`, `postinstall.mjs`, `postinstallSupport.mjs`, + `uninstall.mjs`, `bootstrap-env.mjs`, `runtime-env.mjs`, + `native-binary-compat.mjs`. +- **`scripts/dev/`** — `run-next.mjs`, `run-next-playwright.mjs`, + `run-standalone.mjs`, `standalone-server-ws.mjs`, `responses-ws-proxy.mjs`, + `v1-ws-bridge.mjs`, `smoke-electron-packaged.mjs`, + `run-playwright-tests.mjs`, `run-ecosystem-tests.mjs`, + `run-protocol-clients-tests.mjs`, `sync-env.mjs`, `healthcheck.mjs`, + `system-info.mjs`. +- **`scripts/check/`** — `check-cycles.mjs`, `check-docs-sync.mjs`, + `check-docs-counts-sync.mjs`, `check-env-doc-sync.mjs`, + `check-deprecated-versions.mjs`, `check-route-validation.mjs`, + `check-t11-any-budget.mjs`, `check-pr-test-policy.mjs`, + `check-supported-node-runtime.ts`, `test-report-summary.mjs`. +- **`scripts/docs/`** — `generate-docs-index.mjs`, `gen-provider-reference.ts`. +- **`scripts/i18n/`** — `generate-multilang.mjs`, `run-visual-qa.mjs`, + `generate-qa-checklist.mjs`, `apply-priority-overrides.mjs`, + `validate_translation.py`, `check_translations.py`, `i18n_autotranslate.py`, + `untranslatable-keys.json`. +- **`scripts/ad-hoc/`** — `cursor-tap.cjs`, `sync-cursor-models.mjs`, + `migrate-env.mjs`, `dbsetup.js`. + +--- + +## 9. Request Pipeline (Summary) + +![Request pipeline (/v1/chat/completions)](../diagrams/exported/request-pipeline.svg) + +> Source: [diagrams/request-pipeline.mmd](../diagrams/request-pipeline.mmd) + +``` +Client request + → /v1/chat/completions (route.ts) + CORS preflight check + Zod validation (chatCompletionsSchema in shared/validation/schemas.ts) + Auth (extractApiKey + isValidApiKey OR requireManagementAuth) + Policy engine (src/server/authz/pipeline.ts) + Guardrails (PII masker, prompt injection, vision bridge) + → handleChatCore() (open-sse/handlers/chatCore.ts) + Cache check (semantic + read cache) + Rate limit (rateLimitManager, accountSemaphore) + Combo routing (if model resolves to a combo) + comboResolver → loop per target → handleSingleModel() + translateRequest() (open-sse/translator/request/*) + getExecutor(providerId).execute() (open-sse/executors/*) + fetch upstream → retry/backoff via accountFallback + translateResponse() (open-sse/translator/response/*) + SSE stream OR JSON response + If Responses API: TransformStream via open-sse/transformer/responsesTransformer.ts + → Compliance audit (src/lib/compliance/) + → Response to client +``` + +### Resilience runtime state (three mechanisms) + +| Mechanism | Scope | Where | +| ------------------------ | ----------------------------- | ------------------------------------------------------------------------------------------------------------ | +| Provider circuit breaker | Whole provider | `src/shared/utils/circuitBreaker.ts`, persisted in `domain_circuit_breakers` | +| Connection cooldown | One account/key | `markAccountUnavailable()` in `src/sse/services/auth.ts`; consumed by `accountFallback.checkFallbackError()` | +| Model lockout | Provider + connection + model | `open-sse/services/accountFallback.ts`, persisted in `domain_lockout_state` | + +See [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) and the dedicated section in +[CLAUDE.md](../../CLAUDE.md). + +--- + +## 10. How to Contribute + +### Add a new provider + +1. Register in `src/shared/constants/providers.ts` (Zod-validated at load). +2. Add an executor in `open-sse/executors/` if custom logic is required + (extend `BaseExecutor`). +3. Add a translator in `open-sse/translator/` if it does not speak OpenAI format. +4. If OAuth-based, add config under `src/lib/oauth/providers/` and + `src/lib/oauth/services/`. +5. Register models in `open-sse/config/providerRegistry.ts` (or the format-specific + registry under `open-sse/config/`). +6. Write tests under `tests/unit/`. + +### Add a new API route + +1. Create `src/app/api/your-route/route.ts`. +2. Follow the pattern: CORS → Zod body validation → auth → handler delegation. +3. If new request shape: add the Zod schema in `src/shared/validation/schemas.ts`. +4. If management-only: add the path to `src/shared/constants/publicApiRoutes.ts` + (denylist for the public API surface). +5. Add tests under `tests/unit/`. +6. Update `docs/reference/API_REFERENCE.md` and `docs/reference/openapi.yaml`. + +### Add a new DB module + +1. Create `src/lib/db/yourModule.ts` and import `getDbInstance()` from `./core.ts`. +2. Export CRUD functions for your domain. +3. If new tables: add a migration under `src/lib/db/migrations/`, numbered + sequentially, idempotent, transactional. +4. Re-export from `src/lib/localDb.ts` (re-export only — **no logic**). +5. Add tests under `tests/unit/`. + +### Add a new MCP tool + +1. Add the tool definition under `open-sse/mcp-server/tools/` (or extend + `open-sse/mcp-server/schemas/tools.ts`). +2. Assign the appropriate scope(s) in `src/shared/constants/mcpScopes.ts`. +3. Register the tool in `open-sse/mcp-server/server.ts`. +4. Add tests under `open-sse/mcp-server/__tests__/`. +5. Update [MCP-SERVER.md](../frameworks/MCP-SERVER.md). + +### Add a new A2A skill + +See [A2A-SERVER.md § Adding a New Skill](../frameworks/A2A-SERVER.md). Skills live in +`src/lib/a2a/skills/` and are registered through the A2A task manager. + +--- + +## 11. Conventions + +- **Code style**: 2-space indent, double quotes, 100 char width, semicolons, + `es5` trailing commas — enforced by Prettier via `lint-staged`. +- **Imports**: external → internal (`@/`, `@omniroute/open-sse`) → relative. +- **Naming**: files `camelCase` or `kebab-case`, components `PascalCase`, + constants `UPPER_SNAKE`. +- **ESLint**: `no-eval`, `no-implied-eval`, `no-new-func` = `error` everywhere; + `no-explicit-any` = `warn` in `open-sse/` and `tests/`, error elsewhere. +- **TypeScript**: `strict: false` (legacy posture). Prefer explicit types over + inference for cross-module boundaries. +- **Database**: never write raw SQL in routes or handlers — always go through + `src/lib/db/` modules. Never add logic to `src/lib/localDb.ts`. +- **Errors**: try/catch with specific error types, log with pino context. Never + silently swallow errors in SSE streams; use abort signals for cleanup. +- **Security**: never use `eval()` / `new Function()` / implied eval. Validate + all inputs with Zod. Encrypt credentials at rest (AES-256-GCM). Keep + `src/shared/constants/upstreamHeaders.ts` denylist aligned with the + sanitize/validation layer. +- **Commits**: Conventional Commits — `feat(scope): subject`. Allowed scopes: + `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, + `a2a`, `memory`, `skills`. +- **Branches**: prefixes `feat/`, `fix/`, `refactor/`, `docs/`, `test/`, + `chore/`. Never commit directly to `main`. +- **Husky**: pre-commit runs `lint-staged` + `check:docs-sync` + + `check:any-budget:t11`; pre-push runs `npm run test:unit`. + +--- + +## 12. Hard Rules (from CLAUDE.md) + +1. Never commit secrets or credentials. +2. Never add logic to `src/lib/localDb.ts`. +3. Never use `eval()` / `new Function()` / implied eval. +4. Never commit directly to `main`. +5. Never write raw SQL in routes — always go through `src/lib/db/` modules. +6. Never silently swallow errors in SSE streams. +7. Always validate inputs with Zod schemas. +8. Always include tests when changing production code. +9. Coverage must stay ≥ 60% (statements, lines, functions, branches). + +--- + +## 13. See Also + +- [ARCHITECTURE.md](./ARCHITECTURE.md) — high-level architecture and module + responsibilities. +- [API_REFERENCE.md](../reference/API_REFERENCE.md) — public + management API reference. +- [FEATURES.md](../guides/FEATURES.md) — feature matrix and version highlights. +- [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) — circuit breaker, cooldown, + lockout deep dive. +- [AUTO-COMBO.md](../routing/AUTO-COMBO.md) — Auto Combo scoring and strategies. +- [MCP-SERVER.md](../frameworks/MCP-SERVER.md) — full MCP tool catalog + transports. +- [A2A-SERVER.md](../frameworks/A2A-SERVER.md) — A2A protocol skills and discovery. +- [COMPRESSION_GUIDE.md](../compression/COMPRESSION_GUIDE.md) — RTK + Caveman compression. +- [CLI-TOOLS.md](../reference/CLI-TOOLS.md) — CLI integrations. +- [ELECTRON_GUIDE.md](../guides/ELECTRON_GUIDE.md) (if present), [DOCKER_GUIDE.md](../guides/DOCKER_GUIDE.md), [FLY_IO_DEPLOYMENT_GUIDE.md](../ops/FLY_IO_DEPLOYMENT_GUIDE.md), [VM_DEPLOYMENT_GUIDE.md](../ops/VM_DEPLOYMENT_GUIDE.md), [TERMUX_GUIDE.md](../guides/TERMUX_GUIDE.md), [PWA_GUIDE.md](../guides/PWA_GUIDE.md) — deployment targets. +- [TROUBLESHOOTING.md](../guides/TROUBLESHOOTING.md) — common operational issues. +- [CONTRIBUTING.md](../../CONTRIBUTING.md) — contributor workflow. +- [CLAUDE.md](../../CLAUDE.md) — repo rules for Claude Code (the source of truth + for many of the conventions above). +- [AGENTS.md](../../AGENTS.md) — deeper architecture reference used by agents. diff --git a/docs/architecture/REPOSITORY_MAP.md b/docs/architecture/REPOSITORY_MAP.md new file mode 100644 index 0000000000..205396b9b0 --- /dev/null +++ b/docs/architecture/REPOSITORY_MAP.md @@ -0,0 +1,512 @@ +--- +title: "Repository Map" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Repository Map + +> **One-line description for every directory and root file.** +> Last updated: 2026-05-13 — OmniRoute v3.8.0 +> +> Use this map to navigate the codebase quickly. For deep dives, follow links to dedicated docs. + +## Top-level tree + +``` +OmniRoute/ +├── src/ # Next.js 16 application (UI + API routes + libs + domain + server) +├── open-sse/ # Streaming engine workspace (handlers, executors, translator, MCP server) +├── electron/ # Desktop wrapper (Electron 41 + electron-builder 26.10) +├── bin/ # CLI entry point and command handlers +├── scripts/ # Build, check, sync, and one-off scripts +├── docs/ # Public documentation (you are here) +├── tests/ # All test suites (unit, integration, e2e, protocols-e2e) +├── public/ # Next.js static assets, PWA manifest, service worker, icons +├── config/ # Static config files +├── images/ # Marketing / README image assets +├── .github/ # GitHub Actions workflows + issue templates + PR template +├── .husky/ # Git hooks (pre-commit, pre-push) +├── .claude/ # Claude Code slash commands (project-scoped) +├── .agents/ # Codex / generic agent workflows + skills (mirror of .claude/) +├── .vscode/ # VS Code workspace settings +├── _ideia/ # Planning notes (informal; not shipped) +├── _mono_repo/ # Historic subprojects (cloud, site, vscode-extension) +├── _references/ # Read-only reference clones from related OSS projects +├── _tasks/ # Per-release task tracking files (informal) +├── .issues/ # Local issue cache (gitignored) +├── .playwright-mcp/ # Playwright MCP test artifacts +├── coverage/ # c8 coverage output (gitignored) +├── logs/ # Runtime logs (gitignored) +├── node_modules/ # Dependencies (gitignored) +├── package/ # npm pack staging area (build artifact) +├── .next/ # Next.js build output (gitignored) +└── (root files — see below) +``` + +--- + +## Root files + +| File | Purpose | +| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | +| **README.md** | Marketing landing page + quick start + feature matrix (see also `llm.txt`) | +| **CHANGELOG.md** | Per-release changelog (auto-generated by `/version-bump-cc` skill) | +| **LICENSE** | MIT license text | +| **CLAUDE.md** | Project rules for Claude Code agents (hard rules, conventions, scenarios) | +| **AGENTS.md** | Same as CLAUDE.md but for non-Claude AI agents (Codex, Cursor, etc.) | +| **GEMINI.md** | Concise rules for Gemini-based agents (subset of CLAUDE.md) | +| **CONTRIBUTING.md** | Contributor guide: setup, conventional commits, testing, PR flow | +| **SECURITY.md** | Vulnerability reporting policy, supported versions, threat model | +| **CODE_OF_CONDUCT.md** | Contributor Covenant — community behavior expectations | +| **llm.txt** | Plain-text landing optimized for LLM crawlers (SEO for AI assistants) | +| **Tuto_Qdrant.md** | Tutorial for enabling Qdrant vector memory — **integration currently dormant** (see banner; primary memory docs in `docs/frameworks/MEMORY.md`) | +| **package.json** | npm manifest, scripts, dependencies, engines, c8 coverage gate | +| **package-lock.json** | Locked dependency tree | +| **tsconfig.json** | Root TypeScript config | +| **tsconfig.typecheck-core.json** | Typecheck config for `src/` core | +| **tsconfig.typecheck-noimplicit-core.json** | Strict (`noImplicitAny`) typecheck | +| **tsconfig.tsbuildinfo** | TS incremental build cache (gitignored) | +| **next.config.mjs** | Next.js 16 build configuration (standalone output) | +| **next-env.d.ts** | Next.js auto-generated env types | +| **eslint.config.mjs** | ESLint flat config (rules per project area) | +| **prettier.config.mjs** | Prettier formatting rules | +| **postcss.config.mjs** | PostCSS config for Tailwind/CSS pipeline | +| **playwright.config.ts** | Playwright E2E test config | +| **vitest.config.ts** | Vitest config (default suite) | +| **vitest.mcp.config.ts** | Vitest config for MCP server / autoCombo / cache suites | +| **sonar-project.properties** | SonarQube/SonarCloud config (code quality) | +| **Dockerfile** | Multi-stage Docker build (builder → runner-base → runner-cli) | +| **docker-compose.yml** | Dev compose with 4 profiles (base, cli, host, cliproxyapi) + redis sidecar | +| **docker-compose.prod.yml** | Production compose (port 20130, redis, named volumes) | +| **.dockerignore** | Files excluded from Docker context | +| **fly.toml** | Fly.io deployment config (region `sin`, port 20128, /data volume) | +| **.env.example** | Template env file (815 lines, auto-copied to `.env` on first install) | +| **.gitignore** | Git ignore patterns | +| **.npmignore** | npm publish exclusion list | +| **.npmrc** | npm config (registry, lockfile policy) | +| **.node-version** | Node version pin (used by nvm-compatible tools) | +| **.nvmrc** | Node version pin for nvm | + +--- + +## `src/` — Next.js application + +``` +src/ +├── app/ # App Router (pages + API routes + status pages + landing) +├── lib/ # Core libraries / domain modules (~50 subdirs + ~30 top-level files) +├── domain/ # Pure domain logic (policy engine, fallback, cost, lockout, comboResolver, assessment) +├── server/ # Server-only modules (authz pipeline, cors, auth middleware) — cannot import from client +├── shared/ # Shared between server and client where safe (constants, types, validation, contracts, utils) +├── i18n/ # next-intl config + per-locale message JSON (30+ locales) +├── middleware/ # Next.js middleware (request enrichment, locale detection) +├── mitm/ # MITM proxy helpers (Linux cert install, antigravity stealth) +├── models/ # Model adapter glue (legacy shim) +├── scripts/ # In-tree maintenance scripts (e.g., backfillAggregation) +├── sse/ # Legacy SSE handlers/services (chat.ts, chatHelpers.ts, services/auth.ts) +├── store/ # Legacy in-memory store (being phased out for src/lib/db) +├── types/ # Shared TS type files +├── instrumentation.ts # Next.js telemetry hook (browser + edge) +├── instrumentation-node.ts # Node-only instrumentation +├── server-init.ts # Server bootstrap (DB migrations, jobs, cleanup) +└── proxy.ts # HTTP-proxy entry shim +``` + +### `src/app/` — App Router (Next.js 16) + +| Path | Purpose | +| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `app/api/v1/` | Public OpenAI-compat API (~25 sub-routes: chat, completions, embeddings, files, batches, audio, images, videos, music, rerank, moderations, search, ws, agents, accounts, providers, etc.) | +| `app/api/v1beta/` | Gemini-style API endpoints | +| `app/api/` (non-v1) | Management/admin routes (~60 directories: providers, combos, settings, mcp, a2a, evals, memory, skills, webhooks, compliance, resilience, monitoring, tunnels, cli-tools, etc.) | +| `app/a2a/` | A2A JSON-RPC 2.0 entry point (`POST /a2a`) | +| `app/.well-known/agent.json/` | A2A Agent Card (discovery) | +| `app/(dashboard)/dashboard/` | Dashboard UI pages (~30 pages: providers, combos, settings, memory, skills, webhooks, evals, audit, batch, cache, costs, health, system, etc.) | +| `app/docs/` | Embedded documentation viewer (renders `docs/*.md`) | +| `app/landing/` | Marketing landing page | +| `app/login/`, `forgot-password/`, `forbidden/` | Auth-related pages | +| `app/{400,401,403,408,429,500,502,503}/` | HTTP error pages | +| `app/maintenance/`, `offline/`, `status/`, `privacy/`, `terms/`, `callback/` | Static/status pages | +| `app/layout.tsx`, `page.tsx`, `manifest.ts`, `globals.css` | Root layout, home, PWA manifest, global CSS | +| `app/error.tsx`, `global-error.tsx`, `not-found.tsx`, `loading.tsx` | Error boundaries | + +### `src/lib/` — Core libraries (~50 modules) + +| Module | Purpose | +| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `a2a/` | A2A protocol task manager, skills (5), streaming | +| `acp/` | CLI Agent Registry (local CLI discovery — see `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`) | +| `api/` | Shared API helpers (`requireManagementAuth`, validation) | +| `auth/` | Session, password hashing, token validation | +| `batches/` | OpenAI Batches API handlers | +| `catalog/` | Provider catalog Zod validation + capability resolution | +| `cloudAgent/` | Cloud Agents (Codex Cloud, Devin, Jules) — see `docs/frameworks/CLOUD_AGENT.md` | +| `combos/` | Combo resolution + reorder helpers | +| `compliance/` | Audit log + provider audit — see `docs/security/COMPLIANCE.md` | +| `compression/` | Compression engine glue (engines live in `open-sse/services/compression/`) | +| `config/` | Runtime config helpers | +| `db/` | 45+ domain DB modules + 55 migrations (always go through here for SQLite) | +| `display/` | UI formatting helpers (cost, latency, etc.) | +| `embeddings/` | Embeddings service helpers | +| `env/` | Env variable parsing + validation | +| `evals/` | Eval framework (suites, runner, runtime) — see `docs/frameworks/EVALS.md` | +| `guardrails/` | PII masker, prompt injection, vision bridge — see `docs/security/GUARDRAILS.md` | +| `jobs/` | Background jobs (cron-like) | +| `memory/` | Conversational memory (SQLite FTS5 + Qdrant) — see `docs/frameworks/MEMORY.md` | +| `monitoring/` | Health checks, metrics emission | +| `oauth/` | OAuth flows for 14 providers (claude, codex, antigravity, cursor, github, gemini, kimi-coding, kilocode, cline, qwen, kiro, qoder, gitlab-duo, windsurf) | +| `plugins/` | Plugin registry | +| `promptCache/` | Anthropic-style prompt cache breakpoints | +| `skills/` | Skills framework (built-in + marketplace + SkillsSH) — see `docs/frameworks/SKILLS.md` | +| `webhookDispatcher.ts` | HMAC webhook delivery — see `docs/frameworks/WEBHOOKS.md` | +| `cloudflaredTunnel.ts`, `ngrokTunnel.ts` | Tunnel managers — see `docs/ops/TUNNELS_GUIDE.md` | +| `oneproxySync.ts`, `oneproxyRotator.ts` | 1proxy free proxy marketplace — see `docs/ops/PROXY_GUIDE.md` | +| `cloudSync.ts`, `initCloudSync.ts` | Optional cloud sync of state | +| `localDb.ts` | Re-export barrel for db modules (no logic — re-exports only) | +| `cacheLayer.ts`, `idempotencyLayer.ts` | Request caching + idempotency | +| (~30 more top-level files) | Specialized helpers (logEnv, modelsDevSync, piiSanitizer, etc.) | + +### `src/db/` — Database (45+ modules + 55 migrations) + +| Subdir | Purpose | +| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `db/core.ts` | `getDbInstance()` singleton with WAL journaling | +| `db/migrations/` | 55 versioned SQL files (idempotent, transactional, numbered `001`..`055`) | +| `db/<domain>.ts` | One module per domain: providers, combos, apiKeys, users, sessions, usage, audit*log, webhooks, skills, memory_entries, cloud_agent_tasks, evals*\*, reasoning_cache, etc. | + +### `src/domain/` + +| Module | Purpose | +| ---------------------- | ----------------------------------------------------------------------- | +| `policy.ts` | Policy engine | +| `fallbackPolicy.ts` | Fallback decision tree | +| `costRules.ts` | Cost calculation rules | +| `lockoutPolicy.ts` | Model/connection lockout policy | +| `tagRouter.ts` | Tag-based routing | +| `comboResolver.ts` | Combo resolution (used by combo engine) | +| `modelAvailability.ts` | Per-model availability check | +| `assessment/` | Model assessment (Phase 1 of RFC-AUTO-ASSESSMENT — see `docs/archive/`) | + +### `src/server/` + +| Module | Purpose | +| -------- | ---------------------------------------------------------------------------------------------------- | +| `authz/` | Authorization pipeline: `classify` → `policies` → `enforce` — see `docs/architecture/AUTHZ_GUIDE.md` | +| `cors/` | CORS configuration | +| `auth/` | Session middleware | + +### `src/shared/` + +| Module | Purpose | +| -------------------------------- | ---------------------------------------------------------------------- | +| `constants/providers.ts` | **177 providers** with Zod validation (source of truth) | +| `constants/cliTools.ts` | External CLI tool registry | +| `constants/routingStrategies.ts` | **14 routing strategies** with priorities | +| `constants/publicApiRoutes.ts` | Routes that require Bearer (vs management) auth | +| `constants/upstreamHeaders.ts` | Header denylist for upstream requests | +| `validation/schemas.ts` | ~80 Zod schemas (single source of truth for API contracts) | +| `validation/helpers.ts` | Zod validation helpers (`validateBody`, etc.) | +| `types/` | Shared TS types | +| `contracts/` | Public API contracts (consumed by `files:` in `package.json`) | +| `utils/circuitBreaker.ts` | Provider circuit breaker (see `docs/architecture/RESILIENCE_GUIDE.md`) | +| `utils/apiAuth.ts` | API key validation, scope checking | +| `utils/fetchTimeout.ts` | Timeout/abort wrappers for upstream fetch | + +--- + +## `open-sse/` — Streaming Engine Workspace + +Separate npm workspace (`@omniroute/open-sse`). Handles request processing + provider execution. + +``` +open-sse/ +├── handlers/ # 15 files (11 handlers + 4 helpers): chatCore, responsesHandler, embeddings, audio, image, video, music, rerank, moderations, search, etc. +├── executors/ # 31 provider-specific executors (extend BaseExecutor) +├── translator/ # Format converters (9 request, 8 response, 9 helpers) +├── transformer/ # Responses API ↔ Chat Completions (TransformStream) +├── services/ # ~80+ service modules (combo, accountFallback, autoCombo, reasoningCache, claude code/chatgpt stealth, modelDeprecation, taskAwareRouter, workflowFSM, etc.) +├── mcp-server/ # MCP server (37 tools, 3 transports, ~13 scopes) +├── config/ # Provider/model registries, header config, model aliases +├── utils/ # TLS client, proxy fetch/dispatcher, network helpers +├── index.ts # Workspace entry +├── package.json # Workspace manifest +├── tsconfig.json # Workspace TS config +└── types.d.ts # Workspace type declarations +``` + +### `open-sse/mcp-server/` + +| Path | Purpose | +| --------------------------- | ------------------------------------------------------------------------------ | +| `server.ts` | MCP server lifecycle (stdio + HTTP transports) | +| `httpTransport.ts` | HTTP Streamable + SSE transports (`/api/mcp/sse`, `/api/mcp/stream`) | +| `audit.ts` | Audit logging to `mcp_tool_audit` table | +| `scopeEnforcement.ts` | Per-tool scope validation | +| `runtimeHeartbeat.ts` | Health heartbeat to `DATA_DIR/runtime/mcp-heartbeat.json` | +| `descriptionCompressor.ts` | Compress tool description metadata to save context | +| `schemas/tools.ts` | 30 base tool definitions + scopes | +| `tools/advancedTools.ts` | Advanced tool implementations | +| `tools/memoryTools.ts` | 3 memory tools (search/add/clear) | +| `tools/skillTools.ts` | 4 skill tools (list/enable/execute/executions) | +| `tools/compressionTools.ts` | 5 compression tools | +| `README.md` | Internal MCP server README (cross-linked from `docs/frameworks/MCP-SERVER.md`) | + +--- + +## `electron/` — Desktop Wrapper + +| File | Purpose | +| ---------------- | --------------------------------------------------------------------------------- | +| `main.js` | Electron main process (BrowserWindow, embedded Next.js server, tray, auto-update) | +| `preload.js` | IPC bridge (contextBridge → `window.omniroute`) | +| `package.json` | electron-builder config + Electron 41 + electron-builder 26.10 deps | +| `assets/` | App icons (Windows .ico, macOS .icns, Linux .png) | +| `dist-electron/` | Build output (gitignored) | +| `types.d.ts` | Type declarations for renderer bridge | +| `README.md` | Internal Electron README (see also `docs/guides/ELECTRON_GUIDE.md`) | + +--- + +## `bin/` — CLI + +| File | Purpose | +| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `omniroute.mjs` | Main CLI entry — `omniroute serve`, `omniroute setup`, `omniroute doctor`, `omniroute providers`, `omniroute combos`, etc. | +| `reset-password.mjs` | Standalone password reset CLI | +| `cli/commands/setup.mjs` | Interactive + non-interactive setup wizard | +| `cli/commands/doctor.mjs` | System health diagnostics (8+ checks) | +| `cli/commands/providers.mjs` | Provider list/test/validate | +| `cli/{args,data-dir,encryption,io,provider-catalog,provider-store,provider-test,settings-store,sqlite}.mjs` | CLI helper modules | +| `nodeRuntimeSupport.mjs` | Validate supported Node.js version on install | + +--- + +## `scripts/` — Build & Check Scripts + +| Script | Purpose | +| ----------------------------------- | -------------------------------------------------------------------------- | +| `run-next.mjs` | Dev/start runner with env hydration | +| `build-next-isolated.mjs` | Standalone build (Next.js 16 standalone) | +| `prepublish.ts` | Package preparation before `npm pack` | +| `postinstall.mjs` | Auto-create `.env` from `.env.example` on first install | +| `sync-env.mjs` | Re-sync `.env` keys with `.env.example` | +| `check-cycles.mjs` | Detect circular dependencies | +| `check-route-validation.mjs` | Validate all API routes have Zod validation | +| `check-t11-any-budget.mjs` | Enforce explicit `any` budget per file | +| `check-docs-sync.mjs` | Validate docs version sync (existing pre-commit) | +| **`check-env-doc-sync.mjs`** | NEW: cross-check env vars in code vs `.env.example` vs `ENVIRONMENT.md` | +| **`check-docs-counts-sync.mjs`** | NEW: validate counts (executors, strategies, OAuth, A2A skills) match docs | +| **`check-deprecated-versions.mjs`** | NEW: flag stale versions/dates in docs | +| `check-supported-node-runtime.ts` | Validate current Node version is supported | +| `check-pr-test-policy.mjs` | Enforce "tests required" rule on production code changes | +| **`gen-provider-reference.ts`** | NEW: auto-generate `docs/reference/PROVIDER_REFERENCE.md` from catalog | +| `generate-docs-index.mjs` | Build `src/app/docs/lib/docs-auto-generated.ts` from `docs/*.md` | +| `i18n/generate-multilang.mjs` | Translate UI strings + docs via Google Translate | +| `i18n_autotranslate.py` | LLM-based doc translation pipeline | +| `validate_translation.py` | Per-locale translation validation | +| `check_translations.py` | Code-side i18n key check | +| `run-playwright-tests.mjs` | Playwright E2E runner | +| `run-protocol-clients-tests.mjs` | MCP/A2A E2E runner | +| `run-ecosystem-tests.mjs` | Ecosystem (provider integration) tests | +| `test-report-summary.mjs` | Generate coverage summary markdown | +| `smoke-electron-packaged.mjs` | Smoke-test packaged Electron build | +| `native-binary-compat.mjs` | Validate native deps (`better-sqlite3`) match Electron's Node | +| `validate-pack-artifact.ts` | Validate npm pack output | +| `responses-ws-proxy.mjs` | WebSocket bridge for Codex Responses API | +| `v1-ws-bridge.mjs` | WebSocket bridge for `/api/v1/ws` endpoint | +| `standalone-server-ws.mjs` | Standalone WS server runner | +| `system-info.mjs` | Print system/runtime info for support | +| `healthcheck.mjs` | One-shot health check (used by Docker HEALTHCHECK) | +| `uninstall.mjs` | Clean uninstall script | + +--- + +## `docs/` — Public Documentation (44 files + 4 subdirs) + +### Top-level guides + +| Doc | Purpose | +| --------------------------- | ------------------------------------------------------------------------------------- | +| `ARCHITECTURE.md` | High-level architecture, subsystem map, dashboard surface | +| `CODEBASE_DOCUMENTATION.md` | Engineering reference: directories, modules, conventions | +| `FEATURES.md` | Feature matrix with v3.8 highlights | +| `USER_GUIDE.md` | End-user manual (setup, models, combos, CLIs, audio, etc.) | +| `API_REFERENCE.md` | API endpoint reference with auth model | +| `openapi.yaml` | OpenAPI 3.0 spec (121 paths) | +| `SETUP_GUIDE.md` | Install methods (npm, npx, Docker, Electron, Termux, source) | +| `ENVIRONMENT.md` | All env vars (~219 used in code, ~810 lines `.env.example`) | +| `TROUBLESHOOTING.md` | Common errors + v3.8.0 known issues | +| `RELEASE_CHECKLIST.md` | Full release flow (skills, husky, conventional commits, deploy) | +| `COVERAGE_PLAN.md` | Coverage goals and current state | +| `FREE_TIERS.md` | Curated free-tier providers (48+ free + 11 OAuth) | +| `CLI-TOOLS.md` | External CLI integrations + Internal OmniRoute CLI | +| `I18N.md` | i18n architecture, adding a language, 30 locales | +| `UNINSTALL.md` | Clean uninstall steps | +| `PROVIDER_REFERENCE.md` | **Auto-generated** catalog of 177 providers (regen: `npm run gen:provider-reference`) | + +### Subsystem deep-dives + +| Doc | Purpose | +| -------------------------- | ------------------------------------------------------------------- | +| `MCP-SERVER.md` | MCP server: 37 tools, 3 transports, ~13 scopes, REST endpoints | +| `A2A-SERVER.md` | A2A v0.3: JSON-RPC, 5 skills, REST helpers, agent card | +| `AGENT_PROTOCOLS_GUIDE.md` | Unified guide: A2A vs ACP vs Cloud Agents | +| `CLOUD_AGENT.md` | Codex Cloud / Devin / Jules orchestration | +| `SKILLS.md` | Skills framework (built-in + marketplace + SkillsSH + sandbox) | +| `MEMORY.md` | Memory system (SQLite FTS5 + Qdrant) | +| `EVALS.md` | Eval framework (suites, runs, rubrics) | +| `GUARDRAILS.md` | PII masker, prompt injection, vision bridge | +| `COMPLIANCE.md` | Audit log, retention, noLog opt-out | +| `WEBHOOKS.md` | HMAC-signed webhook delivery | +| `REASONING_REPLAY.md` | Hybrid memory/SQLite cache for `reasoning_content` | +| `AUTHZ_GUIDE.md` | Authorization pipeline (`classify` → `policies` → `enforce`) | +| `RESILIENCE_GUIDE.md` | Circuit breaker + cooldown + model lockout | +| `STEALTH_GUIDE.md` | TLS fingerprinting (JA3/JA4), Claude Code CCH, MITM cert | +| `AUTO-COMBO.md` | Auto Combo engine (9-factor scoring, 4 mode packs, virtual factory) | + +### Compression + +| Doc | Purpose | +| ------------------------------- | ---------------------------------------- | +| `COMPRESSION_GUIDE.md` | Overview of compression modes + roadmap | +| `COMPRESSION_ENGINES.md` | Caveman + RTK engines, registry contract | +| `COMPRESSION_RULES_FORMAT.md` | Caveman rule pack JSON schema | +| `COMPRESSION_LANGUAGE_PACKS.md` | Per-language rule pack inventory | +| `RTK_COMPRESSION.md` | RTK declarative pipeline (49 filters) | + +### Deployment + +| Doc | Purpose | +| ---------------------------- | ----------------------------------------------------------------- | +| `DOCKER_GUIDE.md` | Docker build, profiles (base/cli/host/cliproxyapi), Redis sidecar | +| `VM_DEPLOYMENT_GUIDE.md` | Generic VM/VPS deployment (Ubuntu/Debian + nginx + systemd) | +| `FLY_IO_DEPLOYMENT_GUIDE.md` | Fly.io deployment (currently Chinese-only) | +| `TERMUX_GUIDE.md` | Android headless via Termux | +| `PWA_GUIDE.md` | Progressive Web App install + service worker | +| `ELECTRON_GUIDE.md` | Desktop app build + sign + distribute | +| `TUNNELS_GUIDE.md` | Cloudflared + ngrok + Tailscale Funnel | +| `PROXY_GUIDE.md` | 4-level outbound proxy + 1proxy marketplace | + +### Subdirectories + +| Subdir | Purpose | +| ------------------------- | ------------------------------------------------------------------------------------- | +| `docs/archive/` | Archived/historical docs (e.g., `RFC-AUTO-ASSESSMENT-DRAFT.md` — superseded by EVALS) | +| `docs/i18n/` | Localized doc translations (~40 locales) | +| `docs/screenshots/` | Image assets for guides | +| `docs/superpowers/plans/` | Implementation plans (generated by `superpowers:writing-plans` skill) | + +--- + +## `tests/` — Test Suites + +| Subdir | Type | Runner | +| ---------------------- | --------------------------------------- | --------------------------------------- | +| `tests/unit/` | Unit tests (~500 files, fastest) | Node native test runner | +| `tests/integration/` | Multi-module + DB integration tests | Node native test runner (concurrency 1) | +| `tests/e2e/` | UI + workflow E2E | Playwright | +| `tests/protocols-e2e/` | MCP + A2A real-client E2E | Custom protocol clients | +| `tests/ecosystem/` | Provider integration (network-touching) | Node native test runner | + +--- + +## `public/` — Static Assets + +| Path | Purpose | +| ------------------- | ---------------------------------------------------------------- | +| `public/` (root) | Favicons, robots.txt, manifest, service worker, marketing images | +| `public/providers/` | Provider logo PNG/SVG (used in dashboard) | + +--- + +## `config/` — Static Configs + +Shipped configuration templates and sample files (referenced by setup wizard). + +--- + +## `.github/` — GitHub Integration + +| Path | Purpose | +| ---------------------------------- | -------------------------------------------------------------- | +| `.github/workflows/` | GitHub Actions CI/CD workflows (lint, test, coverage, release) | +| `.github/ISSUE_TEMPLATE/` | Bug/feature issue templates | +| `.github/PULL_REQUEST_TEMPLATE.md` | PR template | +| `.github/dependabot.yml` | Dependency update config | + +--- + +## `.husky/` — Git Hooks + +| File | Purpose | +| ------------ | ----------------------------------------------------------------- | +| `pre-commit` | Runs `lint-staged + check-docs-sync + check:any-budget:t11` | +| `pre-push` | Currently disabled (commented). Run `npm run test:unit` manually. | +| `_/` | Husky internals | + +--- + +## `.claude/` — Claude Code Slash Commands + +| File | Purpose | +| ----------------------------------------------------------------- | -------------------------------------------------- | +| `commands/version-bump-cc.md` | `/version-bump-cc` — bump version + auto-changelog | +| `commands/generate-release-cc.md` | `/generate-release-cc` — full release workflow | +| `commands/deploy-vps-{local,akamai,both}-cc.md` | Deploy to VPS | +| `commands/capture-release-evidences-cc.md` | Browser-record new features as WebP | +| `commands/review-{prs,discussions}-cc.md` | Triage GitHub PRs/discussions | +| `commands/{issue-triage,resolve-issues,implement-features}-cc.md` | Issue workflows | +| `settings.local.json` | Per-project Claude Code settings | + +--- + +## `.agents/` — Generic Agent Workflows (Codex / Cursor / etc.) + +| Path | Purpose | +| ------------------------ | ------------------------------------------------------- | +| `workflows/*-ag.md` | 11 workflow definitions (mirror of `.claude/commands/`) | +| `skills/<name>/SKILL.md` | 9 skill definitions with Codex Execution Notes | + +> **Note:** Workflows and commands are currently identical byte-by-byte. If `.agents/` is meant to target a different agent runtime (Codex), the variants need to diverge meaningfully. + +--- + +## `_ideia/`, `_mono_repo/`, `_references/`, `_tasks/` — Out-of-tree + +These underscore-prefixed directories hold non-shipping content: + +- **`_ideia/`** — design notes (defer / notfit / viable categories) +- **`_mono_repo/`** — historic subprojects (omnirouteCloud, omnirouteSite, vscode-extension) +- **`_references/`** — read-only clones of related OSS projects (LiteLLM, 9router, ClawRouter, CLIProxyAPI, modelrelay, new-api, etc.) for cross-reference during development +- **`_tasks/`** — per-release task tracking files (informal) + +Not included in `npm pack` output. See `.npmignore`. + +--- + +## Generated / Gitignored + +| Path | Purpose | +| ---------------------- | ----------------------------- | +| `node_modules/` | npm dependencies | +| `.next/` | Next.js build output | +| `coverage/` | c8 coverage reports | +| `logs/` | Runtime logs | +| `package/` | npm pack staging | +| `.playwright-mcp/` | Playwright MCP test artifacts | +| `.issues/` | Local issue cache | +| `tsconfig.tsbuildinfo` | TS incremental cache | + +--- + +## Navigation tips + +- **New contributor?** Read `CONTRIBUTING.md` → `CLAUDE.md` → `docs/architecture/ARCHITECTURE.md` → `docs/architecture/CODEBASE_DOCUMENTATION.md`. +- **Adding a provider?** Follow `docs/architecture/ARCHITECTURE.md § Adding a New Provider` + cross-check `docs/reference/PROVIDER_REFERENCE.md`. +- **Adding a route?** `docs/architecture/ARCHITECTURE.md § Adding a New API Route` + `src/shared/validation/schemas.ts`. +- **Adding an MCP tool?** `docs/frameworks/MCP-SERVER.md § Adding a Tool`. +- **Adding an A2A skill?** `docs/frameworks/A2A-SERVER.md § Adding a New Skill`. +- **Running locally?** `docs/guides/SETUP_GUIDE.md`. +- **Deploying?** `docs/guides/DOCKER_GUIDE.md` / `docs/ops/VM_DEPLOYMENT_GUIDE.md` / `docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md`. +- **Releasing?** `docs/ops/RELEASE_CHECKLIST.md` (and `/generate-release-cc` Claude Code skill). diff --git a/docs/architecture/RESILIENCE_GUIDE.md b/docs/architecture/RESILIENCE_GUIDE.md new file mode 100644 index 0000000000..8561b9e179 --- /dev/null +++ b/docs/architecture/RESILIENCE_GUIDE.md @@ -0,0 +1,147 @@ +--- +title: "Resilience Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Resilience Guide + +OmniRoute has three distinct but related resilience mechanisms. Each has a different scope and purpose. Keep them separate when debugging routing behavior. + +![3-layer resilience model](../diagrams/exported/resilience-3layers.svg) + +> Source: [diagrams/resilience-3layers.mmd](../diagrams/resilience-3layers.mmd) + +## 1. Provider Circuit Breaker + +**Scope:** entire provider (e.g., `glm`, `openai`, `anthropic`). + +**Purpose:** stop sending traffic to a provider that is repeatedly failing at the upstream/service level. + +**Implementation:** + +- Core class: `src/shared/utils/circuitBreaker.ts` +- Wiring: `src/sse/handlers/chatHelpers.ts`, `src/sse/handlers/chat.ts` +- Status API: `GET /api/monitoring/health` +- Reset API: `POST /api/resilience/reset` +- Wrappers: `open-sse/services/accountFallback.ts` +- DB table: `domain_circuit_breakers` + +**States:** + +- `CLOSED` — normal traffic allowed +- `OPEN` — provider temporarily blocked; combo routing skips it +- `HALF_OPEN` — reset timeout elapsed; probe request allowed + +**Defaults (`open-sse/config/constants.ts`):** + +| Class | Threshold | Reset timeout | +| ------- | ---------- | ------------- | +| OAuth | 3 failures | 60s | +| API-key | 5 failures | 30s | +| Local | 2 failures | 15s | + +**Trip codes:** only provider-level statuses `[408, 500, 502, 503, 504]`. Do NOT trip for account-level errors (most 401/403/429 — those belong to cooldown or lockout). + +**Lazy recovery:** when `OPEN` expires, `getStatus()`, `canExecute()`, `getRetryAfterMs()` refresh state to `HALF_OPEN`. No background timer needed. + +--- + +## 2. Connection Cooldown + +**Scope:** single provider connection/account/key. + +**Purpose:** skip one bad key while other connections for the same provider keep serving. + +**Implementation:** + +- Mark unavailable: `src/sse/services/auth.ts::markAccountUnavailable()` +- Selection: `getProviderCredentials*` in same file +- Cooldown calc: `open-sse/services/accountFallback.ts::checkFallbackError()` +- Settings: `src/lib/resilience/settings.ts` + +**Fields per connection:** + +- `rateLimitedUntil` — timestamp until cooldown expires +- `testStatus: "unavailable"` +- `lastError`, `lastErrorType`, `errorCode` +- `backoffLevel` — exponential backoff counter + +**Default cooldowns:** + +- OAuth base: 5s +- API-key base: 3s +- API-key 429: prefers upstream `Retry-After`/reset headers/parseable reset text +- Backoff: `baseCooldownMs * 2 ** failureIndex` + +**Anti-thundering-herd guard:** prevents concurrent failures from over-extending cooldown or double-incrementing `backoffLevel`. + +**Terminal states (NOT cooldowns):** + +- `banned` +- `expired` +- `credits_exhausted` + +These persist until credentials change or an operator resets them. Do not overwrite terminal states with transient cooldown state. + +**Lazy recovery:** when `rateLimitedUntil` is past, connection becomes eligible again. On successful use, `clearAccountError()` clears all error fields. + +--- + +## 3. Model Lockout + +**Scope:** provider + connection + model triple. + +**Purpose:** avoid disabling a whole connection when only one model is unavailable or quota-limited. + +**Examples:** + +- Per-model quota providers returning 429 +- Local providers returning 404 for one missing model +- Provider-specific mode/model permission failures (e.g., Grok modes) + +**Implementation:** `open-sse/services/accountFallback.ts` — `lockModel()`, `clearModelLock()`, `getAllModelLockouts()`. + +### Model Cooldowns Dashboard (v3.8.0) + +UI: Settings → Model Cooldowns (`src/app/(dashboard)/dashboard/settings/components/ModelCooldownsCard.tsx`) + +Lists active lockouts with: provider, connection, model, reason, expiresAt. Operators can manually re-enable a model from the card. + +**REST API:** + +- `GET /api/resilience/model-cooldowns` — list active lockouts +- `DELETE /api/resilience/model-cooldowns` — manual re-enable. Body: `{provider, connection, model}`. Auth: management. + +--- + +## Other Resilience Features + +- **14 routing strategies** (priority, weighted, round-robin, context-relay, fill-first, p2c, random, least-used, cost-optimized, reset-aware, strict-random, auto, lkgp, context-optimized) — see [AUTO-COMBO.md](../routing/AUTO-COMBO.md). +- **Reset-aware routing** (v3.8.0) — prioritizes connections by quota reset time. +- **Background mode degradation** — Responses API `background: true` degraded to sync with warning. +- **Dynamic tool limit detection** — backs off providers when tool count limits hit. + +--- + +## Debugging + +- All keys for a provider skipped → check both circuit breaker state AND each connection's `rateLimitedUntil`/`testStatus`. +- Provider permanently excluded after reset window → code reading raw `state` instead of `getStatus()`/`canExecute()`. +- One key fails, others should work → prefer connection cooldown over circuit breaker. +- Only one model fails → prefer model lockout over connection cooldown. +- State should self-recover but doesn't → check for future timestamp + read path that refreshes expired state. Permanent statuses require manual changes. + +--- + +## TLS Fingerprinting & Stealth + +Provider-specific stealth (JA3/JA4, CCH, obfuscation) is separately documented — see [STEALTH_GUIDE.md](../security/STEALTH_GUIDE.md). + +--- + +## See Also + +- [Architecture Guide](./ARCHITECTURE.md) — System architecture and internals +- [User Guide](../guides/USER_GUIDE.md) — Providers, combos, CLI integration +- [Auto-Combo Engine](../routing/AUTO-COMBO.md) — 6-factor scoring, mode packs diff --git a/docs/COMPRESSION_ENGINES.md b/docs/compression/COMPRESSION_ENGINES.md similarity index 88% rename from docs/COMPRESSION_ENGINES.md rename to docs/compression/COMPRESSION_ENGINES.md index 81dc01c1ba..5dcdaa75b4 100644 --- a/docs/COMPRESSION_ENGINES.md +++ b/docs/compression/COMPRESSION_ENGINES.md @@ -1,3 +1,9 @@ +--- +title: "Compression Engines" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Compression Engines OmniRoute compression is built around engine contracts. A mode can run one engine directly @@ -21,13 +27,24 @@ The registry lives in `open-sse/services/compression/engines/registry.ts`. Engin contract: - `id`: stable engine id such as `caveman` or `rtk` -- `label`: dashboard-readable name -- `supports(mode)`: whether the engine can execute a compression mode -- `compress(input)`: transforms text/messages and returns stats +- `apply(text, config)`: legacy execution path used by stacked pipelines +- `compress(input, config)`: primary execution path returning text + stats +- `getConfigSchema()`: returns the JSON-Schema-like shape of valid config +- `validateConfig(config)`: returns `{ valid, errors[] }` + +Registration uses `registerCompressionEngine(engine)` (or `registerEngine` for advanced cases), +which calls `assertValidEngine()` and `validateConfig(defaultConfig)` before accepting. +Use `unregisterCompressionEngine(id)` to remove an engine at runtime. `strategySelector.ts` registers the built-in engines before compression runs. This lets preview, runtime compression, stacked mode, tests, and future engines use the same execution path. +### MCP description compression (related) + +A separate registry compresses MCP tool description metadata at registry-level — see +`open-sse/mcp-server/descriptionCompressor.ts` and [MCP-SERVER.md](../frameworks/MCP-SERVER.md). It reuses +Caveman rules but operates on tool metadata, not request payloads. + ## Caveman Caveman mode focuses on semantic condensation of normal prose: @@ -64,7 +81,7 @@ RTK mode focuses on command and tool output: The dashboard surface is `Dashboard -> Context & Cache -> RTK`. Operational details for custom filters, trust, verify, and raw-output recovery live in -[`RTK_COMPRESSION.md`](RTK_COMPRESSION.md). +[`RTK_COMPRESSION.md`](./RTK_COMPRESSION.md). RTK upstream reports `60-90%` savings for command-output compression. Its README example shows a 30-minute Claude Code session going from `~118,000` tokens to `~23,900`, or `79.7%` saved. diff --git a/docs/COMPRESSION_GUIDE.md b/docs/compression/COMPRESSION_GUIDE.md similarity index 93% rename from docs/COMPRESSION_GUIDE.md rename to docs/compression/COMPRESSION_GUIDE.md index 88213bfc63..12da9d2910 100644 --- a/docs/COMPRESSION_GUIDE.md +++ b/docs/compression/COMPRESSION_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "🗜️ Prompt Compression Guide — OmniRoute" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # 🗜️ Prompt Compression Guide — OmniRoute > Save 15-95% on eligible context automatically. For a quick overview, see the [README Compression section](../README.md#%EF%B8%8F-prompt-compression--save-15-95-eligible-tokens-automatically). @@ -267,10 +273,10 @@ RTK mode is inspired by **[RTK - Rust Token Killer](https://github.com/rtk-ai/rt ## See Also -- [Environment Config](ENVIRONMENT.md) — Compression environment variables -- [Architecture Guide](ARCHITECTURE.md) — Compression pipeline internals -- [User Guide](USER_GUIDE.md) — Getting started with compression -- [RTK Compression](RTK_COMPRESSION.md) — RTK filters, trust model, verify gate, raw-output recovery -- [Compression Engines](COMPRESSION_ENGINES.md) — Caveman, RTK, stacked, APIs, MCP, dashboard -- [Compression Rules Format](COMPRESSION_RULES_FORMAT.md) — JSON rule-pack format -- [Compression Language Packs](COMPRESSION_LANGUAGE_PACKS.md) — Language-specific Caveman rules +- [Environment Config](../reference/ENVIRONMENT.md) — Compression environment variables +- [Architecture Guide](../architecture/ARCHITECTURE.md) — Compression pipeline internals +- [User Guide](../guides/USER_GUIDE.md) — Getting started with compression +- [RTK Compression](./RTK_COMPRESSION.md) — RTK filters, trust model, verify gate, raw-output recovery +- [Compression Engines](./COMPRESSION_ENGINES.md) — Caveman, RTK, stacked, APIs, MCP, dashboard +- [Compression Rules Format](./COMPRESSION_RULES_FORMAT.md) — JSON rule-pack format +- [Compression Language Packs](./COMPRESSION_LANGUAGE_PACKS.md) — Language-specific Caveman rules diff --git a/docs/COMPRESSION_LANGUAGE_PACKS.md b/docs/compression/COMPRESSION_LANGUAGE_PACKS.md similarity index 62% rename from docs/COMPRESSION_LANGUAGE_PACKS.md rename to docs/compression/COMPRESSION_LANGUAGE_PACKS.md index 805a7db1fc..0fa53029d8 100644 --- a/docs/COMPRESSION_LANGUAGE_PACKS.md +++ b/docs/compression/COMPRESSION_LANGUAGE_PACKS.md @@ -1,3 +1,9 @@ +--- +title: "Compression Language Packs" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Compression Language Packs Caveman compression can load language-specific rule packs in addition to the built-in English rules. @@ -12,16 +18,20 @@ Language packs live under: open-sse/services/compression/rules/<language>/ ``` -Current shipped packs include: +Current shipped packs (verified against `rules/` directory contents): -| Language | Directory | -| ------------------- | -------------- | -| English | `rules/en/` | -| Portuguese (Brazil) | `rules/pt-BR/` | -| Spanish | `rules/es/` | -| German | `rules/de/` | -| French | `rules/fr/` | -| Japanese | `rules/ja/` | +| Language | Directory | Rule categories present | +| ------------------- | -------------- | --------------------------------------------------- | +| English | `rules/en/` | `context`, `dedup`, `filler`, `structural`, `ultra` | +| Spanish | `rules/es/` | `context`, `dedup`, `filler`, `structural`, `ultra` | +| Portuguese (Brazil) | `rules/pt-BR/` | `context`, `filler`, `structural` | +| German | `rules/de/` | `context`, `filler`, `structural` | +| French | `rules/fr/` | `context`, `filler`, `structural` | +| Japanese | `rules/ja/` | `context`, `filler`, `structural` | + +> **Parity note:** `en` and `es` packs have the full 5 categories; `pt-BR`, `de`, `fr`, `ja` ship 3 categories. The missing `dedup` and `ultra` categories silently fall back to the English built-ins. Contributions welcome to add `dedup.json` and `ultra.json` for the smaller packs. +> +> The canonical category list and per-category schema live in [`open-sse/services/compression/rules/_schema.json`](../../open-sse/services/compression/rules/_schema.json) (JSON Schema draft 2020-12). ## Language Detection @@ -58,7 +68,7 @@ used when Caveman compresses message text. ## Adding a Language Pack 1. Create `open-sse/services/compression/rules/<language>/<pack>.json`. -2. Use the Caveman rule format from `docs/COMPRESSION_RULES_FORMAT.md`. +2. Use the Caveman rule format from `docs/compression/COMPRESSION_RULES_FORMAT.md`. 3. Keep replacements conservative and avoid changing code, identifiers, URLs, or JSON. 4. Add or update tests for language selection and replacement behavior. 5. Expose new dashboard/i18n labels if the language appears in UI selectors. diff --git a/docs/COMPRESSION_RULES_FORMAT.md b/docs/compression/COMPRESSION_RULES_FORMAT.md similarity index 96% rename from docs/COMPRESSION_RULES_FORMAT.md rename to docs/compression/COMPRESSION_RULES_FORMAT.md index e54343968b..e874c6c9fd 100644 --- a/docs/COMPRESSION_RULES_FORMAT.md +++ b/docs/compression/COMPRESSION_RULES_FORMAT.md @@ -1,8 +1,17 @@ +--- +title: "Compression Rules Format" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Compression Rules Format Compression rules are JSON files loaded at runtime. They are intentionally data-only so new language packs and RTK command filters can be reviewed without changing engine code. +> **Canonical schema (source of truth):** [`open-sse/services/compression/rules/_schema.json`](../../open-sse/services/compression/rules/_schema.json) (JSON Schema draft 2020-12). +> The examples below are illustrative — when in doubt, validate your pack against `_schema.json`. + ## Caveman Rule Packs Caveman rule packs live under: diff --git a/docs/RTK_COMPRESSION.md b/docs/compression/RTK_COMPRESSION.md similarity index 98% rename from docs/RTK_COMPRESSION.md rename to docs/compression/RTK_COMPRESSION.md index f675c93d25..43df17ecdf 100644 --- a/docs/RTK_COMPRESSION.md +++ b/docs/compression/RTK_COMPRESSION.md @@ -1,3 +1,9 @@ +--- +title: "RTK Compression" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # RTK Compression RTK compression is OmniRoute's command-aware compression engine for terminal and tool output. It is @@ -70,7 +76,7 @@ skipped and reported by `/api/context/rtk/filters` diagnostics. Invalid built-in ## Filter DSL -Filters use the JSON schema described in [Compression Rules Format](COMPRESSION_RULES_FORMAT.md). +Filters use the JSON schema described in [Compression Rules Format](./COMPRESSION_RULES_FORMAT.md). The runtime applies these stages in order: ```txt diff --git a/docs/diagrams/README.md b/docs/diagrams/README.md new file mode 100644 index 0000000000..3ae2bc003b --- /dev/null +++ b/docs/diagrams/README.md @@ -0,0 +1,62 @@ +--- +title: "Diagrams" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Diagrams + +Mermaid sources (`.mmd`) and exported SVGs for OmniRoute v3.8.0 architecture flows. + +## Canonical diagrams + +| Source | Exported | Used in | +| -------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------ | +| [request-pipeline.mmd](./request-pipeline.mmd) | [SVG](./exported/request-pipeline.svg) | docs/architecture/ARCHITECTURE.md, docs/architecture/CODEBASE_DOCUMENTATION.md | +| [auto-combo-9factor.mmd](./auto-combo-9factor.mmd) | [SVG](./exported/auto-combo-9factor.svg) | docs/routing/AUTO-COMBO.md | +| [resilience-3layers.mmd](./resilience-3layers.mmd) | [SVG](./exported/resilience-3layers.svg) | docs/architecture/RESILIENCE_GUIDE.md, CLAUDE.md | +| [i18n-flow.mmd](./i18n-flow.mmd) | [SVG](./exported/i18n-flow.svg) | docs/guides/I18N.md | +| [mcp-tools-37.mmd](./mcp-tools-37.mmd) | [SVG](./exported/mcp-tools-37.svg) | docs/frameworks/MCP-SERVER.md | +| [cloud-agent-flow.mmd](./cloud-agent-flow.mmd) | [SVG](./exported/cloud-agent-flow.svg) | docs/frameworks/CLOUD_AGENT.md | +| [authz-pipeline.mmd](./authz-pipeline.mmd) | [SVG](./exported/authz-pipeline.svg) | docs/architecture/AUTHZ_GUIDE.md | +| [db-schema-overview.mmd](./db-schema-overview.mmd) | [SVG](./exported/db-schema-overview.svg) | docs/architecture/CODEBASE_DOCUMENTATION.md | + +## How to update + +1. Edit `*.mmd`. +2. Re-render: `npm run docs:render-diagrams` (uses `@mermaid-js/mermaid-cli`). +3. Commit both `.mmd` and `.svg`. + +If `@mermaid-js/mermaid-cli` is not available locally, install it once: + +```bash +npm install -g @mermaid-js/mermaid-cli +``` + +The script renders every `.mmd` in `docs/diagrams/` into `docs/diagrams/exported/*.svg` +with a white background, suitable for both dark and light themes. + +## Linking from a doc + +From a doc in `docs/<subfolder>/`, the relative path becomes `../diagrams/...`: + +```markdown +![Request pipeline](../diagrams/exported/request-pipeline.svg) + +> Source: [../diagrams/request-pipeline.mmd](../diagrams/request-pipeline.mmd) +``` + +From the repo root (e.g. `CLAUDE.md`): + +```markdown +![Resilience layers](./docs/diagrams/exported/resilience-3layers.svg) +``` + +## Conventions + +- One concept per diagram. Don't try to fit the whole platform in one chart. +- Keep node labels short (3-6 words). Use `<br/>` for line breaks inside nodes. +- Prefer `flowchart LR` for pipelines and `flowchart TB` for layered models. +- Use `sequenceDiagram` for interactive (request/response) flows. +- Use `erDiagram` for database schema overviews. +- Update both `.mmd` and `.svg` in the same commit. Keep them in lock-step. diff --git a/docs/diagrams/authz-pipeline.mmd b/docs/diagrams/authz-pipeline.mmd new file mode 100644 index 0000000000..78b9b5b09c --- /dev/null +++ b/docs/diagrams/authz-pipeline.mmd @@ -0,0 +1,23 @@ +%% AuthZ pipeline (3 route classes + policy evaluation) +%% Reflects: src/middleware.ts, src/server/authz/pipeline.ts, +%% src/server/authz/policies/{public,clientApi,management}.ts +%% v3.8.0 +flowchart LR + Req["Incoming request"] --> Strip["Strip trusted internal headers<br/>(x-omniroute-auth-*)"] + Strip --> Classify["classifyRoute()"] + Classify -->|PUBLIC| PubP["publicPolicy<br/>(login, health, status)"] + Classify -->|CLIENT_API| CliP["clientApiPolicy<br/>(/api/v1/*, /v1/*)"] + Classify -->|MANAGEMENT| MgmtP["managementPolicy<br/>(dashboard, settings, admin)"] + + PubP -->|allow| Stamp["Stamp x-omniroute-auth-*<br/>(kind / id / label / scopes)"] + CliP -->|extract Bearer| Validate["validateApiKey()"] + Validate -->|valid| Stamp + Validate -->|"invalid (REQUIRE_API_KEY=true)"| Reject401["401 AUTH_002"] + Validate -->|"absent (REQUIRE_API_KEY=false)"| Anon["anonymous fallthrough"] --> Stamp + + MgmtP -->|session ok| Stamp + MgmtP -->|Bearer w/ manage scope| Stamp + MgmtP -->|"Bearer invalid"| Reject403["403 AUTH_001"] + MgmtP -->|no auth| Reject401Mgmt["401 / 302 /login"] + + Stamp --> Handler["Handler<br/>(uses assertAuth)"] diff --git a/docs/diagrams/auto-combo-9factor.mmd b/docs/diagrams/auto-combo-9factor.mmd new file mode 100644 index 0000000000..7b604b43d3 --- /dev/null +++ b/docs/diagrams/auto-combo-9factor.mmd @@ -0,0 +1,23 @@ +%% Auto-Combo 9-factor scoring +%% Reflects: open-sse/services/autoCombo/scoring.ts (DEFAULT_WEIGHTS, sum = 1.0) +%% v3.8.0 +flowchart TB + Request["Incoming request"] --> Candidates["Eligible candidates<br/>(provider × model × account)"] + Candidates --> Score["Compute composite score<br/>per candidate"] + + subgraph Factors["9-factor scoring weights (sum = 1.0)"] + f1["health (0.22)"] + f2["quota (0.17)"] + f3["costInv (0.17)"] + f4["latencyInv (0.13)"] + f5["taskFit (0.08)"] + f6["specificityMatch (0.08)"] + f7["stability (0.05)"] + f8["tierPriority (0.05)"] + f9["tierAffinity (0.05)"] + end + + Score --> Factors + Factors --> Final["Sort by score<br/>(desc)"] + Final --> Top["Pick top-N targets"] + Top --> Dispatch["Dispatch sequentially<br/>(short-circuit on success)"] diff --git a/docs/diagrams/cloud-agent-flow.mmd b/docs/diagrams/cloud-agent-flow.mmd new file mode 100644 index 0000000000..32b5a9cea6 --- /dev/null +++ b/docs/diagrams/cloud-agent-flow.mmd @@ -0,0 +1,32 @@ +%% Cloud Agent task lifecycle +%% Reflects: src/lib/cloudAgent/* and src/app/api/v1/agents/tasks/* +%% Supported agents: codex-cloud, devin, jules +%% v3.8.0 +sequenceDiagram + participant U as User + participant API as /v1/agents/tasks + participant Reg as Cloud Agent Registry + participant Ag as Cloud Agent<br/>(codex-cloud / devin / jules) + participant DB as SQLite domain DB + + U->>API: POST createTask (description, sources) + API->>API: Zod validation + AuthZ (management) + API->>Reg: getAgent(providerId) + Reg->>Ag: instantiate with credentials + Ag->>Ag: createTask() returns planning + Ag-->>API: taskId + status: planning + API->>DB: insertCloudAgentTask + API-->>U: taskId + + U->>API: GET /tasks/:id (poll) + API->>Ag: getStatus(externalId) + Ag-->>API: status, plan, messages + API->>DB: updateCloudAgentTask + API-->>U: snapshot + + U->>API: POST approvePlan + API->>Ag: approvePlan(externalId) + Ag-->>API: status: running + Note over Ag: Async execution upstream + + Ag-->>DB: stream events / final result diff --git a/docs/diagrams/db-schema-overview.mmd b/docs/diagrams/db-schema-overview.mmd new file mode 100644 index 0000000000..debf71f3b1 --- /dev/null +++ b/docs/diagrams/db-schema-overview.mmd @@ -0,0 +1,16 @@ +%% Database schema overview (selected core tables) +%% Reflects: src/lib/db/* (45+ modules, 55 migrations) +%% v3.8.0 +erDiagram + api_keys ||--o{ api_key_usage : tracks + api_keys ||--o{ rate_limits : enforces + providers ||--o{ provider_connections : holds + provider_connections ||--o{ domain_circuit_breakers : protected_by + combos ||--o{ combo_targets : contains + combos ||--o{ combo_executions : logs + spend_buffer ||--o{ usage_aggregations : flushed_to + memory_documents ||--o{ memory_chunks : split_into + skills_runs ||--o{ skills_logs : produced + agent_tasks ||--o{ agent_task_events : streams + audit_log }|--|| api_keys : by + mcp_audit }|--|| api_keys : by diff --git a/docs/diagrams/exported/authz-pipeline.svg b/docs/diagrams/exported/authz-pipeline.svg new file mode 100644 index 0000000000..cf29408a46 --- /dev/null +++ b/docs/diagrams/exported/authz-pipeline.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 2595.44px; background-color: white;" viewBox="0 0 2595.4375 596" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M190.734,171L194.901,171C199.068,171,207.401,171,215.068,171C222.734,171,229.734,171,233.234,171L236.734,171" id="my-svg-L_Req_Strip_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Req_Strip_0" data-points="W3sieCI6MTkwLjczNDM3NSwieSI6MTcxfSx7IngiOjIxNS43MzQzNzUsInkiOjE3MX0seyJ4IjoyNDAuNzM0Mzc1LCJ5IjoxNzF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M500.734,171L504.901,171C509.068,171,517.401,171,525.068,171C532.734,171,539.734,171,543.234,171L546.734,171" id="my-svg-L_Strip_Classify_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Strip_Classify_0" data-points="W3sieCI6NTAwLjczNDM3NSwieSI6MTcxfSx7IngiOjUyNS43MzQzNzUsInkiOjE3MX0seyJ4Ijo1NTAuNzM0Mzc1LCJ5IjoxNzF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M667.108,144L687.147,127.833C707.187,111.667,747.265,79.333,793.219,63.167C839.172,47,891,47,944.751,47C998.503,47,1054.177,47,1110.445,47C1166.714,47,1223.576,47,1287.74,47C1351.904,47,1423.37,47,1483.75,47C1544.13,47,1593.424,47,1618.072,47L1642.719,47" id="my-svg-L_Classify_PubP_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Classify_PubP_0" data-points="W3sieCI6NjY3LjEwODI0MDkyNzQxOTQsInkiOjE0NH0seyJ4Ijo3ODcuMzQzNzUsInkiOjQ3fSx7IngiOjk0Mi44MjgxMjUsInkiOjQ3fSx7IngiOjExMDkuODUxNTYyNSwieSI6NDd9LHsieCI6MTI4MC40Mzc1LCJ5Ijo0N30seyJ4IjoxNDk0LjgzNTkzNzUsInkiOjQ3fSx7IngiOjE2NDYuNzE4NzUsInkiOjQ3fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M716.547,171L728.346,171C740.146,171,763.745,171,786.677,171C809.609,171,831.875,171,843.008,171L854.141,171" id="my-svg-L_Classify_CliP_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Classify_CliP_0" data-points="W3sieCI6NzE2LjU0Njg3NSwieSI6MTcxfSx7IngiOjc4Ny4zNDM3NSwieSI6MTcxfSx7IngiOjg1OC4xNDA2MjUsInkiOjE3MX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M649.126,198L672.162,238.167C695.198,278.333,741.271,358.667,790.221,398.833C839.172,439,891,439,944.751,439C998.503,439,1054.177,439,1110.445,439C1166.714,439,1223.576,439,1287.74,439C1351.904,439,1423.37,439,1479.461,439C1535.552,439,1576.268,439,1596.626,439L1616.984,439" id="my-svg-L_Classify_MgmtP_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Classify_MgmtP_0" data-points="W3sieCI6NjQ5LjEyNTY0MTMyNDYyNjgsInkiOjE5OH0seyJ4Ijo3ODcuMzQzNzUsInkiOjQzOX0seyJ4Ijo5NDIuODI4MTI1LCJ5Ijo0Mzl9LHsieCI6MTEwOS44NTE1NjI1LCJ5Ijo0Mzl9LHsieCI6MTI4MC40Mzc1LCJ5Ijo0Mzl9LHsieCI6MTQ5NC44MzU5Mzc1LCJ5Ijo0Mzl9LHsieCI6MTYyMC45ODQzNzUsInkiOjQzOX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1855.25,47L1878.529,47C1901.807,47,1948.365,47,2004.656,84.003C2060.947,121.005,2126.971,195.01,2159.983,232.013L2192.996,269.015" id="my-svg-L_PubP_Stamp_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_PubP_Stamp_0" data-points="W3sieCI6MTg1NS4yNSwieSI6NDd9LHsieCI6MTk5NC45MjE4NzUsInkiOjQ3fSx7IngiOjIxOTUuNjU4NzM1Nzk1NDU0NSwieSI6MjcyfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1027.516,171L1041.238,171C1054.961,171,1082.406,171,1109.185,171C1135.964,171,1162.076,171,1175.132,171L1188.188,171" id="my-svg-L_CliP_Validate_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_CliP_Validate_0" data-points="W3sieCI6MTAyNy41MTU2MjUsInkiOjE3MX0seyJ4IjoxMTA5Ljg1MTU2MjUsInkiOjE3MX0seyJ4IjoxMTkyLjE4NzUsInkiOjE3MX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1368.688,155.359L1389.712,151.632C1410.737,147.906,1452.786,140.453,1516.503,136.726C1580.219,133,1665.602,133,1748.949,133C1832.297,133,1913.609,133,1984.388,155.765C2055.167,178.529,2115.412,224.059,2145.534,246.824L2175.657,269.588" id="my-svg-L_Validate_Stamp_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Validate_Stamp_0" data-points="W3sieCI6MTM2OC42ODc1LCJ5IjoxNTUuMzU4NTYxMzgxNzczMTR9LHsieCI6MTQ5NC44MzU5Mzc1LCJ5IjoxMzN9LHsieCI6MTc1MC45ODQzNzUsInkiOjEzM30seyJ4IjoxOTk0LjkyMTg3NSwieSI6MTMzfSx7IngiOjIxNzguODQ3OTYzNDgzMTQ2LCJ5IjoyNzJ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1368.688,185.818L1389.712,189.349C1410.737,192.879,1452.786,199.939,1501.719,203.47C1550.651,207,1606.466,207,1634.374,207L1662.281,207" id="my-svg-L_Validate_Reject401_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Validate_Reject401_0" data-points="W3sieCI6MTM2OC42ODc1LCJ5IjoxODUuODE4MjA1MDA2NzQxMjR9LHsieCI6MTQ5NC44MzU5Mzc1LCJ5IjoyMDd9LHsieCI6MTY2Ni4yODEyNSwieSI6MjA3fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1321.786,198L1350.627,216.833C1379.469,235.667,1437.153,273.333,1489.528,292.167C1541.904,311,1588.971,311,1612.505,311L1636.039,311" id="my-svg-L_Validate_Anon_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Validate_Anon_0" data-points="W3sieCI6MTMyMS43ODU3NzAwODkyODU3LCJ5IjoxOTh9LHsieCI6MTQ5NC44MzU5Mzc1LCJ5IjozMTF9LHsieCI6MTY0MC4wMzkwNjI1LCJ5IjozMTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1861.93,311L1884.095,311C1906.26,311,1950.591,311,1991.079,311C2031.568,311,2068.214,311,2086.536,311L2104.859,311" id="my-svg-L_Anon_Stamp_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Anon_Stamp_0" data-points="W3sieCI6MTg2MS45Mjk2ODc1LCJ5IjozMTF9LHsieCI6MTk5NC45MjE4NzUsInkiOjMxMX0seyJ4IjoyMTA4Ljg1OTM3NSwieSI6MzExfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1880.984,401.695L1899.974,396.246C1918.964,390.797,1956.943,379.898,1994.275,369.932C2031.606,359.966,2068.291,350.933,2086.633,346.416L2104.975,341.899" id="my-svg-L_MgmtP_Stamp_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MgmtP_Stamp_0" data-points="W3sieCI6MTg4MC45ODQzNzUsInkiOjQwMS42OTUzNjI1NDE2MzQ2fSx7IngiOjE5OTQuOTIxODc1LCJ5IjozNjl9LHsieCI6MjEwOC44NTkzNzUsInkiOjM0MC45NDI2ODI3NjUwMjU5fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1880.984,425.144L1899.974,423.12C1918.964,421.096,1956.943,417.048,1999.566,404.789C2042.19,392.53,2089.458,372.06,2113.092,361.825L2136.726,351.59" id="my-svg-L_MgmtP_Stamp_2" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MgmtP_Stamp_2" data-points="W3sieCI6MTg4MC45ODQzNzUsInkiOjQyNS4xNDM5OTE4MDExNzg2fSx7IngiOjE5OTQuOTIxODc1LCJ5Ijo0MTN9LHsieCI6MjE0MC4zOTcwNTg4MjM1MjkzLCJ5IjozNTB9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1880.984,448.593L1899.974,449.994C1918.964,451.395,1956.943,454.198,2000.404,455.599C2043.865,457,2092.807,457,2117.279,457L2141.75,457" id="my-svg-L_MgmtP_Reject403_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MgmtP_Reject403_0" data-points="W3sieCI6MTg4MC45ODQzNzUsInkiOjQ0OC41OTI2MjEwNjA3MjI1NH0seyJ4IjoxOTk0LjkyMTg3NSwieSI6NDU3fSx7IngiOjIxNDUuNzUsInkiOjQ1N31d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1852.958,490L1876.619,501.833C1900.279,513.667,1947.601,537.333,1995.731,549.167C2043.862,561,2092.802,561,2117.272,561L2141.742,561" id="my-svg-L_MgmtP_Reject401Mgmt_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MgmtP_Reject401Mgmt_0" data-points="W3sieCI6MTg1Mi45NTgyNDc5NTA4MTk3LCJ5Ijo0OTB9LHsieCI6MTk5NC45MjE4NzUsInkiOjU2MX0seyJ4IjoyMTQ1Ljc0MjE4NzUsInkiOjU2MX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2352.047,311L2356.214,311C2360.38,311,2368.714,311,2376.38,311C2384.047,311,2391.047,311,2394.547,311L2398.047,311" id="my-svg-L_Stamp_Handler_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Stamp_Handler_0" data-points="W3sieCI6MjM1Mi4wNDY4NzUsInkiOjMxMX0seyJ4IjoyMzc3LjA0Njg3NSwieSI6MzExfSx7IngiOjI0MDIuMDQ2ODc1LCJ5IjozMTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_Req_Strip_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Strip_Classify_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1109.8515625, 47)"><g class="label" data-id="L_Classify_PubP_0" transform="translate(-28.8984375, -12)"><foreignObject width="57.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>PUBLIC</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(787.34375, 171)"><g class="label" data-id="L_Classify_CliP_0" transform="translate(-45.796875, -12)"><foreignObject width="91.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>CLIENT_API</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1109.8515625, 439)"><g class="label" data-id="L_Classify_MgmtP_0" transform="translate(-57.3359375, -12)"><foreignObject width="114.671875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>MANAGEMENT</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1994.921875, 47)"><g class="label" data-id="L_PubP_Stamp_0" transform="translate(-18.234375, -12)"><foreignObject width="36.46875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>allow</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1109.8515625, 171)"><g class="label" data-id="L_CliP_Validate_0" transform="translate(-50.2421875, -12)"><foreignObject width="100.484375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>extract Bearer</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1750.984375, 133)"><g class="label" data-id="L_Validate_Stamp_0" transform="translate(-16.453125, -12)"><foreignObject width="32.90625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>valid</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1494.8359375, 207)"><g class="label" data-id="L_Validate_Reject401_0" transform="translate(-100, -24)"><foreignObject width="200" height="48"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="edgeLabel"><p>invalid (REQUIRE_API_KEY=true)</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1494.8359375, 311)"><g class="label" data-id="L_Validate_Anon_0" transform="translate(-101.1484375, -24)"><foreignObject width="202.296875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="edgeLabel"><p>absent (REQUIRE_API_KEY=false)</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Anon_Stamp_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1994.34776, 369.16475)"><g class="label" data-id="L_MgmtP_Stamp_0" transform="translate(-37.796875, -12)"><foreignObject width="75.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>session ok</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2015.08622, 404.26756)"><g class="label" data-id="L_MgmtP_Stamp_2" transform="translate(-88.9375, -12)"><foreignObject width="177.875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>Bearer w/ manage scope</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1994.921875, 457)"><g class="label" data-id="L_MgmtP_Reject403_0" transform="translate(-48.9140625, -12)"><foreignObject width="97.828125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>Bearer invalid</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1994.921875, 561)"><g class="label" data-id="L_MgmtP_Reject401Mgmt_0" transform="translate(-26.6953125, -12)"><foreignObject width="53.390625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>no auth</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Stamp_Handler_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-Req-0" data-look="classic" transform="translate(99.3671875, 171)"><rect class="basic label-container" style="" x="-91.3671875" y="-27" width="182.734375" height="54"/><g class="label" style="" transform="translate(-61.3671875, -12)"><rect/><foreignObject width="122.734375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Incoming request</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Strip-1" data-look="classic" transform="translate(370.734375, 171)"><rect class="basic label-container" style="" x="-130" y="-51" width="260" height="102"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Strip trusted internal headers<br />(x-omniroute-auth-*)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Classify-3" data-look="classic" transform="translate(633.640625, 171)"><rect class="basic label-container" style="" x="-82.90625" y="-27" width="165.8125" height="54"/><g class="label" style="" transform="translate(-52.90625, -12)"><rect/><foreignObject width="105.8125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>classifyRoute()</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-PubP-5" data-look="classic" transform="translate(1750.984375, 47)"><rect class="basic label-container" style="" x="-104.265625" y="-39" width="208.53125" height="78"/><g class="label" style="" transform="translate(-74.265625, -24)"><rect/><foreignObject width="148.53125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>publicPolicy<br />(login, health, status)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-CliP-7" data-look="classic" transform="translate(942.828125, 171)"><rect class="basic label-container" style="" x="-84.6875" y="-39" width="169.375" height="78"/><g class="label" style="" transform="translate(-54.6875, -24)"><rect/><foreignObject width="109.375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>clientApiPolicy<br />(/api/v1/*, /v1/*)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-MgmtP-9" data-look="classic" transform="translate(1750.984375, 439)"><rect class="basic label-container" style="" x="-130" y="-51" width="260" height="102"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>managementPolicy<br />(dashboard, settings, admin)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Stamp-11" data-look="classic" transform="translate(2230.453125, 311)"><rect class="basic label-container" style="" x="-121.59375" y="-39" width="243.1875" height="78"/><g class="label" style="" transform="translate(-91.59375, -24)"><rect/><foreignObject width="183.1875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Stamp x-omniroute-auth-*<br />(kind / id / label / scopes)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Validate-13" data-look="classic" transform="translate(1280.4375, 171)"><rect class="basic label-container" style="" x="-88.25" y="-27" width="176.5" height="54"/><g class="label" style="" transform="translate(-58.25, -12)"><rect/><foreignObject width="116.5" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>validateApiKey()</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Reject401-17" data-look="classic" transform="translate(1750.984375, 207)"><rect class="basic label-container" style="" x="-84.703125" y="-27" width="169.40625" height="54"/><g class="label" style="" transform="translate(-54.703125, -12)"><rect/><foreignObject width="109.40625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>401 AUTH_002</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Anon-19" data-look="classic" transform="translate(1750.984375, 311)"><rect class="basic label-container" style="" x="-110.9453125" y="-27" width="221.890625" height="54"/><g class="label" style="" transform="translate(-80.9453125, -12)"><rect/><foreignObject width="161.890625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>anonymous fallthrough</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Reject403-26" data-look="classic" transform="translate(2230.453125, 457)"><rect class="basic label-container" style="" x="-84.703125" y="-27" width="169.40625" height="54"/><g class="label" style="" transform="translate(-54.703125, -12)"><rect/><foreignObject width="109.40625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>403 AUTH_001</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Reject401Mgmt-28" data-look="classic" transform="translate(2230.453125, 561)"><rect class="basic label-container" style="" x="-84.7109375" y="-27" width="169.421875" height="54"/><g class="label" style="" transform="translate(-54.7109375, -12)"><rect/><foreignObject width="109.421875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>401 / 302 /login</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Handler-30" data-look="classic" transform="translate(2494.7421875, 311)"><rect class="basic label-container" style="" x="-92.6953125" y="-39" width="185.390625" height="78"/><g class="label" style="" transform="translate(-62.6953125, -24)"><rect/><foreignObject width="125.390625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Handler<br />(uses assertAuth)</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/auto-combo-9factor.svg b/docs/diagrams/exported/auto-combo-9factor.svg new file mode 100644 index 0000000000..54e8ebb9c0 --- /dev/null +++ b/docs/diagrams/exported/auto-combo-9factor.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 310.172px; background-color: white;" viewBox="0 0 310.171875 1716" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M155.086,62L155.086,66.167C155.086,70.333,155.086,78.667,155.086,86.333C155.086,94,155.086,101,155.086,104.5L155.086,108" id="my-svg-L_Request_Candidates_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Request_Candidates_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjYyfSx7IngiOjE1NS4wODU5Mzc1LCJ5Ijo4N30seyJ4IjoxNTUuMDg1OTM3NSwieSI6MTEyfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M155.086,214L155.086,218.167C155.086,222.333,155.086,230.667,155.086,238.333C155.086,246,155.086,253,155.086,256.5L155.086,260" id="my-svg-L_Candidates_Score_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Candidates_Score_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjIxNH0seyJ4IjoxNTUuMDg1OTM3NSwieSI6MjM5fSx7IngiOjE1NS4wODU5Mzc1LCJ5IjoyNjR9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M155.086,1476L155.086,1480.167C155.086,1484.333,155.086,1492.667,155.086,1500.333C155.086,1508,155.086,1515,155.086,1518.5L155.086,1522" id="my-svg-L_Final_Top_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Final_Top_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjE0NzZ9LHsieCI6MTU1LjA4NTkzNzUsInkiOjE1MDF9LHsieCI6MTU1LjA4NTkzNzUsInkiOjE1MjZ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M155.086,1580L155.086,1584.167C155.086,1588.333,155.086,1596.667,155.086,1604.333C155.086,1612,155.086,1619,155.086,1622.5L155.086,1626" id="my-svg-L_Top_Dispatch_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Top_Dispatch_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjE1ODB9LHsieCI6MTU1LjA4NTkzNzUsInkiOjE2MDV9LHsieCI6MTU1LjA4NTkzNzUsInkiOjE2MzB9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M155.086,342L155.086,346.167C155.086,350.333,155.086,358.667,155.086,366.333C155.086,374,155.086,381,155.086,384.5L155.086,388" id="my-svg-L_Score_Factors_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Score_Factors_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjM0Mn0seyJ4IjoxNTUuMDg1OTM3NSwieSI6MzY3fSx7IngiOjE1NS4wODU5Mzc1LCJ5IjozOTJ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M155.086,1348L155.086,1352.167C155.086,1356.333,155.086,1364.667,155.086,1372.333C155.086,1380,155.086,1387,155.086,1390.5L155.086,1394" id="my-svg-L_Factors_Final_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Factors_Final_0" data-points="W3sieCI6MTU1LjA4NTkzNzUsInkiOjEzNDh9LHsieCI6MTU1LjA4NTkzNzUsInkiOjEzNzN9LHsieCI6MTU1LjA4NTkzNzUsInkiOjEzOTh9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_Request_Candidates_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Candidates_Score_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Final_Top_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Top_Dispatch_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Score_Factors_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Factors_Final_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g class="root" transform="translate(0, 384)"><g class="clusters"><g class="cluster" id="my-svg-Factors" data-look="classic"><rect style="" x="8" y="8" width="294.171875" height="956"/><g class="cluster-label" transform="translate(27.703125, 8)"><foreignObject width="254.765625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5;"><span class="nodeLabel"><p>9-factor scoring weights (sum = 1.0)</p></span></div></foreignObject></g></g></g><g class="edgePaths"/><g class="edgeLabels"/><g class="nodes"><g class="node default" id="my-svg-flowchart-f1-4" data-look="classic" transform="translate(155.0859375, 70)"><rect class="basic label-container" style="" x="-74.921875" y="-27" width="149.84375" height="54"/><g class="label" style="" transform="translate(-44.921875, -12)"><rect/><foreignObject width="89.84375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>health (0.22)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f2-5" data-look="classic" transform="translate(155.0859375, 174)"><rect class="basic label-container" style="" x="-73.140625" y="-27" width="146.28125" height="54"/><g class="label" style="" transform="translate(-43.140625, -12)"><rect/><foreignObject width="86.28125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>quota (0.17)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f3-6" data-look="classic" transform="translate(155.0859375, 278)"><rect class="basic label-container" style="" x="-78.46875" y="-27" width="156.9375" height="54"/><g class="label" style="" transform="translate(-48.46875, -12)"><rect/><foreignObject width="96.9375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>costInv (0.17)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f4-7" data-look="classic" transform="translate(155.0859375, 382)"><rect class="basic label-container" style="" x="-89.140625" y="-27" width="178.28125" height="54"/><g class="label" style="" transform="translate(-59.140625, -12)"><rect/><foreignObject width="118.28125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>latencyInv (0.13)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f5-8" data-look="classic" transform="translate(155.0859375, 486)"><rect class="basic label-container" style="" x="-76.6796875" y="-27" width="153.359375" height="54"/><g class="label" style="" transform="translate(-46.6796875, -12)"><rect/><foreignObject width="93.359375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>taskFit (0.08)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f6-9" data-look="classic" transform="translate(155.0859375, 590)"><rect class="basic label-container" style="" x="-109.5859375" y="-27" width="219.171875" height="54"/><g class="label" style="" transform="translate(-79.5859375, -12)"><rect/><foreignObject width="159.171875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>specificityMatch (0.08)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f7-10" data-look="classic" transform="translate(155.0859375, 694)"><rect class="basic label-container" style="" x="-79.796875" y="-27" width="159.59375" height="54"/><g class="label" style="" transform="translate(-49.796875, -12)"><rect/><foreignObject width="99.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>stability (0.05)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f8-11" data-look="classic" transform="translate(155.0859375, 798)"><rect class="basic label-container" style="" x="-89.125" y="-27" width="178.25" height="54"/><g class="label" style="" transform="translate(-59.125, -12)"><rect/><foreignObject width="118.25" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>tierPriority (0.05)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-f9-12" data-look="classic" transform="translate(155.0859375, 902)"><rect class="basic label-container" style="" x="-88.1015625" y="-27" width="176.203125" height="54"/><g class="label" style="" transform="translate(-58.1015625, -12)"><rect/><foreignObject width="116.203125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>tierAffinity (0.05)</p></span></div></foreignObject></g></g></g></g><g class="node default" id="my-svg-flowchart-Request-0" data-look="classic" transform="translate(155.0859375, 35)"><rect class="basic label-container" style="" x="-91.3671875" y="-27" width="182.734375" height="54"/><g class="label" style="" transform="translate(-61.3671875, -12)"><rect/><foreignObject width="122.734375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Incoming request</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Candidates-1" data-look="classic" transform="translate(155.0859375, 163)"><rect class="basic label-container" style="" x="-130" y="-51" width="260" height="102"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Eligible candidates<br />(provider × model × account)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Score-3" data-look="classic" transform="translate(155.0859375, 303)"><rect class="basic label-container" style="" x="-122.9296875" y="-39" width="245.859375" height="78"/><g class="label" style="" transform="translate(-92.9296875, -24)"><rect/><foreignObject width="185.859375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Compute composite score<br />per candidate</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Final-16" data-look="classic" transform="translate(155.0859375, 1437)"><rect class="basic label-container" style="" x="-77.1328125" y="-39" width="154.265625" height="78"/><g class="label" style="" transform="translate(-47.1328125, -24)"><rect/><foreignObject width="94.265625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Sort by score<br />(desc)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Top-18" data-look="classic" transform="translate(155.0859375, 1553)"><rect class="basic label-container" style="" x="-93.578125" y="-27" width="187.15625" height="54"/><g class="label" style="" transform="translate(-63.578125, -12)"><rect/><foreignObject width="127.15625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Pick top-N targets</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Dispatch-20" data-look="classic" transform="translate(155.0859375, 1669)"><rect class="basic label-container" style="" x="-118.9140625" y="-39" width="237.828125" height="78"/><g class="label" style="" transform="translate(-88.9140625, -24)"><rect/><foreignObject width="177.828125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Dispatch sequentially<br />(short-circuit on success)</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/cloud-agent-flow.svg b/docs/diagrams/exported/cloud-agent-flow.svg new file mode 100644 index 0000000000..8196fc2036 --- /dev/null +++ b/docs/diagrams/exported/cloud-agent-flow.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="max-width: 1261px; background-color: white;" viewBox="-50 -10 1261 1054" role="graphics-document document" aria-roledescription="sequence"><g><rect x="1011" y="968" fill="#eaeaea" stroke="#666" width="150" height="65" name="DB" rx="3" ry="3" class="actor actor-bottom"/><text x="1086" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="1086" dy="0">SQLite domain DB</tspan></text></g><g><rect x="747" y="968" fill="#eaeaea" stroke="#666" width="200" height="65" name="Ag" rx="3" ry="3" class="actor actor-bottom"/><text x="847" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="847" dy="-8">Cloud Agent</tspan></text><text x="847" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="847" dy="8">(codex-cloud / devin / jules)</tspan></text></g><g><rect x="525" y="968" fill="#eaeaea" stroke="#666" width="160" height="65" name="Reg" rx="3" ry="3" class="actor actor-bottom"/><text x="605" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="605" dy="0">Cloud Agent Registry</tspan></text></g><g><rect x="323" y="968" fill="#eaeaea" stroke="#666" width="150" height="65" name="API" rx="3" ry="3" class="actor actor-bottom"/><text x="398" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="398" dy="0">/v1/agents/tasks</tspan></text></g><g><rect x="0" y="968" fill="#eaeaea" stroke="#666" width="150" height="65" name="U" rx="3" ry="3" class="actor actor-bottom"/><text x="75" y="1000.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="75" dy="0">User</tspan></text></g><g><line id="actor4" x1="1086" y1="65" x2="1086" y2="968" class="actor-line 200" stroke-width="0.5px" stroke="#999" name="DB" data-et="life-line" data-id="DB"/><g id="root-4" data-et="participant" data-type="participant" data-id="DB"><rect x="1011" y="0" fill="#eaeaea" stroke="#666" width="150" height="65" name="DB" rx="3" ry="3" class="actor actor-top"/><text x="1086" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="1086" dy="0">SQLite domain DB</tspan></text></g></g><g><line id="actor3" x1="847" y1="65" x2="847" y2="968" class="actor-line 200" stroke-width="0.5px" stroke="#999" name="Ag" data-et="life-line" data-id="Ag"/><g id="root-3" data-et="participant" data-type="participant" data-id="Ag"><rect x="747" y="0" fill="#eaeaea" stroke="#666" width="200" height="65" name="Ag" rx="3" ry="3" class="actor actor-top"/><text x="847" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="847" dy="-8">Cloud Agent</tspan></text><text x="847" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="847" dy="8">(codex-cloud / devin / jules)</tspan></text></g></g><g><line id="actor2" x1="605" y1="65" x2="605" y2="968" class="actor-line 200" stroke-width="0.5px" stroke="#999" name="Reg" data-et="life-line" data-id="Reg"/><g id="root-2" data-et="participant" data-type="participant" data-id="Reg"><rect x="525" y="0" fill="#eaeaea" stroke="#666" width="160" height="65" name="Reg" rx="3" ry="3" class="actor actor-top"/><text x="605" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="605" dy="0">Cloud Agent Registry</tspan></text></g></g><g><line id="actor1" x1="398" y1="65" x2="398" y2="968" class="actor-line 200" stroke-width="0.5px" stroke="#999" name="API" data-et="life-line" data-id="API"/><g id="root-1" data-et="participant" data-type="participant" data-id="API"><rect x="323" y="0" fill="#eaeaea" stroke="#666" width="150" height="65" name="API" rx="3" ry="3" class="actor actor-top"/><text x="398" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="398" dy="0">/v1/agents/tasks</tspan></text></g></g><g><line id="actor0" x1="75" y1="65" x2="75" y2="968" class="actor-line 200" stroke-width="0.5px" stroke="#999" name="U" data-et="life-line" data-id="U"/><g id="root-0" data-et="participant" data-type="participant" data-id="U"><rect x="0" y="0" fill="#eaeaea" stroke="#666" width="150" height="65" name="U" rx="3" ry="3" class="actor actor-top"/><text x="75" y="32.5" dominant-baseline="central" alignment-baseline="central" class="actor actor-box" style="text-anchor: middle; font-size: 16px; font-weight: 400;"><tspan x="75" dy="0">User</tspan></text></g></g><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .actor{stroke:#9370DB;fill:#ECECFF;stroke-width:1;}#my-svg rect.actor.outer-path[data-look="neo"]{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg rect.note[data-look="neo"]{stroke:#aaaa33;fill:#fff5ad;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg text.actor>tspan{fill:black;stroke:none;}#my-svg .actor-line{stroke:#9370DB;}#my-svg .innerArc{stroke-width:1.5;stroke-dasharray:none;}#my-svg .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#my-svg .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#my-svg [id$="-arrowhead"] path{fill:#333;stroke:#333;}#my-svg .sequenceNumber{fill:white;}#my-svg [id$="-sequencenumber"]{fill:#333;}#my-svg [id$="-crosshead"] path{fill:#333;stroke:#333;}#my-svg .messageText{fill:#333;stroke:none;}#my-svg .labelBox{stroke:#9370DB;fill:#ECECFF;filter:none;}#my-svg .labelText,#my-svg .labelText>tspan{fill:black;stroke:none;}#my-svg .loopText,#my-svg .loopText>tspan{fill:black;stroke:none;}#my-svg .sectionTitle,#my-svg .sectionTitle>tspan{fill:black;stroke:none;}#my-svg .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:#9370DB;fill:#9370DB;}#my-svg .note{stroke:#aaaa33;fill:#fff5ad;}#my-svg .noteText,#my-svg .noteText>tspan{fill:black;stroke:none;font-weight:normal;}#my-svg .activation0{fill:#f4f4f4;stroke:#666;}#my-svg .activation1{fill:#f4f4f4;stroke:#666;}#my-svg .activation2{fill:#f4f4f4;stroke:#666;}#my-svg .actorPopupMenu{position:absolute;}#my-svg .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#my-svg .actor-man circle,#my-svg line{fill:#ECECFF;stroke-width:2px;}#my-svg g rect.rect{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));stroke:#9370DB;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g/><defs><symbol id="my-svg-computer" width="24" height="24"><path transform="scale(.5)" d="M2 2v13h20v-13h-20zm18 11h-16v-9h16v9zm-10.228 6l.466-1h3.524l.467 1h-4.457zm14.228 3h-24l2-6h2.104l-1.33 4h18.45l-1.297-4h2.073l2 6zm-5-10h-14v-7h14v7z"/></symbol></defs><defs><symbol id="my-svg-database" fill-rule="evenodd" clip-rule="evenodd"><path transform="scale(.5)" d="M12.258.001l.256.004.255.005.253.008.251.01.249.012.247.015.246.016.242.019.241.02.239.023.236.024.233.027.231.028.229.031.225.032.223.034.22.036.217.038.214.04.211.041.208.043.205.045.201.046.198.048.194.05.191.051.187.053.183.054.18.056.175.057.172.059.168.06.163.061.16.063.155.064.15.066.074.033.073.033.071.034.07.034.069.035.068.035.067.035.066.035.064.036.064.036.062.036.06.036.06.037.058.037.058.037.055.038.055.038.053.038.052.038.051.039.05.039.048.039.047.039.045.04.044.04.043.04.041.04.04.041.039.041.037.041.036.041.034.041.033.042.032.042.03.042.029.042.027.042.026.043.024.043.023.043.021.043.02.043.018.044.017.043.015.044.013.044.012.044.011.045.009.044.007.045.006.045.004.045.002.045.001.045v17l-.001.045-.002.045-.004.045-.006.045-.007.045-.009.044-.011.045-.012.044-.013.044-.015.044-.017.043-.018.044-.02.043-.021.043-.023.043-.024.043-.026.043-.027.042-.029.042-.03.042-.032.042-.033.042-.034.041-.036.041-.037.041-.039.041-.04.041-.041.04-.043.04-.044.04-.045.04-.047.039-.048.039-.05.039-.051.039-.052.038-.053.038-.055.038-.055.038-.058.037-.058.037-.06.037-.06.036-.062.036-.064.036-.064.036-.066.035-.067.035-.068.035-.069.035-.07.034-.071.034-.073.033-.074.033-.15.066-.155.064-.16.063-.163.061-.168.06-.172.059-.175.057-.18.056-.183.054-.187.053-.191.051-.194.05-.198.048-.201.046-.205.045-.208.043-.211.041-.214.04-.217.038-.22.036-.223.034-.225.032-.229.031-.231.028-.233.027-.236.024-.239.023-.241.02-.242.019-.246.016-.247.015-.249.012-.251.01-.253.008-.255.005-.256.004-.258.001-.258-.001-.256-.004-.255-.005-.253-.008-.251-.01-.249-.012-.247-.015-.245-.016-.243-.019-.241-.02-.238-.023-.236-.024-.234-.027-.231-.028-.228-.031-.226-.032-.223-.034-.22-.036-.217-.038-.214-.04-.211-.041-.208-.043-.204-.045-.201-.046-.198-.048-.195-.05-.19-.051-.187-.053-.184-.054-.179-.056-.176-.057-.172-.059-.167-.06-.164-.061-.159-.063-.155-.064-.151-.066-.074-.033-.072-.033-.072-.034-.07-.034-.069-.035-.068-.035-.067-.035-.066-.035-.064-.036-.063-.036-.062-.036-.061-.036-.06-.037-.058-.037-.057-.037-.056-.038-.055-.038-.053-.038-.052-.038-.051-.039-.049-.039-.049-.039-.046-.039-.046-.04-.044-.04-.043-.04-.041-.04-.04-.041-.039-.041-.037-.041-.036-.041-.034-.041-.033-.042-.032-.042-.03-.042-.029-.042-.027-.042-.026-.043-.024-.043-.023-.043-.021-.043-.02-.043-.018-.044-.017-.043-.015-.044-.013-.044-.012-.044-.011-.045-.009-.044-.007-.045-.006-.045-.004-.045-.002-.045-.001-.045v-17l.001-.045.002-.045.004-.045.006-.045.007-.045.009-.044.011-.045.012-.044.013-.044.015-.044.017-.043.018-.044.02-.043.021-.043.023-.043.024-.043.026-.043.027-.042.029-.042.03-.042.032-.042.033-.042.034-.041.036-.041.037-.041.039-.041.04-.041.041-.04.043-.04.044-.04.046-.04.046-.039.049-.039.049-.039.051-.039.052-.038.053-.038.055-.038.056-.038.057-.037.058-.037.06-.037.061-.036.062-.036.063-.036.064-.036.066-.035.067-.035.068-.035.069-.035.07-.034.072-.034.072-.033.074-.033.151-.066.155-.064.159-.063.164-.061.167-.06.172-.059.176-.057.179-.056.184-.054.187-.053.19-.051.195-.05.198-.048.201-.046.204-.045.208-.043.211-.041.214-.04.217-.038.22-.036.223-.034.226-.032.228-.031.231-.028.234-.027.236-.024.238-.023.241-.02.243-.019.245-.016.247-.015.249-.012.251-.01.253-.008.255-.005.256-.004.258-.001.258.001zm-9.258 20.499v.01l.001.021.003.021.004.022.005.021.006.022.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.023.018.024.019.024.021.024.022.025.023.024.024.025.052.049.056.05.061.051.066.051.07.051.075.051.079.052.084.052.088.052.092.052.097.052.102.051.105.052.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.048.144.049.147.047.152.047.155.047.16.045.163.045.167.043.171.043.176.041.178.041.183.039.187.039.19.037.194.035.197.035.202.033.204.031.209.03.212.029.216.027.219.025.222.024.226.021.23.02.233.018.236.016.24.015.243.012.246.01.249.008.253.005.256.004.259.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.021.224-.024.22-.026.216-.027.212-.028.21-.031.205-.031.202-.034.198-.034.194-.036.191-.037.187-.039.183-.04.179-.04.175-.042.172-.043.168-.044.163-.045.16-.046.155-.046.152-.047.148-.048.143-.049.139-.049.136-.05.131-.05.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.053.083-.051.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.05.023-.024.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.023.01-.022.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.127l-.077.055-.08.053-.083.054-.085.053-.087.052-.09.052-.093.051-.095.05-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.045-.118.044-.12.043-.122.042-.124.042-.126.041-.128.04-.13.04-.132.038-.134.038-.135.037-.138.037-.139.035-.142.035-.143.034-.144.033-.147.032-.148.031-.15.03-.151.03-.153.029-.154.027-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.01-.179.008-.179.008-.181.006-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.006-.179-.008-.179-.008-.178-.01-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.027-.153-.029-.151-.03-.15-.03-.148-.031-.146-.032-.145-.033-.143-.034-.141-.035-.14-.035-.137-.037-.136-.037-.134-.038-.132-.038-.13-.04-.128-.04-.126-.041-.124-.042-.122-.042-.12-.044-.117-.043-.116-.045-.113-.045-.112-.046-.109-.047-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.05-.093-.052-.09-.051-.087-.052-.085-.053-.083-.054-.08-.054-.077-.054v4.127zm0-5.654v.011l.001.021.003.021.004.021.005.022.006.022.007.022.009.022.01.022.011.023.012.023.013.023.015.024.016.023.017.024.018.024.019.024.021.024.022.024.023.025.024.024.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.052.11.051.114.051.119.052.123.05.127.051.131.05.135.049.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.044.171.042.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.022.23.02.233.018.236.016.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.012.241-.015.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.048.139-.05.136-.049.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.051.051-.049.023-.025.023-.024.021-.025.02-.024.019-.024.018-.024.017-.024.015-.023.014-.023.013-.024.012-.022.01-.023.01-.023.008-.022.006-.022.006-.022.004-.021.004-.022.001-.021.001-.021v-4.139l-.077.054-.08.054-.083.054-.085.052-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.044-.118.044-.12.044-.122.042-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.035-.143.033-.144.033-.147.033-.148.031-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.009-.179.009-.179.007-.181.007-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.007-.179-.007-.179-.009-.178-.009-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.031-.146-.033-.145-.033-.143-.033-.141-.035-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.04-.126-.041-.124-.042-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.051-.093-.051-.09-.051-.087-.053-.085-.052-.083-.054-.08-.054-.077-.054v4.139zm0-5.666v.011l.001.02.003.022.004.021.005.022.006.021.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.024.018.023.019.024.021.025.022.024.023.024.024.025.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.051.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.043.171.043.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.021.23.02.233.018.236.017.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.013.241-.014.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.049.139-.049.136-.049.131-.051.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.049.023-.025.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.022.01-.023.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.153l-.077.054-.08.054-.083.053-.085.053-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.048-.105.048-.106.048-.109.046-.111.046-.114.046-.115.044-.118.044-.12.043-.122.043-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.034-.143.034-.144.033-.147.032-.148.032-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.024-.161.024-.162.023-.163.023-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.01-.178.01-.179.009-.179.007-.181.006-.182.006-.182.004-.184.003-.184.001-.185.001-.185-.001-.184-.001-.184-.003-.182-.004-.182-.006-.181-.006-.179-.007-.179-.009-.178-.01-.176-.01-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.023-.162-.023-.161-.024-.159-.024-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.032-.146-.032-.145-.033-.143-.034-.141-.034-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.041-.126-.041-.124-.041-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.048-.105-.048-.102-.048-.1-.05-.097-.049-.095-.051-.093-.051-.09-.052-.087-.052-.085-.053-.083-.053-.08-.054-.077-.054v4.153zm8.74-8.179l-.257.004-.254.005-.25.008-.247.011-.244.012-.241.014-.237.016-.233.018-.231.021-.226.022-.224.023-.22.026-.216.027-.212.028-.21.031-.205.032-.202.033-.198.034-.194.036-.191.038-.187.038-.183.04-.179.041-.175.042-.172.043-.168.043-.163.045-.16.046-.155.046-.152.048-.148.048-.143.048-.139.049-.136.05-.131.05-.126.051-.123.051-.118.051-.114.052-.11.052-.106.052-.101.052-.096.052-.092.052-.088.052-.083.052-.079.052-.074.051-.07.052-.065.051-.06.05-.056.05-.051.05-.023.025-.023.024-.021.024-.02.025-.019.024-.018.024-.017.023-.015.024-.014.023-.013.023-.012.023-.01.023-.01.022-.008.022-.006.023-.006.021-.004.022-.004.021-.001.021-.001.021.001.021.001.021.004.021.004.022.006.021.006.023.008.022.01.022.01.023.012.023.013.023.014.023.015.024.017.023.018.024.019.024.02.025.021.024.023.024.023.025.051.05.056.05.06.05.065.051.07.052.074.051.079.052.083.052.088.052.092.052.096.052.101.052.106.052.11.052.114.052.118.051.123.051.126.051.131.05.136.05.139.049.143.048.148.048.152.048.155.046.16.046.163.045.168.043.172.043.175.042.179.041.183.04.187.038.191.038.194.036.198.034.202.033.205.032.21.031.212.028.216.027.22.026.224.023.226.022.231.021.233.018.237.016.241.014.244.012.247.011.25.008.254.005.257.004.26.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.022.224-.023.22-.026.216-.027.212-.028.21-.031.205-.032.202-.033.198-.034.194-.036.191-.038.187-.038.183-.04.179-.041.175-.042.172-.043.168-.043.163-.045.16-.046.155-.046.152-.048.148-.048.143-.048.139-.049.136-.05.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.05.051-.05.023-.025.023-.024.021-.024.02-.025.019-.024.018-.024.017-.023.015-.024.014-.023.013-.023.012-.023.01-.023.01-.022.008-.022.006-.023.006-.021.004-.022.004-.021.001-.021.001-.021-.001-.021-.001-.021-.004-.021-.004-.022-.006-.021-.006-.023-.008-.022-.01-.022-.01-.023-.012-.023-.013-.023-.014-.023-.015-.024-.017-.023-.018-.024-.019-.024-.02-.025-.021-.024-.023-.024-.023-.025-.051-.05-.056-.05-.06-.05-.065-.051-.07-.052-.074-.051-.079-.052-.083-.052-.088-.052-.092-.052-.096-.052-.101-.052-.106-.052-.11-.052-.114-.052-.118-.051-.123-.051-.126-.051-.131-.05-.136-.05-.139-.049-.143-.048-.148-.048-.152-.048-.155-.046-.16-.046-.163-.045-.168-.043-.172-.043-.175-.042-.179-.041-.183-.04-.187-.038-.191-.038-.194-.036-.198-.034-.202-.033-.205-.032-.21-.031-.212-.028-.216-.027-.22-.026-.224-.023-.226-.022-.231-.021-.233-.018-.237-.016-.241-.014-.244-.012-.247-.011-.25-.008-.254-.005-.257-.004-.26-.001-.26.001z"/></symbol></defs><defs><symbol id="my-svg-clock" width="24" height="24"><path transform="scale(.5)" d="M12 2c5.514 0 10 4.486 10 10s-4.486 10-10 10-10-4.486-10-10 4.486-10 10-10zm0-2c-6.627 0-12 5.373-12 12s5.373 12 12 12 12-5.373 12-12-5.373-12-12-12zm5.848 12.459c.202.038.202.333.001.372-1.907.361-6.045 1.111-6.547 1.111-.719 0-1.301-.582-1.301-1.301 0-.512.77-5.447 1.125-7.445.034-.192.312-.181.343.014l.985 6.238 5.394 1.011z"/></symbol></defs><defs><marker id="my-svg-arrowhead" refX="7.9" refY="5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto-start-reverse"><path d="M -1 0 L 10 5 L 0 10 z"/></marker></defs><defs><marker id="my-svg-crosshead" markerWidth="15" markerHeight="8" orient="auto" refX="4" refY="4.5"><path fill="none" stroke="#000000" stroke-width="1pt" d="M 1,2 L 6,7 M 6,2 L 1,7" style="stroke-dasharray: 0, 0;"/></marker></defs><defs><marker id="my-svg-filled-head" refX="15.5" refY="7" markerWidth="20" markerHeight="28" orient="auto"><path d="M 18,7 L9,13 L14,7 L9,1 Z"/></marker></defs><defs><marker id="my-svg-sequencenumber" refX="15" refY="15" markerWidth="60" markerHeight="40" orient="auto"><circle cx="15" cy="15" r="6"/></marker></defs><defs><marker id="my-svg-solidTopArrowHead" refX="7.9" refY="7.25" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto-start-reverse"><path d="M 0 0 L 10 8 L 0 8 z"/></marker></defs><defs><marker id="my-svg-solidBottomArrowHead" refX="7.9" refY="0.75" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto-start-reverse"><path d="M 0 0 L 10 0 L 0 8 z"/></marker></defs><defs><marker id="my-svg-stickTopArrowHead" refX="7.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto-start-reverse"><path d="M 0 0 L 7 7" stroke="black" stroke-width="1.5" fill="none"/></marker></defs><defs><marker id="my-svg-stickBottomArrowHead" refX="7.5" refY="0" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto-start-reverse"><path d="M 0 7 L 7 0" stroke="black" stroke-width="1.5" fill="none"/></marker></defs><g data-et="note" data-id="i16"><rect x="747" y="867" fill="#EDF2AE" stroke="#666" width="200" height="37" class="note"/><text x="847" y="872" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="noteText" dy="1em" style="font-size: 16px; font-weight: 400;"><tspan x="847">Async execution upstream</tspan></text></g><text x="235" y="80" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">POST createTask (description, sources)</text><line x1="76" y1="111" x2="394" y2="111" class="messageLine0" data-et="message" data-id="i0" data-from="U" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="399" y="126" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">Zod validation + AuthZ (management)</text><path d="M 399,157 C 459,147 459,187 399,177" class="messageLine0" data-et="message" data-id="i1" data-from="API" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="500" y="202" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">getAgent(providerId)</text><line x1="399" y1="233" x2="601" y2="233" class="messageLine0" data-et="message" data-id="i2" data-from="API" data-to="Reg" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="725" y="248" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">instantiate with credentials</text><line x1="606" y1="277" x2="843" y2="277" class="messageLine0" data-et="message" data-id="i3" data-from="Reg" data-to="Ag" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="848" y="292" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">createTask() returns planning</text><path d="M 848,323 C 908,313 908,353 848,343" class="messageLine0" data-et="message" data-id="i4" data-from="Ag" data-to="Ag" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="624" y="368" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">taskId + status: planning</text><line x1="846" y1="399" x2="402" y2="399" class="messageLine1" data-et="message" data-id="i5" data-from="Ag" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/><text x="741" y="414" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">insertCloudAgentTask</text><line x1="399" y1="445" x2="1082" y2="445" class="messageLine0" data-et="message" data-id="i6" data-from="API" data-to="DB" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="238" y="460" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">taskId</text><line x1="397" y1="489" x2="79" y2="489" class="messageLine1" data-et="message" data-id="i7" data-from="API" data-to="U" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/><text x="235" y="504" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">GET /tasks/:id (poll)</text><line x1="76" y1="535" x2="394" y2="535" class="messageLine0" data-et="message" data-id="i8" data-from="U" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="621" y="550" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">getStatus(externalId)</text><line x1="399" y1="581" x2="843" y2="581" class="messageLine0" data-et="message" data-id="i9" data-from="API" data-to="Ag" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="624" y="596" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">status, plan, messages</text><line x1="846" y1="627" x2="402" y2="627" class="messageLine1" data-et="message" data-id="i10" data-from="Ag" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/><text x="741" y="642" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">updateCloudAgentTask</text><line x1="399" y1="673" x2="1082" y2="673" class="messageLine0" data-et="message" data-id="i11" data-from="API" data-to="DB" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="238" y="688" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">snapshot</text><line x1="397" y1="719" x2="79" y2="719" class="messageLine1" data-et="message" data-id="i12" data-from="API" data-to="U" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/><text x="235" y="734" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">POST approvePlan</text><line x1="76" y1="765" x2="394" y2="765" class="messageLine0" data-et="message" data-id="i13" data-from="U" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="621" y="780" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">approvePlan(externalId)</text><line x1="399" y1="811" x2="843" y2="811" class="messageLine0" data-et="message" data-id="i14" data-from="API" data-to="Ag" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="fill: none;"/><text x="624" y="826" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">status: running</text><line x1="846" y1="857" x2="402" y2="857" class="messageLine1" data-et="message" data-id="i15" data-from="Ag" data-to="API" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/><text x="965" y="919" text-anchor="middle" dominant-baseline="middle" alignment-baseline="middle" class="messageText" dy="1em" style="font-size: 16px; font-weight: 400;">stream events / final result</text><line x1="848" y1="948" x2="1082" y2="948" class="messageLine1" data-et="message" data-id="i17" data-from="Ag" data-to="DB" stroke-width="2" stroke="none" marker-end="url(#my-svg-arrowhead)" style="stroke-dasharray: 3, 3; fill: none;"/></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/db-schema-overview.svg b/docs/diagrams/exported/db-schema-overview.svg new file mode 100644 index 0000000000..1aabb59678 --- /dev/null +++ b/docs/diagrams/exported/db-schema-overview.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="erDiagram" style="max-width: 2550.33px; background-color: white;" viewBox="0 0 2550.328125 470" role="graphics-document document" aria-roledescription="er"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .entityBox{fill:#ECECFF;stroke:#9370DB;}#my-svg .relationshipLabelBox{fill:hsl(80, 100%, 96.2745098039%);opacity:0.7;background-color:hsl(80, 100%, 96.2745098039%);}#my-svg .relationshipLabelBox rect{opacity:0.5;}#my-svg .labelBkg{background-color:rgba(248.6666666666, 255, 235.9999999999, 0.5);}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel .label rect{fill:rgba(232,232,232, 0.8);}#my-svg .edgeLabel .label text{fill:#333;}#my-svg .edgeLabel .label{fill:#9370DB;font-size:14px;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .edge-pattern-dashed{stroke-dasharray:8,8;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .relationshipLine{stroke:#333333;stroke-width:1px;fill:none;}#my-svg .marker{fill:none!important;stroke:#333333!important;stroke-width:1;}#my-svg [data-look=neo].labelBkg{background-color:rgba(248.6666666666, 255, 235.9999999999, 0.5);}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><defs><marker id="my-svg_er-onlyOneStart" class="marker onlyOne er" refX="0" refY="9" markerWidth="18" markerHeight="18" orient="auto"><path d="M9,0 L9,18 M15,0 L15,18"/></marker></defs><defs><marker id="my-svg_er-onlyOneEnd" class="marker onlyOne er" refX="18" refY="9" markerWidth="18" markerHeight="18" orient="auto"><path d="M3,0 L3,18 M9,0 L9,18"/></marker></defs><defs><marker id="my-svg_er-zeroOrOneStart" class="marker zeroOrOne er" refX="0" refY="9" markerWidth="30" markerHeight="18" orient="auto"><circle fill="white" cx="21" cy="9" r="6"/><path d="M9,0 L9,18"/></marker></defs><defs><marker id="my-svg_er-zeroOrOneEnd" class="marker zeroOrOne er" refX="30" refY="9" markerWidth="30" markerHeight="18" orient="auto"><circle fill="white" cx="9" cy="9" r="6"/><path d="M21,0 L21,18"/></marker></defs><defs><marker id="my-svg_er-oneOrMoreStart" class="marker oneOrMore er" refX="18" refY="18" markerWidth="45" markerHeight="36" orient="auto"><path d="M0,18 Q 18,0 36,18 Q 18,36 0,18 M42,9 L42,27"/></marker></defs><defs><marker id="my-svg_er-oneOrMoreEnd" class="marker oneOrMore er" refX="27" refY="18" markerWidth="45" markerHeight="36" orient="auto"><path d="M3,9 L3,27 M9,18 Q27,0 45,18 Q27,36 9,18"/></marker></defs><defs><marker id="my-svg_er-zeroOrMoreStart" class="marker zeroOrMore er" refX="18" refY="18" markerWidth="57" markerHeight="36" orient="auto"><circle fill="white" cx="48" cy="18" r="6"/><path d="M0,18 Q18,0 36,18 Q18,36 0,18"/></marker></defs><defs><marker id="my-svg_er-zeroOrMoreEnd" class="marker zeroOrMore er" refX="39" refY="18" markerWidth="57" markerHeight="36" orient="auto"><circle fill="white" cx="9" cy="18" r="6"/><path d="M21,18 Q39,0 57,18 Q39,36 21,18"/></marker></defs><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M519.691,270.305L505.765,279.837C491.839,289.37,463.986,308.435,450.059,326.384C436.133,344.333,436.133,361.167,436.133,369.583L436.133,378" id="my-svg-id_entity-api_keys-0_entity-api_key_usage-1_0" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-api_keys-0_entity-api_key_usage-1_0" data-points="W3sieCI6NTE5LjY5MTQwNjI1LCJ5IjoyNzAuMzA0ODEyODM0MjI0Nn0seyJ4Ijo0MzYuMTMyODEyNSwieSI6MzI3LjV9LHsieCI6NDM2LjEzMjgxMjUsInkiOjM3OH1d" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M622.848,270.305L636.774,279.837C650.701,289.37,678.553,308.435,692.48,326.384C706.406,344.333,706.406,361.167,706.406,369.583L706.406,378" id="my-svg-id_entity-api_keys-0_entity-rate_limits-2_1" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-api_keys-0_entity-rate_limits-2_1" data-points="W3sieCI6NjIyLjg0NzY1NjI1LCJ5IjoyNzAuMzA0ODEyODM0MjI0Nn0seyJ4Ijo3MDYuNDA2MjUsInkiOjMyNy41fSx7IngiOjcwNi40MDYyNSwieSI6Mzc4fV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M115.156,92L115.156,100.417C115.156,108.833,115.156,125.667,115.156,142.5C115.156,159.333,115.156,176.167,115.156,184.583L115.156,193" id="my-svg-id_entity-providers-3_entity-provider_connections-4_2" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-providers-3_entity-provider_connections-4_2" data-points="W3sieCI6MTE1LjE1NjI1LCJ5Ijo5Mn0seyJ4IjoxMTUuMTU2MjUsInkiOjE0Mi41fSx7IngiOjExNS4xNTYyNSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M115.156,277L115.156,285.417C115.156,293.833,115.156,310.667,115.156,327.5C115.156,344.333,115.156,361.167,115.156,369.583L115.156,378" id="my-svg-id_entity-provider_connections-4_entity-domain_circuit_breakers-5_3" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-provider_connections-4_entity-domain_circuit_breakers-5_3" data-points="W3sieCI6MTE1LjE1NjI1LCJ5IjoyNzd9LHsieCI6MTE1LjE1NjI1LCJ5IjozMjcuNX0seyJ4IjoxMTUuMTU2MjUsInkiOjM3OH1d" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M1051.488,80.871L1034.852,91.143C1018.216,101.414,984.944,121.957,968.308,140.645C951.672,159.333,951.672,176.167,951.672,184.583L951.672,193" id="my-svg-id_entity-combos-6_entity-combo_targets-7_4" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-combos-6_entity-combo_targets-7_4" data-points="W3sieCI6MTA1MS40ODgyODEyNSwieSI6ODAuODcxMTE4Mjk1ODMwODR9LHsieCI6OTUxLjY3MTg3NSwieSI6MTQyLjV9LHsieCI6OTUxLjY3MTg3NSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M1151.488,80.871L1168.124,91.143C1184.76,101.414,1218.033,121.957,1234.669,140.645C1251.305,159.333,1251.305,176.167,1251.305,184.583L1251.305,193" id="my-svg-id_entity-combos-6_entity-combo_executions-8_5" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-combos-6_entity-combo_executions-8_5" data-points="W3sieCI6MTE1MS40ODgyODEyNSwieSI6ODAuODcxMTE4Mjk1ODMwODR9LHsieCI6MTI1MS4zMDQ2ODc1LCJ5IjoxNDIuNX0seyJ4IjoxMjUxLjMwNDY4NzUsInkiOjE5M31d" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M1570.523,92L1570.523,100.417C1570.523,108.833,1570.523,125.667,1570.523,142.5C1570.523,159.333,1570.523,176.167,1570.523,184.583L1570.523,193" id="my-svg-id_entity-spend_buffer-9_entity-usage_aggregations-10_6" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-spend_buffer-9_entity-usage_aggregations-10_6" data-points="W3sieCI6MTU3MC41MjM0Mzc1LCJ5Ijo5Mn0seyJ4IjoxNTcwLjUyMzQzNzUsInkiOjE0Mi41fSx7IngiOjE1NzAuNTIzNDM3NSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M1881.719,92L1881.719,100.417C1881.719,108.833,1881.719,125.667,1881.719,142.5C1881.719,159.333,1881.719,176.167,1881.719,184.583L1881.719,193" id="my-svg-id_entity-memory_documents-11_entity-memory_chunks-12_7" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-memory_documents-11_entity-memory_chunks-12_7" data-points="W3sieCI6MTg4MS43MTg3NSwieSI6OTJ9LHsieCI6MTg4MS43MTg3NSwieSI6MTQyLjV9LHsieCI6MTg4MS43MTg3NSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M2171.539,92L2171.539,100.417C2171.539,108.833,2171.539,125.667,2171.539,142.5C2171.539,159.333,2171.539,176.167,2171.539,184.583L2171.539,193" id="my-svg-id_entity-skills_runs-13_entity-skills_logs-14_8" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-skills_runs-13_entity-skills_logs-14_8" data-points="W3sieCI6MjE3MS41MzkwNjI1LCJ5Ijo5Mn0seyJ4IjoyMTcxLjUzOTA2MjUsInkiOjE0Mi41fSx7IngiOjIxNzEuNTM5MDYyNSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M2455.164,92L2455.164,100.417C2455.164,108.833,2455.164,125.667,2455.164,142.5C2455.164,159.333,2455.164,176.167,2455.164,184.583L2455.164,193" id="my-svg-id_entity-agent_tasks-15_entity-agent_task_events-16_9" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-agent_tasks-15_entity-agent_task_events-16_9" data-points="W3sieCI6MjQ1NS4xNjQwNjI1LCJ5Ijo5Mn0seyJ4IjoyNDU1LjE2NDA2MjUsInkiOjE0Mi41fSx7IngiOjI0NTUuMTY0MDYyNSwieSI6MTkzfV0=" data-look="classic" marker-start="url(#my-svg_er-onlyOneStart)" marker-end="url(#my-svg_er-zeroOrMoreEnd)"/><path d="M398.336,92L398.336,100.417C398.336,108.833,398.336,125.667,418.562,144.902C438.788,164.137,479.24,185.774,499.465,196.593L519.691,207.412" id="my-svg-id_entity-audit_log-17_entity-api_keys-0_10" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-audit_log-17_entity-api_keys-0_10" data-points="W3sieCI6Mzk4LjMzNTkzNzUsInkiOjkyfSx7IngiOjM5OC4zMzU5Mzc1LCJ5IjoxNDIuNX0seyJ4Ijo1MTkuNjkxNDA2MjUsInkiOjIwNy40MTE1MTA5MjEzNzA2NX1d" data-look="classic" marker-start="url(#my-svg_er-oneOrMoreStart)" marker-end="url(#my-svg_er-onlyOneEnd)"/><path d="M695.965,92L695.965,100.417C695.965,108.833,695.965,125.667,683.779,143.123C671.592,160.58,647.22,178.659,635.034,187.699L622.848,196.739" id="my-svg-id_entity-mcp_audit-18_entity-api_keys-0_11" class="edge-thickness-normal edge-pattern-solid relationshipLine" style="undefined;;;undefined" data-edge="true" data-et="edge" data-id="id_entity-mcp_audit-18_entity-api_keys-0_11" data-points="W3sieCI6Njk1Ljk2NDg0Mzc1LCJ5Ijo5Mn0seyJ4Ijo2OTUuOTY0ODQzNzUsInkiOjE0Mi41fSx7IngiOjYyMi44NDc2NTYyNSwieSI6MTk2LjczODkyNjEzMjQ0NzgzfV0=" data-look="classic" marker-start="url(#my-svg_er-oneOrMoreStart)" marker-end="url(#my-svg_er-onlyOneEnd)"/></g><g class="edgeLabels"><g class="edgeLabel" transform="translate(436.1328125, 327.5)"><g class="label" data-id="id_entity-api_keys-0_entity-api_key_usage-1_0" transform="translate(-18.671875, -10.5)"><foreignObject width="37.34375" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>tracks</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(706.40625, 327.5)"><g class="label" data-id="id_entity-api_keys-0_entity-rate_limits-2_1" transform="translate(-26.8515625, -10.5)"><foreignObject width="53.703125" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>enforces</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(115.15625, 142.5)"><g class="label" data-id="id_entity-providers-3_entity-provider_connections-4_2" transform="translate(-16.734375, -10.5)"><foreignObject width="33.46875" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>holds</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(115.15625, 327.5)"><g class="label" data-id="id_entity-provider_connections-4_entity-domain_circuit_breakers-5_3" transform="translate(-40.4765625, -10.5)"><foreignObject width="80.953125" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>protected_by</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(951.671875, 142.5)"><g class="label" data-id="id_entity-combos-6_entity-combo_targets-7_4" transform="translate(-26.078125, -10.5)"><foreignObject width="52.15625" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>contains</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1251.3046875, 142.5)"><g class="label" data-id="id_entity-combos-6_entity-combo_executions-8_5" transform="translate(-12.84375, -10.5)"><foreignObject width="25.6875" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>logs</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1570.5234375, 142.5)"><g class="label" data-id="id_entity-spend_buffer-9_entity-usage_aggregations-10_6" transform="translate(-32.3046875, -10.5)"><foreignObject width="64.609375" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>flushed_to</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(1881.71875, 142.5)"><g class="label" data-id="id_entity-memory_documents-11_entity-memory_chunks-12_7" transform="translate(-27.6328125, -10.5)"><foreignObject width="55.265625" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>split_into</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2171.5390625, 142.5)"><g class="label" data-id="id_entity-skills_runs-13_entity-skills_logs-14_8" transform="translate(-29.1953125, -10.5)"><foreignObject width="58.390625" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>produced</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2455.1640625, 142.5)"><g class="label" data-id="id_entity-agent_tasks-15_entity-agent_task_events-16_9" transform="translate(-24.8984375, -10.5)"><foreignObject width="49.796875" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>streams</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(398.3359375, 142.5)"><g class="label" data-id="id_entity-audit_log-17_entity-api_keys-0_10" transform="translate(-7.3984375, -10.5)"><foreignObject width="14.796875" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>by</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(695.96484375, 142.5)"><g class="label" data-id="id_entity-mcp_audit-18_entity-api_keys-0_11" transform="translate(-7.3984375, -10.5)"><foreignObject width="14.796875" height="21"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>by</p></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-entity-api_keys-0" data-look="classic" transform="translate(571.26953125, 235)"><rect class="basic label-container" style="" x="-51.578125" y="-42" width="103.15625" height="84"/><g class="label" style="" transform="translate(-31.578125, -12)"><rect/><foreignObject width="63.15625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 100px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>api_keys</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-api_key_usage-1" data-look="classic" transform="translate(436.1328125, 420)"><rect class="basic label-container" style="" x="-73.8203125" y="-42" width="147.640625" height="84"/><g class="label" style="" transform="translate(-53.8203125, -12)"><rect/><foreignObject width="107.640625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>api_key_usage</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-rate_limits-2" data-look="classic" transform="translate(706.40625, 420)"><rect class="basic label-container" style="" x="-56.453125" y="-42" width="112.90625" height="84"/><g class="label" style="" transform="translate(-36.453125, -12)"><rect/><foreignObject width="72.90625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>rate_limits</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-providers-3" data-look="classic" transform="translate(115.15625, 50)"><rect class="basic label-container" style="" x="-52.90625" y="-42" width="105.8125" height="84"/><g class="label" style="" transform="translate(-32.90625, -12)"><rect/><foreignObject width="65.8125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>providers</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-provider_connections-4" data-look="classic" transform="translate(115.15625, 235)"><rect class="basic label-container" style="" x="-96.046875" y="-42" width="192.09375" height="84"/><g class="label" style="" transform="translate(-76.046875, -12)"><rect/><foreignObject width="152.09375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>provider_connections</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-domain_circuit_breakers-5" data-look="classic" transform="translate(115.15625, 420)"><rect class="basic label-container" style="" x="-107.15625" y="-42" width="214.3125" height="84"/><g class="label" style="" transform="translate(-87.15625, -12)"><rect/><foreignObject width="174.3125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>domain_circuit_breakers</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-combos-6" data-look="classic" transform="translate(1101.48828125, 50)"><rect class="basic label-container" style="" x="-50" y="-42" width="100" height="84"/><g class="label" style="" transform="translate(-28.015625, -12)"><rect/><foreignObject width="56.03125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 100px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>combos</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-combo_targets-7" data-look="classic" transform="translate(951.671875, 235)"><rect class="basic label-container" style="" x="-72.921875" y="-42" width="145.84375" height="84"/><g class="label" style="" transform="translate(-52.921875, -12)"><rect/><foreignObject width="105.84375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>combo_targets</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-combo_executions-8" data-look="classic" transform="translate(1251.3046875, 235)"><rect class="basic label-container" style="" x="-86.7109375" y="-42" width="173.421875" height="84"/><g class="label" style="" transform="translate(-66.7109375, -12)"><rect/><foreignObject width="133.421875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>combo_executions</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-spend_buffer-9" data-look="classic" transform="translate(1570.5234375, 50)"><rect class="basic label-container" style="" x="-66.5625" y="-42" width="133.125" height="84"/><g class="label" style="" transform="translate(-46.5625, -12)"><rect/><foreignObject width="93.125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>spend_buffer</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-usage_aggregations-10" data-look="classic" transform="translate(1570.5234375, 235)"><rect class="basic label-container" style="" x="-92.5078125" y="-42" width="185.015625" height="84"/><g class="label" style="" transform="translate(-72.5078125, -12)"><rect/><foreignObject width="145.015625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>usage_aggregations</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-memory_documents-11" data-look="classic" transform="translate(1881.71875, 50)"><rect class="basic label-container" style="" x="-92.4765625" y="-42" width="184.953125" height="84"/><g class="label" style="" transform="translate(-72.4765625, -12)"><rect/><foreignObject width="144.953125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>memory_documents</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-memory_chunks-12" data-look="classic" transform="translate(1881.71875, 235)"><rect class="basic label-container" style="" x="-78.6875" y="-42" width="157.375" height="84"/><g class="label" style="" transform="translate(-58.6875, -12)"><rect/><foreignObject width="117.375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>memory_chunks</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-skills_runs-13" data-look="classic" transform="translate(2171.5390625, 50)"><rect class="basic label-container" style="" x="-57.34375" y="-42" width="114.6875" height="84"/><g class="label" style="" transform="translate(-37.34375, -12)"><rect/><foreignObject width="74.6875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>skills_runs</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-skills_logs-14" data-look="classic" transform="translate(2171.5390625, 235)"><rect class="basic label-container" style="" x="-56.4609375" y="-42" width="112.921875" height="84"/><g class="label" style="" transform="translate(-36.4609375, -12)"><rect/><foreignObject width="72.921875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>skills_logs</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-agent_tasks-15" data-look="classic" transform="translate(2455.1640625, 50)"><rect class="basic label-container" style="" x="-63.140625" y="-42" width="126.28125" height="84"/><g class="label" style="" transform="translate(-43.140625, -12)"><rect/><foreignObject width="86.28125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>agent_tasks</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-agent_task_events-16" data-look="classic" transform="translate(2455.1640625, 235)"><rect class="basic label-container" style="" x="-87.1640625" y="-42" width="174.328125" height="84"/><g class="label" style="" transform="translate(-67.1640625, -12)"><rect/><foreignObject width="134.328125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>agent_task_events</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-audit_log-17" data-look="classic" transform="translate(398.3359375, 50)"><rect class="basic label-container" style="" x="-52.4765625" y="-42" width="104.953125" height="84"/><g class="label" style="" transform="translate(-32.4765625, -12)"><rect/><foreignObject width="64.953125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>audit_log</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-entity-mcp_audit-18" data-look="classic" transform="translate(695.96484375, 50)"><rect class="basic label-container" style="" x="-56.9140625" y="-42" width="113.828125" height="84"/><g class="label" style="" transform="translate(-36.9140625, -12)"><rect/><foreignObject width="73.828125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel markdown-node-label"><p>mcp_audit</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/i18n-flow.svg b/docs/diagrams/exported/i18n-flow.svg new file mode 100644 index 0000000000..dc0d44561e --- /dev/null +++ b/docs/diagrams/exported/i18n-flow.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 2218px; background-color: white;" viewBox="0 0 2218 288.19140625" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M267.172,166.043L271.339,166.043C275.505,166.043,283.839,166.043,291.505,166.043C299.172,166.043,306.172,166.043,309.672,166.043L313.172,166.043" id="my-svg-L_Src_Hash_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Src_Hash_0" data-points="W3sieCI6MjY3LjE3MTg3NSwieSI6MTY2LjA0Mjk2ODc1fSx7IngiOjI5Mi4xNzE4NzUsInkiOjE2Ni4wNDI5Njg3NX0seyJ4IjozMTcuMTcxODc1LCJ5IjoxNjYuMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M468.813,166.043L472.979,166.043C477.146,166.043,485.479,166.043,493.146,166.043C500.813,166.043,507.813,166.043,511.313,166.043L514.813,166.043" id="my-svg-L_Hash_State_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Hash_State_0" data-points="W3sieCI6NDY4LjgxMjUsInkiOjE2Ni4wNDI5Njg3NX0seyJ4Ijo0OTMuODEyNSwieSI6MTY2LjA0Mjk2ODc1fSx7IngiOjUxOC44MTI1LCJ5IjoxNjYuMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M653.333,139.043L664.921,132.818C676.509,126.594,699.684,114.145,716.527,107.92C733.37,101.695,743.88,101.695,749.135,101.695L754.391,101.695" id="my-svg-L_State_Dirty_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_State_Dirty_0" data-points="W3sieCI6NjUzLjMzMzI4ODI3ODU0NjcsInkiOjEzOS4wNDI5Njg3NX0seyJ4Ijo3MjIuODU5Mzc1LCJ5IjoxMDEuNjk1MzEyNX0seyJ4Ijo3NTguMzkwNjI1LCJ5IjoxMDEuNjk1MzEyNX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M941.094,101.695L945.26,101.695C949.427,101.695,957.76,101.695,965.427,101.695C973.094,101.695,980.094,101.695,983.594,101.695L987.094,101.695" id="my-svg-L_Dirty_Loop_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Dirty_Loop_0" data-points="W3sieCI6OTQxLjA5Mzc1LCJ5IjoxMDEuNjk1MzEyNX0seyJ4Ijo5NjYuMDkzNzUsInkiOjEwMS42OTUzMTI1fSx7IngiOjk5MS4wOTM3NSwieSI6MTAxLjY5NTMxMjV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1178.484,101.695L1182.651,101.695C1186.818,101.695,1195.151,101.695,1202.818,101.695C1210.484,101.695,1217.484,101.695,1220.984,101.695L1224.484,101.695" id="my-svg-L_Loop_LLM_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Loop_LLM_0" data-points="W3sieCI6MTE3OC40ODQzNzUsInkiOjEwMS42OTUzMTI1fSx7IngiOjEyMDMuNDg0Mzc1LCJ5IjoxMDEuNjk1MzEyNX0seyJ4IjoxMjI4LjQ4NDM3NSwieSI6MTAxLjY5NTMxMjV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1413,101.695L1417.167,101.695C1421.333,101.695,1429.667,101.695,1438.576,103.664C1447.486,105.633,1456.972,109.571,1461.715,111.54L1466.457,113.509" id="my-svg-L_LLM_Target_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_LLM_Target_0" data-points="W3sieCI6MTQxMywieSI6MTAxLjY5NTMxMjV9LHsieCI6MTQzOCwieSI6MTAxLjY5NTMxMjV9LHsieCI6MTQ3MC4xNTE3MDI3ODYzNzc3LCJ5IjoxMTUuMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1470.152,217.043L1464.793,219.268C1459.434,221.492,1448.717,225.941,1423.816,228.166C1398.914,230.391,1359.828,230.391,1320.742,230.391C1281.656,230.391,1242.57,230.391,1203.245,230.391C1163.919,230.391,1124.354,230.391,1084.789,230.391C1045.224,230.391,1005.659,230.391,966.484,230.391C927.31,230.391,888.526,230.391,847.987,230.391C807.448,230.391,765.154,230.391,733.006,224.481C700.859,218.572,678.858,206.754,667.857,200.845L656.857,194.936" id="my-svg-L_Target_State_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Target_State_0" data-points="W3sieCI6MTQ3MC4xNTE3MDI3ODYzNzc3LCJ5IjoyMTcuMDQyOTY4NzV9LHsieCI6MTQzOCwieSI6MjMwLjM5MDYyNX0seyJ4IjoxMzIwLjc0MjE4NzUsInkiOjIzMC4zOTA2MjV9LHsieCI6MTIwMy40ODQzNzUsInkiOjIzMC4zOTA2MjV9LHsieCI6MTA4NC43ODkwNjI1LCJ5IjoyMzAuMzkwNjI1fSx7IngiOjk2Ni4wOTM3NSwieSI6MjMwLjM5MDYyNX0seyJ4Ijo4NDkuNzQyMTg3NSwieSI6MjMwLjM5MDYyNX0seyJ4Ijo3MjIuODU5Mzc1LCJ5IjoyMzAuMzkwNjI1fSx7IngiOjY1My4zMzMyODgyNzg1NDY3LCJ5IjoxOTMuMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1723,166.043L1727.167,166.043C1731.333,166.043,1739.667,166.043,1747.333,166.043C1755,166.043,1762,166.043,1765.5,166.043L1769,166.043" id="my-svg-L_Target_CI_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Target_CI_0" data-points="W3sieCI6MTcyMywieSI6MTY2LjA0Mjk2ODc1fSx7IngiOjE3NDgsInkiOjE2Ni4wNDI5Njg3NX0seyJ4IjoxNzczLCJ5IjoxNjYuMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1971.481,136.227L1984.766,131.529C1998.052,126.832,2024.624,117.438,2046.818,112.74C2069.013,108.043,2086.831,108.043,2095.74,108.043L2104.648,108.043" id="my-svg-L_CI_Pass_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_CI_Pass_0" data-points="W3sieCI6MTk3MS40ODA2MDU5MTI2NzM0LCJ5IjoxMzYuMjI2Njk5NjYyNjczMjd9LHsieCI6MjA1MS4xOTUzMTI1LCJ5IjoxMDguMDQyOTY4NzV9LHsieCI6MjEwOC42NDg0Mzc1LCJ5IjoxMDguMDQyOTY4NzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1971.481,195.859L1984.766,200.557C1998.052,205.254,2024.624,214.648,2045.559,219.346C2066.495,224.043,2081.794,224.043,2089.444,224.043L2097.094,224.043" id="my-svg-L_CI_Fail_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_CI_Fail_0" data-points="W3sieCI6MTk3MS40ODA2MDU5MTI2NzM0LCJ5IjoxOTUuODU5MjM3ODM3MzI2NzN9LHsieCI6MjA1MS4xOTUzMTI1LCJ5IjoyMjQuMDQyOTY4NzV9LHsieCI6MjEwMS4wOTM3NSwieSI6MjI0LjA0Mjk2ODc1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_Src_Hash_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Hash_State_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(722.859375, 101.6953125)"><g class="label" data-id="L_State_Dirty_0" transform="translate(-10.53125, -12)"><foreignObject width="21.0625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>diff</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Dirty_Loop_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Loop_LLM_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_LLM_Target_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Target_State_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Target_CI_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2051.1953125, 108.04296875)"><g class="label" data-id="L_CI_Pass_0" transform="translate(-24.8984375, -12)"><foreignObject width="49.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>in sync</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2051.1953125, 224.04296875)"><g class="label" data-id="L_CI_Fail_0" transform="translate(-13.3359375, -12)"><foreignObject width="26.671875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>drift</p></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-Src-0" data-look="classic" transform="translate(137.5859375, 166.04296875)"><rect class="basic label-container" style="" x="-129.5859375" y="-39" width="259.171875" height="78"/><g class="label" style="" transform="translate(-99.5859375, -24)"><rect/><foreignObject width="199.171875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Source MDs<br />(CLAUDE.md, docs/**/*.md)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Hash-1" data-look="classic" transform="translate(392.9921875, 166.04296875)"><rect class="basic label-container" style="" x="-75.8203125" y="-27" width="151.640625" height="54"/><g class="label" style="" transform="translate(-45.8203125, -12)"><rect/><foreignObject width="91.640625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>sha256 hash</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-State-3" data-look="classic" transform="translate(603.0703125, 166.04296875)"><rect class="basic label-container" style="" x="-84.2578125" y="-27" width="168.515625" height="54"/><g class="label" style="" transform="translate(-54.2578125, -12)"><rect/><foreignObject width="108.515625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>.i18n-state.json</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Dirty-5" data-look="classic" transform="translate(849.7421875, 101.6953125)"><rect class="basic label-container" style="" x="-91.3515625" y="-27" width="182.703125" height="54"/><g class="label" style="" transform="translate(-61.3515625, -12)"><rect/><foreignObject width="122.703125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Mark source dirty</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Loop-7" data-look="classic" transform="translate(1084.7890625, 101.6953125)"><polygon points="93.6953125,0 187.390625,-93.6953125 93.6953125,-187.390625 0,-93.6953125" class="label-container" transform="translate(-93.1953125, 93.6953125)"/><g class="label" style="" transform="translate(-54.6953125, -24)"><rect/><foreignObject width="109.390625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>For each locale<br />(39 langs)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-LLM-9" data-look="classic" transform="translate(1320.7421875, 101.6953125)"><rect class="basic label-container" style="" x="-92.2578125" y="-51" width="184.515625" height="102"/><g class="label" style="" transform="translate(-62.2578125, -36)"><rect/><foreignObject width="124.515625" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>OmniRoute<br />/chat/completions<br />(cx/gpt-5.4-mini)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Target-11" data-look="classic" transform="translate(1593, 166.04296875)"><rect class="basic label-container" style="" x="-130" y="-51" width="260" height="102"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Write<br />docs/i18n/<locale>/<rel-path>.md</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-CI-15" data-look="classic" transform="translate(1887.1484375, 166.04296875)"><polygon points="114.1484375,0 228.296875,-114.1484375 114.1484375,-228.296875 0,-114.1484375" class="label-container" transform="translate(-113.6484375, 114.1484375)"/><g class="label" style="" transform="translate(-75.1484375, -24)"><rect/><foreignObject width="150.296875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>CI drift check<br />(npm run i18n:check)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Pass-17" data-look="classic" transform="translate(2155.546875, 108.04296875)"><rect class="basic label-container" style="" x="-46.8984375" y="-27" width="93.796875" height="54"/><g class="label" style="" transform="translate(-16.8984375, -12)"><rect/><foreignObject width="33.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>pass</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Fail-19" data-look="classic" transform="translate(2155.546875, 224.04296875)"><rect class="basic label-container" style="" x="-54.453125" y="-39" width="108.90625" height="78"/><g class="label" style="" transform="translate(-24.453125, -24)"><rect/><foreignObject width="48.90625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>fail<br />(exit 1)</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/mcp-tools-37.svg b/docs/diagrams/exported/mcp-tools-37.svg new file mode 100644 index 0000000000..2877bf0caf --- /dev/null +++ b/docs/diagrams/exported/mcp-tools-37.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 668.516px; background-color: white;" viewBox="0 0 668.515625 1750" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M90.697,1156L106.204,1073.5C121.71,991,152.722,826,172.912,743.5C193.102,661,202.469,661,207.152,661L211.836,661" id="my-svg-L_MCP_Core_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MCP_Core_0" data-points="W3sieCI6OTAuNjk3Mzc1MzUxMTIzNiwieSI6MTE1Nn0seyJ4IjoxODMuNzM0Mzc1LCJ5Ijo2NjF9LHsieCI6MjE1LjgzNTkzNzUsInkiOjY2MX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M158.734,1195L162.901,1195C167.068,1195,175.401,1195,183.068,1195C190.734,1195,197.734,1195,201.234,1195L204.734,1195" id="my-svg-L_MCP_Mem_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MCP_Mem_0" data-points="W3sieCI6MTU4LjczNDM3NSwieSI6MTE5NX0seyJ4IjoxODMuNzM0Mzc1LCJ5IjoxMTk1fSx7IngiOjIwOC43MzQzNzUsInkiOjExOTV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M94.121,1234L109.056,1288.167C123.992,1342.333,153.863,1450.667,174.002,1504.833C194.141,1559,204.547,1559,209.75,1559L214.953,1559" id="my-svg-L_MCP_Skl_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_MCP_Skl_0" data-points="W3sieCI6OTQuMTIwODE0NzMyMTQyODYsInkiOjEyMzR9LHsieCI6MTgzLjczNDM3NSwieSI6MTU1OX0seyJ4IjoyMTguOTUzMTI1LCJ5IjoxNTU5fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M284.298,634L299.501,546.167C314.704,458.333,345.11,282.667,363.813,194.833C382.516,107,389.516,107,393.016,107L396.516,107" id="my-svg-L_Core_Essential_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Essential_0" data-points="W3sieCI6Mjg0LjI5ODM2OTgxMDQ2OTMsInkiOjYzNH0seyJ4IjozNzUuNTE1NjI1LCJ5IjoxMDd9LHsieCI6NDAwLjUxNTYyNSwieSI6MTA3fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M286.699,634L301.502,577.5C316.304,521,345.91,408,373.689,351.5C401.469,295,427.422,295,440.398,295L453.375,295" id="my-svg-L_Core_Search_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Search_0" data-points="W3sieCI6Mjg2LjY5ODg5ODU2NTU3Mzc2LCJ5Ijo2MzR9LHsieCI6Mzc1LjUxNTYyNSwieSI6Mjk1fSx7IngiOjQ1Ny4zNzUsInkiOjI5NX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M301.566,634L313.891,618.833C326.216,603.667,350.866,573.333,366.691,558.167C382.516,543,389.516,543,393.016,543L396.516,543" id="my-svg-L_Core_Advanced_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Advanced_0" data-points="W3sieCI6MzAxLjU2NjA3NTIxMTg2NDQsInkiOjYzNH0seyJ4IjozNzUuNTE1NjI1LCJ5Ijo1NDN9LHsieCI6NDAwLjUxNTYyNSwieSI6NTQzfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M301.566,688L313.891,703.167C326.216,718.333,350.866,748.667,377.503,763.833C404.141,779,432.766,779,447.078,779L461.391,779" id="my-svg-L_Core_Cache_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Cache_0" data-points="W3sieCI6MzAxLjU2NjA3NTIxMTg2NDQsInkiOjY4OH0seyJ4IjozNzUuNTE1NjI1LCJ5Ijo3Nzl9LHsieCI6NDY1LjM5MDYyNSwieSI6Nzc5fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M291.287,688L305.325,720.5C319.363,753,347.44,818,371.789,850.5C396.138,883,416.76,883,427.072,883L437.383,883" id="my-svg-L_Core_Compression_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Compression_0" data-points="W3sieCI6MjkxLjI4NzM3MzMxMDgxMDg0LCJ5Ijo2ODh9LHsieCI6Mzc1LjUxNTYyNSwieSI6ODgzfSx7IngiOjQ0MS4zODI4MTI1LCJ5Ijo4ODN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M287.567,688L302.225,737.833C316.883,787.667,346.199,887.333,369.093,937.167C391.987,987,408.458,987,416.694,987L424.93,987" id="my-svg-L_Core_Tunnels_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Core_Tunnels_0" data-points="W3sieCI6Mjg3LjU2Njg2MTU3OTc1NDYsInkiOjY4OH0seyJ4IjozNzUuNTE1NjI1LCJ5Ijo5ODd9LHsieCI6NDI4LjkyOTY4NzUsInkiOjk4N31d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M304.52,1168L316.352,1155.167C328.185,1142.333,351.85,1116.667,374.291,1103.833C396.732,1091,417.948,1091,428.556,1091L439.164,1091" id="my-svg-L_Mem_M1_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Mem_M1_0" data-points="W3sieCI6MzA0LjUxOTY4MTQ5MDM4NDY0LCJ5IjoxMTY4fSx7IngiOjM3NS41MTU2MjUsInkiOjEwOTF9LHsieCI6NDQzLjE2NDA2MjUsInkiOjEwOTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M350.516,1195L354.682,1195C358.849,1195,367.182,1195,383.142,1195C399.102,1195,422.688,1195,434.48,1195L446.273,1195" id="my-svg-L_Mem_M2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Mem_M2_0" data-points="W3sieCI6MzUwLjUxNTYyNSwieSI6MTE5NX0seyJ4IjozNzUuNTE1NjI1LCJ5IjoxMTk1fSx7IngiOjQ1MC4yNzM0Mzc1LCJ5IjoxMTk1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M304.52,1222L316.352,1234.833C328.185,1247.667,351.85,1273.333,374.66,1286.167C397.469,1299,419.422,1299,430.398,1299L441.375,1299" id="my-svg-L_Mem_M3_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Mem_M3_0" data-points="W3sieCI6MzA0LjUxOTY4MTQ5MDM4NDY0LCJ5IjoxMjIyfSx7IngiOjM3NS41MTU2MjUsInkiOjEyOTl9LHsieCI6NDQ1LjM3NSwieSI6MTI5OX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M296.221,1532L309.437,1510.5C322.653,1489,349.084,1446,375.649,1424.5C402.214,1403,428.911,1403,442.26,1403L455.609,1403" id="my-svg-L_Skl_S1_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Skl_S1_0" data-points="W3sieCI6Mjk2LjIyMTQ1NDMyNjkyMzEsInkiOjE1MzJ9LHsieCI6Mzc1LjUxNTYyNSwieSI6MTQwM30seyJ4Ijo0NTkuNjA5Mzc1LCJ5IjoxNDAzfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M329.414,1532L337.098,1527.833C344.781,1523.667,360.149,1515.333,383.405,1511.167C406.661,1507,437.807,1507,453.38,1507L468.953,1507" id="my-svg-L_Skl_S2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Skl_S2_0" data-points="W3sieCI6MzI5LjQxNDM2Mjk4MDc2OTIsInkiOjE1MzJ9LHsieCI6Mzc1LjUxNTYyNSwieSI6MTUwN30seyJ4Ijo0NzIuOTUzMTI1LCJ5IjoxNTA3fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M329.414,1586L337.098,1590.167C344.781,1594.333,360.149,1602.667,379.622,1606.833C399.096,1611,422.677,1611,434.467,1611L446.258,1611" id="my-svg-L_Skl_S3_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Skl_S3_0" data-points="W3sieCI6MzI5LjQxNDM2Mjk4MDc2OTIsInkiOjE1ODZ9LHsieCI6Mzc1LjUxNTYyNSwieSI6MTYxMX0seyJ4Ijo0NTAuMjU3ODEyNSwieSI6MTYxMX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M296.221,1586L309.437,1607.5C322.653,1629,349.084,1672,374.611,1693.5C400.138,1715,424.76,1715,437.072,1715L449.383,1715" id="my-svg-L_Skl_S4_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Skl_S4_0" data-points="W3sieCI6Mjk2LjIyMTQ1NDMyNjkyMzEsInkiOjE1ODZ9LHsieCI6Mzc1LjUxNTYyNSwieSI6MTcxNX0seyJ4Ijo0NTMuMzgyODEyNSwieSI6MTcxNX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_MCP_Core_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_MCP_Mem_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_MCP_Skl_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Essential_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Search_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Advanced_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Cache_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Compression_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Core_Tunnels_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Mem_M1_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Mem_M2_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Mem_M3_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Skl_S1_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Skl_S2_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Skl_S3_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Skl_S4_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-MCP-0" data-look="classic" transform="translate(83.3671875, 1195)"><rect class="basic label-container" style="" x="-75.3671875" y="-39" width="150.734375" height="78"/><g class="label" style="" transform="translate(-45.3671875, -24)"><rect/><foreignObject width="90.734375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>MCP Server<br />37 tools total</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Core-1" data-look="classic" transform="translate(279.625, 661)"><rect class="basic label-container" style="" x="-63.7890625" y="-27" width="127.578125" height="54"/><g class="label" style="" transform="translate(-33.7890625, -12)"><rect/><foreignObject width="67.578125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Core (30)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Mem-3" data-look="classic" transform="translate(279.625, 1195)"><rect class="basic label-container" style="" x="-70.890625" y="-27" width="141.78125" height="54"/><g class="label" style="" transform="translate(-40.890625, -12)"><rect/><foreignObject width="81.78125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Memory (3)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Skl-5" data-look="classic" transform="translate(279.625, 1559)"><rect class="basic label-container" style="" x="-60.671875" y="-27" width="121.34375" height="54"/><g class="label" style="" transform="translate(-30.671875, -12)"><rect/><foreignObject width="61.34375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Skills (4)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Essential-7" data-look="classic" transform="translate(530.515625, 107)"><rect class="basic label-container" style="" x="-130" y="-99" width="260" height="198"/><g class="label" style="" transform="translate(-100, -84)"><rect/><foreignObject width="200" height="168"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Essential (8)<br />get_health, list_combos,<br />switch_combo, check_quota,<br />route_request, cost_report,<br />list_models_catalog,<br />get_combo_metrics</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Search-9" data-look="classic" transform="translate(530.515625, 295)"><rect class="basic label-container" style="" x="-73.140625" y="-39" width="146.28125" height="78"/><g class="label" style="" transform="translate(-43.140625, -24)"><rect/><foreignObject width="86.28125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Search (1)<br />web_search</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Advanced-11" data-look="classic" transform="translate(530.515625, 543)"><rect class="basic label-container" style="" x="-130" y="-159" width="260" height="318"/><g class="label" style="" transform="translate(-100, -144)"><rect/><foreignObject width="200" height="288"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Advanced (11)<br />simulate_route, set_budget_guard,<br />set_routing_strategy,<br />set_resilience_profile,<br />test_combo, get_provider_metrics,<br />best_combo_for_task, explain_route,<br />get_session_snapshot,<br />db_health_check, sync_pricing</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Cache-13" data-look="classic" transform="translate(530.515625, 779)"><rect class="basic label-container" style="" x="-65.125" y="-27" width="130.25" height="54"/><g class="label" style="" transform="translate(-35.125, -12)"><rect/><foreignObject width="70.25" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Cache (2)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Compression-15" data-look="classic" transform="translate(530.515625, 883)"><rect class="basic label-container" style="" x="-89.1328125" y="-27" width="178.265625" height="54"/><g class="label" style="" transform="translate(-59.1328125, -12)"><rect/><foreignObject width="118.265625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Compression (5)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Tunnels-17" data-look="classic" transform="translate(530.515625, 987)"><rect class="basic label-container" style="" x="-101.5859375" y="-27" width="203.171875" height="54"/><g class="label" style="" transform="translate(-71.5859375, -12)"><rect/><foreignObject width="143.171875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>1Proxy / Tunnels (3)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-M1-19" data-look="classic" transform="translate(530.515625, 1091)"><rect class="basic label-container" style="" x="-87.3515625" y="-27" width="174.703125" height="54"/><g class="label" style="" transform="translate(-57.3515625, -12)"><rect/><foreignObject width="114.703125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>memory_search</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-M2-21" data-look="classic" transform="translate(530.515625, 1195)"><rect class="basic label-container" style="" x="-80.2421875" y="-27" width="160.484375" height="54"/><g class="label" style="" transform="translate(-50.2421875, -12)"><rect/><foreignObject width="100.484375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>memory_save</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-M3-23" data-look="classic" transform="translate(530.515625, 1299)"><rect class="basic label-container" style="" x="-85.140625" y="-27" width="170.28125" height="54"/><g class="label" style="" transform="translate(-55.140625, -12)"><rect/><foreignObject width="110.28125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>memory_delete</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-S1-25" data-look="classic" transform="translate(530.515625, 1403)"><rect class="basic label-container" style="" x="-70.90625" y="-27" width="141.8125" height="54"/><g class="label" style="" transform="translate(-40.90625, -12)"><rect/><foreignObject width="81.8125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>skill_invoke</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-S2-27" data-look="classic" transform="translate(530.515625, 1507)"><rect class="basic label-container" style="" x="-57.5625" y="-27" width="115.125" height="54"/><g class="label" style="" transform="translate(-27.5625, -12)"><rect/><foreignObject width="55.125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>skill_list</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-S3-29" data-look="classic" transform="translate(530.515625, 1611)"><rect class="basic label-container" style="" x="-80.2578125" y="-27" width="160.515625" height="54"/><g class="label" style="" transform="translate(-50.2578125, -12)"><rect/><foreignObject width="100.515625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>skill_diagnose</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-S4-31" data-look="classic" transform="translate(530.515625, 1715)"><rect class="basic label-container" style="" x="-77.1328125" y="-27" width="154.265625" height="54"/><g class="label" style="" transform="translate(-47.1328125, -12)"><rect/><foreignObject width="94.265625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>skill_uninstall</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/request-pipeline.svg b/docs/diagrams/exported/request-pipeline.svg new file mode 100644 index 0000000000..f64c7903fe --- /dev/null +++ b/docs/diagrams/exported/request-pipeline.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 4194.58px; background-color: white;" viewBox="0 0 4194.578125 268.125" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M172.016,104.711L176.182,102.759C180.349,100.807,188.682,96.904,196.349,94.952C204.016,93,211.016,93,214.516,93L218.016,93" id="my-svg-L_Client_Route_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Client_Route_0" data-points="W3sieCI6MTcyLjAxNTYyNSwieSI6MTA0LjcxMDU5MzU2MDYzMzczfSx7IngiOjE5Ny4wMTU2MjUsInkiOjkzfSx7IngiOjIyMi4wMTU2MjUsInkiOjkzfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M427.875,93L432.042,93C436.208,93,444.542,93,452.208,93C459.875,93,466.875,93,470.375,93L473.875,93" id="my-svg-L_Route_CORS_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Route_CORS_0" data-points="W3sieCI6NDI3Ljg3NSwieSI6OTN9LHsieCI6NDUyLjg3NSwieSI6OTN9LHsieCI6NDc3Ljg3NSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M645.469,93L649.635,93C653.802,93,662.135,93,669.802,93C677.469,93,684.469,93,687.969,93L691.469,93" id="my-svg-L_CORS_Validate_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_CORS_Validate_0" data-points="W3sieCI6NjQ1LjQ2ODc1LCJ5Ijo5M30seyJ4Ijo2NzAuNDY4NzUsInkiOjkzfSx7IngiOjY5NS40Njg3NSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M858.641,93L862.807,93C866.974,93,875.307,93,882.974,93C890.641,93,897.641,93,901.141,93L904.641,93" id="my-svg-L_Validate_Authz_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Validate_Authz_0" data-points="W3sieCI6ODU4LjY0MDYyNSwieSI6OTN9LHsieCI6ODgzLjY0MDYyNSwieSI6OTN9LHsieCI6OTA4LjY0MDYyNSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1086.469,93L1090.635,93C1094.802,93,1103.135,93,1110.802,93C1118.469,93,1125.469,93,1128.969,93L1132.469,93" id="my-svg-L_Authz_Policy_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Authz_Policy_0" data-points="W3sieCI6MTA4Ni40Njg3NSwieSI6OTN9LHsieCI6MTExMS40Njg3NSwieSI6OTN9LHsieCI6MTEzNi40Njg3NSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1332.078,93L1336.245,93C1340.411,93,1348.745,93,1356.411,93C1364.078,93,1371.078,93,1374.578,93L1378.078,93" id="my-svg-L_Policy_Guard_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Policy_Guard_0" data-points="W3sieCI6MTMzMi4wNzgxMjUsInkiOjkzfSx7IngiOjEzNTcuMDc4MTI1LCJ5Ijo5M30seyJ4IjoxMzgyLjA3ODEyNSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1557.688,93L1561.854,93C1566.021,93,1574.354,93,1582.021,93C1589.688,93,1596.688,93,1600.188,93L1603.688,93" id="my-svg-L_Guard_ChatCore_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Guard_ChatCore_0" data-points="W3sieCI6MTU1Ny42ODc1LCJ5Ijo5M30seyJ4IjoxNTgyLjY4NzUsInkiOjkzfSx7IngiOjE2MDcuNjg3NSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1784.219,93L1788.385,93C1792.552,93,1800.885,93,1808.552,93C1816.219,93,1823.219,93,1826.719,93L1830.219,93" id="my-svg-L_ChatCore_Cache_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_ChatCore_Cache_0" data-points="W3sieCI6MTc4NC4yMTg3NSwieSI6OTN9LHsieCI6MTgwOS4yMTg3NSwieSI6OTN9LHsieCI6MTgzNC4yMTg3NSwieSI6OTN9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1941.169,69.45L1951.336,63.709C1961.503,57.967,1981.838,46.483,1998.515,40.742C2015.193,35,2028.214,35,2034.724,35L2041.234,35" id="my-svg-L_Cache_Return_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Cache_Return_0" data-points="W3sieCI6MTk0MS4xNjkxMTQ2MDg2NTM0LCJ5Ijo2OS40NTAzNjQ2MDg2NTMzN30seyJ4IjoyMDAyLjE3MTg3NSwieSI6MzV9LHsieCI6MjA0NS4yMzQzNzUsInkiOjM1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M1941.169,116.55L1951.336,122.291C1961.503,128.033,1981.838,139.517,1997.58,145.258C2013.323,151,2024.474,151,2030.049,151L2035.625,151" id="my-svg-L_Cache_Rate_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Cache_Rate_0" data-points="W3sieCI6MTk0MS4xNjkxMTQ2MDg2NTM0LCJ5IjoxMTYuNTQ5NjM1MzkxMzQ2NjN9LHsieCI6MjAwMi4xNzE4NzUsInkiOjE1MX0seyJ4IjoyMDM5LjYyNSwieSI6MTUxfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2214.906,151L2219.073,151C2223.24,151,2231.573,151,2239.24,151C2246.906,151,2253.906,151,2257.406,151L2260.906,151" id="my-svg-L_Rate_Combo_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Rate_Combo_0" data-points="W3sieCI6MjIxNC45MDYyNSwieSI6MTUxfSx7IngiOjIyMzkuOTA2MjUsInkiOjE1MX0seyJ4IjoyMjY0LjkwNjI1LCJ5IjoxNTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2376.717,133.233L2387.848,129.028C2398.978,124.822,2421.239,116.411,2439.872,112.206C2458.505,108,2473.51,108,2481.013,108L2488.516,108" id="my-svg-L_Combo_Resolve_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Combo_Resolve_0" data-points="W3sieCI6MjM3Ni43MTc0OTc0MTU0MjU0LCJ5IjoxMzMuMjMzMTIyNDE1NDI1MjR9LHsieCI6MjQ0My41LCJ5IjoxMDh9LHsieCI6MjQ5Mi41MTU2MjUsInkiOjEwOH1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2708.141,108L2712.307,108C2716.474,108,2724.807,108,2732.511,109.236C2740.215,110.472,2747.29,112.944,2750.827,114.18L2754.365,115.416" id="my-svg-L_Resolve_Single_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Resolve_Single_0" data-points="W3sieCI6MjcwOC4xNDA2MjUsInkiOjEwOH0seyJ4IjoyNzMzLjE0MDYyNSwieSI6MTA4fSx7IngiOjI3NTguMTQwNjI1LCJ5IjoxMTYuNzM1OTUzMjcyODA4MDh9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2376.717,168.767L2387.848,172.972C2398.978,177.178,2421.239,185.589,2458.508,189.794C2495.776,194,2548.052,194,2596.326,194C2644.599,194,2688.87,194,2714.543,192.764C2740.215,191.528,2747.29,189.056,2750.827,187.82L2754.365,186.584" id="my-svg-L_Combo_Single_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Combo_Single_0" data-points="W3sieCI6MjM3Ni43MTc0OTc0MTU0MjU0LCJ5IjoxNjguNzY2ODc3NTg0NTc0NzZ9LHsieCI6MjQ0My41LCJ5IjoxOTR9LHsieCI6MjYwMC4zMjgxMjUsInkiOjE5NH0seyJ4IjoyNzMzLjE0MDYyNSwieSI6MTk0fSx7IngiOjI3NTguMTQwNjI1LCJ5IjoxODUuMjY0MDQ2NzI3MTkxOTJ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M2954.25,151L2958.417,151C2962.583,151,2970.917,151,2978.583,151C2986.25,151,2993.25,151,2996.75,151L3000.25,151" id="my-svg-L_Single_Translate_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Single_Translate_0" data-points="W3sieCI6Mjk1NC4yNSwieSI6MTUxfSx7IngiOjI5NzkuMjUsInkiOjE1MX0seyJ4IjozMDA0LjI1LCJ5IjoxNTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M3262.547,151L3266.714,151C3270.88,151,3279.214,151,3286.88,151C3294.547,151,3301.547,151,3305.047,151L3308.547,151" id="my-svg-L_Translate_Exec_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Translate_Exec_0" data-points="W3sieCI6MzI2Mi41NDY4NzUsInkiOjE1MX0seyJ4IjozMjg3LjU0Njg3NSwieSI6MTUxfSx7IngiOjMzMTIuNTQ2ODc1LCJ5IjoxNTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M3474.813,151L3478.979,151C3483.146,151,3491.479,151,3499.146,151C3506.813,151,3513.813,151,3517.313,151L3520.813,151" id="my-svg-L_Exec_Upstream_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Exec_Upstream_0" data-points="W3sieCI6MzQ3NC44MTI1LCJ5IjoxNTF9LHsieCI6MzQ5OS44MTI1LCJ5IjoxNTF9LHsieCI6MzUyNC44MTI1LCJ5IjoxNTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M3718.188,151L3722.354,151C3726.521,151,3734.854,151,3742.521,151C3750.188,151,3757.188,151,3760.688,151L3764.188,151" id="my-svg-L_Upstream_Stream_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Upstream_Stream_0" data-points="W3sieCI6MzcxOC4xODc1LCJ5IjoxNTF9LHsieCI6Mzc0My4xODc1LCJ5IjoxNTF9LHsieCI6Mzc2OC4xODc1LCJ5IjoxNTF9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M3916.219,151L3920.385,151C3924.552,151,3932.885,151,3941.427,152.622C3949.969,154.245,3958.72,157.49,3963.095,159.112L3967.471,160.734" id="my-svg-L_Stream_Transformer_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Stream_Transformer_0" data-points="W3sieCI6MzkxNi4yMTg3NSwieSI6MTUxfSx7IngiOjM5NDEuMjE4NzUsInkiOjE1MX0seyJ4IjozOTcxLjIyMTIyNDI4MzA0MjQsInkiOjE2Mi4xMjV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M3987.042,240.125L3979.405,243.458C3971.768,246.792,3956.493,253.458,3932.353,256.792C3908.214,260.125,3875.208,260.125,3842.203,260.125C3809.198,260.125,3776.193,260.125,3739.409,260.125C3702.625,260.125,3662.063,260.125,3621.5,260.125C3580.938,260.125,3540.375,260.125,3502.405,260.125C3464.435,260.125,3429.057,260.125,3393.68,260.125C3358.302,260.125,3322.924,260.125,3279.544,260.125C3236.164,260.125,3184.781,260.125,3133.398,260.125C3082.016,260.125,3030.633,260.125,2984.432,260.125C2938.232,260.125,2897.214,260.125,2856.195,260.125C2815.177,260.125,2774.159,260.125,2731.514,260.125C2688.87,260.125,2644.599,260.125,2596.326,260.125C2548.052,260.125,2495.776,260.125,2450.671,260.125C2405.565,260.125,2367.63,260.125,2333.698,260.125C2299.766,260.125,2269.836,260.125,2236.098,260.125C2202.359,260.125,2164.813,260.125,2125.19,260.125C2085.568,260.125,2043.87,260.125,2005.904,260.125C1967.938,260.125,1933.703,260.125,1901.544,260.125C1869.385,260.125,1839.302,260.125,1805.383,260.125C1771.464,260.125,1733.708,260.125,1695.953,260.125C1658.198,260.125,1620.443,260.125,1582.764,260.125C1545.086,260.125,1507.484,260.125,1469.883,260.125C1432.281,260.125,1394.68,260.125,1355.411,260.125C1316.143,260.125,1275.208,260.125,1234.273,260.125C1193.339,260.125,1152.404,260.125,1112.951,260.125C1073.497,260.125,1035.526,260.125,997.555,260.125C959.583,260.125,921.612,260.125,884.862,260.125C848.112,260.125,812.583,260.125,777.055,260.125C741.526,260.125,705.997,260.125,670.1,260.125C634.203,260.125,597.938,260.125,561.672,260.125C525.406,260.125,489.141,260.125,449.686,260.125C410.232,260.125,367.589,260.125,324.945,260.125C282.302,260.125,239.659,260.125,206.897,247.617C174.136,235.109,151.256,210.093,139.816,197.585L128.377,185.077" id="my-svg-L_Transformer_Client_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Transformer_Client_0" data-points="W3sieCI6Mzk4Ny4wNDIzNzI4ODEzNTU3LCJ5IjoyNDAuMTI1fSx7IngiOjM5NDEuMjE4NzUsInkiOjI2MC4xMjV9LHsieCI6Mzg0Mi4yMDMxMjUsInkiOjI2MC4xMjV9LHsieCI6Mzc0My4xODc1LCJ5IjoyNjAuMTI1fSx7IngiOjM2MjEuNSwieSI6MjYwLjEyNX0seyJ4IjozNDk5LjgxMjUsInkiOjI2MC4xMjV9LHsieCI6MzM5My42Nzk2ODc1LCJ5IjoyNjAuMTI1fSx7IngiOjMyODcuNTQ2ODc1LCJ5IjoyNjAuMTI1fSx7IngiOjMxMzMuMzk4NDM3NSwieSI6MjYwLjEyNX0seyJ4IjoyOTc5LjI1LCJ5IjoyNjAuMTI1fSx7IngiOjI4NTYuMTk1MzEyNSwieSI6MjYwLjEyNX0seyJ4IjoyNzMzLjE0MDYyNSwieSI6MjYwLjEyNX0seyJ4IjoyNjAwLjMyODEyNSwieSI6MjYwLjEyNX0seyJ4IjoyNDQzLjUsInkiOjI2MC4xMjV9LHsieCI6MjMyOS42OTUzMTI1LCJ5IjoyNjAuMTI1fSx7IngiOjIyMzkuOTA2MjUsInkiOjI2MC4xMjV9LHsieCI6MjEyNy4yNjU2MjUsInkiOjI2MC4xMjV9LHsieCI6MjAwMi4xNzE4NzUsInkiOjI2MC4xMjV9LHsieCI6MTg5OS40Njg3NSwieSI6MjYwLjEyNX0seyJ4IjoxODA5LjIxODc1LCJ5IjoyNjAuMTI1fSx7IngiOjE2OTUuOTUzMTI1LCJ5IjoyNjAuMTI1fSx7IngiOjE1ODIuNjg3NSwieSI6MjYwLjEyNX0seyJ4IjoxNDY5Ljg4MjgxMjUsInkiOjI2MC4xMjV9LHsieCI6MTM1Ny4wNzgxMjUsInkiOjI2MC4xMjV9LHsieCI6MTIzNC4yNzM0Mzc1LCJ5IjoyNjAuMTI1fSx7IngiOjExMTEuNDY4NzUsInkiOjI2MC4xMjV9LHsieCI6OTk3LjU1NDY4NzUsInkiOjI2MC4xMjV9LHsieCI6ODgzLjY0MDYyNSwieSI6MjYwLjEyNX0seyJ4Ijo3NzcuMDU0Njg3NSwieSI6MjYwLjEyNX0seyJ4Ijo2NzAuNDY4NzUsInkiOjI2MC4xMjV9LHsieCI6NTYxLjY3MTg3NSwieSI6MjYwLjEyNX0seyJ4Ijo0NTIuODc1LCJ5IjoyNjAuMTI1fSx7IngiOjMyNC45NDUzMTI1LCJ5IjoyNjAuMTI1fSx7IngiOjE5Ny4wMTU2MjUsInkiOjI2MC4xMjV9LHsieCI6MTI1LjY3NzA4MzMzMzMzMzM0LCJ5IjoxODIuMTI1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_Client_Route_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Route_CORS_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_CORS_Validate_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Validate_Authz_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Authz_Policy_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Policy_Guard_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Guard_ChatCore_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_ChatCore_Cache_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2002.171875, 35)"><g class="label" data-id="L_Cache_Return_0" transform="translate(-12.453125, -12)"><foreignObject width="24.90625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>yes</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2002.171875, 151)"><g class="label" data-id="L_Cache_Rate_0" transform="translate(-8.8984375, -12)"><foreignObject width="17.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>no</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Rate_Combo_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2443.5, 108)"><g class="label" data-id="L_Combo_Resolve_0" transform="translate(-24.015625, -12)"><foreignObject width="48.03125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>combo</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Resolve_Single_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(2600.328125, 194)"><g class="label" data-id="L_Combo_Single_0" transform="translate(-20.90625, -12)"><foreignObject width="41.8125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>single</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Single_Translate_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Translate_Exec_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Exec_Upstream_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Upstream_Stream_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Stream_Transformer_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Transformer_Client_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-Client-0" data-look="classic" transform="translate(90.0078125, 143.125)"><rect class="basic label-container" style="" x="-82.0078125" y="-39" width="164.015625" height="78"/><g class="label" style="" transform="translate(-52.0078125, -24)"><rect/><foreignObject width="104.015625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Client<br />(IDE/CLI/SDK)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Route-1" data-look="classic" transform="translate(324.9453125, 93)"><rect class="basic label-container" style="" x="-102.9296875" y="-39" width="205.859375" height="78"/><g class="label" style="" transform="translate(-72.9296875, -24)"><rect/><foreignObject width="145.859375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Next.js Route<br />/v1/chat/completions</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-CORS-3" data-look="classic" transform="translate(561.671875, 93)"><rect class="basic label-container" style="" x="-83.796875" y="-27" width="167.59375" height="54"/><g class="label" style="" transform="translate(-53.796875, -12)"><rect/><foreignObject width="107.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>CORS preflight</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Validate-5" data-look="classic" transform="translate(777.0546875, 93)"><rect class="basic label-container" style="" x="-81.5859375" y="-39" width="163.171875" height="78"/><g class="label" style="" transform="translate(-51.5859375, -24)"><rect/><foreignObject width="103.171875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Zod validation<br />(request body)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Authz-7" data-look="classic" transform="translate(997.5546875, 93)"><rect class="basic label-container" style="" x="-88.9140625" y="-51" width="177.828125" height="102"/><g class="label" style="" transform="translate(-58.9140625, -36)"><rect/><foreignObject width="117.828125" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>AuthZ pipeline<br />(extractApiKey +<br />isValidApiKey)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Policy-9" data-look="classic" transform="translate(1234.2734375, 93)"><rect class="basic label-container" style="" x="-97.8046875" y="-39" width="195.609375" height="78"/><g class="label" style="" transform="translate(-67.8046875, -24)"><rect/><foreignObject width="135.609375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>API key policy<br />(allowlist + scopes)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Guard-11" data-look="classic" transform="translate(1469.8828125, 93)"><rect class="basic label-container" style="" x="-87.8046875" y="-39" width="175.609375" height="78"/><g class="label" style="" transform="translate(-57.8046875, -24)"><rect/><foreignObject width="115.609375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Prompt-injection<br />guardrail</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-ChatCore-13" data-look="classic" transform="translate(1695.953125, 93)"><rect class="basic label-container" style="" x="-88.265625" y="-27" width="176.53125" height="54"/><g class="label" style="" transform="translate(-58.265625, -12)"><rect/><foreignObject width="116.53125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>handleChatCore</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Cache-15" data-look="classic" transform="translate(1899.46875, 93)"><polygon points="65.25,0 130.5,-65.25 65.25,-130.5 0,-65.25" class="label-container" transform="translate(-64.75, 65.25)"/><g class="label" style="" transform="translate(-38.25, -12)"><rect/><foreignObject width="76.5" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Cache hit?</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Return-17" data-look="classic" transform="translate(2127.265625, 35)"><rect class="basic label-container" style="" x="-82.03125" y="-27" width="164.0625" height="54"/><g class="label" style="" transform="translate(-52.03125, -12)"><rect/><foreignObject width="104.0625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Return cached</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Rate-19" data-look="classic" transform="translate(2127.265625, 151)"><rect class="basic label-container" style="" x="-87.640625" y="-39" width="175.28125" height="78"/><g class="label" style="" transform="translate(-57.640625, -24)"><rect/><foreignObject width="115.28125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Rate limit<br />(per-key, per-IP)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Combo-21" data-look="classic" transform="translate(2329.6953125, 151)"><polygon points="64.7890625,0 129.578125,-64.7890625 64.7890625,-129.578125 0,-64.7890625" class="label-container" transform="translate(-64.2890625, 64.7890625)"/><g class="label" style="" transform="translate(-25.7890625, -24)"><rect/><foreignObject width="51.578125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Combo<br />target?</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Resolve-23" data-look="classic" transform="translate(2600.328125, 108)"><rect class="basic label-container" style="" x="-107.8125" y="-39" width="215.625" height="78"/><g class="label" style="" transform="translate(-77.8125, -24)"><rect/><foreignObject width="155.625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>resolveComboTargets<br />(14 strategies)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Single-25" data-look="classic" transform="translate(2856.1953125, 151)"><rect class="basic label-container" style="" x="-98.0546875" y="-39" width="196.109375" height="78"/><g class="label" style="" transform="translate(-68.0546875, -24)"><rect/><foreignObject width="136.109375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>handleSingleModel<br />(per target)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Translate-29" data-look="classic" transform="translate(3133.3984375, 151)"><rect class="basic label-container" style="" x="-129.1484375" y="-39" width="258.296875" height="78"/><g class="label" style="" transform="translate(-99.1484375, -24)"><rect/><foreignObject width="198.296875" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>translateRequest<br />(OpenAI↔Claude↔Gemini)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Exec-31" data-look="classic" transform="translate(3393.6796875, 151)"><rect class="basic label-container" style="" x="-81.1328125" y="-39" width="162.265625" height="78"/><g class="label" style="" transform="translate(-51.1328125, -24)"><rect/><foreignObject width="102.265625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>getExecutor<br />(31 executors)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Upstream-33" data-look="classic" transform="translate(3621.5, 151)"><rect class="basic label-container" style="" x="-96.6875" y="-39" width="193.375" height="78"/><g class="label" style="" transform="translate(-66.6875, -24)"><rect/><foreignObject width="133.375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Upstream Provider<br />(177 providers)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Stream-35" data-look="classic" transform="translate(3842.203125, 151)"><rect class="basic label-container" style="" x="-74.015625" y="-27" width="148.03125" height="54"/><g class="label" style="" transform="translate(-44.015625, -12)"><rect/><foreignObject width="88.03125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>SSE / JSON</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Transformer-37" data-look="classic" transform="translate(4076.3984375, 201.125)"><rect class="basic label-container" style="" x="-110.1796875" y="-39" width="220.359375" height="78"/><g class="label" style="" transform="translate(-80.1796875, -24)"><rect/><foreignObject width="160.359375" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>responsesTransformer<br />(Responses↔Chat)</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/exported/resilience-3layers.svg b/docs/diagrams/exported/resilience-3layers.svg new file mode 100644 index 0000000000..b1804b1da2 --- /dev/null +++ b/docs/diagrams/exported/resilience-3layers.svg @@ -0,0 +1 @@ +<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 1081.95px; background-color: white;" viewBox="0 0 1081.953125 1458.59375" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:1px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#9370DB;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#my-svg [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M751.867,62L751.867,66.167C751.867,70.333,751.867,78.667,751.867,86.333C751.867,94,751.867,101,751.867,104.5L751.867,108" id="my-svg-L_Req_L1_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Req_L1_0" data-points="W3sieCI6NzUxLjg2NzE4NzUsInkiOjYyfSx7IngiOjc1MS44NjcxODc1LCJ5Ijo4N30seyJ4Ijo3NTEuODY3MTg3NSwieSI6MTEyfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M751.867,359.828L751.867,365.995C751.867,372.161,751.867,384.495,751.867,403.328C751.867,422.161,751.867,447.495,751.867,470.828C751.867,494.161,751.867,515.495,756.538,536.417C761.208,557.339,770.548,577.849,775.219,588.104L779.889,598.36" id="my-svg-L_L1_L2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L1_L2_0" data-points="W3sieCI6NzUxLjg2NzE4NzUsInkiOjM1OS44MjgxMjV9LHsieCI6NzUxLjg2NzE4NzUsInkiOjM5Ni44MjgxMjV9LHsieCI6NzUxLjg2NzE4NzUsInkiOjQ3Mi44MjgxMjV9LHsieCI6NzUxLjg2NzE4NzUsInkiOjUzNi44MjgxMjV9LHsieCI6NzgxLjU0Njg5MDAzNzcwOTEsInkiOjYwMS45OTk5ODQ5NjIyOTA5fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M689.548,297.509L672.801,314.062C656.053,330.616,622.558,363.722,605.81,385.775C589.063,407.828,589.063,418.828,589.063,424.328L589.063,429.828" id="my-svg-L_L1_Block1_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L1_Block1_0" data-points="W3sieCI6Njg5LjU0ODMwNjYxMjkwOTEsInkiOjI5Ny41MDkyNDQxMTI5MDkxfSx7IngiOjU4OS4wNjI1LCJ5IjozOTYuODI4MTI1fSx7IngiOjU4OS4wNjI1LCJ5Ijo0MzMuODI4MTI1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M809.453,302.243L823.139,318.007C836.825,333.771,864.198,365.3,877.884,388.564C891.57,411.828,891.57,426.828,891.57,434.328L891.57,441.828" id="my-svg-L_L1_Probe_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L1_Probe_0" data-points="W3sieCI6ODA5LjQ1MjY1NjYwMzI3NzEsInkiOjMwMi4yNDI2NTU4OTY3MjI5fSx7IngiOjg5MS41NzAzMTI1LCJ5IjozOTYuODI4MTI1fSx7IngiOjg5MS41NzAzMTI1LCJ5Ijo0NDUuODI4MTI1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M891.57,499.828L891.57,505.995C891.57,512.161,891.57,524.495,886.9,540.917C882.23,557.339,872.889,577.849,868.219,588.104L863.548,598.36" id="my-svg-L_Probe_L2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Probe_L2_0" data-points="W3sieCI6ODkxLjU3MDMxMjUsInkiOjQ5OS44MjgxMjV9LHsieCI6ODkxLjU3MDMxMjUsInkiOjUzNi44MjgxMjV9LHsieCI6ODYxLjg5MDYwOTk2MjI5MDksInkiOjYwMS45OTk5ODQ5NjIyOTA5fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M760.429,757.304L745.464,773.686C730.499,790.067,700.57,822.83,685.605,844.712C670.641,866.594,670.641,877.594,670.641,883.094L670.641,888.594" id="my-svg-L_L2_L3_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L2_L3_0" data-points="W3sieCI6NzYwLjQyODkyNzc5MzM0NDMsInkiOjc1Ny4zMDM5Mjc3OTMzNDQzfSx7IngiOjY3MC42NDA2MjUsInkiOjg1NS41OTM3NX0seyJ4Ijo2NzAuNjQwNjI1LCJ5Ijo4OTIuNTkzNzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M883.009,757.304L897.973,773.686C912.938,790.067,942.867,822.83,957.832,863.379C972.797,903.927,972.797,952.26,972.797,976.427L972.797,1000.594" id="my-svg-L_L2_Skip2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L2_Skip2_0" data-points="W3sieCI6ODgzLjAwODU3MjIwNjY1NTcsInkiOjc1Ny4zMDM5Mjc3OTMzNDQzfSx7IngiOjk3Mi43OTY4NzUsInkiOjg1NS41OTM3NX0seyJ4Ijo5NzIuNzk2ODc1LCJ5IjoxMDA0LjU5Mzc1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M608.14,1132.093L596.429,1148.677C584.717,1165.26,561.294,1198.427,549.583,1220.51C537.871,1242.594,537.871,1253.594,537.871,1259.094L537.871,1264.594" id="my-svg-L_L3_Exec_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L3_Exec_0" data-points="W3sieCI6NjA4LjE0MDMwMjI4OTcyMDgsInkiOjExMzIuMDkzNDI3Mjg5NzIwN30seyJ4Ijo1MzcuODcxMDkzNzUsInkiOjEyMzEuNTkzNzV9LHsieCI6NTM3Ljg3MTA5Mzc1LCJ5IjoxMjY4LjU5Mzc1fV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M730.645,1134.589L741.307,1150.756C751.968,1166.924,773.291,1199.259,783.952,1220.926C794.613,1242.594,794.613,1253.594,794.613,1259.094L794.613,1264.594" id="my-svg-L_L3_Skip3_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_L3_Skip3_0" data-points="W3sieCI6NzMwLjY0NTQ3MDY3NzA4MDEsInkiOjExMzQuNTg4OTA0MzIyOTJ9LHsieCI6Nzk0LjYxMzI4MTI1LCJ5IjoxMjMxLjU5Mzc1fSx7IngiOjc5NC42MTMyODEyNSwieSI6MTI2OC41OTM3NX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M443.395,1310.372L390.947,1318.575C338.5,1326.779,233.605,1343.186,181.158,1356.89C128.711,1370.594,128.711,1381.594,128.711,1387.094L128.711,1392.594" id="my-svg-L_Exec_Clear_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Exec_Clear_0" data-points="W3sieCI6NDQzLjM5NDUzMTI1LCJ5IjoxMzEwLjM3MTU4MTg3NzQxNjV9LHsieCI6MTI4LjcxMDkzNzUsInkiOjEzNTkuNTkzNzV9LHsieCI6MTI4LjcxMDkzNzUsInkiOjEzOTYuNTkzNzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M481.131,1322.594L468.171,1328.76C455.212,1334.927,429.294,1347.26,416.334,1358.927C403.375,1370.594,403.375,1381.594,403.375,1387.094L403.375,1392.594" id="my-svg-L_Exec_TripL1_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Exec_TripL1_0" data-points="W3sieCI6NDgxLjEzMDU1NDE5OTIxODc1LCJ5IjoxMzIyLjU5Mzc1fSx7IngiOjQwMy4zNzUsInkiOjEzNTkuNTkzNzV9LHsieCI6NDAzLjM3NSwieSI6MTM5Ni41OTM3NX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M598.323,1322.594L612.13,1328.76C625.937,1334.927,653.55,1347.26,667.357,1358.927C681.164,1370.594,681.164,1381.594,681.164,1387.094L681.164,1392.594" id="my-svg-L_Exec_TripL2_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Exec_TripL2_0" data-points="W3sieCI6NTk4LjMyMjgxNDk0MTQwNjIsInkiOjEzMjIuNTkzNzV9LHsieCI6NjgxLjE2NDA2MjUsInkiOjEzNTkuNTkzNzV9LHsieCI6NjgxLjE2NDA2MjUsInkiOjEzOTYuNTkzNzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M632.348,1310.142L685.869,1318.384C739.391,1326.626,846.434,1343.11,899.955,1356.852C953.477,1370.594,953.477,1381.594,953.477,1387.094L953.477,1392.594" id="my-svg-L_Exec_TripL3_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_Exec_TripL3_0" data-points="W3sieCI6NjMyLjM0NzY1NjI1LCJ5IjoxMzEwLjE0MjQwMzYwMjE0Mjh9LHsieCI6OTUzLjQ3NjU2MjUsInkiOjEzNTkuNTkzNzV9LHsieCI6OTUzLjQ3NjU2MjUsInkiOjEzOTYuNTkzNzV9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_Req_L1_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(751.8671875, 472.828125)"><g class="label" data-id="L_L1_L2_0" transform="translate(-32.8984375, -12)"><foreignObject width="65.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>CLOSED</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(589.0625, 396.828125)"><g class="label" data-id="L_L1_Block1_0" transform="translate(-22.671875, -12)"><foreignObject width="45.34375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>OPEN</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(891.5703125, 396.828125)"><g class="label" data-id="L_L1_Probe_0" transform="translate(-47.5703125, -12)"><foreignObject width="95.140625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>HALF_OPEN</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_Probe_L2_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(670.640625, 855.59375)"><g class="label" data-id="L_L2_L3_0" transform="translate(-31.578125, -12)"><foreignObject width="63.15625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>available</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(972.796875, 855.59375)"><g class="label" data-id="L_L2_Skip2_0" transform="translate(-46.703125, -12)"><foreignObject width="93.40625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>cooling down</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(537.87109375, 1231.59375)"><g class="label" data-id="L_L3_Exec_0" transform="translate(-27.1328125, -12)"><foreignObject width="54.265625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>allowed</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(794.61328125, 1231.59375)"><g class="label" data-id="L_L3_Skip3_0" transform="translate(-23.125, -12)"><foreignObject width="46.25" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>locked</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(128.7109375, 1359.59375)"><g class="label" data-id="L_Exec_Clear_0" transform="translate(-28.8984375, -12)"><foreignObject width="57.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>success</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(403.375, 1359.59375)"><g class="label" data-id="L_Exec_TripL1_0" transform="translate(-93.4140625, -12)"><foreignObject width="186.828125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>408 / 500 / 502 / 503 / 504</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(681.1640625, 1359.59375)"><g class="label" data-id="L_Exec_TripL2_0" transform="translate(-68.9375, -12)"><foreignObject width="137.875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>401 / 403 (account)</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(953.4765625, 1359.59375)"><g class="label" data-id="L_Exec_TripL3_0" transform="translate(-64.9296875, -12)"><foreignObject width="129.859375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>429 quota (model)</p></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-Req-0" data-look="classic" transform="translate(751.8671875, 35)"><rect class="basic label-container" style="" x="-59.796875" y="-27" width="119.59375" height="54"/><g class="label" style="" transform="translate(-29.796875, -12)"><rect/><foreignObject width="59.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Request</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-L1-1" data-look="classic" transform="translate(751.8671875, 235.9140625)"><polygon points="123.9140625,0 247.828125,-123.9140625 123.9140625,-247.828125 0,-123.9140625" class="label-container" transform="translate(-123.4140625, 123.9140625)"/><g class="label" style="" transform="translate(-84.9140625, -24)"><rect/><foreignObject width="169.828125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Provider Circuit Breaker<br />(scope: whole provider)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-L2-3" data-look="classic" transform="translate(821.71875, 690.2109375)"><polygon points="128.3828125,0 256.765625,-128.3828125 128.3828125,-256.765625 0,-128.3828125" class="label-container" transform="translate(-127.8828125, 128.3828125)"/><g class="label" style="" transform="translate(-89.3828125, -24)"><rect/><foreignObject width="178.765625" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Connection Cooldown<br />(scope: one account/key)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Block1-5" data-look="classic" transform="translate(589.0625, 472.828125)"><rect class="basic label-container" style="" x="-94.90625" y="-39" width="189.8125" height="78"/><g class="label" style="" transform="translate(-64.90625, -24)"><rect/><foreignObject width="129.8125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Skip provider<br />(or 503 retry-after)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Probe-7" data-look="classic" transform="translate(891.5703125, 472.828125)"><rect class="basic label-container" style="" x="-71.8046875" y="-27" width="143.609375" height="54"/><g class="label" style="" transform="translate(-41.8046875, -12)"><rect/><foreignObject width="83.609375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Allow probe</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-L3-11" data-look="classic" transform="translate(670.640625, 1043.59375)"><polygon points="151,0 302,-151 151,-302 0,-151" class="label-container" transform="translate(-150.5, 151)"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Model Lockout<br />(scope: provider × conn × model)</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Skip2-13" data-look="classic" transform="translate(972.796875, 1043.59375)"><rect class="basic label-container" style="" x="-101.15625" y="-39" width="202.3125" height="78"/><g class="label" style="" transform="translate(-71.15625, -24)"><rect/><foreignObject width="142.3125" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Skip this connection<br />fall back to next</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Exec-15" data-look="classic" transform="translate(537.87109375, 1295.59375)"><rect class="basic label-container" style="" x="-94.4765625" y="-27" width="188.953125" height="54"/><g class="label" style="" transform="translate(-64.4765625, -12)"><rect/><foreignObject width="128.953125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Execute upstream</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Skip3-17" data-look="classic" transform="translate(794.61328125, 1295.59375)"><rect class="basic label-container" style="" x="-112.265625" y="-27" width="224.53125" height="54"/><g class="label" style="" transform="translate(-82.265625, -12)"><rect/><foreignObject width="164.53125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Fall back to next model</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-Clear-19" data-look="classic" transform="translate(128.7109375, 1423.59375)"><rect class="basic label-container" style="" x="-120.7109375" y="-27" width="241.421875" height="54"/><g class="label" style="" transform="translate(-90.7109375, -12)"><rect/><foreignObject width="181.421875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Clear cooldowns/lockouts</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-TripL1-21" data-look="classic" transform="translate(403.375, 1423.59375)"><rect class="basic label-container" style="" x="-103.953125" y="-27" width="207.90625" height="54"/><g class="label" style="" transform="translate(-73.953125, -12)"><rect/><foreignObject width="147.90625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Trip provider breaker</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-TripL2-23" data-look="classic" transform="translate(681.1640625, 1423.59375)"><rect class="basic label-container" style="" x="-123.8359375" y="-27" width="247.671875" height="54"/><g class="label" style="" transform="translate(-93.8359375, -12)"><rect/><foreignObject width="187.671875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Start connection cooldown</p></span></div></foreignObject></g></g><g class="node default" id="my-svg-flowchart-TripL3-25" data-look="classic" transform="translate(953.4765625, 1423.59375)"><rect class="basic label-container" style="" x="-98.4765625" y="-27" width="196.953125" height="54"/><g class="label" style="" transform="translate(-68.4765625, -12)"><rect/><foreignObject width="136.953125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Start model lockout</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg> \ No newline at end of file diff --git a/docs/diagrams/i18n-flow.mmd b/docs/diagrams/i18n-flow.mmd new file mode 100644 index 0000000000..50ddb293c9 --- /dev/null +++ b/docs/diagrams/i18n-flow.mmd @@ -0,0 +1,14 @@ +%% Incremental hash-based i18n pipeline +%% Reflects: scripts/i18n/* and docs/i18n/<locale>/*.md mirror layout +%% v3.8.0 +flowchart LR + Src["Source MDs<br/>(CLAUDE.md, docs/**/*.md)"] --> Hash["sha256 hash"] + Hash --> State[".i18n-state.json"] + State -->|diff| Dirty["Mark source dirty"] + Dirty --> Loop{"For each locale<br/>(39 langs)"} + Loop --> LLM["OmniRoute<br/>/chat/completions<br/>(cx/gpt-5.4-mini)"] + LLM --> Target["Write<br/>docs/i18n/<locale>/<rel-path>.md"] + Target --> State + Target --> CI{"CI drift check<br/>(npm run i18n:check)"} + CI -->|in sync| Pass["pass"] + CI -->|drift| Fail["fail<br/>(exit 1)"] diff --git a/docs/diagrams/mcp-tools-37.mmd b/docs/diagrams/mcp-tools-37.mmd new file mode 100644 index 0000000000..bd0afb082c --- /dev/null +++ b/docs/diagrams/mcp-tools-37.mmd @@ -0,0 +1,23 @@ +%% MCP Server tool inventory by category +%% Reflects: open-sse/mcp-server/tools/* and docs/MCP-SERVER.md +%% v3.8.0 +flowchart LR + MCP["MCP Server<br/>37 tools total"] --> Core["Core (30)"] + MCP --> Mem["Memory (3)"] + MCP --> Skl["Skills (4)"] + + Core --> Essential["Essential (8)<br/>get_health, list_combos,<br/>switch_combo, check_quota,<br/>route_request, cost_report,<br/>list_models_catalog,<br/>get_combo_metrics"] + Core --> Search["Search (1)<br/>web_search"] + Core --> Advanced["Advanced (11)<br/>simulate_route, set_budget_guard,<br/>set_routing_strategy,<br/>set_resilience_profile,<br/>test_combo, get_provider_metrics,<br/>best_combo_for_task, explain_route,<br/>get_session_snapshot,<br/>db_health_check, sync_pricing"] + Core --> Cache["Cache (2)"] + Core --> Compression["Compression (5)"] + Core --> Tunnels["1Proxy / Tunnels (3)"] + + Mem --> M1["memory_search"] + Mem --> M2["memory_save"] + Mem --> M3["memory_delete"] + + Skl --> S1["skill_invoke"] + Skl --> S2["skill_list"] + Skl --> S3["skill_diagnose"] + Skl --> S4["skill_uninstall"] diff --git a/docs/diagrams/request-pipeline.mmd b/docs/diagrams/request-pipeline.mmd new file mode 100644 index 0000000000..d0883aa76c --- /dev/null +++ b/docs/diagrams/request-pipeline.mmd @@ -0,0 +1,24 @@ +%% Request pipeline for /v1/chat/completions +%% Reflects: src/app/api/v1/chat/completions/route.ts → open-sse/handlers/chatCore.ts +%% v3.8.0 +flowchart LR + Client["Client<br/>(IDE/CLI/SDK)"] --> Route["Next.js Route<br/>/v1/chat/completions"] + Route --> CORS["CORS preflight"] + CORS --> Validate["Zod validation<br/>(request body)"] + Validate --> Authz["AuthZ pipeline<br/>(extractApiKey +<br/>isValidApiKey)"] + Authz --> Policy["API key policy<br/>(allowlist + scopes)"] + Policy --> Guard["Prompt-injection<br/>guardrail"] + Guard --> ChatCore["handleChatCore"] + ChatCore --> Cache{"Cache hit?"} + Cache -->|yes| Return["Return cached"] + Cache -->|no| Rate["Rate limit<br/>(per-key, per-IP)"] + Rate --> Combo{"Combo<br/>target?"} + Combo -->|combo| Resolve["resolveComboTargets<br/>(14 strategies)"] + Resolve --> Single["handleSingleModel<br/>(per target)"] + Combo -->|single| Single + Single --> Translate["translateRequest<br/>(OpenAI↔Claude↔Gemini)"] + Translate --> Exec["getExecutor<br/>(31 executors)"] + Exec --> Upstream["Upstream Provider<br/>(177 providers)"] + Upstream --> Stream["SSE / JSON"] + Stream --> Transformer["responsesTransformer<br/>(Responses↔Chat)"] + Transformer --> Client diff --git a/docs/diagrams/resilience-3layers.mmd b/docs/diagrams/resilience-3layers.mmd new file mode 100644 index 0000000000..777198946a --- /dev/null +++ b/docs/diagrams/resilience-3layers.mmd @@ -0,0 +1,21 @@ +%% 3-layer resilience model +%% Reflects: src/shared/utils/circuitBreaker.ts, src/sse/services/auth.ts, +%% open-sse/services/accountFallback.ts +%% v3.8.0 +flowchart TB + Req["Request"] --> L1{"Provider Circuit Breaker<br/>(scope: whole provider)"} + L1 -->|CLOSED| L2 + L1 -->|OPEN| Block1["Skip provider<br/>(or 503 retry-after)"] + L1 -->|HALF_OPEN| Probe["Allow probe"] + Probe --> L2 + + L2{"Connection Cooldown<br/>(scope: one account/key)"} -->|available| L3 + L2 -->|cooling down| Skip2["Skip this connection<br/>fall back to next"] + + L3{"Model Lockout<br/>(scope: provider × conn × model)"} -->|allowed| Exec["Execute upstream"] + L3 -->|locked| Skip3["Fall back to next model"] + + Exec -->|success| Clear["Clear cooldowns/lockouts"] + Exec -->|"408 / 500 / 502 / 503 / 504"| TripL1["Trip provider breaker"] + Exec -->|"401 / 403 (account)"| TripL2["Start connection cooldown"] + Exec -->|"429 quota (model)"| TripL3["Start model lockout"] diff --git a/docs/A2A-SERVER.md b/docs/frameworks/A2A-SERVER.md similarity index 53% rename from docs/A2A-SERVER.md rename to docs/frameworks/A2A-SERVER.md index cb8b18dd2c..b814c6f35c 100644 --- a/docs/A2A-SERVER.md +++ b/docs/frameworks/A2A-SERVER.md @@ -1,7 +1,20 @@ +--- +title: "OmniRoute A2A Server Documentation" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute A2A Server Documentation > Agent-to-Agent Protocol v0.3 — OmniRoute as an intelligent routing agent +The A2A surface has two faces: + +- **JSON-RPC 2.0** at `POST /a2a` (canonical entry point, defined in `src/app/a2a/route.ts`). +- **REST** under `/api/a2a/*` for dashboards and tooling (status, task list, cancel). + +Tasks are tracked by `A2ATaskManager` (`src/lib/a2a/taskManager.ts`, default 5-minute TTL). Skills are dispatched via `A2A_SKILL_HANDLERS` in `src/lib/a2a/taskExecution.ts`. + ## Agent Discovery ```bash @@ -10,6 +23,8 @@ curl http://localhost:20128/.well-known/agent.json Returns the Agent Card describing OmniRoute's capabilities, skills, and authentication requirements. +The Agent Card's `version` field is sourced from `process.env.npm_package_version` (see `src/app/.well-known/agent.json/route.ts:13`), so it stays auto-synced with `package.json` on every release. + --- ## Authentication @@ -124,10 +139,73 @@ curl -X POST http://localhost:20128/a2a \ ## Available Skills -| Skill | Description | -| :----------------- | :------------------------------------------------------------------------------------------------------------------------------ | -| `smart-routing` | Routes prompts through OmniRoute's intelligent pipeline. Returns response with routing explanation, cost, and resilience trace. | -| `quota-management` | Answers natural-language queries about provider quotas, suggests free combos, and provides quota rankings. | +OmniRoute exposes 5 A2A skills wired in `src/lib/a2a/taskExecution.ts::A2A_SKILL_HANDLERS`. Each skill module lives in `src/lib/a2a/skills/`. + +| Skill | ID | Description | +| :----------------- | :------------------- | :------------------------------------------------------------------------------------------ | +| Smart Routing | `smart-routing` | Routes a prompt through the optimal provider/combo using OmniRoute's combo engine + scoring | +| Quota Management | `quota-management` | Reports per-provider quota state, helps callers decide when to throttle/switch | +| Provider Discovery | `provider-discovery` | Lists installed providers with capabilities, free-tier flags, OAuth status | +| Cost Analysis | `cost-analysis` | Estimates cost of a request/conversation given the catalog + recent usage | +| Health Report | `health-report` | Aggregates circuit breaker, cooldown, lockout state per provider | + +> Note: the Agent Card description currently advertises "36+ providers" (`src/app/.well-known/agent.json/route.ts:26` and `:55`). The actual catalog has grown to 180+ providers — the string should be updated in a follow-up change (tracked as a separate doc/code TODO; not modified here). + +--- + +## REST API (auxiliary) + +The JSON-RPC endpoint `/a2a` is the canonical A2A entry point. The REST endpoints below provide auxiliary access for dashboards and external tooling: + +| Endpoint | Method | Description | Auth | +| :--------------------------- | :----- | :------------------------------- | :--------------------- | +| `/api/a2a/status` | GET | Server status, registered skills | (public) | +| `/api/a2a/tasks` | GET | List tasks with filters | management | +| `/api/a2a/tasks/[id]` | GET | Get task by ID | management | +| `/api/a2a/tasks/[id]/cancel` | POST | Cancel running task | management | +| `/.well-known/agent.json` | GET | Agent Card (A2A discovery) | (public, cached 3600s) | + +--- + +## Adding a New Skill + +1. **Create skill file:** `src/lib/a2a/skills/<your-skill>.ts` + + Export an async function `(task: A2ATask) => Promise<{ artifacts, metadata }>`. Follow the shape of existing skills such as `smartRouting.ts`. + +2. **Register handler:** in `src/lib/a2a/taskExecution.ts`, add an entry to `A2A_SKILL_HANDLERS`: + + ```typescript + export const A2A_SKILL_HANDLERS = { + // ...existing skills + "your-skill": async (task) => { + const skillModule = await import("./skills/yourSkill"); + return skillModule.executeYourSkill(task); + }, + }; + ``` + +3. **Expose in Agent Card:** in `src/app/.well-known/agent.json/route.ts`, append to the `skills` array: + + ```json + { + "id": "your-skill", + "name": "Your Skill", + "description": "Brief, intent-focused description", + "tags": ["routing", "quota"], + "examples": ["Sample natural-language invocation"] + } + ``` + +4. **Write tests:** `tests/unit/a2a-<your-skill>.test.ts`. Cover happy path + error path. + +5. **Document** the new skill in this file's `Available Skills` table. + +--- + +## Task TTL + +Tasks expire after `ttlMinutes` (default 5 min) — configured in the `A2ATaskManager` constructor at `src/lib/a2a/taskManager.ts:82`. To customize, fork the `A2ATaskManager` instantiation and pass a different value (e.g., `new A2ATaskManager(15)` for 15-minute TTL). A background interval sweeps expired tasks every 60 seconds. --- @@ -139,7 +217,7 @@ submitted → working → completed → cancelled ``` -- Tasks expire after 5 minutes (configurable) +- Tasks expire after 5 minutes by default (see [Task TTL](#task-ttl)) - Terminal states: `completed`, `failed`, `cancelled` - Event log tracks every state transition diff --git a/docs/frameworks/AGENT_PROTOCOLS_GUIDE.md b/docs/frameworks/AGENT_PROTOCOLS_GUIDE.md new file mode 100644 index 0000000000..15ac69679c --- /dev/null +++ b/docs/frameworks/AGENT_PROTOCOLS_GUIDE.md @@ -0,0 +1,282 @@ +--- +title: "Agent Protocols Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Agent Protocols Guide + +> **Source:** `src/lib/{a2a,acp,cloudAgent}/`, `src/app/api/{a2a,acp,cloud}/`, `src/app/api/v1/agents/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute exposes three different agent-related surfaces. They look similar at first glance but solve different problems. Use this page to pick the right one. + +## TL;DR + +| Surface | Best for | Transport | Standard | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------- | -------------------- | +| **A2A — Agent-to-Agent** | Cross-agent collaboration with peer agents that speak the A2A protocol | JSON-RPC 2.0 over HTTP | A2A v0.3 (open spec) | +| **ACP — CLI Agents Registry** | Detecting / registering / launching CLI coding agents installed on the user's machine (Cursor, Cline, Codex CLI, Claude Code, Aider, etc.) | HTTP REST | OmniRoute-specific | +| **Cloud Agents** | Submitting long-running coding tasks to external cloud services (Codex Cloud, Devin, Jules) | HTTP REST + DB-backed tasks | OmniRoute-specific | + +The three are independent — pick any subset. + +## Decision Tree + +``` +Do you need a cloud service to do work outside this machine (Codex Cloud / Devin / Jules)? +├─ YES → Cloud Agents (POST /api/v1/agents/tasks) +└─ NO → Continue + │ + Do you have a peer agent that speaks A2A and wants to collaborate? + ├─ YES → A2A (POST /a2a) + └─ NO → Continue + │ + Do you need to list / configure CLI coding agents installed locally? + ├─ YES → ACP (GET /api/acp/agents) + └─ NO → Use plain /v1/chat/completions +``` + +## 1. A2A — Agent-to-Agent + +**Spec:** [A2A v0.3](https://a2a-protocol.org) +**OmniRoute endpoint:** `POST /a2a` (JSON-RPC 2.0) +**Agent Card:** `GET /.well-known/agent.json` + +### When to use + +- Building a multi-agent system where OmniRoute is one of the peers +- Exposing OmniRoute's routing intelligence (smart-routing, quota-management, etc.) to agents in frameworks like Google ADK or generic agent meshes +- Wrapping OmniRoute behind a standard discovery + invocation surface + +### Methods + +- `message/send` — submit a message, receive sync response +- `message/stream` — submit + receive SSE-streamed progress events +- `tasks/get` — read task by ID +- `tasks/cancel` — cancel a running task + +### Built-in skills (5) + +- `smart-routing` — route a prompt through the optimal combo +- `quota-management` — report per-provider quota state +- `provider-discovery` — list installed providers with capabilities +- `cost-analysis` — estimate cost of a request/conversation +- `health-report` — aggregate breaker/cooldown/lockout state per provider + +### Deep dive + +See [A2A-SERVER.md](./A2A-SERVER.md) for transport details, agent card structure, task TTL config, and the template for adding new skills. + +## 2. ACP — CLI Agents Registry + +**OmniRoute endpoint:** `GET /api/acp/agents` +**Source:** `src/lib/acp/{index,manager,registry}.ts` + +### What it is + +ACP is OmniRoute's **local CLI agent inventory**. It detects which coding CLIs are installed on the host (Cursor, Cline, Claude Code, Codex CLI, Continue, etc.), resolves their versions, and surfaces them to the dashboard so the user can wire each CLI to point at OmniRoute. + +This is NOT an external protocol — it's an internal registry that powers the "CLI Tools" UI and the CLI fingerprint tracking (see [CLI-TOOLS.md](../reference/CLI-TOOLS.md)). + +### What it does + +- Probes the host for installed CLI binaries (uses `which` / `where` per OS) +- Reads each CLI's version (calls `<bin> --version`) +- Optionally accepts user-defined custom agents (binary path + version probe + spawn args) +- Persists custom agents in settings +- Returns the unified list to the dashboard + +### REST API + +| Endpoint | Method | Description | Auth | +| ----------------- | ------ | ------------------------------------------------------------- | ------- | +| `/api/acp/agents` | GET | List detected + custom agents (installed/total counts) | API key | +| `/api/acp/agents` | POST | Add/update/remove custom agent (action discriminator in body) | API key | + +Body shape for POST (`customAgentBodySchema` in `src/app/api/acp/agents/route.ts`): + +```json +{ + "action": "add|update|remove", + "id": "cursor", + "name": "Cursor", + "binary": "/usr/local/bin/cursor", + "versionCommand": "--version", + "providerAlias": "cursor", + "spawnArgs": ["--api-base", "http://localhost:20128"], + "protocol": "stdio" +} +``` + +### Use cases + +- Dashboard "CLI Tools" page lists what's installed and helps you point each at OmniRoute +- Custom agents let power users register internal/proprietary CLIs that OmniRoute doesn't know about by default +- Detection result fuels the `cli-tools` fingerprint matrix + +### When NOT to use ACP + +- ACP doesn't _run_ tasks. It only detects + configures CLIs. To actually invoke a CLI, you launch it yourself with the env vars OmniRoute provides (`OPENAI_BASE_URL`, `OPENAI_API_KEY`, etc.). + +## 3. Cloud Agents + +**OmniRoute endpoints:** `/api/v1/agents/tasks/*` (lifecycle) + `/api/cloud/*` (plumbing) +**Source:** `src/lib/cloudAgent/` + +### What it is + +A uniform interface over third-party cloud coding agents. You submit a prompt + repo URL, OmniRoute dispatches to the right cloud agent, polls status, returns results. + +### Supported agents (3, all confirmed in `src/lib/cloudAgent/agents/`) + +- `codex-cloud` — OpenAI Codex Cloud +- `devin` — Cognition Devin +- `jules` — Google Jules + +### Lifecycle + +``` +POST /api/v1/agents/tasks + → BaseAgent.createTask() per agent class + → external service starts work + → task row created in DB (cloud_agent_tasks) + ↓ +GET /api/v1/agents/tasks/[id] + → lazy status sync from provider + → returns current status + plan + activity log + ↓ +POST /api/v1/agents/tasks/[id] (action: "approve" | "message" | "cancel") + → forwards to provider (or marks cancelled locally) + ↓ +DELETE /api/v1/agents/tasks/[id] + → local cancel +``` + +### Auth + +⚠️ **All `/api/v1/agents/tasks/*` endpoints require management auth** (commit `588a0333`). Bearer-only callers receive 401 since v3.8.0. + +### Deep dive + +See [CLOUD_AGENT.md](./CLOUD_AGENT.md) for the `CloudAgentBase` contract, per-agent specifics, schema details, and credential plumbing endpoints. + +## Comparison: A2A vs Cloud Agents + +Both have "long-running tasks" but at different layers: + +| Aspect | A2A | Cloud Agents | +| ------------------ | --------------------------------------------------------------------------------- | ---------------------------------------- | +| Standard | Open A2A v0.3 | OmniRoute-specific | +| Where compute runs | Inside OmniRoute (uses configured combos) | External (Codex / Devin / Jules servers) | +| Task duration | Default TTL 5 min (configurable in `TaskManager`) | Minutes to hours | +| Repo-aware | No (passes prompts only) | Yes (repo URL + branch) | +| Use case | Cross-agent collab, smart routing as a service | Delegate "implement feature X in repo Y" | +| Auth | Optional `OMNIROUTE_API_KEY` for `/a2a`; management for `/api/a2a/*` REST helpers | Always management | + +## Integration Examples + +### Discover OmniRoute's A2A capabilities + +```bash +curl http://localhost:20128/.well-known/agent.json +``` + +Returns the Agent Card with all 5 skills, transports, and version. + +### Call OmniRoute as an A2A agent + +```bash +curl -X POST http://localhost:20128/a2a \ + -H "Content-Type: application/json" \ + -d '{ + "jsonrpc": "2.0", + "method": "message/send", + "params": { + "messages": [{"role": "user", "content": "Route this prompt"}], + "skillId": "smart-routing" + }, + "id": 1 + }' +``` + +### List installed CLI agents via ACP + +```bash +curl http://localhost:20128/api/acp/agents \ + -H "Authorization: Bearer <api-key>" +``` + +### Add a custom CLI agent + +```bash +curl -X POST http://localhost:20128/api/acp/agents \ + -H "Authorization: Bearer <api-key>" \ + -H "Content-Type: application/json" \ + -d '{ + "action": "add", + "id": "my-custom-cli", + "name": "My Custom CLI", + "binary": "/opt/mycli/bin/mycli", + "versionCommand": "--version", + "providerAlias": "openai" + }' +``` + +### Submit a Cloud Agent task + +```bash +curl -X POST http://localhost:20128/api/v1/agents/tasks \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{ + "agentId": "devin", + "prompt": "Implement feature X in repo Y", + "repo": "https://github.com/user/repo", + "branch": "main" + }' +``` + +### Poll cloud task status + +```bash +curl http://localhost:20128/api/v1/agents/tasks/<task-id> \ + -H "Cookie: auth_token=..." +``` + +## When to Use What + +- **Chatbot / copilot frontend** → `/v1/chat/completions` (OpenAI-compat — not an agent protocol) +- **Multi-agent collaboration** → A2A +- **Listing local CLIs in the dashboard** → ACP +- **Delegating long-running coding tasks to cloud services** → Cloud Agents + +## Internal Architecture + +``` + ┌─────────────────────┐ + │ OmniRoute Core │ + └─────────────────────┘ + ↑ ↑ ↑ + ┌─────────┘ │ └─────────┐ + │ │ │ + ┌───────┐ ┌─────────┐ ┌────────────┐ + │ A2A │ │ ACP │ │ Cloud │ + │ (/a2a)│ │ (/acp) │ │ Agents │ + └───────┘ └─────────┘ │ (/v1/agents│ + │ │ │ /tasks) │ + ↓ ↓ └────────────┘ + External peer Local CLI │ + agents that binaries on ↓ + speak A2A v0.3 the host Codex Cloud, + Devin, Jules +``` + +## See Also + +- [A2A-SERVER.md](./A2A-SERVER.md) — A2A deep dive +- [CLOUD_AGENT.md](./CLOUD_AGENT.md) — Cloud Agents deep dive +- [CLI-TOOLS.md](../reference/CLI-TOOLS.md) — External CLI integrations (uses ACP) +- [SKILLS.md](./SKILLS.md) — Skills framework (different from A2A skills — local execution sandbox) +- [API_REFERENCE.md](../reference/API_REFERENCE.md#agents-protocol) — endpoint reference +- Source: `src/lib/{a2a,acp,cloudAgent}/` diff --git a/docs/frameworks/CLOUD_AGENT.md b/docs/frameworks/CLOUD_AGENT.md new file mode 100644 index 0000000000..c80c604771 --- /dev/null +++ b/docs/frameworks/CLOUD_AGENT.md @@ -0,0 +1,382 @@ +--- +title: "Cloud Agents" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Cloud Agents + +> **Source of truth:** `src/lib/cloudAgent/` and `src/app/api/v1/agents/tasks/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute orchestrates third-party cloud-hosted coding agents (Codex Cloud, Devin, +Jules) as long-running tasks. Each agent is wrapped behind a uniform interface so +clients can submit a prompt + repo URL and receive results without dealing with +provider-specific APIs. + +A Cloud Agent task is **not** a regular chat completion. It is a durable, multi-step +unit of work that may take minutes to hours, can produce a Pull Request as its +artifact, and supports follow-up messages and (in some providers) plan approval gates. + +![Cloud Agent task lifecycle](../diagrams/exported/cloud-agent-flow.svg) + +> Source: [diagrams/cloud-agent-flow.mmd](../diagrams/cloud-agent-flow.mmd) + +## Supported Agents + +| Provider ID | Class | Source | Upstream Base URL | Plan Approval | +| ------------- | ----------------- | ------------------------------------ | --------------------------------------- | ------------- | +| `jules` | `JulesAgent` | `src/lib/cloudAgent/agents/jules.ts` | `https://jules.googleapis.com/v1alpha` | Yes | +| `devin` | `DevinAgent` | `src/lib/cloudAgent/agents/devin.ts` | `https://api.devin.ai/v1` | Yes | +| `codex-cloud` | `CodexCloudAgent` | `src/lib/cloudAgent/agents/codex.ts` | `https://api.openai.com/v1/codex/cloud` | No (auto) | + +Registry: `src/lib/cloudAgent/registry.ts` — exports `getAgent(providerId)`, +`getAvailableAgents()`, and `isCloudAgentProvider(providerId)`. The registry is a +plain in-memory `Record<string, CloudAgentBase>` populated at module load. + +## Architecture + +``` +Client (Dashboard / CLI / API) + → POST /api/v1/agents/tasks (management auth required) + → CreateCloudAgentTaskSchema validation (Zod) + → registry.getAgent(providerId) + → getCloudAgentCredentials(providerId) + └─ pulls from getProviderConnections({ provider, isActive: true }) + (apiKey first, fallback to accessToken) + → agent.createTask({ prompt, source, options }, credentials) + └─ HTTP POST to upstream provider API + └─ returns CloudAgentTask with internal id + externalId + → insertCloudAgentTask(...) into cloud_agent_tasks (SQLite) + +Polling (lazy sync on read): + GET /api/v1/agents/tasks/[id] + → getCloudAgentTaskById(id) + → agent.getStatus(externalId, credentials) // refreshes status + activities + → updateCloudAgentTask(...) with new status, result, completed_at + → return serialized task + +Interactions: + POST /api/v1/agents/tasks/[id] body: { action: "approve" | "message" | "cancel" } + → agent.approvePlan(externalId, credentials) for "approve" + → agent.sendMessage(externalId, message, credentials) for "message" + → status flips to "cancelled" for "cancel" (local-only) +``` + +Sync is **lazy**: status is refreshed from the upstream on every `GET /tasks/[id]`. +There is no background poller. Dashboards that need fresh state should poll the GET +endpoint at a sensible interval. + +## `CloudAgentBase` Interface + +Source: `src/lib/cloudAgent/baseAgent.ts` + +```typescript +export interface AgentCredentials { + apiKey: string; + baseUrl?: string; +} + +export interface CreateTaskParams { + prompt: string; + source: CloudAgentSource; + options: { + autoCreatePr?: boolean; + planApprovalRequired?: boolean; + environment?: Record<string, string>; + }; +} + +export interface GetStatusResult { + status: CloudAgentStatus; + externalId?: string; + result?: CloudAgentResult; + activities: CloudAgentActivity[]; + error?: string; +} + +export abstract class CloudAgentBase { + abstract readonly providerId: string; + abstract readonly baseUrl: string; + + abstract createTask(p: CreateTaskParams, c: AgentCredentials): Promise<CloudAgentTask>; + abstract getStatus(externalId: string, c: AgentCredentials): Promise<GetStatusResult>; + abstract approvePlan(externalId: string, c: AgentCredentials): Promise<void>; + abstract sendMessage( + externalId: string, + message: string, + c: AgentCredentials + ): Promise<CloudAgentActivity>; + abstract listSources( + c: AgentCredentials + ): Promise<{ name: string; url: string; branch?: string }[]>; + + protected mapStatus(raw: string): CloudAgentStatus; // heuristic upstream-string → enum + protected generateTaskId(): string; // `task_<ts>_<rand>` + protected generateActivityId(): string; // `act_<ts>_<rand>` +} +``` + +`CodexCloudAgent.approvePlan` intentionally throws — Codex Cloud auto-plans and has +no approval gate. `CodexCloudAgent.listSources` returns `[]`. + +## Domain Types + +Source: `src/lib/cloudAgent/types.ts` + +```typescript +export const CLOUD_AGENT_STATUS = { + QUEUED: "queued", + RUNNING: "running", + AWAITING_APPROVAL: "awaiting_approval", + COMPLETED: "completed", + FAILED: "failed", + CANCELLED: "cancelled", +} as const; + +export interface CloudAgentSource { + repoName: string; + repoUrl: string; // must be a valid URL + branch?: string; +} + +export interface CloudAgentResult { + prUrl?: string; + prNumber?: number; + commitMessage?: string; + diffUrl?: string; + summary?: string; + duration?: number; // seconds, positive int + cost?: number; // positive float +} + +export interface CloudAgentActivity { + id: string; + type: "plan" | "command" | "code_change" | "message" | "error" | "completion"; + content: string; + timestamp: string; // ISO 8601 + metadata?: Record<string, unknown>; +} + +export interface CloudAgentTask { + id: string; // internal `task_...` id + providerId: "jules" | "devin" | "codex-cloud"; + externalId?: string; // upstream provider's id + status: CloudAgentStatus; + prompt: string; // 1..10000 chars + source: CloudAgentSource; + options: { + autoCreatePr?: boolean; + planApprovalRequired?: boolean; + environment?: Record<string, string>; + }; + result?: CloudAgentResult; + activities: CloudAgentActivity[]; + error?: string; + createdAt: string; + updatedAt: string; + completedAt?: string; +} +``` + +Validation schemas (`CreateCloudAgentTaskSchema`, `UpdateCloudAgentTaskSchema`) are +exported alongside the types and are used by the route handlers. + +## Database + +Source: `src/lib/cloudAgent/db.ts` — table is created lazily via +`createCloudAgentTaskTable()` (also called from `src/lib/cloudAgent/index.ts` at +module import). + +```sql +CREATE TABLE IF NOT EXISTS cloud_agent_tasks ( + id TEXT PRIMARY KEY, + provider_id TEXT NOT NULL, + external_id TEXT, + status TEXT NOT NULL DEFAULT 'queued', + prompt TEXT NOT NULL, + source TEXT NOT NULL, -- JSON + options TEXT DEFAULT '{}', -- JSON + result TEXT, -- JSON + activities TEXT DEFAULT '[]', -- JSON + error TEXT, + created_at TEXT NOT NULL DEFAULT (datetime('now')), + updated_at TEXT NOT NULL DEFAULT (datetime('now')), + completed_at TEXT +); +CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_provider ON cloud_agent_tasks(provider_id); +CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_status ON cloud_agent_tasks(status); +CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_created ON cloud_agent_tasks(created_at DESC); +``` + +`updateCloudAgentTask` enforces a **column whitelist** to prevent SQL injection: +`status`, `prompt`, `source`, `options`, `result`, `activities`, `error`, +`completed_at`. Any other key in the partial update is silently dropped. + +## REST API — Task Lifecycle + +**Auth:** All `/api/v1/agents/tasks*` endpoints require **management auth** +(`requireCloudAgentManagementAuth` wraps `requireManagementAuth` from +`src/lib/api/requireManagementAuth`). This is enforced after commit `588a0333` +(_"fix(auth): require management auth for agent and cooldown APIs"_). + +| Method | Path | Purpose | +| ------- | ----------------------------- | ------------------------------------------------------ | +| OPTIONS | `/api/v1/agents/tasks` | CORS preflight | +| GET | `/api/v1/agents/tasks` | List tasks (filter: `provider`, `status`, `limit≤500`) | +| POST | `/api/v1/agents/tasks` | Create task (dispatches to upstream + persists) | +| DELETE | `/api/v1/agents/tasks?id=...` | Delete task by query id (does **not** cancel upstream) | +| OPTIONS | `/api/v1/agents/tasks/[id]` | CORS preflight | +| GET | `/api/v1/agents/tasks/[id]` | Read task + lazy-sync status from upstream | +| POST | `/api/v1/agents/tasks/[id]` | Action: `approve` / `message` / `cancel` | +| DELETE | `/api/v1/agents/tasks/[id]` | Delete task by path id | + +### Create task + +```bash +curl -X POST http://localhost:20128/api/v1/agents/tasks \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{ + "providerId": "devin", + "prompt": "Fix the bug in src/foo.ts where the parser returns null", + "source": { + "repoName": "user/repo", + "repoUrl": "https://github.com/user/repo", + "branch": "main" + }, + "options": { + "autoCreatePr": true, + "planApprovalRequired": false + } + }' +``` + +Response `201`: + +```json +{ + "data": { + "id": "task_1731512345678_abc123def", + "providerId": "devin", + "externalId": "session_xyz", + "status": "queued", + "prompt": "...", + "source": { "repoName": "user/repo", "repoUrl": "...", "branch": "main" }, + "options": { "autoCreatePr": true }, + "createdAt": "2026-05-13T12:34:56.789Z" + } +} +``` + +### Approve a plan + +```bash +curl -X POST http://localhost:20128/api/v1/agents/tasks/<id> \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{"action":"approve"}' +``` + +### Send a follow-up message + +```bash +curl -X POST http://localhost:20128/api/v1/agents/tasks/<id> \ + -d '{"action":"message","message":"Also add a unit test for the parser"}' +``` + +### Cancel (local status only) + +```bash +curl -X POST http://localhost:20128/api/v1/agents/tasks/<id> \ + -d '{"action":"cancel"}' +``` + +`cancel` flips `status` to `"cancelled"` in the local DB but does **not** call the +upstream provider — there is no abort RPC in `CloudAgentBase`. To stop billing +upstream, terminate the task in the provider's own console. + +## REST API — Cloud Provider Plumbing + +These auxiliary endpoints under `src/app/api/cloud/` are used by remote clients +(the CLI, the Electron app, or sync workers) to read provider connection metadata +and resolve model aliases. They are authenticated with a **regular API key** +(via `validateApiKey`), not the management auth used by the task endpoints. + +| Method | Path | Purpose | +| ------ | ------------------------------- | ------------------------------------------------------------------- | +| POST | `/api/cloud/auth` | Validate API key, return masked connection metadata + model aliases | +| PUT | `/api/cloud/credentials/update` | Refresh `accessToken` / `refreshToken` / `expiresAt` | +| POST | `/api/cloud/model/resolve` | Resolve a model alias to `{ provider, model }` | +| GET | `/api/cloud/models/alias` | List all model aliases | +| PUT | `/api/cloud/models/alias` | Set a model alias (and auto-sync to Cloud if enabled) | + +`/api/cloud/auth` never returns raw `apiKey` / `accessToken` / `refreshToken`. It +returns `hasApiKey`, `hasAccessToken`, `hasRefreshToken`, and a masked preview +(`maskedApiKey`: first 4 + `****` + last 4). + +## Credentials Resolution + +`getCloudAgentCredentials(providerId)` in `src/lib/cloudAgent/api.ts`: + +1. Loads active provider connections via `getProviderConnections({ provider: providerId, isActive: true })`. +2. For each connection, prefers `apiKey` (trimmed). Falls back to `accessToken`. +3. Returns the first non-empty token wrapped as `{ apiKey: token }`. +4. Returns `null` if no usable token is found — the API responds `400` with + `"No active credentials configured for cloud agent provider: <id>"`. + +This means Cloud Agents reuse the same Provider Connection table as regular LLM +providers. To enable Jules, create an active connection with `provider: "jules"` +and a populated `apiKey`. + +## Dashboard + +Source: `src/app/(dashboard)/dashboard/cloud-agents/page.tsx` + +A `"use client"` React page that: + +- Lists tasks (polled via `GET /api/v1/agents/tasks`). +- Submits new tasks via a form that maps to `CreateCloudAgentTaskSchema`. +- Shows status badges (`queued`, `running`, `awaiting_approval`, `completed`, + `failed`, `cancelled`) and renders the `activities[]` timeline. +- Surfaces the `result.prUrl` / `commitMessage` / `summary` when `status === "completed"`. + +## Integration with A2A + +Cloud Agents can be exposed as A2A skills by registering an A2A skill that delegates +its `tasks/send` handler to `getAgent(...).createTask(...)` and translates A2A task +status events to the JSON-RPC 2.0 protocol. See [A2A-SERVER.md](./A2A-SERVER.md). + +## Adding a New Cloud Agent + +1. Create `src/lib/cloudAgent/agents/<name>.ts` extending `CloudAgentBase`. +2. Implement `createTask`, `getStatus`, `approvePlan` (or throw if N/A), + `sendMessage`, `listSources`. Use `this.mapStatus(...)` for status normalization. +3. Register in `src/lib/cloudAgent/registry.ts` under a stable `providerId`. +4. Extend the `providerId` literal union in `src/lib/cloudAgent/types.ts` + (`CloudAgentTask.providerId` and `CreateCloudAgentTaskSchema`). +5. Add the provider to `src/shared/constants/providers.ts` if it needs a connection + record. OAuth-based providers also need `src/lib/oauth/providers/`. +6. Add tests under `tests/unit/cloud-agent-*.test.ts`. +7. Update this doc and the dashboard's `CLOUD_AGENTS` constant. + +## Configuration + +| Env Var | Purpose | +| ---------------- | ----------------------------------------------------------- | +| `DATA_DIR` | Location of the SQLite database holding `cloud_agent_tasks` | +| `JWT_SECRET` | Required for management auth on task endpoints | +| `API_KEY_SECRET` | Required to encrypt provider connection credentials at rest | + +No Cloud-Agent-specific env vars exist today — every secret lives in the +`provider_connections` table. + +## See Also + +- [A2A-SERVER.md](./A2A-SERVER.md) +- [API_REFERENCE.md](../reference/API_REFERENCE.md) +- [SKILLS.md](./SKILLS.md) +- [MEMORY.md](./MEMORY.md) +- Source: `src/lib/cloudAgent/` +- Routes: `src/app/api/v1/agents/tasks/`, `src/app/api/cloud/` +- Dashboard: `src/app/(dashboard)/dashboard/cloud-agents/page.tsx` diff --git a/docs/frameworks/EVALS.md b/docs/frameworks/EVALS.md new file mode 100644 index 0000000000..45d210a0cb --- /dev/null +++ b/docs/frameworks/EVALS.md @@ -0,0 +1,250 @@ +--- +title: "Evaluations (Evals)" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Evaluations (Evals) + +> **Source of truth:** `src/lib/evals/`, `src/lib/db/evals.ts`, `src/app/api/evals/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute ships a generic evaluation framework you can use to benchmark routing +configurations, single providers/models, or the bundled "golden set" suites. +Use it to verify routing changes, validate new providers, and gate releases +before promoting them to production traffic. + +The framework is implemented as: + +- A pure runner (`src/lib/evals/evalRunner.ts`) that registers in-memory + built-in suites, evaluates outputs against expected criteria, and aggregates + scorecards. +- A persistence layer (`src/lib/db/evals.ts`) for custom (user-defined) suites + and historical runs in SQLite. +- An orchestration layer (`src/lib/evals/runtime.ts`) that executes each case + by dispatching real calls to `POST /v1/chat/completions`, captures latency + and outputs, and persists the run. +- REST endpoints under `/api/evals/*` (management-auth only). +- A dashboard surface at `Dashboard → Usage → Evals` (`EvalsTab.tsx`). + +## Concepts + +### Suite + +A suite is a named collection of test cases with a `description` and one or +more cases. Suites come from two sources: + +| Source | Where defined | Mutable at runtime? | +| ---------- | --------------------------------------------- | ------------------- | +| `built-in` | Registered via `registerSuite()` at boot | No (code-defined) | +| `custom` | Stored in SQLite `eval_suites` + `eval_cases` | Yes (via API/UI) | + +The current built-in suites (see `src/lib/evals/evalRunner.ts`): + +- `golden-set` — 10 baseline cases across greeting/math/translation/safety +- `coding-proficiency` — Python/JS/SQL/TS/bug detection +- `reasoning-logic` — syllogisms, word problems, pattern recognition +- `multilingual` — translation and language detection +- `safety-guardrails` — PII, jailbreak, refusal, bias awareness +- `instruction-following` — JSON-only, numbered lists, language constraints +- `codex-comparison` — head-to-head coding tasks intended for compare mode + +### Case + +Each case carries: + +| Field | Description | +| ---------- | ------------------------------------------------------------ | +| `id` | Stable identifier (used to key outputs and metrics) | +| `name` | Human-readable label | +| `model` | Default model when the run uses `suite-default` targeting | +| `input` | `{ messages, max_tokens? }` — sent to `/v1/chat/completions` | +| `expected` | `{ strategy, value }` — scoring rubric (see below) | +| `tags` | Optional labels (e.g. `safety`, `pii`, `jailbreak`) | + +### Target + +The same suite can be run against different targets. The target schema is +`evalTargetSchema` in `src/shared/validation/schemas.ts`: + +| Target type | `id` | Behavior | +| --------------- | ---------- | --------------------------------------------------------------- | +| `suite-default` | `null` | Each case uses its built-in `model` field | +| `model` | model name | Force every case through one direct model (e.g. `gpt-4o`) | +| `combo` | combo name | Run every case through one combo (exercises the routing engine) | + +For `model` and `combo`, the `id` field is required (enforced by Zod +`superRefine`). When `compareTarget` is provided, both targets must differ — +the runner persists both runs under the same `runGroupId` for A/B comparison. + +## Scoring Rubrics + +Implemented in `evaluateCase()` (evalRunner.ts): + +| Strategy | Pass when… | +| ---------- | -------------------------------------------------------------------- | +| `exact` | `actualOutput === expected.value` | +| `contains` | `actualOutput.toLowerCase().includes(expected.value.toLowerCase())` | +| `regex` | `new RegExp(expected.value).test(actualOutput)` is truthy | +| `custom` | `expected.fn(actualOutput, evalCase)` returns truthy (built-in only) | + +**Note:** Custom-function scoring is reserved for code-defined (built-in) +suites because functions cannot be serialized through the API. The +`evalCaseBuilderSchema` only accepts `contains | exact | regex` for +user-created suites. + +There is no LLM-as-judge or embedding-based similarity scorer today — it would +be a clean extension point in `evaluateCase()`. + +## Database Schema + +Three tables (migrations `030_create_eval_runs.sql` and +`031_create_eval_suites.sql`): + +| Table | Purpose | +| ------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| `eval_suites` | Custom suite metadata (`id`, `name`, `description`) | +| `eval_cases` | Cases per suite — `input_json`, `expected_*`, `tags_json` | +| `eval_runs` | Historical runs — `pass_rate`, `total`, `passed`, `failed`, `avg_latency_ms`, `summary_json`, `results_json`, `outputs_json` | + +Built-in suites are **not** stored in the DB. They live in memory and are +re-registered every time `evalRunner.ts` is imported. + +## REST API + +All endpoints require management auth (`requireManagementAuth`) — they are not +part of the public proxy surface. + +| Endpoint | Method | Description | +| ----------------------------- | -------- | ------------------------------------------------------------- | +| `/api/evals` | `GET` | List suites + recent runs + scorecard + targets + keys | +| `/api/evals` | `POST` | Run a suite (single or compare) — schema `evalRunSuiteSchema` | +| `/api/evals/{suiteId}` | `GET` | Fetch one suite (built-in or custom) | +| `/api/evals/suites` | `POST` | Create a custom suite — schema `evalSuiteSaveSchema` | +| `/api/evals/suites/{suiteId}` | `GET` | Fetch a custom suite | +| `/api/evals/suites/{suiteId}` | `PUT` | Replace a custom suite (cases get re-inserted) | +| `/api/evals/suites/{suiteId}` | `DELETE` | Delete a custom suite and its cases | + +### Running a suite + +```bash +curl -X POST http://localhost:20128/api/evals \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{ + "suiteId": "golden-set", + "target": { "type": "combo", "id": "my-combo" }, + "apiKeyId": "optional-api-key-uuid" + }' +``` + +Optional fields: + +- `outputs` — `Record<caseId, string>` of pre-computed outputs. When provided, + the runner **skips dispatch** and only scores the cached outputs (useful for + offline evaluation). +- `compareTarget` — second target to run in parallel; both runs share a + generated `runGroupId` for head-to-head viewing. +- `apiKeyId` — internal API key used to authenticate the dispatched + `/v1/chat/completions` calls. Required when `REQUIRE_API_KEY` is enabled. + +### Creating a custom suite + +```bash +curl -X POST http://localhost:20128/api/evals/suites \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{ + "name": "Production smoke", + "description": "Quick sanity check before deploy", + "cases": [ + { + "name": "JSON shape", + "model": "gpt-4o", + "input": { "messages": [{ "role": "user", "content": "Reply with {\"ok\": true}" }] }, + "expected": { "strategy": "regex", "value": "\"ok\"\\s*:\\s*true" } + } + ] + }' +``` + +## Dispatch Pipeline + +`runEvalSuiteAgainstTarget()` (`src/lib/evals/runtime.ts`): + +1. Resolves the suite (built-in or custom). +2. For each case, builds a `Request` to `/v1/chat/completions` with the case's + `messages`, the resolved `model`, `stream: false`, and `max_tokens: 512` + (or the case override). +3. Calls the chat handler directly (in-process — no extra HTTP hop). +4. Captures latency and extracts text from either `choices[0].message.content` + or the Responses-API `output[]` payload. +5. Scores all outputs via `runSuite()`, then persists via `saveEvalRun()`. + +Cases run **sequentially**. There is no concurrency flag today. + +## Dashboard + +The UI lives at `Dashboard → Usage → Evals` +(`src/app/(dashboard)/dashboard/usage/components/EvalsTab.tsx`). From there you +can: + +- Browse built-in and custom suites with case-by-case preview. +- Create/edit/delete custom suites with the case builder. +- Pick a target (suite defaults / model / combo), optionally a second + `compareTarget`, optionally an API key, then run on demand. +- Inspect run history, per-case pass/fail, latency, and captured outputs. +- See the rolling scorecard aggregated across the latest run per + `(suite, target)` scope. + +## Relationship with the Auto-Assessment RFC + +A separate, narrower assessment subsystem lives at `src/domain/assessment/` +(see also [AUTO-COMBO.md](../routing/AUTO-COMBO.md) for the live scoring engine). +That subsystem targets the Auto Combo engine — automatically scoring providers and +models so combos can self-heal when upstreams fail. It uses its own runner, +its own categorizer, and its own scoring logic. + +The Evals framework documented here is the **broader, general-purpose +testing surface**. Prefer it for arbitrary regression suites, A/B comparisons, +and per-release smoke tests. Use the Auto-Assessment subsystem when you need +real-time provider health to influence routing decisions. + +## CI Integration + +There is no dedicated `eval:ci` npm script today. Two paths if you want to +gate releases on eval results: + +- **HTTP path**: stand up the server, hit `POST /api/evals` with a known + `suiteId` + `target`, and assert `runs[].summary.passRate >= N` in the + response. +- **In-process path**: import `runEvalSuiteAgainstTarget()` from + `@/lib/evals/runtime` from a script, run against a test DB, and check the + returned `PersistedEvalRun.summary`. + +Tests covering the route and history live at +`tests/unit/evals-route.test.ts` and `tests/unit/evals-history.test.ts`. + +## Extension Points + +Common changes and where to make them: + +- **New scoring strategy** — extend the `switch (evalCase.expected.strategy)` + block in `evaluateCase()` (`evalRunner.ts`) and widen `EvalCaseStrategy` in + `src/lib/db/evals.ts` plus `evalCaseBuilderSchema` in `schemas.ts`. +- **New built-in suite** — define a suite object and call `registerSuite()` at + the bottom of `evalRunner.ts`. It will be auto-discovered by `listSuites()`. +- **Run with concurrency** — change the sequential `for` loop in + `runEvalSuiteAgainstTarget()` to a bounded `Promise.all` (no concurrency + control exists today). +- **Stream/tool-call cases** — currently the runner forces `stream: false`. + Streaming or tool-aware evaluation would require changes in `runtime.ts` + (capture and aggregate SSE chunks before scoring). + +## See Also + +- [USER_GUIDE.md](../guides/USER_GUIDE.md) — overall product walkthrough +- [ARCHITECTURE.md](../architecture/ARCHITECTURE.md) — request pipeline reference +- [AUTO-COMBO.md](../routing/AUTO-COMBO.md) — Auto Combo scoring engine (live runtime) +- Source: `src/lib/evals/`, `src/lib/db/evals.ts`, `src/app/api/evals/` +- UI: `src/app/(dashboard)/dashboard/usage/components/EvalsTab.tsx` diff --git a/docs/frameworks/MCP-SERVER.md b/docs/frameworks/MCP-SERVER.md new file mode 100644 index 0000000000..176f7d755b --- /dev/null +++ b/docs/frameworks/MCP-SERVER.md @@ -0,0 +1,298 @@ +--- +title: "OmniRoute MCP Server Documentation" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# OmniRoute MCP Server Documentation + +> Model Context Protocol server with 37 tools across routing, cache, compression, memory, skills, and proxy operations. +> +> Source of truth: `open-sse/mcp-server/schemas/tools.ts` (30 tools) + `open-sse/mcp-server/tools/memoryTools.ts` (3 tools) + `open-sse/mcp-server/tools/skillTools.ts` (4 tools). Tool registration and scope wiring lives in `open-sse/mcp-server/server.ts`. + +![MCP tool inventory (37 tools by category)](../diagrams/exported/mcp-tools-37.svg) + +> Source: [diagrams/mcp-tools-37.mmd](../diagrams/mcp-tools-37.mmd) + +## Installation + +OmniRoute MCP is built-in. Start it with: + +```bash +omniroute --mcp +``` + +Or via the open-sse transport: + +```bash +# HTTP streamable transport (port 20130) +omniroute --dev # MCP auto-starts on /mcp endpoint +``` + +## Transports + +The MCP server exposes three transports, all backed by the same `createMcpServer()` factory: + +| Transport | Where | When to use | +| :---------------- | :------------------------------------------ | :--------------------------------------------------- | +| `stdio` | `open-sse/mcp-server/server.ts` | IDE integrations (Claude Desktop, Cursor, etc.) | +| `sse` | `POST/GET /api/mcp/sse` via `httpTransport` | Browser/agent clients that need an event stream | +| `streamable-http` | `POST/GET/DELETE /api/mcp/stream` | Multi-session HTTP clients (`mcp-session-id` header) | + +The active HTTP transport (`sse` or `streamable-http`) is selected by the `mcpTransport` setting. Switching transports closes existing sessions on the other transport. + +## IDE Configuration + +See [MCP Client Configuration](../guides/SETUP_GUIDE.md#mcp-client-configuration) for Claude Desktop, +Cursor, Cline, and compatible MCP client setup. + +--- + +## Essential Tools (8) — Phase 1 + +| Tool | Scopes | Description | +| :------------------------------ | :-------------------- | :------------------------------------------------------------ | +| `omniroute_get_health` | `read:health` | Uptime, memory, circuit breakers, rate limits, cache stats | +| `omniroute_list_combos` | `read:combos` | All configured combos with strategies (optional metrics) | +| `omniroute_get_combo_metrics` | `read:combos` | Performance metrics for a specific combo | +| `omniroute_switch_combo` | `write:combos` | Activate or deactivate a combo | +| `omniroute_check_quota` | `read:quota` | Quota used/total, percent remaining, reset time, token health | +| `omniroute_route_request` | `execute:completions` | Send a chat completion through OmniRoute routing | +| `omniroute_cost_report` | `read:usage` | Cost report by period (session/day/week/month) | +| `omniroute_list_models_catalog` | `read:models` | Full model catalog with capabilities, status, pricing | + +## Phase 1 — Search + +| Tool | Scopes | Description | +| :--------------------- | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------- | +| `omniroute_web_search` | `execute:search` | Web search through OmniRoute search gateway (Serper/Brave/Perplexity/Exa/Tavily/Google PSE/Linkup/SearchAPI/SearXNG) with failover | + +## Advanced Tools (11) — Phase 2 + +| Tool | Scopes | Description | +| :--------------------------------- | :----------------------------------- | :---------------------------------------------------------------------------------------- | +| `omniroute_simulate_route` | `read:health`, `read:combos` | Dry-run routing simulation with fallback tree | +| `omniroute_set_budget_guard` | `write:budget` | Session budget with degrade/block/alert action | +| `omniroute_set_routing_strategy` | `write:combos` | Update combo strategy at runtime (priority/weighted/auto/etc.) | +| `omniroute_set_resilience_profile` | `write:resilience` | Apply `aggressive` / `balanced` / `conservative` resilience preset | +| `omniroute_test_combo` | `execute:completions`, `read:combos` | Live test of every provider in a combo using a real upstream call | +| `omniroute_get_provider_metrics` | `read:health` | Per-provider metrics with p50/p95/p99 latency and circuit breaker state | +| `omniroute_best_combo_for_task` | `read:combos`, `read:health` | Recommend combo by task type with budget/latency constraints | +| `omniroute_explain_route` | `read:health`, `read:usage` | Explain why a request was routed to a provider (scoring factors + fallbacks) | +| `omniroute_get_session_snapshot` | `read:usage` | Full session snapshot: cost, tokens, top models/providers, errors, budget guard | +| `omniroute_db_health_check` | `read:health`, `write:resilience` | Diagnose (and optionally auto-repair) database drift like broken combo refs / orphan rows | +| `omniroute_sync_pricing` | `pricing:write` | Sync pricing data from external sources (LiteLLM); supports `dryRun` | + +## Cache Tools (2) + +| Tool | Scopes | Description | +| :---------------------- | :------------ | :-------------------------------------------------- | +| `omniroute_cache_stats` | `read:cache` | Semantic cache, prompt-cache, and idempotency stats | +| `omniroute_cache_flush` | `write:cache` | Flush cache globally or by signature/model | + +## Compression Tools (5) + +| Tool | Scopes | Description | +| :---------------------------------- | :------------------ | :----------------------------------------------------------------------------------------------------------------------- | +| `omniroute_compression_status` | `read:compression` | Compression settings, analytics summary, and cache-aware stats (includes `analytics.mcpDescriptionCompression` metadata) | +| `omniroute_compression_configure` | `write:compression` | Configure compression mode, threshold, target ratio, system-prompt preservation, MCP description compression toggle | +| `omniroute_set_compression_engine` | `write:compression` | Pick the active engine (off/caveman/rtk/stacked) and Caveman/RTK intensity | +| `omniroute_list_compression_combos` | `read:compression` | List named compression combos and their engine pipelines | +| `omniroute_compression_combo_stats` | `read:compression` | Analytics grouped by compression combo and engine | + +`omniroute_compression_status` reports MCP description compression separately under +`analytics.mcpDescriptionCompression`. Those values are metadata-size estimates for MCP listable +descriptions (`tools`, `prompts`, `resources`, and `resourceTemplates`); they are not provider usage +receipts and are marked with `source: "mcp_metadata_estimate"`. + +See [Compression Engines](../compression/COMPRESSION_ENGINES.md) and [RTK Compression](../compression/RTK_COMPRESSION.md) for +the runtime compression model behind these tools. + +## 1Proxy Tools (3) + +| Tool | Scopes | Description | +| :-------------------------- | :------------- | :-------------------------------------------------------------------------------------- | +| `omniroute_oneproxy_fetch` | `read:proxies` | Fetch free proxies from the 1proxy marketplace (protocol/country/quality/limit filters) | +| `omniroute_oneproxy_rotate` | `read:proxies` | Get the next available proxy by strategy (`random` / `quality` / `sequential`) | +| `omniroute_oneproxy_stats` | `read:proxies` | Pool stats, sync status, distribution by protocol and country | + +## Memory Tools (3) + +Defined in `open-sse/mcp-server/tools/memoryTools.ts`. Auth/scope is enforced through the standard MCP scope pipeline. + +| Tool | Description | +| :------------------------ | :---------------------------------------------------------------------------------- | +| `omniroute_memory_search` | Search memories by query / type / API key with token-budget enforcement | +| `omniroute_memory_add` | Add a new memory entry (`factual` / `episodic` / `procedural` / `semantic`) | +| `omniroute_memory_clear` | Clear memories for an API key, optionally filtered by type or `olderThan` timestamp | + +## Skill Tools (4) + +Defined in `open-sse/mcp-server/tools/skillTools.ts`. Backed by `src/lib/skills/registry` + `src/lib/skills/executor`. + +| Tool | Description | +| :---------------------------- | :-------------------------------------------------------------------------------- | +| `omniroute_skills_list` | List registered skills with optional filtering by API key, name, or enabled state | +| `omniroute_skills_enable` | Enable or disable a specific skill by ID | +| `omniroute_skills_execute` | Execute a skill with provided input and return the execution record | +| `omniroute_skills_executions` | List recent skill execution history | + +## Related Frameworks (v3.8.0) + +The MCP tool inventory above (37 tools = 30 base + 3 memory + 4 skills) is intentionally +scoped to runtime routing/cache/compression/memory/skills/proxy operations. Two adjacent +frameworks ship alongside the MCP server in v3.8.0 and are documented separately: + +### Cloud Agents + +Cloud Agents are out-of-process AI coding agents (codex-cloud, devin, jules) wired into +OmniRoute through the same connection model used for LLM providers. They are exposed via +their own REST surface (`/api/v1/agents/*`) and are **not** part of the MCP tool catalog +— calling a Cloud Agent does not consume an MCP scope. + +- Implementation: `src/lib/cloudAgent/` (`registry.ts`, `agents/codex-cloud.ts`, `agents/devin.ts`, `agents/jules.ts`). +- Lifecycle: `createTask`, `getStatus`, `approvePlan`, `sendMessage`, `listSources`. +- Documentation: [docs/frameworks/CLOUD_AGENT.md](./CLOUD_AGENT.md). + +### Guardrails + +Guardrails are pre/post-execution filters (vision-bridge, pii-masker, prompt-injection) +applied inside the chat pipeline. They run before the MCP tool/route layer is reached +and emit structured violations to the audit pipeline; they are not invoked as MCP tools. + +- Implementation: `src/lib/guardrails/`. +- Documentation: [docs/security/GUARDRAILS.md](../security/GUARDRAILS.md). + +When debugging an MCP call that appears blocked, check both the MCP audit log +(`scope_denied:*` entries) and the guardrails audit trail — a request may be rejected by +a guardrail **before** it ever reaches the MCP scope enforcement layer. + +--- + +## REST API Endpoints + +| Endpoint | Method | Description | Auth | +| :--------------------- | :-------------------- | :-------------------------------------------------------------------------------------------------- | :------------------------- | +| `/api/mcp/status` | `GET` | Server status: heartbeat, HTTP transport state, audit activity summary | Management (session/admin) | +| `/api/mcp/tools` | `GET` | Tool catalog (name, description, scopes, phase, source endpoints) | Management | +| `/api/mcp/sse` | `GET` / `POST` | SSE transport endpoint (gated by `mcpEnabled` + `mcpTransport === "sse"`) | API key + scopes | +| `/api/mcp/stream` | `POST`/`GET`/`DELETE` | Streamable HTTP transport (uses `mcp-session-id` header; `DELETE` ends the session) | API key + scopes | +| `/api/mcp/audit` | `GET` | Audit log entries from `mcp_tool_audit` (filters: `limit`, `offset`, `tool`, `success`, `apiKeyId`) | Management | +| `/api/mcp/audit/stats` | `GET` | Aggregated audit stats (`totalCalls`, `successRate`, `avgDurationMs`, top tools) | Management | + +Source files: `src/app/api/mcp/{status,tools,sse,stream,audit,audit/stats}/route.ts`. + +Both SSE and Streamable HTTP transports are blocked until the MCP server is enabled in Settings (`mcpEnabled`) and the appropriate `mcpTransport` is selected. If the wrong transport is configured the route returns HTTP 400 with a hint to switch settings. + +--- + +## Authentication & Scopes + +MCP tools are authenticated through API key scopes. Scope enforcement is centralized in +`open-sse/mcp-server/scopeEnforcement.ts`. Each tool requires specific scopes: + +| Scope | Tools | +| :-------------------- | :---------------------------------------------------------------------------------------------------------------- | +| `read:health` | `get_health`, `get_provider_metrics`, `simulate_route`, `explain_route`, `best_combo_for_task`, `db_health_check` | +| `read:combos` | `list_combos`, `get_combo_metrics`, `simulate_route`, `best_combo_for_task`, `test_combo` | +| `write:combos` | `switch_combo`, `set_routing_strategy` | +| `read:quota` | `check_quota` | +| `read:usage` | `cost_report`, `get_session_snapshot`, `explain_route` | +| `read:models` | `list_models_catalog` | +| `execute:completions` | `route_request`, `test_combo` | +| `execute:search` | `web_search` | +| `write:budget` | `set_budget_guard` | +| `write:resilience` | `set_resilience_profile`, `db_health_check` | +| `pricing:write` | `sync_pricing` | +| `read:cache` | `cache_stats` | +| `write:cache` | `cache_flush` | +| `read:compression` | `compression_status`, `list_compression_combos`, `compression_combo_stats` | +| `write:compression` | `compression_configure`, `set_compression_engine` | +| `read:proxies` | `oneproxy_fetch`, `oneproxy_rotate`, `oneproxy_stats` | + +Wildcard scopes are supported: `read:*` grants all read-scopes, `*` grants full access. + +Memory and Skill tools currently do not declare static scope requirements in their definitions; access is gated by the caller's API key and audited through the standard MCP audit pipeline. + +--- + +## Environment Variables + +| Variable | Default | Purpose | +| :-------------------------------------- | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------- | +| `OMNIROUTE_BASE_URL` | `http://localhost:20128` | Base URL the MCP server uses when calling OmniRoute internal APIs | +| `OMNIROUTE_API_KEY` | (empty) | API key forwarded as `Authorization: Bearer` to internal API calls | +| `OMNIROUTE_MCP_ENFORCE_SCOPES` | `false` (only `"true"` enables it) | When enabled, missing scopes deny tool calls and log `scope_denied:<reason>` in audit log | +| `OMNIROUTE_MCP_SCOPES` | (empty) | Comma-separated allowlist of scopes considered "available" by default (used when caller does not provide its own scopes) | +| `OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS` | (unset = on) | When set to `0/false/off/no`, disables MCP description compression at registration time | +| `OMNIROUTE_MCP_DESCRIPTION_COMPRESSION` | (unset = on) | Alternate alias for the same toggle as above | +| `DATA_DIR` | `~/.omniroute` | Heartbeat file is written to `${DATA_DIR}/runtime/mcp-heartbeat.json` | + +--- + +## Description Compression + +MCP tool, prompt, and resource registries can compress descriptions at registration/list time to reduce the metadata footprint exposed to clients (and therefore the prompt context cost). The implementation lives in `open-sse/mcp-server/descriptionCompressor.ts` and is wired into the MCP server via `compressMcpRegistryMetadata` inside `createMcpServer()`. + +- Compression runs over the description text using the Caveman ruleset (`getRulesForContext("all", "full")`) with preserved-block extraction (code spans, fenced blocks, etc.) so structural content is not altered. +- Toggle per-deployment via the `compression.mcpDescriptionCompressionEnabled` value in the `key_value` settings table (default: enabled) — exposed in the UI as **Analytics → MCP description compression**. +- Toggle process-wide via either `OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS=false` or `OMNIROUTE_MCP_DESCRIPTION_COMPRESSION=false`. +- Realtime stats are surfaced via `omniroute_compression_status` under `analytics.mcpDescriptionCompression` and tagged `source: "mcp_metadata_estimate"` to disambiguate from real provider usage receipts. + +--- + +## Runtime Heartbeat + +The stdio transport persists liveness to `${DATA_DIR}/runtime/mcp-heartbeat.json` every 5 seconds. The dashboard (`/api/mcp/status`) reads this file plus PID liveness to derive `online`. HTTP transports report state from in-process `getMcpHttpStatus()` instead (no file write). + +The heartbeat snapshot contains: + +```json +{ + "pid": 12345, + "startedAt": "2026-05-13T12:34:56.000Z", + "lastHeartbeatAt": "2026-05-13T12:35:01.000Z", + "version": "1.8.1", + "transport": "stdio", + "scopesEnforced": false, + "allowedScopes": [], + "toolCount": 37 +} +``` + +--- + +## Audit Logging + +Every tool call is logged to the SQLite `mcp_tool_audit` table by `open-sse/mcp-server/audit.ts`: + +- Tool name, arguments (hashed/truncated as per per-tool `auditLevel`), result +- Duration in ms, success/failure flag, error message (when applicable) +- API key hash, timestamp +- Scope denials are logged as `scope_denied:<reason>` with the missing scope list + +Use the dashboard or the `/api/mcp/audit` and `/api/mcp/audit/stats` REST endpoints to inspect recent calls. + +--- + +## Files + +| File | Purpose | +| :---------------------------------------------- | :--------------------------------------------------------------- | +| `open-sse/mcp-server/server.ts` | MCP server factory, stdio entry point, scoped tool registrations | +| `open-sse/mcp-server/httpTransport.ts` | SSE + Streamable HTTP transport (session management) | +| `open-sse/mcp-server/scopeEnforcement.ts` | Tool scope evaluation and caller resolution | +| `open-sse/mcp-server/audit.ts` | Tool call audit logging (`mcp_tool_audit`) | +| `open-sse/mcp-server/runtimeHeartbeat.ts` | stdio heartbeat writer (`mcp-heartbeat.json`) | +| `open-sse/mcp-server/descriptionCompressor.ts` | Description compression for tool / prompt / resource registries | +| `open-sse/mcp-server/schemas/tools.ts` | Zod schemas + tool registry (`MCP_TOOLS`, 30 entries) | +| `open-sse/mcp-server/tools/advancedTools.ts` | Phase 2 + cache + 1proxy tool handlers | +| `open-sse/mcp-server/tools/compressionTools.ts` | Compression tool handlers | +| `open-sse/mcp-server/tools/memoryTools.ts` | Memory tool definitions (3 tools) | +| `open-sse/mcp-server/tools/skillTools.ts` | Skill tool definitions (4 tools) | +| `src/app/api/mcp/status/route.ts` | `/api/mcp/status` endpoint | +| `src/app/api/mcp/tools/route.ts` | `/api/mcp/tools` endpoint | +| `src/app/api/mcp/sse/route.ts` | `/api/mcp/sse` SSE transport route | +| `src/app/api/mcp/stream/route.ts` | `/api/mcp/stream` Streamable HTTP transport route | +| `src/app/api/mcp/audit/route.ts` | `/api/mcp/audit` audit log query | +| `src/app/api/mcp/audit/stats/route.ts` | `/api/mcp/audit/stats` aggregated audit metrics | diff --git a/docs/frameworks/MEMORY.md b/docs/frameworks/MEMORY.md new file mode 100644 index 0000000000..7216a50656 --- /dev/null +++ b/docs/frameworks/MEMORY.md @@ -0,0 +1,328 @@ +--- +title: "Memory System" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Memory System + +> **Source of truth:** `src/lib/memory/` and `src/app/api/memory/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute provides persistent conversational memory keyed by API key (and +optionally session id). Memories are extracted automatically from LLM responses +via lightweight regex pattern matching and injected back into subsequent +requests as a leading system message (or first user message for providers that +reject the system role). + +Memory is **scoped per API key**, not per user — every request authenticated +with the same API key shares the same memory pool, with optional further +scoping by `sessionId`. + +## Architecture + +``` +Client → /v1/chat/completions (apiKeyInfo resolved upstream) + → handleChatCore() [open-sse/handlers/chatCore.ts] + → resolveMemoryOwnerId(apiKeyInfo) # extracts id + → getMemorySettings() # cached settings + → shouldInjectMemory(body, {enabled}) # gate + → retrieveMemories(apiKeyId, config) # SQL + optional FTS5 + → injectMemory(body, memories, provider) # system or user message + → upstream provider call + → on response: extractFacts(text, apiKeyId, sessionId) # non-blocking + → setImmediate → createMemory(fact) per match +``` + +The injection and extraction call-sites are wired in +`open-sse/handlers/chatCore.ts` (look for `retrieveMemories`, `injectMemory`, +and `extractFacts`). + +## Storage Layers + +### Primary: SQLite (`memories` table) + +Created by migration `015_create_memories.sql`: + +| Column | Type | Notes | +| --------------------------- | ------------------ | -------------------------------------------------------------------- | +| `id` | `TEXT PRIMARY KEY` | UUID generated via `crypto.randomUUID()` | +| `api_key_id` | `TEXT NOT NULL` | Owning API key | +| `session_id` | `TEXT` | Optional per-conversation scope | +| `type` | `TEXT NOT NULL` | One of `factual`, `episodic`, `procedural`, `semantic` | +| `key` | `TEXT` | Stable upsert key, e.g. `preference:i_prefer_python` | +| `content` | `TEXT NOT NULL` | The actual fact text | +| `metadata` | `TEXT` | JSON blob (category, extractedAt, source, ...) | +| `created_at` / `updated_at` | `TEXT` | ISO 8601 strings | +| `expires_at` | `TEXT` | Optional expiry; `NULL` means permanent | +| `memory_id` | `INTEGER UNIQUE` | Added by `023_fix_memory_fts_uuid.sql` to bridge UUIDs ↔ FTS5 rowids | + +Indexes: `api_key_id`, `session_id`, `type`, `expires_at`, plus the unique +`memory_id` index. + +**Upsert semantics**: `createMemory()` looks for an existing row with the same +`(api_key_id, key)` and updates it in place when found (merging `metadata` via +shallow spread). This keeps the table from growing unbounded for repeated +preference statements. + +### Full-text Search (`memory_fts` virtual table) + +`022_add_memory_fts5.sql` creates an FTS5 virtual table over `content` and +`key`. `023_fix_memory_fts_uuid.sql` fixes a real-world bug where the UUID +primary key did not join to FTS5's integer rowid — the migration adds the +`memory_id` column, recreates the FTS table, and wires triggers +(`memory_fts_ai`, `memory_fts_ad`, `memory_fts_au`) that keep FTS in sync on +INSERT, DELETE, and UPDATE. + +Used by `retrieval.ts` for the `semantic` and `hybrid` strategies (see below). +The retrieval code guards with `hasTable("memory_fts")` and falls back to +chronological order if the FTS table is missing or the FTS query throws. + +### Optional: Qdrant (vector store) + +`src/lib/memory/qdrant.ts` implements an optional Qdrant integration for true +semantic memory: + +- `upsertSemanticMemoryPoint()` — embed `key + content` with the configured + embedding model, ensure the collection exists (creates cosine-distance + vectors on first use), and upsert a point with payload `{memoryId, +apiKeyId, sessionId, key, content, metadata, createdAtUnix, expiresAtUnix}`. +- `searchSemanticMemory(query, topK, scope)` — embed the query, search the + collection filtered by `kind = "omniroute_memory"` and optionally by + `apiKeyId` / `sessionId`. Caps `topK` to `[1, 20]`. +- `deleteSemanticMemoryPoint(id)` — single point delete. +- `cleanupSemanticMemoryPoints({retentionDays})` — bulk delete points whose + `expiresAtUnix` is in the past or whose `createdAtUnix` is older than the + retention cutoff. Counts first so the dashboard can show actual numbers. +- `checkQdrantHealth()` — `GET /readyz` health probe with latency. + +> **TODO**: The chat pipeline (`chatCore.ts`) and the in-tree `retrieveMemories()` +> implementation do not currently call `upsertSemanticMemoryPoint` or +> `searchSemanticMemory`. The Qdrant integration is feature-flagged via +> `qdrantEnabled` in settings, but at the time of writing the +> `searchSemanticMemory` results are not fused into retrieval — the +> `semantic`/`hybrid` retrieval strategies use SQLite FTS5 only. The settings UI +> in `dashboard/settings → MemorySkillsTab` exposes Qdrant config, health, +> search test, and cleanup, but the corresponding `/api/settings/qdrant`, +> `/api/settings/qdrant/health`, `/api/settings/qdrant/search`, and +> `/api/settings/qdrant/cleanup` routes are referenced from the UI but **not +> present** under `src/app/api/settings/qdrant/` (only `embedding-models/` is +> wired). Treat Qdrant as preview/optional plumbing. + +## Memory Types + +`MemoryType` (`src/lib/memory/types.ts`): + +| Type | Used for | +| ------------ | ------------------------------------------------------------ | +| `factual` | Preferences, stable user facts, behavioral patterns | +| `episodic` | Decisions tied to a specific moment ("I chose Postgres") | +| `procedural` | Workflow / how-to memory (reserved; no auto-extractor today) | +| `semantic` | Reserved for vector-store entries | + +`MemoryConfig` retrieval strategy is one of `exact`, `semantic`, or `hybrid`, +and scope is one of `session`, `apiKey`, or `global`. The default scope from +`getMemorySettings()` is `apiKey`. + +## Fact Extraction (`extraction.ts`) + +Extraction is **regex-based**, not LLM-based — it runs in-process with +`setImmediate()` so it never blocks the response stream: + +- **Preference patterns** → `MemoryType.FACTUAL` + (e.g. `I prefer …`, `I really like …`, `my favorite is …`, `I hate …`) +- **Decision patterns** → `MemoryType.EPISODIC` + (e.g. `I'll use …`, `I chose …`, `I went with …`, `I'm going to adopt …`) +- **Pattern patterns** → `MemoryType.FACTUAL` + (e.g. `I usually …`, `I always …`, `I tend to …`) + +Each match is sanitised (`trim`, whitespace-collapse, capped at 500 chars), +deduplicated within the batch via a stable `factKey(category, content)`, and +stored via `createMemory()` with metadata +`{category, extractedAt, source: "llm_response"}`. Input text is capped at +64 KiB (`MAX_EXTRACTION_TEXT_LENGTH`) — when longer, the **tail** of the text +is used so the most recent assistant content always participates. + +`extractFactsFromText(text)` is exported for tests and returns the structured +facts without storing them. + +## Retrieval (`retrieval.ts`) + +`retrieveMemories(apiKeyId, config)` is the main entry point. It: + +1. Normalises and validates the config through `MemoryConfigSchema`. +2. Returns `[]` immediately when `enabled` is false or `maxTokens <= 0`. +3. Clamps `maxTokens` to `[1, 8000]`. +4. Detects whether the modern `memories` table exists (vs the legacy `memory` + table) so older databases keep working. +5. Builds the base query with expiry guard + (`expires_at IS NULL OR datetime(expires_at) > datetime('now')`), optional + session scope, and optional `retentionDays` cutoff. +6. Branches on strategy: + - **`exact`** (default): chronological `ORDER BY created_at DESC LIMIT 100`. + - **`semantic`**: if `config.query` and `memory_fts` exists, JOIN + `memory_fts MATCH ?` and order by FTS rank; fall back to chronological + when FTS returns 0 rows. + - **`hybrid`**: union of FTS results (higher relevance) and the + chronological set, deduplicated by id. +7. Computes a keyword relevance score (`getRelevanceScore`) over + `content`, `key`, and `metadata` JSON when a query is provided. Rows with + zero score are filtered out. +8. Sorts by score desc, then `createdAt` desc. +9. Walks the ranked list and accepts entries while a running + `estimateTokens(content)` (≈ `length / 4`) stays under the budget. Always + returns at least one entry when any matched. + +`estimateTokens` is exported and used by retrieval, summarisation, and the MCP +`omniroute_memory_search` tool. + +## Injection (`injection.ts`) + +`injectMemory(request, memories, provider)`: + +1. Joins all memory contents into a single `Memory context: …` string. +2. Picks a strategy by provider name: + - **System message** (default for OpenAI, Anthropic, Gemini, …) — prepends + a `{role: "system", content: memoryText}` ahead of any existing system + messages so user system prompts still take precedence. + - **User message** (fallback) — for providers in + `PROVIDERS_WITHOUT_SYSTEM_MESSAGE`: `o1`, `o1-mini`, `o1-preview`, + `glm`, `glmt`, `glm-cn`, `zai`, `qianfan`. These reject the system role + and would 400 otherwise (cf. issue #1701 for GLM/Zhipu). +3. Logs the count, strategy, and model under `memory.injection.injected`. + +`providerSupportsSystemMessage(provider)` is exported for callers that need to +make routing decisions of their own. Unknown providers default to `true` +(system role allowed) for safety. + +## Settings (`settings.ts`) + +Memory configuration is **stored in the DB settings table**, not in env vars. +`getMemorySettings()` reads from `getSettings()` and caches the result +in-process; `invalidateMemorySettingsCache()` is called by the settings PUT +route after writes. + +| DB key | Type | Default | UI control | +| --------------------- | ------- | -------------------------------------------------- | ----------------------------------------------- | +| `memoryEnabled` | boolean | `true` | Memory on/off | +| `memoryMaxTokens` | integer | `2000` (range `0–16000`) | Token budget for injection | +| `memoryRetentionDays` | integer | `30` (range `1–365`) | Retention window | +| `memoryStrategy` | enum | `"hybrid"` (one of `recent`, `semantic`, `hybrid`) | Retrieval strategy | +| `skillsEnabled` | boolean | `false` | Toggles per-key skill injection (see SKILLS.md) | + +Note: the UI strategy `"recent"` maps to the internal `"exact"` retrieval +strategy via `toMemoryRetrievalConfig()` (chronological order). + +Qdrant-related DB keys (`qdrantEnabled`, `qdrantHost`, `qdrantPort`, +`qdrantApiKey`, `qdrantCollection` default `"omniroute_memory"`, +`qdrantEmbeddingModel` default `"openai/text-embedding-3-small"`) are read by +`normalizeQdrantConfig()` in `qdrant.ts`. + +No `MEMORY_*` or `QDRANT_*` env vars exist today — everything is per-instance +DB settings. `OMNIROUTE_MEMORY_MB` (commented out in `.env.example`) is +unrelated and refers to Node heap sizing. + +## Summarisation (`summarization.ts`) + +`summarizeMemories(apiKeyId, sessionId?, maxTokens = 4000)` compacts older +content when the running token total over a key's memories exceeds the +budget. It iterates rows DESC by `created_at`, keeps rows that fit, and for +the rest replaces `content` in place with the first three sentences of the +original. `tokensSaved` is the difference in `estimateTokens` between old and +new content. + +This routine is **available but not called automatically** in the current +chat pipeline — call it from a cron, an admin action, or +`MemoryConfig.autoSummarize` glue if you need ongoing compaction. The data +loss is one-way: original text is overwritten. + +## REST API + +All endpoints require management auth (`requireManagementAuth`). + +| Method | Path | Description | +| -------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GET` | `/api/memory` | Paginated list with filters: `apiKeyId`, `type`, `sessionId`, `q`, `limit`, `page`, `offset`. Response includes `stats.total` and `stats.byType` | +| `POST` | `/api/memory` | Create entry (Zod-validated: `content`, `key`, optional `type`, `sessionId`, `apiKeyId`, `metadata`, `expiresAt`). Calls `createMemory()` which upserts on `(apiKeyId, key)` | +| `GET` | `/api/memory/[id]` | Fetch a single entry by UUID | +| `DELETE` | `/api/memory/[id]` | Delete an entry; returns 404 when missing | +| `GET` | `/api/memory/health` | Runs `verifyExtractionPipeline("health-check")` — round-trip create→list→delete to confirm the store is alive. Returns `{working, latencyMs, error?}` | +| `GET` | `/api/settings/memory` | Current normalised `MemorySettings` | +| `PUT` | `/api/settings/memory` | Update one or more of `enabled`, `maxTokens`, `retentionDays`, `strategy`, `skillsEnabled` | + +The `/api/memory` list query supports either `page`-based pagination +(`parsePaginationParams`) **or** raw `offset` — when `offset` is present it +takes precedence and a derived `page` is computed for the response shape. + +## MCP Tools (`open-sse/mcp-server/tools/memoryTools.ts`) + +When the MCP server is enabled, three memory tools are registered: + +- `omniroute_memory_search` — `{apiKeyId, query?, type?, maxTokens?, limit?}` + → wraps `retrieveMemories()` with `retrievalStrategy: "exact"`, optionally + filters by `type`, and reports `totalTokens`. +- `omniroute_memory_add` — `{apiKeyId, sessionId?, type, key, content, +metadata?}` → wraps `createMemory()`. +- `omniroute_memory_clear` — `{apiKeyId, type?, olderThan?}` → lists matching + entries, optionally filters by created-before timestamp, then deletes each + via `deleteMemory()`. + +See [MCP-SERVER.md](./MCP-SERVER.md) for transport and scope details. + +## Dashboard + +`src/app/(dashboard)/dashboard/memory/page.tsx` provides: + +- Real-time list, search, and pagination (debounced 300 ms). +- Type filter (`factual` / `episodic` / `procedural` / `semantic` / all). +- Add-memory modal (key, content, type). +- Delete per row. +- JSON export of the current page; JSON import via file picker. +- A green/red health dot driven by `GET /api/memory/health`. +- Stat cards: `totalEntries`, `tokensUsed`, `hitRate` (the latter two come + from the API stats payload). + +Memory and Qdrant settings live under +`/dashboard/settings → Memory & Skills` (`MemorySkillsTab.tsx`). + +## Caching + +`src/lib/memory/store.ts` keeps an in-process LRU-ish cache +(`MEMORY_CACHE_TTL = 5 min`, `MEMORY_MAX_CACHE_SIZE = 10 000`, with 20 % +oldest eviction) for `getMemory(id)` reads, plus a generic key/value +`memoryCache` layer (`src/lib/memory/cache.ts`) with `get`/`set`/`invalidate` +methods used by callers that want their own scoped cache (1 000-entry LRU, +default TTL 5 min). + +## Privacy & Lifecycle + +- Memory ownership is the API key id (`resolveMemoryOwnerId` in + `chatCore.ts`). Without an `apiKeyInfo.id` neither retrieval nor injection + nor extraction runs. +- Entries with a future `expires_at` are filtered out of retrieval; old + entries beyond `retentionDays` are excluded by the + `created_at >= cutoff` clause in `retrieveMemories`. +- For hard deletion, use `DELETE /api/memory/[id]` or `omniroute_memory_clear`. +- Extraction is fire-and-forget via `setImmediate`; failures are logged under + `memory.extraction.background.failed` and never surface to the caller. +- Verification round-trips (`verifyExtractionPipeline`) clean up their own + test entries in a `finally` block. + +## See Also + +- [SKILLS.md](./SKILLS.md) — the `skillsEnabled` setting injects tool + definitions alongside memory. +- [MCP-SERVER.md](./MCP-SERVER.md) — MCP transport / scopes. +- [API_REFERENCE.md](../reference/API_REFERENCE.md) — broader API surface. +- [Tuto_Qdrant.md](../../Tuto_Qdrant.md) — repository-root Qdrant setup tutorial (integration currently dormant — see status banner at top of that file). +- Source modules: + - `src/lib/memory/types.ts`, `schemas.ts` + - `src/lib/memory/store.ts`, `retrieval.ts`, `injection.ts` + - `src/lib/memory/extraction.ts`, `summarization.ts`, `verify.ts` + - `src/lib/memory/settings.ts`, `qdrant.ts`, `cache.ts` + - `src/lib/db/migrations/015_create_memories.sql`, + `022_add_memory_fts5.sql`, `023_fix_memory_fts_uuid.sql` + - `src/app/api/memory/route.ts`, `[id]/route.ts`, `health/route.ts` + - `src/app/api/settings/memory/route.ts` + - `open-sse/handlers/chatCore.ts` (injection / extraction wiring) + - `open-sse/mcp-server/tools/memoryTools.ts` diff --git a/docs/frameworks/SKILLS.md b/docs/frameworks/SKILLS.md new file mode 100644 index 0000000000..37f8d85628 --- /dev/null +++ b/docs/frameworks/SKILLS.md @@ -0,0 +1,288 @@ +--- +title: "Skills Framework" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Skills Framework + +> **Source of truth:** `src/lib/skills/` and `src/app/api/skills/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute exposes an extensible Skills framework that lets language models (and operators) compose reusable capabilities — from filesystem reads and HTTP requests to sandboxed code execution and curated marketplace skills. + +A skill is a versioned, schema-defined unit of work. OmniRoute can inject skills as tool definitions into outbound requests, intercept tool calls coming back from the model, run the matching handler, and feed the result back to the model so the conversation can continue. The model never sees the implementation — only the tool interface. + +--- + +## Concepts + +### Skill Sources + +Three sources of skills coexist in the same registry: + +1. **Built-in skills** (`src/lib/skills/builtins.ts`) — shipped with OmniRoute. Cover the common cases: + - `file_read`, `file_write` — per-API-key sandbox workspace under `<DATA_DIR>/skills/workspaces/<hashed-key>/` + - `http_request` — outbound HTTP through `safeOutboundFetch` with `guard: "public-only"` + - `web_search` — pluggable search provider with caching (`executeWebSearch`) + - `eval_code` — Docker-sandboxed `node` or `python` execution + - `execute_command` — Docker-sandboxed shell command + - `browser` — Playwright-backed scaffolding, disabled by default (`builtin/browser.ts`) +2. **SkillsMP** (the OmniRoute Marketplace) — fetched from `https://skillsmp.com/api/v1/skills/search`. Requires `skillsmpApiKey` in Settings. +3. **SkillsSH** (`skills.sh` community catalog) — fetched from `https://skills.sh/api/search`. No auth needed; SKILL.md content pulled from GitHub raw. + +A single "active provider" controls which catalog the dashboard installs from (`src/lib/skills/providerSettings.ts`). Switch it under **Settings → Memory & Skills**. Default: `skillsmp`. + +### Skill Identity + +Skills are keyed by `name@version` in the in-memory registry (`src/lib/skills/registry.ts`). Version must be semver (`^\d+\.\d+\.\d+$`). `resolveVersion()` understands `^`, `~`, `>`, `>=`, `<`, `<=`, `==`, and exact-match constraints. + +### Skill Mode + +Each skill has a runtime mode that controls when it is injected: + +| Mode | Behavior | +| ------ | ------------------------------------------------------------------------------------------ | +| `on` | Always injected as a tool definition | +| `off` | Never injected, never executable | +| `auto` | Scored against the incoming request; injected only if score ≥ `AUTO_MIN_SCORE` (default 3) | + +`auto` is the default for marketplace-installed skills. `enabled=true` and `mode="off"` together mean "registered but inactive" — toggling `enabled` via the legacy column also bumps `mode` so older codepaths stay consistent (`src/app/api/skills/[id]/route.ts`). + +### Status (executions) + +Skill executions are tracked in the `skill_executions` table with the following statuses (`src/lib/skills/types.ts`): + +```ts +enum SkillStatus { + PENDING = "pending", + RUNNING = "running", + SUCCESS = "success", + ERROR = "error", + TIMEOUT = "timeout", +} +``` + +### Registry Cache + +`SkillRegistry` is a singleton with a 60-second TTL cache (`registry.ts:14`). `loadFromDatabase()` is idempotent and dedupes concurrent calls via `pendingLoad`. Any write (`register`/`unregister`/`unregisterById`) invalidates the cache. Look up versions via `getSkillVersions(name)` and `resolveVersion(name, constraint)`. + +### Provider-Aware Injection + +`injectSkills()` in `src/lib/skills/injection.ts` is the entry point that turns registered skills into provider-specific tool definitions: + +- **OpenAI** — `{ type: "function", function: { name, description, parameters } }` +- **Anthropic** — `{ name, description, input_schema }` +- **Google (Gemini)** — `{ name, description, parameters }` + +The tool name is encoded as `name@version` so the handler can pick the right version when the model calls it back. + +### AUTO Scoring + +When `mode="auto"`, each candidate skill is scored against the request context (`scoreAutoSkill()` in `injection.ts`): + +| Signal | Points | +| ---------------------------------------------- | ------------ | +| Skill name appears verbatim in context | +6 | +| Each name token matches a context token | +2 | +| Each tag substring matches context | +3 | +| Each description token matches context | +1 | +| Background reason matches a name token | +2 per token | +| Background reason matches a tag | +2 per token | +| Provider hint in tags matches request provider | +2 / −2 | + +Top `AUTO_MAX_SKILLS = 5` skills with `score >= AUTO_MIN_SCORE = 3` are injected. Ties are broken by `installCount` (desc), then alphabetical name (`injection.ts:225-235`). + +### Tool Call Interception + +`handleToolCallExecution()` in `src/lib/skills/interception.ts` is invoked by the chat handler after the upstream returns a tool-calling response: + +1. `extractToolCalls()` reads provider-specific shapes (OpenAI `tool_calls` / Responses `function_call`, Anthropic `tool_use`, Gemini `functionCalls`). +2. Built-in tool aliases (e.g. `omniroute_web_search` → `web_search`) are resolved first. Built-in handlers run inline. +3. Anything else routes through `skillExecutor.execute(name@version, args, { apiKeyId, sessionId })`. +4. Results are spliced back into the response — `tool_results`, `function_call_output` items, or Anthropic `tool_result` blocks as appropriate. + +`customSkillExecutionEnabled` in the execution context can be set to `false` to allow only built-in interception (used by request paths that explicitly disable user-defined handlers). + +--- + +## Docker Sandbox + +Non-builtin code paths (`eval_code`, `execute_command`) run inside Docker via `SandboxRunner` (`src/lib/skills/sandbox.ts`). Every container is launched with: + +``` +--rm --network none|bridge --cap-drop ALL +--security-opt no-new-privileges --pids-limit 100 +--cpus <cpuLimit/1000> --memory <memoryLimit>m +--tmpfs /tmp:rw,noexec,nosuid,size=64m +--tmpfs /workspace:rw,noexec,nosuid,size=64m +--read-only (when readOnly=true) +``` + +Defaults (`SandboxRunner.DEFAULT_CONFIG`): + +| Field | Default | Notes | +| ---------------- | --------------- | ---------------------------------------------------- | +| `cpuLimit` | 100 (= 0.1 CPU) | Divided by 1000 before passing to `--cpus` | +| `memoryLimit` | 256 MB | Hard limit | +| `timeout` | 30000 ms | Soft kill via `SIGTERM` + `docker kill` | +| `networkEnabled` | `false` | Becomes `--network none` | +| `readOnly` | `true` | Root FS read-only; `/tmp` and `/workspace` are tmpfs | + +`SandboxRunner.kill(id)` and `killAll()` are exposed for shutdown; running containers are tracked in `runningContainers: Map<string, ChildProcess>`. + +### Sandbox Env Vars + +Configured via `process.env` in `src/lib/skills/builtins.ts`: + +| Env Var | Default | Purpose | +| --------------------------------- | ---------------- | ------------------------------------------------------------------ | +| `SKILLS_MAX_FILE_BYTES` | `1048576` (1 MB) | Cap for `file_read` and `file_write` | +| `SKILLS_MAX_HTTP_RESPONSE_BYTES` | `256000` | Cap for `http_request` response body | +| `SKILLS_MAX_SANDBOX_OUTPUT_CHARS` | `100000` | Cap for stdout/stderr returned to the caller | +| `SKILLS_SANDBOX_TIMEOUT_MS` | `10000` | Default timeout for sandboxed commands; capped at 60 s | +| `SKILLS_SANDBOX_NETWORK_ENABLED` | `false` | Master gate for egress. Set `1` or `true` to allow per-call opt-in | +| `SKILLS_ALLOWED_SANDBOX_IMAGES` | (see below) | Comma-separated allowlist of Docker images | + +Default allowed images: `alpine:3.20`, `node:22-alpine`, `python:3.12-alpine`. Any additions via `SKILLS_ALLOWED_SANDBOX_IMAGES` are merged with the defaults; unknown images are rejected by `normalizeImage()`. + +> Note: there is no separate `SKILLS_EXECUTION_TIMEOUT_MS` env var. The non-sandbox handler timeout is hard-coded to 30 s in `SkillExecutor` (`executor.ts:13`) but can be overridden at runtime via `skillExecutor.setTimeout(ms)`. + +### Workspace Isolation + +`file_read` and `file_write` resolve every path relative to a per-API-key workspace at `<DATA_DIR>/skills/workspaces/<sha256(apiKeyId).slice(0,24)>/`. Path traversal (`..`) and forbidden segments (`.env`, `.git`, `.ssh`, `.omniroute`, `.codex`, `secrets`) are rejected before any disk I/O. + +### HTTP Hardening + +`http_request` (`builtins.ts:257`): + +- Method allowlist: `GET, HEAD, POST, PUT, PATCH, DELETE` +- Blocked outbound headers: `host, connection, content-length, cookie, set-cookie, authorization, proxy-authorization` +- Redirects disabled (`allowRedirect: false`) +- Routed through `safeOutboundFetch` with `guard: "public-only"` (private/loopback ranges blocked) +- Response truncated at `SKILLS_MAX_HTTP_RESPONSE_BYTES`; client sees `truncated: true` + +--- + +## Hybrid Executor (preview) + +`src/lib/skills/hybrid.ts` defines a `HybridExecutor` that decides between `direct` (in-process) and `sandbox` execution per call, with an `autoUpgrade` retry path on timeout/memory errors. The wired-in `directExecutor` / `sandboxRunner` implementations are stubs (`executeDirect`, `executeInSandbox` return placeholder objects) — treat this module as a contract under construction. Real execution still goes through `skillExecutor` + `SandboxRunner`. + +--- + +## Storage + +Schema lives in two migrations: + +- `src/lib/db/migrations/016_create_skills.sql` — base `skills` and `skill_executions` tables, with indexes on `(api_key_id, name)` and `(skill_id, status, created_at)`. +- `src/lib/db/migrations/027_skill_mode_and_metadata.sql` — adds `mode`, `source_provider`, `tags` (JSON), `install_count` to `skills`. + +`skill_executions.status` is constrained at the database level: `CHECK(status IN ('pending', 'running', 'success', 'error', 'timeout'))`. + +--- + +## REST API + +All endpoints live under `src/app/api/skills/`. Management endpoints (`/api/skills`, `/api/skills/[id]`, `/api/skills/install`) require **management auth** via `requireManagementAuth()`. The marketplace/install flows use the lighter `isAuthenticated()` (session or API key). + +| Endpoint | Method | Purpose | +| --------------------------------- | ------ | ------------------------------------------------------------------------ | --- | ------------------------ | -------- | ------------------ | +| `/api/skills` | GET | List registered skills. Supports `?q=`, `?mode=on | off | auto`, `?source=skillsmp | skillssh | local`, pagination | +| `/api/skills/[id]` | PUT | Update `enabled` or `mode` | +| `/api/skills/[id]` | DELETE | Unregister by id | +| `/api/skills/install` | POST | Install a custom skill (handler code + schema) | +| `/api/skills/marketplace` | GET | Search the SkillsMP catalog (returns popular defaults when `q` is empty) | +| `/api/skills/marketplace/install` | POST | Install a SkillsMP skill (requires active provider = `skillsmp`) | +| `/api/skills/skillssh` | GET | Search the skills.sh catalog (`?q=&limit=`, capped at 100) | +| `/api/skills/skillssh/install` | POST | Install a skills.sh skill (requires active provider = `skillssh`) | +| `/api/skills/executions` | GET | Paginated execution history (`?apiKeyId=`) | +| `/api/skills/executions` | POST | Execute a registered skill ad-hoc | + +The `POST /api/skills/executions` endpoint returns HTTP `503` with `{ error: "Skills execution is disabled..." }` when `settings.skillsEnabled === false` (`executor.ts:42-45`). Operators can flip the master switch from **Settings → AI**. + +### Example: install a custom skill + +```bash +curl -X POST http://localhost:20128/api/skills/install \ + -H "Authorization: Bearer $OMNIROUTE_MGMT_TOKEN" \ + -H "Content-Type: application/json" \ + -d '{ + "name": "reverse-text", + "version": "1.0.0", + "description": "Reverses a string", + "schema": { + "input": { "type": "object", "properties": { "text": { "type": "string" } }, "required": ["text"] }, + "output": { "type": "object", "properties": { "reversed": { "type": "string" } } } + }, + "handlerCode": "echo-handler", + "apiKeyId": "your-api-key-id" + }' +``` + +The `handlerCode` string is a **handler name lookup** — not executable code. The executor maps it via `skillExecutor.registerHandler(name, fn)` (`executor.ts:25`). Marketplace installs store the SKILL.md text in this field as documentation and route execution through model-generated tool calls. Arbitrary user-supplied source is not eval'd. + +--- + +## MCP Tools + +Four MCP tools wrap the skills surface (`open-sse/mcp-server/tools/skillTools.ts`). They are auto-registered when the MCP server boots. + +| Tool | Description | +| ----------------------------- | ------------------------------------------------------------ | +| `omniroute_skills_list` | List skills, optional filters: `apiKeyId`, `name`, `enabled` | +| `omniroute_skills_enable` | Enable/disable a skill by `skillId` | +| `omniroute_skills_execute` | Execute a skill with an input payload | +| `omniroute_skills_executions` | Recent execution history (default 50, max 100) | + +See [MCP-SERVER.md](./MCP-SERVER.md) for transport setup and scope assignments. + +--- + +## A2A Integration + +`src/lib/skills/a2a.ts` exports the `memory_aware_routing` A2A skill descriptor and a `registerA2ASkill(registry)` helper. Custom A2A skills live in `src/lib/a2a/skills/` and are dispatched via `A2A_SKILL_HANDLERS` (`src/lib/a2a/taskExecution.ts`). See [A2A-SERVER.md](./A2A-SERVER.md) for the full task lifecycle. + +--- + +## Adding a New Built-in Skill + +1. **Define the handler** in `src/lib/skills/builtins.ts` (or a sibling file under `src/lib/skills/builtin/`). Signature: `(input, { apiKeyId, sessionId }) => Promise<output>`. +2. **Sandboxed code path?** Call `sandboxRunner.run(image, command, env, sandboxConfig({...}))`. Use `normalizeImage()` against the allowlist. +3. **Filesystem path?** Always pass through `resolveWorkspacePath(input, context)` before touching disk. +4. **Network call?** Use `safeOutboundFetch` with `guard: "public-only"`; sanitize headers via `sanitizeHeaders()`. +5. **Register** by adding the entry to `builtinSkills` (or calling `registerBrowserSkill(executor)`-style at boot). +6. **Wire built-in tool aliases** (optional) in `BUILTIN_TOOL_ALIASES` (`interception.ts:23`) if the upstream model emits a different name. +7. **Tests** in `src/lib/skills/__tests__/` (Vitest). + +--- + +## Adding a Custom (Non-Builtin) Skill + +1. Register the handler at process startup: + ```ts + skillExecutor.registerHandler("my-handler", async (input, ctx) => { ... }); + ``` +2. Insert the skill via `POST /api/skills/install` (the `handlerCode` field must match the registered handler name). +3. Toggle `mode` to `on` or `auto` via `PUT /api/skills/[id]`. + +--- + +## Operational Tips + +- **Master switch:** `settings.skillsEnabled = false` blocks all execution and returns HTTP `503` on `/api/skills/executions`. The registry continues to load. +- **Lock down egress:** keep `SKILLS_SANDBOX_NETWORK_ENABLED` unset (default) for fully air-gapped sandboxing. Per-call `networkEnabled: true` still requires the master gate. +- **Allow specific images:** set `SKILLS_ALLOWED_SANDBOX_IMAGES="myorg/sandbox:1.0,node:22-alpine"` to extend the allowlist. +- **Audit executions:** `/dashboard/skills/executions` and `omniroute_skills_executions` both query `skill_executions`. Successful runs include `durationMs`; failures include `errorMessage`. +- **Cache invalidation:** call `skillRegistry.invalidateCache()` after manual DB edits; otherwise wait 60 s. +- **Anonymous workspace:** when `apiKeyId` is empty, all calls hash to the same `"anonymous"` workspace — share-aware code should always pass a real key. + +--- + +## See Also + +- [MCP-SERVER.md](./MCP-SERVER.md) — MCP tool registration and transports +- [A2A-SERVER.md](./A2A-SERVER.md) — A2A task lifecycle and skill dispatch +- [USER_GUIDE.md](../guides/USER_GUIDE.md#-skills-system) — user-facing introduction +- [ARCHITECTURE.md](../architecture/ARCHITECTURE.md) — request pipeline and component map +- Source: `src/lib/skills/`, `src/app/api/skills/`, `open-sse/mcp-server/tools/skillTools.ts` +- Tests: `src/lib/skills/__tests__/integration.test.ts` diff --git a/docs/frameworks/WEBHOOKS.md b/docs/frameworks/WEBHOOKS.md new file mode 100644 index 0000000000..a39b906929 --- /dev/null +++ b/docs/frameworks/WEBHOOKS.md @@ -0,0 +1,259 @@ +--- +title: "Webhooks" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Webhooks + +> **Source of truth:** `src/lib/webhookDispatcher.ts`, `src/lib/db/webhooks.ts`, `src/app/api/webhooks/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute can fire HTTP webhooks on platform events. Use them to integrate with +Slack, PagerDuty, Datadog, internal alerting services, or any HTTP receiver. + +The dispatcher signs each delivery with HMAC-SHA256, retries on transient +failures, tracks delivery health per webhook, and auto-disables endpoints that +keep failing. + +## Supported Events + +The `WebhookEvent` type (`src/lib/webhookDispatcher.ts`) currently models: + +| Event | Fires when | +| -------------------- | --------------------------------------------------------- | +| `request.completed` | A proxied request completes successfully | +| `request.failed` | A proxied request fails after all retries/fallback | +| `provider.error` | A provider returns an error eligible for circuit-breaking | +| `provider.recovered` | A previously failing provider returns to a healthy state | +| `quota.exceeded` | An API key crosses a budget/quota threshold | +| `combo.switched` | A combo strategy switches its primary target | +| `test.ping` | Synthetic event used by the test endpoint | + +Subscriptions accept the literal `"*"` to receive every event. Unknown event +names in `events` are ignored at dispatch time. + +> Note: the dispatcher API is wired, but production call sites for some of the +> non-`test.ping` events are still landing. Check `grep dispatchEvent` to see +> which paths currently invoke the dispatcher in your release. + +## Architecture + +``` +Caller (handler, service, monitor) + dispatchEvent(event, data) [src/lib/webhookDispatcher.ts] + -> getEnabledWebhooks() [src/lib/db/webhooks.ts] + -> filter by webhook.events + -> for each match (in parallel): + deliverWebhook(url, payload, secret) + build payload { event, timestamp, data } + sign body with HMAC-SHA256 (if secret present) + POST with 10s timeout + retry up to 3 times on 5xx / network error + recordWebhookDelivery(id, status, success) + -> disableWebhooksWithHighFailures(10) +``` + +Dispatch is fire-and-forget for the caller: `Promise.allSettled` swallows +per-webhook errors so one bad receiver cannot block the others. + +## HMAC Signing + +When a webhook has a `secret`, OmniRoute signs the JSON body and sends: + +``` +Content-Type: application/json +User-Agent: OmniRoute-Webhook/1.0 +X-Webhook-Event: <event> +X-Webhook-Timestamp: <ISO-8601> +X-Webhook-Signature: sha256=<hex HMAC-SHA256(secret, body)> +``` + +> Header names use the `X-Webhook-*` prefix (not `X-OmniRoute-*`). The signature +> value is `sha256=<hex>` — verify the full prefix. + +If `createWebhook` is called without a secret, the DB module generates one +(`whsec_<48 hex>`) so all webhooks are signed by default. + +### Verifying on the receiver + +```typescript +import { createHmac, timingSafeEqual } from "node:crypto"; + +function verify(rawBody: string, signature: string, secret: string) { + const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex"); + const a = Buffer.from(expected); + const b = Buffer.from(signature); + return a.length === b.length && timingSafeEqual(a, b); +} +``` + +Always verify against the **raw** request body, before any JSON parsing. + +## Retry & Failure Policy + +`deliverWebhook(url, payload, secret, maxRetries = 3)`: + +- 10 second timeout per attempt (`AbortController`). +- HTTP 2xx counts as success. +- HTTP 3xx/4xx counts as a non-retryable final status — recorded as delivered + with `success = res.ok`. +- HTTP 5xx and network errors are retried with exponential backoff: + `2^attempt * 1000 ms` (1s, 2s, 4s). +- After `maxRetries`, the delivery is recorded as failed. +- Each delivery updates `last_triggered_at`, `last_status`, and either resets + or increments `failure_count`. +- The dispatcher calls `disableWebhooksWithHighFailures(10)` after each fan-out, + so any webhook with `failure_count >= 10` is automatically disabled. + +## Database + +Table `webhooks` (migration `011_webhooks.sql`): + +| Column | Type | Notes | +| ------------------- | ------- | --------------------------------------------- | +| `id` | TEXT PK | UUID | +| `url` | TEXT | Destination URL | +| `events` | TEXT | JSON array; default `["*"]` | +| `secret` | TEXT | HMAC secret (auto-generated if not given) | +| `enabled` | INT | 0/1; defaults to 1 | +| `description` | TEXT | Optional human label | +| `created_at` | TEXT | `datetime('now')` | +| `last_triggered_at` | TEXT | Updated on every delivery attempt | +| `last_status` | INT | HTTP status of the last attempt (0 = network) | +| `failure_count` | INT | Resets to 0 on success, +1 on failure | + +There is **no separate `webhook_deliveries` table** in the current schema — +delivery history is aggregated on the `webhooks` row. If you need full audit +history, consume `request.completed` / `audit` style events from a downstream +log store. + +## REST API + +All endpoints require management auth (`requireManagementAuth`). + +| Endpoint | Method | Description | +| ------------------------- | ------ | ------------------------------- | +| `/api/webhooks` | GET | List webhooks (secrets masked) | +| `/api/webhooks` | POST | Create webhook | +| `/api/webhooks/[id]` | GET | Webhook detail (full secret) | +| `/api/webhooks/[id]` | PUT | Update fields | +| `/api/webhooks/[id]` | DELETE | Remove | +| `/api/webhooks/[id]/test` | POST | Fire a `test.ping` (no retries) | + +`GET /api/webhooks` masks the secret to `<first 10 chars>...` to avoid leaking +on listing pages. Use the `[id]` GET when you actually need the secret. + +### Create webhook + +```bash +curl -X POST http://localhost:20128/api/webhooks \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{ + "url": "https://hooks.slack.com/services/...", + "secret": "whsec_my_shared_secret", + "events": ["quota.exceeded", "provider.error"], + "description": "Slack alerts" + }' +``` + +If `secret` is omitted, the server generates a `whsec_<hex>` secret and returns +it in the response. + +### Test webhook + +```bash +curl -X POST http://localhost:20128/api/webhooks/<id>/test \ + -H "Cookie: auth_token=..." +``` + +Returns `{ delivered, status, error }`. No retries are attempted — useful for +quickly validating that the receiver accepts the payload and signature. + +## Dashboard + +The dashboard page at `/dashboard/webhooks` (see +`src/app/(dashboard)/dashboard/webhooks/page.tsx`) provides: + +- Create/edit webhooks with an event picker +- Status indicator (active / inactive / errored) based on `enabled`, + `failure_count`, and `last_status` +- One-click test delivery +- Manual enable/disable toggle + +## Payload Examples + +### request.completed + +```json +{ + "event": "request.completed", + "timestamp": "2026-05-13T20:30:00.123Z", + "data": { + "trace_id": "...", + "api_key_id": "...", + "provider": "openai", + "model": "gpt-5", + "status": 200, + "tokens_in": 142, + "tokens_out": 350, + "cost_usd": 0.0042 + } +} +``` + +### provider.error + +```json +{ + "event": "provider.error", + "timestamp": "2026-05-13T20:31:00.000Z", + "data": { + "provider": "anthropic", + "status": 503, + "consecutive_failures": 5, + "circuit_state": "open" + } +} +``` + +### test.ping + +```json +{ + "event": "test.ping", + "timestamp": "2026-05-13T20:32:00.000Z", + "data": { + "message": "Test webhook delivery from OmniRoute", + "webhookId": "<uuid>" + } +} +``` + +Field shapes for non-`test.ping` events are defined by the call sites that emit +them; treat the `data` object as forward-compatible (add fields, don't depend on +absence). + +## Best Practices + +- **Verify the signature on every delivery** against the raw body — prevents + spoofed POSTs from anyone who guesses your webhook URL. +- **Respond 2xx within ~5 seconds** — the dispatcher times out at 10 s. Slow + receivers will eat retries and inflate `failure_count`. +- **Make handlers idempotent** — retries and at-least-once delivery semantics + mean duplicates are possible. +- **Subscribe minimally** — list only events you actually consume; `"*"` will + add cost on receivers you do not control. +- **Watch `failure_count`** — endpoints are auto-disabled at 10 consecutive + failures; reset by calling `PUT /api/webhooks/[id]` with `enabled: true` + after fixing the receiver. +- **Rotate secrets periodically** — `PUT` a new `secret`, deploy the new value + to the receiver, and confirm via the test endpoint. + +## See Also + +- [API_REFERENCE.md](../reference/API_REFERENCE.md) — full management API surface +- [RESILIENCE_GUIDE.md](../architecture/RESILIENCE_GUIDE.md) — circuit breaker / cooldown + semantics that drive `provider.error` / `provider.recovered` +- Source: `src/lib/webhookDispatcher.ts`, `src/lib/db/webhooks.ts` diff --git a/docs/guides/DOCKER_GUIDE.md b/docs/guides/DOCKER_GUIDE.md new file mode 100644 index 0000000000..913b583725 --- /dev/null +++ b/docs/guides/DOCKER_GUIDE.md @@ -0,0 +1,236 @@ +--- +title: "🐳 Docker Guide — OmniRoute" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# 🐳 Docker Guide — OmniRoute + +> Complete Docker deployment reference. For a quick start, see the [README Docker section](../README.md#-docker). + +## Table of Contents + +- [Quick Run](#quick-run) +- [With Environment File](#with-environment-file) +- [Docker Compose](#docker-compose) +- [Available Profiles](#available-profiles) +- [Redis Sidecar](#redis-sidecar) +- [Production Compose](#production-compose) +- [Dockerfile Stages](#dockerfile-stages) +- [Critical Environment Variables](#critical-environment-variables) +- [Docker Compose with Caddy (HTTPS)](#docker-compose-with-caddy-https-auto-tls) +- [Cloudflare Quick Tunnel](#cloudflare-quick-tunnel) +- [Image Tags](#image-tags) +- [Important Notes](#important-notes) + +--- + +## Quick Run + +```bash +docker run -d \ + --name omniroute \ + --restart unless-stopped \ + --stop-timeout 40 \ + -p 20128:20128 \ + -v omniroute-data:/app/data \ + diegosouzapw/omniroute:latest +``` + +## With Environment File + +```bash +# Copy and edit .env first +cp .env.example .env + +docker run -d \ + --name omniroute \ + --restart unless-stopped \ + --stop-timeout 40 \ + --env-file .env \ + -p 20128:20128 \ + -v omniroute-data:/app/data \ + diegosouzapw/omniroute:latest +``` + +## Docker Compose + +```bash +# Base profile (no CLI tools) +docker compose --profile base up -d + +# CLI profile (Claude Code, Codex, OpenClaw built-in) +docker compose --profile cli up -d + +# Host profile (Linux-first; mounts host CLI binaries read-only) +docker compose --profile host up -d + +# Combine CLI + CLIProxyAPI sidecar +docker compose --profile cli --profile cliproxyapi up -d +``` + +## Available Profiles + +OmniRoute ships four Compose profiles. Pick the one that matches your environment. + +| Profile | Service | When to use | Command | +| ---------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | +| `base` (default) | `omniroute-base` | Headless server / minimal runtime, no provider CLIs bundled | `docker compose --profile base up -d` | +| `cli` | `omniroute-cli` | Agentic workflows that call `omniroute providers/setup/doctor` and bundled CLIs (Codex, Claude Code, Droid, OpenClaw) | `docker compose --profile cli up -d` | +| `host` | `omniroute-host` | Linux hosts that want `network_mode`-like access to host CLIs by mounting `~/.local/bin`, `~/.codex`, `~/.claude`, etc. read-only | `docker compose --profile host up -d` | +| `cliproxyapi` | `cliproxyapi` | Run the [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) sidecar on port `8317` for upstream CLI proxying | `docker compose --profile cliproxyapi up -d` | + +> Multiple profiles can be combined: `docker compose --profile cli --profile cliproxyapi up -d`. + +## Redis Sidecar + +OmniRoute relies on Redis to back the distributed rate limiter and shared cache. The `redis` service is **always defined** in `docker-compose.yml` (it has no profile gate) and starts alongside any other profile. + +| Detail | Value | +| -------------------- | --------------------------------- | +| Image | `redis:7-alpine` | +| Container name | `omniroute-redis` | +| Internal port | `6379` | +| Host port (override) | `REDIS_PORT` (defaults to `6379`) | +| Volume | `omniroute-redis-data` → `/data` | +| Healthcheck | `redis-cli ping` (10s interval) | + +Related environment variables: + +- `REDIS_URL` — connection string injected into the app (`redis://redis:6379` by default). +- `REDIS_PORT` — host-side port mapping for the Redis container. + +**Disabling Redis** is not recommended (rate limiter will degrade to in-memory fallback). If you must, either remove/comment the `redis:` service block in `docker-compose.yml` or scale it to zero: + +```bash +docker compose up -d --scale redis=0 +``` + +## Production Compose + +For an isolated production snapshot running alongside dev, use `docker-compose.prod.yml`. + +| Detail | Value | +| ---------------------- | ---------------------------------------------------------------------------------- | +| File | `docker-compose.prod.yml` | +| Default dashboard port | `PROD_DASHBOARD_PORT=20130` (mapped to internal `${DASHBOARD_PORT:-20128}`) | +| Default API port | `PROD_API_PORT=20131` | +| Image | `omniroute:prod` (built from `runner-cli` target) | +| Redis container | `omniroute-redis-prod` (`redis:8.6.2`, dedicated `redis-prod-data` volume) | +| Data volume | `omniroute-prod-data` (named, persisted across rebuilds) | +| Healthchecks | `node healthcheck.mjs` + `redis-cli ping`, with `depends_on` gated on Redis health | + +How to use: + +```bash +# Build & start the production stack +docker compose -f docker-compose.prod.yml up -d --build + +# Stream logs +docker compose -f docker-compose.prod.yml logs -f + +# Tear down (keep volumes) +docker compose -f docker-compose.prod.yml down +``` + +The prod stack runs in parallel with the dev compose (different container names, ports, and volumes), so you can keep iterating locally while production stays up. + +## Dockerfile Stages + +The repository ships a multi-stage Dockerfile (`Dockerfile`). Three stages are exposed; pick the right `target` for your use case. + +| Stage | Base image | Purpose | +| ------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `builder` | `node:24.15.0-trixie-slim` | Installs deps (`npm ci --legacy-peer-deps`) and runs `npm run build -- --webpack` | +| `runner-base` | `node:24.15.0-trixie-slim` | Production runtime with the Next.js standalone output. **No provider CLIs bundled.** | +| `runner-cli` | `runner-base` | Adds `git`, `docker.io`, `docker-compose` and global CLIs: `@openai/codex`, `@anthropic-ai/claude-code`, `droid`, `openclaw`. **Pick this for agentic workflows.** | + +Build a specific target manually: + +```bash +docker build --target runner-base -t omniroute:base . +docker build --target runner-cli -t omniroute:cli . +``` + +Defaults exported by `runner-base`: `PORT=20128`, `HOSTNAME=0.0.0.0`, `NODE_OPTIONS=--max-old-space-size=256`, `DATA_DIR=/app/data`, `OMNIROUTE_MIGRATIONS_DIR=/app/migrations`. + +## Critical Environment Variables + +Beyond the defaults documented in [ENVIRONMENT.md](../reference/ENVIRONMENT.md), the following variables matter most when running under Docker: + +| Variable | Purpose | Default | +| ----------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------- | +| `OMNIROUTE_WS_BRIDGE_SECRET` | Shared secret for the WebSocket bridge. **Required in production** — set to a strong random string. | unset (must be provided) | +| `REDIS_URL` | Connection string for the rate limiter / cache backend | `redis://redis:6379` | +| `REDIS_PORT` | Host-side port for the bundled Redis container | `6379` | +| `AUTO_UPDATE_HOST_REPO_DIR` | Host path mounted into `cli` profile at `/workspace/omniroute` for self-update workflows | `.` (current directory) | +| `OMNIROUTE_MEMORY_MB` | Node heap ceiling (`NODE_OPTIONS=--max-old-space-size`) baked into the image | `256` (set in Dockerfile) | +| `DASHBOARD_PORT` / `API_PORT` | Override exposed ports for dashboard (20128) and API (20129) | `20128` / `20129` | +| `PROD_DASHBOARD_PORT` | Host-side dashboard port for `docker-compose.prod.yml` | `20130` | +| `CLIPROXYAPI_PORT` | Host-side port for the `cliproxyapi` sidecar | `8317` | + +## Docker Compose with Caddy (HTTPS Auto-TLS) + +OmniRoute can be securely exposed using Caddy's automatic SSL provisioning. Ensure your domain's DNS A record points to your server's IP. + +```yaml +services: + omniroute: + image: diegosouzapw/omniroute:latest + container_name: omniroute + restart: unless-stopped + volumes: + - omniroute-data:/app/data + environment: + - PORT=20128 + - NEXT_PUBLIC_BASE_URL=https://your-domain.com + + caddy: + image: caddy:latest + container_name: caddy + restart: unless-stopped + ports: + - "80:80" + - "443:443" + command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128 + +volumes: + omniroute-data: +``` + +## Cloudflare Quick Tunnel + +Dashboard support for Docker deployments includes a one-click **Cloudflare Quick Tunnel** on `Dashboard → Endpoints`. The first enable downloads `cloudflared` only when needed, starts a temporary tunnel to your current `/v1` endpoint, and shows the generated `https://*.trycloudflare.com/v1` URL directly below your normal public URL. + +Endpoint tunnel panels (Cloudflare, Tailscale, ngrok) can be shown or hidden from `Settings → Appearance` without changing active tunnel state. + +### Tunnel Notes + +- Quick Tunnel URLs are temporary and change after every restart. +- Quick Tunnels are not auto-restored after an OmniRoute or container restart. Re-enable them from the dashboard when needed. +- Managed install currently supports Linux, macOS, and Windows on `x64` / `arm64`. +- Managed Quick Tunnels default to HTTP/2 transport to avoid noisy QUIC UDP buffer warnings in constrained container environments. Set `CLOUDFLARED_PROTOCOL=quic` or `auto` if you want a different transport. +- Docker images bundle system CA roots and pass them to managed `cloudflared`, which avoids TLS trust failures when the tunnel bootstraps inside the container. +- Set `CLOUDFLARED_BIN=/absolute/path/to/cloudflared` if you want OmniRoute to use an existing binary instead of downloading one. + +## Image Tags + +| Image | Tag | Size | Description | +| ------------------------ | -------- | ------ | --------------------- | +| `diegosouzapw/omniroute` | `latest` | ~250MB | Latest stable release | +| `diegosouzapw/omniroute` | `3.8.0` | ~250MB | Current version | + +Multi-platform manifest: `linux/amd64` + `linux/arm64` native (Apple Silicon, AWS Graviton, Raspberry Pi). Docker selects the matching architecture automatically; pass `--platform linux/amd64` if you need to force AMD64 emulation on ARM hosts. + +## Important Notes + +- **SQLite WAL Mode:** `docker stop` should be allowed to finish so OmniRoute can checkpoint the latest changes back into `storage.sqlite`. The bundled Compose files already set a 40s stop grace period. If you run the image directly, keep `--stop-timeout 40`. +- **`DISABLE_SQLITE_AUTO_BACKUP`:** Set to `true` if backups are managed externally. +- **Data Persistence:** Always mount a volume to `/app/data` to persist your database, keys, and configurations across container restarts. +- **Port Configuration:** Override `PORT` environment variable to change the default `20128` port. + +## See Also + +- [VM Deployment Guide](../ops/VM_DEPLOYMENT_GUIDE.md) — VM + nginx + Cloudflare setup +- [Fly.io Deployment Guide](../ops/FLY_IO_DEPLOYMENT_GUIDE.md) — Deploy to Fly.io +- [Environment Config](../reference/ENVIRONMENT.md) — Complete `.env` reference diff --git a/docs/guides/ELECTRON_GUIDE.md b/docs/guides/ELECTRON_GUIDE.md new file mode 100644 index 0000000000..b6af20f64b --- /dev/null +++ b/docs/guides/ELECTRON_GUIDE.md @@ -0,0 +1,277 @@ +--- +title: "Electron Desktop Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Electron Desktop Guide + +> **Source of truth:** `electron/` workspace +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute ships a cross-platform desktop app (Windows / macOS / Linux) built on +**Electron 41** + **electron-builder 26.10**. The desktop app spawns the Next.js +standalone server as a child process, points a `BrowserWindow` at it, and adds a +system tray, auto-updater, IPC bridge, and zero-config secret bootstrap. + +## Architecture + +``` +┌──────────────────────────────────────────────┐ +│ Electron main process (electron/main.js) │ +│ ├─ Single-instance lock │ +│ ├─ Child process: Next.js standalone server │ +│ │ (spawned with Electron's Node runtime) │ +│ ├─ BrowserWindow → http://localhost:PORT │ +│ ├─ System tray + context menu │ +│ ├─ Auto-update via electron-updater │ +│ ├─ Content Security Policy (session headers) │ +│ └─ Secret bootstrap (JWT / API_KEY_SECRET) │ +└──────────────────────────────────────────────┘ + ↕ IPC bridge (electron/preload.js) +┌──────────────────────────────────────────────┐ +│ Renderer (Next.js dashboard) │ +│ window.electronAPI.* (contextIsolation) │ +└──────────────────────────────────────────────┘ +``` + +## Versions + +Confirmed from `electron/package.json`: + +| Package | Version | +| ------------------ | -------------------------- | +| `electron` | `^41.5.1` | +| `electron-builder` | `^26.10.0` | +| `electron-updater` | `^6.8.5` | +| `better-sqlite3` | `^12.9.0` | +| App version | `3.8.0` | +| App id | `online.omniroute.desktop` | +| Product name | `OmniRoute` | + +## Scripts (root `package.json`) + +| Script | Purpose | +| --------------------------------- | -------------------------------------------------------------------------- | +| `npm run electron:dev` | Starts `npm run dev` + waits for `localhost:20128` + launches Electron | +| `npm run electron:build` | Builds Next.js then runs `electron-builder` for the current OS | +| `npm run electron:build:win` | Builds Windows NSIS installer + portable (x64) | +| `npm run electron:build:mac` | Builds macOS DMG (Intel + Apple Silicon) | +| `npm run electron:build:linux` | Builds Linux AppImage + DEB (x64 + arm64) | +| `npm run electron:smoke:packaged` | Launches packaged binary and probes `/login` for HTTP 200, then shuts down | + +The `electron/` workspace also exposes: + +- `npm run prepare:bundle` — runs `scripts/build/prepare-electron-standalone.mjs` +- `npm run build:mac-x64` / `build:mac-arm64` — single-arch macOS builds +- `npm run pack` — directory-only build for local testing (no installer) + +## Directory Layout + +``` +electron/ +├── package.json # Electron deps + electron-builder config +├── main.js # Main process (24 KB — see annotations below) +├── preload.js # contextBridge IPC bridge +├── types.d.ts # AppInfo / ServerStatus / ElectronAPI types +├── README.md # In-workspace notes +├── assets/ # icon.png, icon.ico, icon.icns, tray-icon.png +└── dist-electron/ # electron-builder output (gitignored) + +scripts/ +├── build/ +│ └── prepare-electron-standalone.mjs # Stages .next/electron-standalone bundle +└── dev/ + └── smoke-electron-packaged.mjs # Post-build smoke test +``` + +Both `main.js` and `preload.js` are **CommonJS `.js` files**, not TypeScript. The +renderer-side typings live in `electron/types.d.ts`. + +## IPC Bridge (`preload.js`) + +The preload exposes a whitelisted API on `window.electronAPI` using `contextBridge` +with `contextIsolation: true` and `nodeIntegration: false`. + +```javascript +const VALID_CHANNELS = { + invoke: [ + "get-app-info", + "open-external", + "get-data-dir", + "restart-server", + "check-for-updates", + "download-update", + "install-update", + "get-app-version", + ], + send: ["window-minimize", "window-maximize", "window-close"], + receive: ["server-status", "port-changed", "update-status"], +}; +``` + +Exposed methods: + +| Renderer call | Type | +| ----------------------------------------------------------------- | -------------------------- | +| `getAppInfo()` → `{ name, version, platform, isDev, port }` | invoke | +| `openExternal(url)` | invoke | +| `getDataDir()` | invoke | +| `restartServer()` | invoke | +| `getAppVersion()` | invoke | +| `checkForUpdates()` / `downloadUpdate()` / `installUpdate()` | invoke | +| `minimizeWindow()` / `maximizeWindow()` / `closeWindow()` | send | +| `onServerStatus(cb)` / `onPortChanged(cb)` / `onUpdateStatus(cb)` | receive (returns disposer) | + +The receive helpers return a **disposer function** rather than relying on +`removeAllListeners` — this prevents listener accumulation when React components +remount. + +## Server Lifecycle + +`main.js` spawns the Next.js standalone bundle directly with the Electron Node +runtime to avoid native-module ABI mismatch with system Node: + +```js +spawn(process.execPath, [serverScript], { + cwd: NEXT_SERVER_PATH, + env: { ...serverEnv, PORT, NODE_ENV: "production", ELECTRON_RUN_AS_NODE: "1", NODE_PATH }, + stdio: "pipe", +}); +``` + +Highlights: + +- `waitForServer()` polls the URL up to 30 s before showing the window (no blank screen on cold start). +- `stdio: "pipe"` captures stdout/stderr; ready phrases (`Ready` / `listening`) emit `server-status: running` over IPC. +- `before-quit` waits up to 5 s for graceful SIGTERM (WAL checkpoint) then sends SIGKILL. +- Port switcher in the tray (`20128`, `3000`, `8080`) stops and restarts the server, then reloads the BrowserWindow. + +## Zero-config Secret Bootstrap + +On first launch, the main process auto-generates and persists missing secrets: + +| Secret | Source | +| ------------------------ | ----------------------------------------------------------------------------------- | +| `JWT_SECRET` | `crypto.randomBytes(64).toString("hex")` | +| `STORAGE_ENCRYPTION_KEY` | `crypto.randomBytes(32).toString("hex")` (refuses if encrypted creds already exist) | +| `API_KEY_SECRET` | `crypto.randomBytes(32).toString("hex")` | + +Persisted to `<DATA_DIR>/server.env`. `DATA_DIR` resolves to: + +- Windows: `%APPDATA%\omniroute` +- Linux: `$XDG_CONFIG_HOME/omniroute` or `~/.omniroute` +- macOS: `~/.omniroute` + +## Window & Tray + +- `BrowserWindow`: 1400×900 (min 1024×700), `backgroundColor: "#0a0a0a"`. +- macOS: `titleBarStyle: "hiddenInset"`, traffic-light at `{ x: 16, y: 16 }`. +- Windows/Linux: native title bar. +- Close button minimizes to tray; the tray menu has **Open OmniRoute**, **Open Dashboard** (external browser), **Server Port** submenu, **Check for Updates**, **Quit**. + +## Content Security Policy + +Set via `session.defaultSession.webRequest.onHeadersReceived`. Notable directives: + +- `frame-ancestors 'none'`, `object-src 'none'`, `child-src 'none'` +- `connect-src 'self' http://localhost:* http://127.0.0.1:* ws://localhost:* ws://127.0.0.1:* https://*.omniroute.online https://*.omniroute.dev` +- Dev mode adds `'unsafe-eval'` to `script-src` only + +## Auto-update + +Uses `electron-updater` with the GitHub provider (`diegosouzapw/OmniRoute`). + +- `autoDownload = false`, `autoInstallOnAppQuit = true` +- Events forwarded to renderer via `update-status` IPC: + `checking`, `available`, `not-available`, `downloading` (with `percent`), `downloaded`, `error` +- `installUpdate()` kills the server then calls `autoUpdater.quitAndInstall()` +- Skipped in dev mode (`!app.isPackaged`) + +## Build Pipeline + +1. `npm run build` → Next.js standalone in `.next/standalone`. +2. `prepare-electron-standalone.mjs` → re-stages into `.next/electron-standalone` and rewrites absolute paths inside `server.js` + `required-server-files.json` so the bundle is relocatable. +3. `electron-builder` packages `main.js`, `preload.js`, `node_modules`, and `extraResources: { ../.next/electron-standalone → app }`. + +### Build targets + +| OS | Targets | +| ------- | ----------------------------------------- | +| Windows | NSIS installer + portable (x64) | +| macOS | DMG (Intel + arm64, drag-to-Applications) | +| Linux | AppImage + DEB (x64 + arm64) | + +NSIS settings: `oneClick: false`, lets the user choose the install directory, creates Desktop and Start-Menu shortcuts. + +## Smoke Testing Packaged Build + +```bash +npm run electron:smoke:packaged +``` + +`scripts/dev/smoke-electron-packaged.mjs`: + +- Auto-discovers the packaged binary in `electron/dist-electron/` for the current platform. +- Launches with isolated `HOME`/`APPDATA`/`XDG_*` directories so it doesn't touch developer data. +- Polls `http://127.0.0.1:20128/login` for HTTP 200 within 45 s. +- Watches stderr/stdout for fatal patterns (`Cannot find module`, `MODULE_NOT_FOUND`, `ERR_DLOPEN_FAILED`, `Failed to start server`, etc.). +- Waits 2 s of stable runtime after readiness, then issues SIGTERM and waits for the port to free. +- In CI, automatically passes `--no-sandbox --disable-gpu` (and `--disable-dev-shm-usage` on Linux). + +Env overrides: `ELECTRON_SMOKE_APP_EXECUTABLE`, `ELECTRON_SMOKE_URL`, `ELECTRON_SMOKE_TIMEOUT_MS`, `ELECTRON_SMOKE_SETTLE_MS`, `ELECTRON_SMOKE_DATA_DIR`, `ELECTRON_SMOKE_KEEP_DATA`, `ELECTRON_SMOKE_STREAM_LOGS`. + +## Code Signing + +`electron/package.json` does **not** wire signing credentials directly. Pass them via env vars to `electron-builder`: + +### macOS + +```bash +export APPLE_ID=<email> +export APPLE_APP_SPECIFIC_PASSWORD=<password> +export APPLE_TEAM_ID=<id> +export CSC_LINK=path/to/cert.p12 +export CSC_KEY_PASSWORD=<cert-password> +npm run electron:build:mac +``` + +### Windows + +```bash +export CSC_LINK=path/to/cert.pfx +export CSC_KEY_PASSWORD=<cert-password> +npm run electron:build:win +``` + +### Linux + +AppImage signing is optional — set `LINUX_GPG_KEY` if signing. + +## Distribution + +Artifacts land in `electron/dist-electron/`: + +- `OmniRoute Setup X.Y.Z.exe`, `OmniRoute-X.Y.Z-portable.exe` (Windows) +- `OmniRoute-X.Y.Z-mac.dmg`, `OmniRoute-X.Y.Z-arm64-mac.dmg` (macOS) +- `OmniRoute-X.Y.Z.AppImage`, `omniroute-desktop_X.Y.Z_amd64.deb` (Linux) + +Releases are published to GitHub Releases (`diegosouzapw/OmniRoute`), which is also where `electron-updater` checks for new versions. + +## Troubleshooting + +| Symptom | Fix | +| --------------------------------------------------------------- | --------------------------------------------------------------------------- | +| `Cannot find module 'better-sqlite3'` after Electron major bump | `cd electron && npm rebuild` | +| `ERR_DLOPEN_FAILED` for native module | Re-run `prepare:bundle` and verify ABI matches Electron's Node | +| Window appears blank on Linux | Confirm Next.js server actually bound to PORT (check `[Server]` logs) | +| macOS notarization stalls | Ensure `APPLE_*` vars are exported, not just in `.env` | +| Windows SmartScreen warning | Sign with EV cert, or users right-click → "Run anyway" | +| Smoke test fails with port-in-use | Stop any local dev server on 20128 before running `electron:smoke:packaged` | + +## See Also + +- [SETUP_GUIDE.md](./SETUP_GUIDE.md) +- [RELEASE_CHECKLIST.md](../ops/RELEASE_CHECKLIST.md) +- Source: `electron/main.js`, `electron/preload.js`, `electron/package.json` +- Helpers: `scripts/build/prepare-electron-standalone.mjs`, `scripts/dev/smoke-electron-packaged.mjs` diff --git a/docs/FEATURES.md b/docs/guides/FEATURES.md similarity index 62% rename from docs/FEATURES.md rename to docs/guides/FEATURES.md index 4c8e9e455f..1ba1699032 100644 --- a/docs/FEATURES.md +++ b/docs/guides/FEATURES.md @@ -1,22 +1,65 @@ +--- +title: "OmniRoute — Dashboard Features Gallery" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute — Dashboard Features Gallery -🌐 **Main README translations:** 🇺🇸 [English](../README.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/README.md) | 🇪🇸 [Español](i18n/es/README.md) | 🇫🇷 [Français](i18n/fr/README.md) | 🇮🇹 [Italiano](i18n/it/README.md) | 🇷🇺 [Русский](i18n/ru/README.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/README.md) | 🇩🇪 [Deutsch](i18n/de/README.md) | 🇮🇳 [हिन्दी](i18n/in/README.md) | 🇹🇭 [ไทย](i18n/th/README.md) | 🇺🇦 [Українська](i18n/uk-UA/README.md) | 🇸🇦 [العربية](i18n/ar/README.md) | 🇯🇵 [日本語](i18n/ja/README.md) | 🇻🇳 [Tiếng Việt](i18n/vi/README.md) | 🇧🇬 [Български](i18n/bg/README.md) | 🇩🇰 [Dansk](i18n/da/README.md) | 🇫🇮 [Suomi](i18n/fi/README.md) | 🇮🇱 [עברית](i18n/he/README.md) | 🇭🇺 [Magyar](i18n/hu/README.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/README.md) | 🇰🇷 [한국어](i18n/ko/README.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/README.md) | 🇳🇱 [Nederlands](i18n/nl/README.md) | 🇳🇴 [Norsk](i18n/no/README.md) | 🇵🇹 [Português (Portugal)](i18n/pt/README.md) | 🇷🇴 [Română](i18n/ro/README.md) | 🇵🇱 [Polski](i18n/pl/README.md) | 🇸🇰 [Slovenčina](i18n/sk/README.md) | 🇸🇪 [Svenska](i18n/sv/README.md) | 🇵🇭 [Filipino](i18n/phi/README.md) | 🇨🇿 [Čeština](i18n/cs/README.md) +🌐 **Main README translations:** 🇺🇸 [English](../README.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/README.md) | 🇪🇸 [Español](../i18n/es/README.md) | 🇫🇷 [Français](../i18n/fr/README.md) | 🇮🇹 [Italiano](../i18n/it/README.md) | 🇷🇺 [Русский](../i18n/ru/README.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/README.md) | 🇩🇪 [Deutsch](../i18n/de/README.md) | 🇮🇳 [हिन्दी](../i18n/in/README.md) | 🇹🇭 [ไทย](../i18n/th/README.md) | 🇺🇦 [Українська](../i18n/uk-UA/README.md) | 🇸🇦 [العربية](../i18n/ar/README.md) | 🇯🇵 [日本語](../i18n/ja/README.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/README.md) | 🇧🇬 [Български](../i18n/bg/README.md) | 🇩🇰 [Dansk](../i18n/da/README.md) | 🇫🇮 [Suomi](../i18n/fi/README.md) | 🇮🇱 [עברית](../i18n/he/README.md) | 🇭🇺 [Magyar](../i18n/hu/README.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/README.md) | 🇰🇷 [한국어](../i18n/ko/README.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/README.md) | 🇳🇱 [Nederlands](../i18n/nl/README.md) | 🇳🇴 [Norsk](../i18n/no/README.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/README.md) | 🇷🇴 [Română](../i18n/ro/README.md) | 🇵🇱 [Polski](../i18n/pl/README.md) | 🇸🇰 [Slovenčina](../i18n/sk/README.md) | 🇸🇪 [Svenska](../i18n/sv/README.md) | 🇵🇭 [Filipino](../i18n/phi/README.md) | 🇨🇿 [Čeština](../i18n/cs/README.md) Visual guide to every section of the OmniRoute dashboard. +> 📅 **Last updated:** 2026-05-13 — **v3.8.0** + +--- + +## ✨ v3.8.0 Highlights + +The v3.7.x → v3.8.0 cycle added zero-config auto routing, new providers, OAuth flows, deeper resilience, and a much richer CLI experience. Headline features below — full details further in the document and in linked specs. + +- 🤖 **Auto Combo / Zero-config auto-routing** — use prefixes `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp`. Backed by a 9-factor scoring engine and 4 curated **mode packs** (ship-fast, cost-saver, quality-first, offline-friendly) +- 🆕 **Command Code provider** (#2199) — first-class registration with model catalog and quota tracking +- 🆕 **Z.AI provider** — new free-tier provider with quota labels +- 🎬 **KIE media expansion** — extended catalog including video generation models +- 🔐 **Windsurf + Devin CLI OAuth flows** (#2168) — end-to-end browser-based login +- 🆓 **9 new free providers** — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi, Command Code +- 🎯 **Manifest-aware tier routing W1–W4** — provider manifests drive weighted tier selection +- 🎨 **Cursor full OpenAI parity** — tool calls, streaming, session management end-to-end +- 📊 **Cursor Pro plan usage** — quota & cycle data surfaced in the provider-limits dashboard +- ⚡ **Service tier breakdown / Codex fast tier analytics** — per-tier consumption visibility +- 📌 **Per-session sticky routing** — Codex sessions pin to the same account between turns +- 🔊 **Inworld TTS enhancements** — voice catalogs, streaming, and latency improvements +- 🔑 **Kiro headless auth** — login via local `kiro-cli` SQLite store, no browser required +- 📉 **DeepSeek quota and limit monitoring** — daily/monthly usage exposed via dashboard +- 🔄 **Reset-aware routing strategy** — combos now prefer accounts whose quota window resets soonest +- ⏱️ **`fallbackDelayMs`** and **dynamic tool limit detection** — finer fallback timing + per-provider tool-count limits +- 🔧 **Background mode degradation (Responses API)** — falls back to synchronous mode with a structured warning when an upstream lacks background polling +- 🚦 **Per-provider 429 classification** + `useUpstream429BreakerHints` toggle — finer breaker behavior using upstream rate-limit hints +- 🩺 **Model cooldowns dashboard** — observe per-model lockouts and manually re-enable from the UI +- 🔒 **MITM dynamic Linux cert detection** — works across Debian/Ubuntu, Fedora/RHEL, Arch, and other distros +- 💻 **CLI enhancement suite** — 20+ commands including `omniroute providers`, `omniroute combos`, `omniroute doctor`, `omniroute setup` +- 🔍 **Qdrant embedding model discovery** — automatic vector-store model probe +- 🔑 **API Manager / Bearer keys with `manage` scope** — perform admin operations programmatically via API +- 🏥 **Combo target health analytics** + **structured combo builder** — per-target health & UI builder for assembling `(provider, model, connection)` steps +- 🤝 **GitLab Duo OAuth provider** — login with GitLab credentials +- 🧠 **Reasoning Replay Cache** — hybrid in-memory + SQLite persistence of reasoning traces + +📚 **Related docs:** [Skills Framework](../frameworks/SKILLS.md) · [Memory System](../frameworks/MEMORY.md) · [Cloud Agents](../frameworks/CLOUD_AGENT.md) · [Webhooks](../frameworks/WEBHOOKS.md) · [Reasoning Replay Cache](../routing/REASONING_REPLAY.md) + --- ## 🔌 Providers Manage AI provider connections: OAuth providers (Claude Code, Codex, Gemini CLI), API key providers (Groq, DeepSeek, OpenRouter), and free providers (Qoder, Qwen, Kiro). Kiro accounts include credit balance tracking — remaining credits, total allowance, and renewal date visible in Dashboard → Usage. -![Providers Dashboard](screenshots/01-providers.png) +![Providers Dashboard](../screenshots/01-providers.png) --- ## 🎨 Combos -Create model routing combos with 13 strategies: priority, weighted, round-robin, random, least-used, cost-optimized, strict-random, auto, fill-first, p2c, lkgp, context-optimized, and **context-relay**. Each combo chains multiple models with automatic fallback and includes quick templates and readiness checks. +Create model routing combos with 14 strategies: priority, weighted, fill-first, round-robin, p2c (power-of-two-choices), random, least-used, cost-optimized, reset-aware, strict-random, auto, lkgp (last-known-good-provider), context-optimized, and **context-relay**. Each combo chains multiple models with automatic fallback and includes quick templates and readiness checks. Recent combo improvements: @@ -25,7 +68,7 @@ Recent combo improvements: - **Combo target health** — analytics and health surfaces now distinguish individual combo targets/steps instead of collapsing everything into model strings - **Composite tier ordering** — `defaultTier -> fallbackTier` now influences runtime execution/fallback order for top-level combo steps -![Combos Dashboard](screenshots/02-combos.png) +![Combos Dashboard](../screenshots/02-combos.png) --- @@ -33,7 +76,7 @@ Recent combo improvements: Comprehensive usage analytics with token consumption, cost estimates, activity heatmaps, weekly distribution charts, and per-provider breakdowns. -![Analytics Dashboard](screenshots/03-analytics.png) +![Analytics Dashboard](../screenshots/03-analytics.png) --- @@ -41,7 +84,7 @@ Comprehensive usage analytics with token consumption, cost estimates, activity h Real-time monitoring: uptime, memory, version, latency percentiles (p50/p95/p99), cache statistics, provider circuit breaker states, active quota-monitored sessions, and combo target health. -![Health Dashboard](screenshots/04-health.png) +![Health Dashboard](../screenshots/04-health.png) --- @@ -49,7 +92,7 @@ Real-time monitoring: uptime, memory, version, latency percentiles (p50/p95/p99) 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) +![Translator Playground](../screenshots/05-translator.png) --- @@ -67,16 +110,17 @@ Customizable color themes for the entire dashboard. Choose from 7 preset colors ## ⚙️ Settings -Comprehensive settings panel with tabs: +Comprehensive settings panel with **7 tabs**: - **General** — System storage, backup management (export/import database) - **Appearance** — Theme selector (dark/light/system), color theme presets and custom colors, health log visibility, sidebar item visibility controls, Endpoint tunnel visibility controls +- **AI** — AI assistant features, default routing presets (Auto Combo `auto/coding`, `auto/fast`, `auto/cheap`, `auto/smart`), reasoning replay cache, and skill/memory toggles - **Security** — API endpoint protection, custom provider blocking, IP filtering, session info -- **Routing** — Model aliases, background task degradation -- **Resilience** — Rate limit persistence, circuit breaker tuning, auto-disable banned accounts, provider expiration monitoring, **Context Relay** handoff threshold and summary model configuration -- **Advanced** — Configuration overrides, configuration audit trail, fallback degradation mode +- **Routing** — Model aliases, background task degradation, manifest-aware tier routing (W1–W4), `fallbackDelayMs`, per-session sticky routing +- **Resilience** — Rate limit persistence, circuit breaker tuning, auto-disable banned accounts, provider expiration monitoring, **Context Relay** handoff threshold and summary model configuration, per-provider 429 classification & `useUpstream429BreakerHints` toggle, model cooldowns +- **Advanced** — Configuration overrides, configuration audit trail, fallback degradation mode, background mode degradation for Responses API -![Settings Dashboard](screenshots/06-settings.png) +![Settings Dashboard](../screenshots/06-settings.png) --- @@ -84,18 +128,19 @@ Comprehensive settings panel with tabs: One-click configuration for AI coding tools: Claude Code, Codex CLI, Gemini CLI, OpenClaw, Kilo Code, Antigravity, Cline, Continue, Cursor, and Factory Droid. Features automated config apply/reset, connection profiles, and model mapping. -![CLI Tools Dashboard](screenshots/07-cli-tools.png) +![CLI Tools Dashboard](../screenshots/07-cli-tools.png) --- ## 🤖 CLI Agents _(v2.0.11+)_ -Dashboard for discovering and managing CLI agents. Shows a grid of 14 built-in agents (Codex, Claude, Goose, Gemini CLI, OpenClaw, Aider, OpenCode, Cline, Qwen Code, ForgeCode, Amazon Q, Open Interpreter, Cursor CLI, Warp) with: +Dashboard for discovering and managing CLI agents. Shows a grid of 18 built-in agents (Codex, Claude, Goose, Gemini CLI, OpenClaw, Aider, OpenCode, Cline, Qwen Code, ForgeCode, Amazon Q, Open Interpreter, Cursor CLI, Warp, **Windsurf**, **Devin CLI**, **Kimi Coding**, **Command Code**) with: - **Installation status** — Installed / Not Found with version detection - **Protocol badges** — stdio, HTTP, etc. - **Custom agents** — Register any CLI tool via form (name, binary, version command, spawn args) - **CLI Fingerprint Matching** — Per-provider toggle to match native CLI request signatures, reducing ban risk while preserving proxy IP +- **OAuth-backed agents** — Windsurf & Devin CLI now use browser OAuth flows for authentication (v3.8.0+) --- @@ -109,7 +154,7 @@ Configurable via combo-level or global settings: - **Max Messages For Summary** — How much recent history to condense - **Summary Model** — Optional override model for generating the handoff summary -Currently supports Codex account rotation. See [Context Relay documentation](ARCHITECTURE.md). +Currently supports Codex account rotation. See [Context Relay documentation](../architecture/ARCHITECTURE.md). --- @@ -122,8 +167,8 @@ Context & Cache now exposes dedicated pages for Caveman, RTK, and Compression Co - **Compression Combos** — named pipelines such as `rtk -> caveman` assigned to routing combos; the default stacked math reaches `~89%` average and `78-95%` eligible-context savings when both engines apply - **Raw-output recovery** — optional redacted RTK raw-output pointers for debugging compressed failures -See [Compression Guide](COMPRESSION_GUIDE.md), [RTK Compression](RTK_COMPRESSION.md), and -[Compression Engines](COMPRESSION_ENGINES.md). +See [Compression Guide](../compression/COMPRESSION_GUIDE.md), [RTK Compression](../compression/RTK_COMPRESSION.md), and +[Compression Engines](../compression/COMPRESSION_ENGINES.md). --- @@ -185,7 +230,7 @@ Generate images, videos, and music from the dashboard. Supports OpenAI, xAI, Tog 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) +![Usage Logs](../screenshots/08-usage.png) --- @@ -193,7 +238,7 @@ Real-time request logging with filtering by provider, model, account, and API ke Your unified API endpoint with capability breakdown: Chat Completions, Responses API, Embeddings, Image Generation, Reranking, Audio Transcription, Text-to-Speech, Moderations, and registered API keys. Cloudflare Quick Tunnel, Tailscale Funnel, ngrok Tunnel, and cloud proxy support are available for remote access. -![Endpoint Dashboard](screenshots/09-endpoint.png) +![Endpoint Dashboard](../screenshots/09-endpoint.png) --- @@ -224,13 +269,13 @@ Key features: - Hardened Electron build packaging — symlinked `node_modules` in the standalone bundle is detected and rejected before packaging, preventing runtime dependency on the build machine (v2.5.5+) - **Graceful shutdown** — Electron `before-quit` shuts down Next.js cleanly, preventing SQLite WAL database locks (v3.6.2+) -📖 See [`electron/README.md`](../electron/README.md) for full documentation. +📖 See [`electron/README.md`](../../electron/README.md) for full documentation. --- ## 🌐 V1 WebSocket Bridge _(v3.6.6+)_ -OmniRoute now supports **OpenAI-compatible WebSocket clients** via the `/v1/ws` upgrade endpoint. The custom `scripts/v1-ws-bridge.mjs` server wraps Next.js and upgrades WS connections to full bidirectional streaming sessions. Authentication uses the same API key or session cookie as HTTP requests. +OmniRoute now supports **OpenAI-compatible WebSocket clients** via the `/v1/ws` upgrade endpoint. The custom `scripts/dev/v1-ws-bridge.mjs` server wraps Next.js and upgrades WS connections to full bidirectional streaming sessions. Authentication uses the same API key or session cookie as HTTP requests. Key behaviours: diff --git a/docs/guides/I18N.md b/docs/guides/I18N.md new file mode 100644 index 0000000000..7da3906fc5 --- /dev/null +++ b/docs/guides/I18N.md @@ -0,0 +1,509 @@ +--- +title: "i18n — Internationalization Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# i18n — Internationalization Guide + +OmniRoute supports **30 languages** with full dashboard UI translation, translated documentation, and RTL support for Arabic and Hebrew. + +🌐 **Languages:** 🇺🇸 [English](./I18N.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/guides/I18N.md) | 🇪🇸 [Español](../i18n/es/docs/guides/I18N.md) | 🇫🇷 [Français](../i18n/fr/docs/guides/I18N.md) | 🇩🇪 [Deutsch](../i18n/de/docs/guides/I18N.md) | 🇮🇹 [Italiano](../i18n/it/docs/guides/I18N.md) | 🇷🇺 [Русский](../i18n/ru/docs/guides/I18N.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/guides/I18N.md) | 🇯🇵 [日本語](../i18n/ja/docs/guides/I18N.md) | 🇰🇷 [한국어](../i18n/ko/docs/guides/I18N.md) | 🇸🇦 [العربية](../i18n/ar/docs/guides/I18N.md) | 🇮🇳 [हिन्दी](../i18n/hi/docs/guides/I18N.md) | 🇹🇭 [ไทย](../i18n/th/docs/guides/I18N.md) | 🇹🇷 [Türkçe](../i18n/tr/docs/guides/I18N.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/guides/I18N.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/guides/I18N.md) | 🇧🇬 [Български](../i18n/bg/docs/guides/I18N.md) | 🇩🇰 [Dansk](../i18n/da/docs/guides/I18N.md) | 🇫🇮 [Suomi](../i18n/fi/docs/guides/I18N.md) | 🇮🇱 [עברית](../i18n/he/docs/guides/I18N.md) | 🇭🇺 [Magyar](../i18n/hu/docs/guides/I18N.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/guides/I18N.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/guides/I18N.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/guides/I18N.md) | 🇳🇴 [Norsk](../i18n/no/docs/guides/I18N.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/guides/I18N.md) | 🇷🇴 [Română](../i18n/ro/docs/guides/I18N.md) | 🇵🇱 [Polski](../i18n/pl/docs/guides/I18N.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/guides/I18N.md) | 🇸🇪 [Svenska](../i18n/sv/docs/guides/I18N.md) | 🇵🇭 [Filipino](../i18n/phi/docs/guides/I18N.md) | 🇨🇿 [Čeština](../i18n/cs/docs/guides/I18N.md) + +## Translation pipeline (recommended — v3.8.0) + +OmniRoute uses a hash-based incremental translator for docs, backed by an +OpenAI-compatible LLM endpoint (typically `cx/gpt-5.4-mini` through OmniRoute +Cloud): + +```bash +# Run translations (incremental — only touches changed sources) +npm run i18n:run + +# Limit to one locale +npm run i18n:run -- --locale=pt-BR + +# Specific files (comma-separated, repo-relative paths) +npm run i18n:run -- --files=CLAUDE.md,docs/architecture/ARCHITECTURE.md + +# Force retranslate everything (expensive) +npm run i18n:run -- --force + +# Preview what would happen (no API calls, no writes) +npm run i18n:run:dry + +# CI gate — exits non-zero if state is drifting +npm run i18n:check +``` + +**Source of truth.** `config/i18n.json` lists every locale (UI + docs) plus +the RTL set and the `docsExcluded` codes. The runtime config in +`src/i18n/config.ts` is a thin adapter over that JSON. + +**Backend.** Configured via env (set in `.env`, never committed): + +| Variable | Purpose | +| ----------------------------------- | --------------------------------------- | +| `OMNIROUTE_TRANSLATION_API_URL` | OpenAI-compatible base URL, e.g. `…/v1` | +| `OMNIROUTE_TRANSLATION_API_KEY` | bearer token (kept out of logs) | +| `OMNIROUTE_TRANSLATION_MODEL` | model id, e.g. `cx/gpt-5.4-mini` | +| `OMNIROUTE_TRANSLATION_TIMEOUT_MS` | optional, default `60000` | +| `OMNIROUTE_TRANSLATION_CONCURRENCY` | optional, default `4` | + +**State tracking.** `.i18n-state.json` (committed) keeps SHA-256 hashes per +source + per locale. Drift detection is automatic and deterministic — no API +calls in `i18n:check`. + +**Output shape.** Each translated file gets a top-level `# <heading> +(<native>)` line, a `🌐 Languages: …` bar, an `---` separator, and the +translated body. That layout matches what `scripts/check/check-docs-sync.mjs` +already enforces for `llm.txt` and `CHANGELOG.md` mirrors. + +### Legacy scripts (deprecated) + +The older Python script (`scripts/i18n/i18n_autotranslate.py`) and the +Google-Translate-backed generator (`scripts/i18n/generate-multilang.mjs`) +still exist with a deprecation banner. They will be removed in v3.10. The +`messages` and `readme` modes of `generate-multilang.mjs` (UI strings + root +README variants) are not yet handled by the new pipeline and are still used. + +## Quick Reference + +| Task | Command | +| ----------------------- | ---------------------------------------------------------- | +| Translate docs (LLM) | `npm run i18n:run` (preferred — incremental, hash-based) | +| Translate UI strings | `node scripts/i18n/generate-multilang.mjs messages` | +| Check translation drift | `npm run i18n:check` | +| Validate a locale | `python3 scripts/i18n/validate_translation.py quick -l cs` | +| Check code keys | `python3 scripts/i18n/check_translations.py` | +| Generate QA report | `node scripts/i18n/generate-qa-checklist.mjs` | +| Visual QA (Playwright) | `node scripts/i18n/run-visual-qa.mjs` | + +## Architecture + +![Incremental hash-based i18n pipeline](../diagrams/exported/i18n-flow.svg) + +> Source: [diagrams/i18n-flow.mmd](../diagrams/i18n-flow.mmd) + +### Source of Truth + +- **UI strings**: `src/i18n/messages/en.json` (English source, ~2800 keys) +- **Locale files**: `src/i18n/messages/{locale}.json` (30 translations) +- **Framework**: `next-intl` with cookie-based locale resolution +- **Config**: `src/i18n/config.ts` — defines all 30 locales, language names, flags + +### Runtime Flow + +1. User selects language → `NEXT_LOCALE` cookie set +2. `src/i18n/request.ts` resolves locale: cookie → `Accept-Language` header → fallback `en` +3. Dynamic import loads `messages/{locale}.json` +4. Components use `useTranslations("namespace")` and `t("key")` + +### Supported Locales + +| Code | Language | RTL | Google Translate Code | +| ------- | -------------------- | --- | --------------------- | +| `ar` | العربية | Yes | `ar` | +| `bg` | Български | No | `bg` | +| `cs` | Čeština | No | `cs` | +| `da` | Dansk | No | `da` | +| `de` | Deutsch | No | `de` | +| `es` | Español | No | `es` | +| `fi` | Suomi | No | `fi` | +| `fr` | Français | No | `fr` | +| `he` | עברית | Yes | `iw` | +| `hi` | हिन्दी | No | `hi` | +| `hu` | Magyar | No | `hu` | +| `id` | Bahasa Indonesia | No | `id` | +| `it` | Italiano | No | `it` | +| `ja` | 日本語 | No | `ja` | +| `ko` | 한국어 | No | `ko` | +| `ms` | Bahasa Melayu | No | `ms` | +| `nl` | Nederlands | No | `nl` | +| `no` | Norsk | No | `no` | +| `phi` | Filipino | No | `tl` | +| `pl` | Polski | No | `pl` | +| `pt` | Português (Portugal) | No | `pt` | +| `pt-BR` | Português (Brasil) | No | `pt` | +| `ro` | Română | No | `ro` | +| `ru` | Русский | No | `ru` | +| `sk` | Slovenčina | No | `sk` | +| `sv` | Svenska | No | `sv` | +| `th` | ไทย | No | `th` | +| `tr` | Türkçe | No | `tr` | +| `uk-UA` | Українська | No | `uk` | +| `vi` | Tiếng Việt | No | `vi` | +| `zh-CN` | 中文 (简体) | No | `zh-CN` | + +## Adding a New Language + +### 1. Register the Locale + +Edit `src/i18n/config.ts`: + +```ts +// Add to LOCALES array +"xx", +// Add to LANGUAGES array +{ code: "xx", label: "XX", name: "Language Name", flag: "🏳️" }, +``` + +### 2. Add to Generator + +Edit `scripts/i18n/generate-multilang.mjs` — add entry to `LOCALE_SPECS`: + +```js +{ + code: "xx", + googleTl: "xx", + label: "XX", + flag: "🏳️", + languageName: "Language Name", + readmeName: "Language Name", + docsName: "Language Name", +}, +``` + +### 3. Generate Initial Translation + +```bash +node scripts/i18n/generate-multilang.mjs messages +``` + +This creates `src/i18n/messages/xx.json` auto-translated from `en.json` via Google Translate. + +### 4. Review & Fix Auto-Translations + +Auto-translations are a starting point. Review manually for: + +- Technical accuracy +- Context-appropriate terminology +- Proper handling of placeholders (`{count}`, `{value}`, etc.) + +### 5. Validate + +```bash +python3 scripts/i18n/validate_translation.py quick -l xx +python3 scripts/i18n/validate_translation.py diff common -l xx +``` + +### 6. Generate Translated Documentation + +```bash +node scripts/i18n/generate-multilang.mjs docs +``` + +## Auto-Translation Pipeline + +### generate-multilang.mjs (Google Translate) + +**Primary auto-translation engine** — uses Google Translate free API to generate translations for UI strings, READMEs, and documentation. + +```bash +node scripts/i18n/generate-multilang.mjs [messages|readme|docs|all] +``` + +| Mode | What it does | +| ---------- | ----------------------------------------------------------------------------- | +| `messages` | Translates missing keys in `src/i18n/messages/{locale}.json` from `en.json` | +| `readme` | Translates `README.md` into all locales as `README.{code}.md` in project root | +| `docs` | Translates `DOC_SOURCE_FILES` into `docs/i18n/{locale}/{docName}` | +| `all` | Runs all three modes | + +**Features:** + +- **Text protection**: Masks code blocks (` ``` `), inline code (`` ` ``), markdown links/images (`[text](url)`), HTML tags, tables, and ICU placeholders (`{count}`, `{value}`, `{total}`, etc.) before translation, then restores them +- **Chunked batching**: Joins multiple strings with `__OMNIROUTE_I18N_SEPARATOR__` delimiters to minimize API calls (max 1800 chars per request) +- **In-memory cache**: Avoids redundant API calls for repeated strings within a session +- **Retry logic**: Exponential backoff (up to 5 attempts with 300ms × attempt delay) for 429/5xx errors +- **Timeout**: 20 seconds per request +- **Skip existing**: If target file already exists, it is NOT overwritten + +**Important behaviors:** + +- `docs/i18n/README.md` is **regenerated** each run — it's an auto-generated index of all docs +- Root `README.{code}.md` files are only created if they don't exist (skips locales in `EXISTING_README_CODES`) +- Language bars (`🌐 **Languages:** ...`) are automatically inserted/updated in all translated docs + +### i18n_autotranslate.py (LLM-based) + +**Secondary translator** — uses any OpenAI-compatible LLM API (including OmniRoute itself) to translate existing `docs/i18n/` markdown files. Best for polishing or re-translating docs with better quality than Google Translate. + +```bash +python3 scripts/i18n/i18n_autotranslate.py \ + --api-url http://localhost:20128/v1 \ + --api-key sk-your-key \ + --model gpt-4o +``` + +**Features:** + +- Scans `docs/i18n/` markdown files for English paragraphs +- Skips code blocks, tables, and already-translated content +- Sends paragraphs to LLM with technical translation system prompt +- Supports all 30 languages + +## Validation & QA + +### validate_translation.py + +**Translation validator** — compares any locale JSON against `en.json` and reports issues. + +```bash +# Quick check (counts only) +python3 scripts/i18n/validate_translation.py quick -l cs +# Output: +# Missing: 0 +# Untranslated: 0 +# Ignored (UNTRANSLATABLE_KEYS): 236 + +# Detailed diff by category +python3 scripts/i18n/validate_translation.py diff common -l cs +python3 scripts/i18n/validate_translation.py diff settings -l cs + +# Export to CSV +python3 scripts/i18n/validate_translation.py csv -l cs > report.csv + +# Export to Markdown +python3 scripts/i18n/validate_translation.py md -l cs > report.md + +# Full report (default) +python3 scripts/i18n/validate_translation.py -l cs +``` + +**Detects:** + +- **Missing keys** — keys in `en.json` but not in locale file +- **Extra keys** — keys in locale file but not in `en.json` +- **Untranslated keys** — keys where locale value equals English source (excluding allowlist) +- **Placeholder mismatches** — ICU placeholders that don't match between source and translation + +**Exit codes:** +| Code | Meaning | +|------|---------| +| 0 | OK | +| 1 | Generic error | +| 2 | Missing strings (hard error) | +| 3 | Untranslated warning (soft) | + +**Environment:** Set `TRANSLATION_LANG=cs` or use `-l cs` flag. + +### check_translations.py + +**Code-to-JSON key checker** — scans `src/**/*.tsx` and `src/**/*.ts` for `useTranslations()` calls and verifies all referenced keys exist in `en.json`. + +```bash +# Basic check +python3 scripts/i18n/check_translations.py + +# Verbose output +python3 scripts/i18n/check_translations.py --verbose + +# Auto-fix (adds missing keys to en.json) +python3 scripts/i18n/check_translations.py --fix +``` + +### generate-qa-checklist.mjs + +**Static analysis QA** — scans Next.js page files for i18n risk metrics and generates a Markdown report. + +```bash +node scripts/i18n/generate-qa-checklist.mjs +``` + +**Checks:** + +- Fixed-width class usage (overflow risk) +- Directional left/right classes (RTL risk) +- Clipping-prone patterns +- Locale parity (missing/extra keys vs `en.json`) +- README language selector bars in priority locales (`es`, `fr`, `de`, `ja`, `ar`) + +**Output:** `docs/reports/i18n-qa-checklist-{date}.md` + +### run-visual-qa.mjs + +**Visual QA via Playwright** — takes screenshots of all dashboard routes in multiple locales and viewports, then evaluates page health. + +```bash +# Default: es, fr, de, ja, ar on localhost:20128 +node scripts/i18n/run-visual-qa.mjs + +# Custom base URL and locales +QA_BASE_URL=http://staging.example.com QA_LOCALES=de,fr node scripts/i18n/run-visual-qa.mjs + +# Custom routes +QA_ROUTES=/dashboard/settings,/dashboard/providers node scripts/i18n/run-visual-qa.mjs +``` + +**Detects:** + +- Text overflow +- Element clipping +- RTL layout mismatches + +**Output:** `docs/reports/i18n-visual-qa-{date}.md` + JSON report + +## Managing Untranslatable Keys + +### untranslatable-keys.json + +**File:** `scripts/i18n/untranslatable-keys.json` + +Allowlist of keys that should remain identical to English source. Used by `validate_translation.py` to avoid false-positive "untranslated" warnings. + +```json +{ + "description": "Keys that should remain untranslated...", + "keys": [ + "common.model", + "common.oauth", + "health.cpu", + ... + ] +} +``` + +**What belongs here:** + +- Brand/product names: `landing.brandName`, `common.social-github` +- Technical terms/acronyms: `health.cpu`, `mcpDashboard.pid`, `settings.ai` +- ICU/format strings: `apiManager.modelsCount`, `health.millisecondsShort` +- Placeholder values: `providers.openaiBaseUrlPlaceholder`, `cliTools.baseUrlPlaceholder` +- Protocol names: `common.http`, `common.oauth`, `providers.oauth2Label` +- Navigation sections: `sidebar.primarySection`, `sidebar.cliSection` + +**To add a key:** Edit the `keys` array in `scripts/i18n/untranslatable-keys.json` and re-run validation. + +## CI Integration + +### GitHub Actions (`.github/workflows/ci.yml`) + +The CI pipeline validates all locales on every push and PR: + +1. **`i18n-matrix` job** — dynamically discovers all locale files (excluding `en.json`) +2. **`i18n` job** — runs `validate_translation.py quick -l '<lang>'` for each locale in parallel +3. **`ci-summary` job** — aggregates results into a dashboard summary + +```yaml +# i18n-matrix: discovers languages +LANGS=$(ls src/i18n/messages/*.json | xargs -n1 basename | sed 's/.json$//' | grep -v '^en$') + +# i18n: validates each language +python3 scripts/i18n/validate_translation.py quick -l '${{ matrix.lang }}' +``` + +**Dashboard output:** + +``` +## 🌍 Translations +| Metric | Value | +|--------|------| +| Languages checked | 30 | +| Total untranslated | 0 | + +✅ All translations complete +``` + +## File Structure + +``` +src/i18n/ +├── config.ts # Locale definitions (30 locales, RTL config) +├── request.ts # Runtime locale resolution +└── messages/ + ├── en.json # Source of truth (~2800 keys) + ├── cs.json # Czech translation + ├── de.json # German translation + └── ... # 30 locale files total + +scripts/ +├── i18n/ +│ ├── generate-multilang.mjs # Auto-translation engine (Google Translate, 888 lines) +│ ├── generate-qa-checklist.mjs # Static analysis QA +│ ├── run-visual-qa.mjs # Playwright visual QA +│ └── untranslatable-keys.json # Allowlist for validation (236 keys) +├── validate_translation.py # Translation validator +├── check_translations.py # Code-to-JSON key checker +└── i18n_autotranslate.py # LLM-based doc translator + +.github/workflows/ +└── ci.yml # i18n validation in CI matrix + +docs/ +├── I18N.md # This file — i18n toolchain documentation +├── i18n/ +│ ├── README.md # Auto-generated language index +│ ├── cs/ # Czech docs +│ │ └── docs/ +│ │ ├── I18N.md # Czech translation of this file +│ │ └── ... +│ ├── de/ # German docs +│ └── ... # 30 locale directories +└── reports/ + ├── i18n-qa-checklist-*.md # Static analysis reports + └── i18n-visual-qa-*.md # Visual QA reports +``` + +## Best Practices + +### When Editing Translations + +1. **Always edit `en.json` first** — it's the source of truth +2. **Run `generate-multilang.mjs messages`** to propagate new keys to all locales +3. **Review auto-translations** — Google Translate is a starting point, not final +4. **Validate before committing** — `python3 scripts/i18n/validate_translation.py quick -l <lang>` +5. **Update `untranslatable-keys.json`** if a key should remain in English + +### Placeholder Safety + +- ICU placeholders (`{count}`, `{value}`, `{total}`, `{seconds}`) must be preserved exactly +- Plural formats (`{count, plural, one {# model} other {# models}}`) must maintain structure +- The validator detects placeholder mismatches automatically + +### Adding New Translation Keys in Code + +```tsx +// Use namespaced keys +const t = useTranslations("settings"); +t("cacheSettings"); // maps to settings.cacheSettings in JSON + +// Run check_translations.py to verify keys exist +python3 scripts/i18n/check_translations.py --verbose +``` + +### RTL Considerations + +- Arabic (`ar`) and Hebrew (`he`) are RTL locales +- Avoid hardcoded `left`/`right` CSS — use `start`/`end` logical properties +- Visual QA catches RTL layout mismatches via `run-visual-qa.mjs` + +## Known Issues & History + +### `in.json` → `hi.json` Fix + +The generator originally used `code: "in"` (deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 `hi`. This created an orphaned `in.json` duplicate of `hi.json`. Fixed by changing `code: "in"` to `code: "hi"` in `generate-multilang.mjs` and removing the orphaned file. + +> ⚠️ **Audit (2026-05-13):** The `docs/i18n/in/` directory still exists on disk (full duplicate of `hi/`). Translation generator no longer writes to it, but the historical tree was not pruned. Safe to delete with `rm -rf docs/i18n/in/` after confirming no external links reference the old path. + +### `docs/i18n/README.md` Is Auto-Generated + +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. + +### External Untranslatable Keys List + +The `untranslatable-keys.json` allowlist was moved from an inline Python set in `validate_translation.py` to an external JSON file for easier maintenance. The validator loads it at runtime. + +### `generate-multilang.mjs` Hindi Code Fix + +The generator originally used `code: "in"` (deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 `hi`. This was introduced in upstream commit `952b0b22c` by `diegosouzapw`. Fixed by changing `code: "in"` to `code: "hi"` in the `LOCALE_SPECS` array and removing the orphaned `in.json` file. + +### `validate_translation.py` Ignored Count Output + +The `quick` check now displays the count of ignored keys from `untranslatable-keys.json`: + +``` +Missing: 0 +Untranslated: 0 +Ignored (UNTRANSLATABLE_KEYS): <varies per release> +``` diff --git a/docs/PWA_GUIDE.md b/docs/guides/PWA_GUIDE.md similarity index 99% rename from docs/PWA_GUIDE.md rename to docs/guides/PWA_GUIDE.md index a775bb2c9d..c52a35ddb3 100644 --- a/docs/PWA_GUIDE.md +++ b/docs/guides/PWA_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "Progressive Web App (PWA) Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Progressive Web App (PWA) Guide OmniRoute ships as a fully installable Progressive Web App. When you access the dashboard from any mobile browser — Android (Chrome) or iOS (Safari) — you can "Add to Home Screen" and get a native app-like experience with no app store required. diff --git a/docs/SETUP_GUIDE.md b/docs/guides/SETUP_GUIDE.md similarity index 80% rename from docs/SETUP_GUIDE.md rename to docs/guides/SETUP_GUIDE.md index b4f20d7213..4031ea6160 100644 --- a/docs/SETUP_GUIDE.md +++ b/docs/guides/SETUP_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "📖 Setup Guide — OmniRoute" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # 📖 Setup Guide — OmniRoute > Complete setup reference for OmniRoute. For the quick version, see the [Quick Start in README](../README.md#-quick-start). @@ -47,27 +53,59 @@ The [AUR package](https://aur.archlinux.org/packages/omniroute-bin) installs Omn ### From Source ```bash -cp .env.example .env npm install PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev ``` +> **Note:** `npm install` auto-generates `.env` from `.env.example` on first run. Subsequent installs will not overwrite an existing `.env`, so customizations are preserved. To re-seed, delete `.env` before re-running. + ### Docker -See the [Docker Guide](DOCKER_GUIDE.md) for complete Docker setup including Compose profiles and Caddy HTTPS. +See the [Docker Guide](./DOCKER_GUIDE.md) for complete Docker setup including Compose profiles and Caddy HTTPS. + +### Desktop App (Electron) + +OmniRoute ships a desktop wrapper built on Electron 41 + electron-builder 26.10. Available scripts (workspace root): + +```bash +npm run electron:dev # Run desktop with hot-reload +npm run electron:build # Build for current OS (auto-detected) +npm run electron:build:win # Windows installer (NSIS + portable) +npm run electron:build:mac # macOS (dmg + zip, arm64+x64) +npm run electron:build:linux # Linux (AppImage + deb + rpm) +npm run electron:smoke:packaged # Smoke-test packaged build +``` + +Releases of the desktop installers are attached to GitHub Releases. For the full Electron deep-dive (signing, IPC bridge, distros), see [`ELECTRON_GUIDE.md`](./ELECTRON_GUIDE.md) _(criado em fase posterior)_. + +### Headless server (CI/automation) + +For unattended setups (Docker, Kubernetes, CI), use: + +```bash +omniroute setup --non-interactive +omniroute providers test-batch +``` + +Combined with env vars (`INITIAL_PASSWORD`, `OMNIROUTE_WS_BRIDGE_SECRET`, etc.), this lets you spin up an OmniRoute instance fully scriptable. ### CLI Options -| Command | Description | -| ----------------------- | ----------------------------------------------------------- | -| `omniroute` | Start server (`PORT=20128`, API and dashboard on same port) | -| `omniroute setup` | Guided CLI onboarding for password and first provider | -| `omniroute doctor` | Run local health checks without starting the server | -| `omniroute providers` | Discover, list, validate, and test providers from CLI | -| `omniroute --port 3000` | Set canonical/API port to 3000 | -| `omniroute --mcp` | Start MCP server (stdio transport) | -| `omniroute --no-open` | Don't auto-open browser | -| `omniroute --help` | Show help | +| Command | Description | +| ----------------------- | -------------------------------------------------------------- | +| `omniroute` | Start server (`PORT=20128`, API and dashboard on same port) | +| `omniroute setup` | Guided CLI onboarding for password and first provider | +| `omniroute doctor` | Run local health checks without starting the server | +| `omniroute providers` | Discover, list, validate, and test providers from CLI | +| `omniroute config` | CLI tool configuration — list, get, set, validate configs | +| `omniroute status` | Offline status dashboard — version, DB, tools, config | +| `omniroute logs` | Stream usage logs from the API (supports `--follow`) | +| `omniroute update` | Check for or apply OmniRoute updates | +| `omniroute provider` | Manage provider connections — add, list, remove, test, default | +| `omniroute --port 3000` | Set canonical/API port to 3000 | +| `omniroute --mcp` | Start MCP server (stdio transport) | +| `omniroute --no-open` | Don't auto-open browser | +| `omniroute --help` | Show help | Headless setup can be scripted with flags or environment variables: @@ -117,7 +155,7 @@ Model: if/kimi-k2-thinking (or any provider/model prefix) Works with Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode, and OpenAI-compatible SDKs. -For detailed per-tool configuration (Claude Code, Codex CLI, Cursor, Cline, OpenClaw, Kilo Code, Copilot, and more), see the dedicated **[CLI Tools Guide](CLI-TOOLS.md)**. +For detailed per-tool configuration (Claude Code, Codex CLI, Cursor, Cline, OpenClaw, Kilo Code, Copilot, and more), see the dedicated **[CLI Tools Guide](../reference/CLI-TOOLS.md)**. --- @@ -169,7 +207,7 @@ Add to your MCP settings: } ``` -**Full MCP documentation:** [MCP Server README](../open-sse/mcp-server/README.md) — 37 tools, IDE configs, Python/TS/Go clients. +**Full MCP documentation:** [MCP Server README](../../open-sse/mcp-server/README.md) — 37 tools, IDE configs, Python/TS/Go clients. ### A2A Setup (Agent-to-Agent Protocol) @@ -187,7 +225,7 @@ curl -X POST http://localhost:20128/a2a \ -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}' ``` -**Full A2A documentation:** [A2A Server README](../src/lib/a2a/README.md) — JSON-RPC 2.0, skills, streaming, task lifecycle. +**Full A2A documentation:** [A2A Server README](../../src/lib/a2a/README.md) — JSON-RPC 2.0, skills, streaming, task lifecycle. --- @@ -253,7 +291,7 @@ For Void Linux users, you can build a native package using `xbps-src`. Save this ```bash # Template file for 'omniroute' pkgname=omniroute -version=3.4.1 +version=3.8.0 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" @@ -262,7 +300,9 @@ maintainer="zenobit <zenobit@disroot.org>" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" -checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b +# Regenerate the checksum for each release with: +# curl -L -o /tmp/omniroute.tar.gz "https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" && sha256sum /tmp/omniroute.tar.gz +checksum=PLACEHOLDER_REGENERATE_PER_RELEASE system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production @@ -339,4 +379,4 @@ post_install() { | `npm run uninstall` | Removes the system app but **keeps your DB and configurations** in `~/.omniroute`. | | `npm run uninstall:full` | Removes the app AND permanently **erases all configurations, keys, and databases**. | -> For detailed uninstall instructions across all methods, see [UNINSTALL.md](UNINSTALL.md). +> For detailed uninstall instructions across all methods, see [UNINSTALL.md](./UNINSTALL.md). diff --git a/docs/TERMUX_GUIDE.md b/docs/guides/TERMUX_GUIDE.md similarity index 89% rename from docs/TERMUX_GUIDE.md rename to docs/guides/TERMUX_GUIDE.md index 28012906e9..6b8a8b3306 100644 --- a/docs/TERMUX_GUIDE.md +++ b/docs/guides/TERMUX_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "Termux Headless Setup" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Termux Headless Setup OmniRoute can run as a headless server on Android through Termux. The Electron desktop app is not supported in Termux, but the web dashboard and OpenAI-compatible API work from the local browser or from other devices on the same network. @@ -12,6 +18,8 @@ pkg upgrade pkg install nodejs-lts python build-essential git ``` +> **Node.js version:** OmniRoute requires Node `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27` (per `engines` in `package.json`). Termux's `nodejs-lts` typically ships Node 20 LTS, which is compatible. If `node --version` reports an older line, install `pkg install nodejs` (current) and verify the major matches a supported range. + If native package compilation fails, rerun the `pkg install` command above and then retry the OmniRoute install. ## Install diff --git a/docs/TROUBLESHOOTING.md b/docs/guides/TROUBLESHOOTING.md similarity index 65% rename from docs/TROUBLESHOOTING.md rename to docs/guides/TROUBLESHOOTING.md index 5a46315fba..70c95c0081 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/guides/TROUBLESHOOTING.md @@ -1,6 +1,12 @@ +--- +title: "Troubleshooting" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Troubleshooting -🌐 **Languages:** 🇺🇸 [English](TROUBLESHOOTING.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/TROUBLESHOOTING.md) | 🇪🇸 [Español](i18n/es/TROUBLESHOOTING.md) | 🇫🇷 [Français](i18n/fr/TROUBLESHOOTING.md) | 🇮🇹 [Italiano](i18n/it/TROUBLESHOOTING.md) | 🇷🇺 [Русский](i18n/ru/TROUBLESHOOTING.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/TROUBLESHOOTING.md) | 🇩🇪 [Deutsch](i18n/de/TROUBLESHOOTING.md) | 🇮🇳 [हिन्दी](i18n/in/TROUBLESHOOTING.md) | 🇹🇭 [ไทย](i18n/th/TROUBLESHOOTING.md) | 🇺🇦 [Українська](i18n/uk-UA/TROUBLESHOOTING.md) | 🇸🇦 [العربية](i18n/ar/TROUBLESHOOTING.md) | 🇯🇵 [日本語](i18n/ja/TROUBLESHOOTING.md) | 🇻🇳 [Tiếng Việt](i18n/vi/TROUBLESHOOTING.md) | 🇧🇬 [Български](i18n/bg/TROUBLESHOOTING.md) | 🇩🇰 [Dansk](i18n/da/TROUBLESHOOTING.md) | 🇫🇮 [Suomi](i18n/fi/TROUBLESHOOTING.md) | 🇮🇱 [עברית](i18n/he/TROUBLESHOOTING.md) | 🇭🇺 [Magyar](i18n/hu/TROUBLESHOOTING.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/TROUBLESHOOTING.md) | 🇰🇷 [한국어](i18n/ko/TROUBLESHOOTING.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/TROUBLESHOOTING.md) | 🇳🇱 [Nederlands](i18n/nl/TROUBLESHOOTING.md) | 🇳🇴 [Norsk](i18n/no/TROUBLESHOOTING.md) | 🇵🇹 [Português (Portugal)](i18n/pt/TROUBLESHOOTING.md) | 🇷🇴 [Română](i18n/ro/TROUBLESHOOTING.md) | 🇵🇱 [Polski](i18n/pl/TROUBLESHOOTING.md) | 🇸🇰 [Slovenčina](i18n/sk/TROUBLESHOOTING.md) | 🇸🇪 [Svenska](i18n/sv/TROUBLESHOOTING.md) | 🇵🇭 [Filipino](i18n/phi/TROUBLESHOOTING.md) | 🇨🇿 [Čeština](i18n/cs/TROUBLESHOOTING.md) +🌐 **Languages:** 🇺🇸 [English](./TROUBLESHOOTING.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/guides/TROUBLESHOOTING.md) | 🇪🇸 [Español](../i18n/es/docs/guides/TROUBLESHOOTING.md) | 🇫🇷 [Français](../i18n/fr/docs/guides/TROUBLESHOOTING.md) | 🇮🇹 [Italiano](../i18n/it/docs/guides/TROUBLESHOOTING.md) | 🇷🇺 [Русский](../i18n/ru/docs/guides/TROUBLESHOOTING.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/guides/TROUBLESHOOTING.md) | 🇩🇪 [Deutsch](../i18n/de/docs/guides/TROUBLESHOOTING.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/guides/TROUBLESHOOTING.md) | 🇹🇭 [ไทย](../i18n/th/docs/guides/TROUBLESHOOTING.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/guides/TROUBLESHOOTING.md) | 🇸🇦 [العربية](../i18n/ar/docs/guides/TROUBLESHOOTING.md) | 🇯🇵 [日本語](../i18n/ja/docs/guides/TROUBLESHOOTING.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/guides/TROUBLESHOOTING.md) | 🇧🇬 [Български](../i18n/bg/docs/guides/TROUBLESHOOTING.md) | 🇩🇰 [Dansk](../i18n/da/docs/guides/TROUBLESHOOTING.md) | 🇫🇮 [Suomi](../i18n/fi/docs/guides/TROUBLESHOOTING.md) | 🇮🇱 [עברית](../i18n/he/docs/guides/TROUBLESHOOTING.md) | 🇭🇺 [Magyar](../i18n/hu/docs/guides/TROUBLESHOOTING.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/guides/TROUBLESHOOTING.md) | 🇰🇷 [한국어](../i18n/ko/docs/guides/TROUBLESHOOTING.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/guides/TROUBLESHOOTING.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/guides/TROUBLESHOOTING.md) | 🇳🇴 [Norsk](../i18n/no/docs/guides/TROUBLESHOOTING.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/guides/TROUBLESHOOTING.md) | 🇷🇴 [Română](../i18n/ro/docs/guides/TROUBLESHOOTING.md) | 🇵🇱 [Polski](../i18n/pl/docs/guides/TROUBLESHOOTING.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/guides/TROUBLESHOOTING.md) | 🇸🇪 [Svenska](../i18n/sv/docs/guides/TROUBLESHOOTING.md) | 🇵🇭 [Filipino](../i18n/phi/docs/guides/TROUBLESHOOTING.md) | 🇨🇿 [Čeština](../i18n/cs/docs/guides/TROUBLESHOOTING.md) Common problems and solutions for OmniRoute. @@ -14,7 +20,7 @@ Common problems and solutions for OmniRoute. | Dashboard opens on wrong port | Set `PORT=20128` and `NEXT_PUBLIC_BASE_URL=http://localhost:20128` | | No logs written to disk | Set `APP_LOG_TO_FILE=true` and verify call log capture is enabled | | EACCES: permission denied | Set `DATA_DIR=/path/to/writable/dir` to override `~/.omniroute` | -| Routing strategy not saving | Update to v1.4.11+ (Zod schema fix for settings persistence) | +| Routing strategy not saving | Update to the latest v3.x release (Zod schema fix for settings persistence shipped in earlier versions) | | Login crash / blank page | Check Node.js version — see [Node.js Compatibility](#nodejs-compatibility) below | | `dlopen` / `slice is not valid mach-o file` (macOS) | Run `cd $(npm root -g)/omniroute/app && npm rebuild better-sqlite3 && omniroute` — see [macOS native module rebuild](#macos-native-module-rebuild) below | | Proxy "fetch failed" | Ensure proxy config is set at the correct level — see [Proxy Issues](#proxy-issues) below | @@ -46,7 +52,7 @@ Common problems and solutions for OmniRoute. 3. Reinstall OmniRoute: `npm install -g omniroute` 4. Restart: `omniroute` -> **Supported secure versions:** `>=20.20.2 <21`, `>=22.22.2 <23`, or `>=24.0.0 <25`. Node.js 24.x LTS (Krypton) is fully supported. +> **Supported secure versions:** `>=20.20.2 <21`, `>=22.22.2 <23`, or `>=24.0.0 <27`. Node.js 24.x LTS (Krypton) and Node.js 26 are fully supported. ### macOS: `dlopen` / "slice is not valid mach-o file" @@ -72,7 +78,7 @@ npm rebuild better-sqlite3 omniroute ``` -> **Note:** This recompiles the native binding against your local Node.js version and CPU architecture, resolving the binary mismatch. The officially supported range is **`>=20.20.2 <21`, `>=22.22.2 <23`, or `>=24.0.0 <25`** (`engines` field in `package.json`). Node.js 24.x LTS (Krypton) is fully supported with `better-sqlite3` v12.x. +> **Note:** This recompiles the native binding against your local Node.js version and CPU architecture, resolving the binary mismatch. The officially supported range is **`>=20.20.2 <21`, `>=22.22.2 <23`, or `>=24.0.0 <27`** (`engines` field in `package.json`). Node.js 24.x LTS (Krypton) and Node.js 26 are fully supported with `better-sqlite3` v12.x. --- @@ -268,10 +274,10 @@ Use **Dashboard → Translator** to debug format translation issues: - **Thinking tags not appearing** — Check if the target provider supports thinking and the thinking budget setting - **Tool calls dropping** — Some format translations may strip unsupported fields; verify in Playground mode - **System prompt missing** — Claude and Gemini handle system prompts differently; check translation output -- **SDK returns raw string instead of object** — Fixed in v1.1.0: response sanitizer now strips non-standard fields (`x_groq`, `usage_breakdown`, etc.) that cause OpenAI SDK Pydantic validation failures -- **GLM/ERNIE rejects `system` role** — Fixed in v1.1.0: role normalizer automatically merges system messages into user messages for incompatible models -- **`developer` role not recognized** — Fixed in v1.1.0: automatically converted to `system` for non-OpenAI providers -- **`json_schema` not working with Gemini** — Fixed in v1.1.0: `response_format` is now converted to Gemini's `responseMimeType` + `responseSchema` +- **SDK returns raw string instead of object** — Resolved in v1.x; response sanitizer strips non-standard fields (`x_groq`, `usage_breakdown`, etc.) that cause OpenAI SDK Pydantic validation failures. If you still see this on v3.x+, please file an issue. +- **GLM/ERNIE rejects `system` role** — Resolved in v1.x; role normalizer automatically merges system messages into user messages for incompatible models. If you still see this on v3.x+, please file an issue. +- **`developer` role not recognized** — Resolved in v1.x; automatically converted to `system` for non-OpenAI providers. If you still see this on v3.x+, please file an issue. +- **`json_schema` not working with Gemini** — Resolved in v1.x; `response_format` is now converted to Gemini's `responseMimeType` + `responseSchema`. If you still see this on v3.x+, please file an issue. --- @@ -332,10 +338,122 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni --- +## v3.8.0 Known Issues + +Issues specific to the v3.8.0 release and their current workarounds. If a fix lands in a later patch, the entry will be updated or removed. + +### Windsurf OAuth flow fails with 401 + +**Symptoms:** + +- "401 unauthorized" while completing the Windsurf OAuth flow from the dashboard +- Windsurf provider card stays in "needs reconnection" state after the callback + +**Causes:** + +- `WINDSURF_FIREBASE_API_KEY` env var missing or empty +- `WINDSURF_API_KEY` misconfigured or pointing at a stale token +- Local firewall/proxy blocking the OAuth callback + +**Fix:** + +1. Verify both `WINDSURF_FIREBASE_API_KEY` and `WINDSURF_API_KEY` are set in `.env` +2. Restart OmniRoute so the new env values are picked up +3. Re-run the OAuth flow from **Dashboard → Providers → Windsurf → Reconnect** + +### Devin CLI auth failures + +**Symptoms:** + +- "Devin CLI not found" or "auth failed" when invoking Devin-backed tools +- CLI runtime check reports `installed=false` + +**Causes:** + +- `CLI_DEVIN_BIN` points to a path that does not exist +- Devin CLI is not installed on the host + +**Fix:** + +1. Install the Devin CLI for your platform +2. Set `CLI_DEVIN_BIN=/usr/local/bin/devin` (or the real path) in `.env` +3. Restart OmniRoute and re-test from **Dashboard → CLI Tools** + +### Model cooldown stuck (manual reset) + +**Symptoms:** + +- A model stays listed in cooldown even after the expiration time has passed +- Requests still skip the model in combo routing despite the timestamp being in the past + +**Manual reset:** + +- **Dashboard:** **Settings → Model Cooldowns** → click **Re-enable** on the affected card +- **API:** `DELETE /api/resilience/model-cooldowns` with management auth headers + +### Command Code provider connection fails with 403 + +**Symptoms:** + +- 403 when testing the Command Code provider connection +- The provider card shows "unauthorized" after a fresh add + +**Cause:** The OAuth flow did not complete (callback not received or token not persisted). + +**Fix:** + +- Run `omniroute providers` from the CLI to re-trigger the OAuth flow, or +- Re-run OAuth from **Dashboard → Providers → Command Code → Reconnect** + +### ModelScope returns aggressive 429 cooldowns + +**Symptoms:** + +- Very short or immediate cooldowns on ModelScope after a small burst of requests +- Combo routing skips ModelScope earlier than expected + +**Cause:** ModelScope emits provider-specific `Retry-After` headers. v3.8.0 ships dedicated handling for those headers, so older versions misread them as generic rate-limit hints. + +**Fix:** + +- Ensure you are on v3.8.0 or later +- Verify the `useUpstream429BreakerHints` toggle is enabled under **Settings → Resilience** + +### OMNIROUTE_WS_BRIDGE_SECRET missing in production + +**Symptoms:** + +- 401 on every Codex/Responses WebSocket bridge request when running on a remote production host +- WebSocket bridge handshake closes immediately after connect + +**Cause:** The `OMNIROUTE_WS_BRIDGE_SECRET` env var is missing from the production environment. + +**Fix:** + +1. Generate a random secret: `openssl rand -hex 32` +2. Set `OMNIROUTE_WS_BRIDGE_SECRET=<random-secret>` in the production server env (and any client that talks to the bridge) +3. Restart OmniRoute + +### Responses API: background mode degraded to synchronous + +**Symptoms:** + +- Warning logged: `background mode degraded to synchronous` +- A `background: true` request returns a normal synchronous response instead of a background job handle + +**Cause:** v3.8.0 intentionally degrades `background: true` on the Responses API to synchronous execution while emitting a warning. Full async background execution is a future deliverable. + +**Fix:** + +- Adjust the client to call without `background`, or +- Wait for a later release that ships full async background mode (track the changelog) + +--- + ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](../architecture/ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](../reference/API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/UNINSTALL.md b/docs/guides/UNINSTALL.md similarity index 64% rename from docs/UNINSTALL.md rename to docs/guides/UNINSTALL.md index faab403be4..fc069987a3 100644 --- a/docs/UNINSTALL.md +++ b/docs/guides/UNINSTALL.md @@ -1,6 +1,12 @@ +--- +title: "OmniRoute — Uninstall Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute — Uninstall Guide -🌐 **Languages:** 🇺🇸 [English](UNINSTALL.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/UNINSTALL.md) | 🇪🇸 [Español](i18n/es/UNINSTALL.md) | 🇫🇷 [Français](i18n/fr/UNINSTALL.md) | 🇮🇹 [Italiano](i18n/it/UNINSTALL.md) | 🇷🇺 [Русский](i18n/ru/UNINSTALL.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/UNINSTALL.md) | 🇩🇪 [Deutsch](i18n/de/UNINSTALL.md) | 🇮🇳 [हिन्दी](i18n/in/UNINSTALL.md) | 🇹🇭 [ไทย](i18n/th/UNINSTALL.md) | 🇺🇦 [Українська](i18n/uk-UA/UNINSTALL.md) | 🇸🇦 [العربية](i18n/ar/UNINSTALL.md) | 🇯🇵 [日本語](i18n/ja/UNINSTALL.md) | 🇻🇳 [Tiếng Việt](i18n/vi/UNINSTALL.md) | 🇧🇬 [Български](i18n/bg/UNINSTALL.md) | 🇩🇰 [Dansk](i18n/da/UNINSTALL.md) | 🇫🇮 [Suomi](i18n/fi/UNINSTALL.md) | 🇮🇱 [עברית](i18n/he/UNINSTALL.md) | 🇭🇺 [Magyar](i18n/hu/UNINSTALL.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/UNINSTALL.md) | 🇰🇷 [한국어](i18n/ko/UNINSTALL.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/UNINSTALL.md) | 🇳🇱 [Nederlands](i18n/nl/UNINSTALL.md) | 🇳🇴 [Norsk](i18n/no/UNINSTALL.md) | 🇵🇹 [Português (Portugal)](i18n/pt/UNINSTALL.md) | 🇷🇴 [Română](i18n/ro/UNINSTALL.md) | 🇵🇱 [Polski](i18n/pl/UNINSTALL.md) | 🇸🇰 [Slovenčina](i18n/sk/UNINSTALL.md) | 🇸🇪 [Svenska](i18n/sv/UNINSTALL.md) | 🇵🇭 [Filipino](i18n/phi/UNINSTALL.md) | 🇨🇿 [Čeština](i18n/cs/UNINSTALL.md) +🌐 **Languages:** 🇺🇸 [English](./UNINSTALL.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/guides/UNINSTALL.md) | 🇪🇸 [Español](../i18n/es/docs/guides/UNINSTALL.md) | 🇫🇷 [Français](../i18n/fr/docs/guides/UNINSTALL.md) | 🇮🇹 [Italiano](../i18n/it/docs/guides/UNINSTALL.md) | 🇷🇺 [Русский](../i18n/ru/docs/guides/UNINSTALL.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/guides/UNINSTALL.md) | 🇩🇪 [Deutsch](../i18n/de/docs/guides/UNINSTALL.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/guides/UNINSTALL.md) | 🇹🇭 [ไทย](../i18n/th/docs/guides/UNINSTALL.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/guides/UNINSTALL.md) | 🇸🇦 [العربية](../i18n/ar/docs/guides/UNINSTALL.md) | 🇯🇵 [日本語](../i18n/ja/docs/guides/UNINSTALL.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/guides/UNINSTALL.md) | 🇧🇬 [Български](../i18n/bg/docs/guides/UNINSTALL.md) | 🇩🇰 [Dansk](../i18n/da/docs/guides/UNINSTALL.md) | 🇫🇮 [Suomi](../i18n/fi/docs/guides/UNINSTALL.md) | 🇮🇱 [עברית](../i18n/he/docs/guides/UNINSTALL.md) | 🇭🇺 [Magyar](../i18n/hu/docs/guides/UNINSTALL.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/guides/UNINSTALL.md) | 🇰🇷 [한국어](../i18n/ko/docs/guides/UNINSTALL.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/guides/UNINSTALL.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/guides/UNINSTALL.md) | 🇳🇴 [Norsk](../i18n/no/docs/guides/UNINSTALL.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/guides/UNINSTALL.md) | 🇷🇴 [Română](../i18n/ro/docs/guides/UNINSTALL.md) | 🇵🇱 [Polski](../i18n/pl/docs/guides/UNINSTALL.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/guides/UNINSTALL.md) | 🇸🇪 [Svenska](../i18n/sv/docs/guides/UNINSTALL.md) | 🇵🇭 [Filipino](../i18n/phi/docs/guides/UNINSTALL.md) | 🇨🇿 [Čeština](../i18n/cs/docs/guides/UNINSTALL.md) This guide covers how to cleanly remove OmniRoute from your system. diff --git a/docs/USER_GUIDE.md b/docs/guides/USER_GUIDE.md similarity index 61% rename from docs/USER_GUIDE.md rename to docs/guides/USER_GUIDE.md index 3a24e323c7..95a84fd286 100644 --- a/docs/USER_GUIDE.md +++ b/docs/guides/USER_GUIDE.md @@ -1,6 +1,12 @@ +--- +title: "User Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # User Guide -🌐 **Languages:** 🇺🇸 [English](USER_GUIDE.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/USER_GUIDE.md) | 🇪🇸 [Español](i18n/es/USER_GUIDE.md) | 🇫🇷 [Français](i18n/fr/USER_GUIDE.md) | 🇮🇹 [Italiano](i18n/it/USER_GUIDE.md) | 🇷🇺 [Русский](i18n/ru/USER_GUIDE.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/USER_GUIDE.md) | 🇩🇪 [Deutsch](i18n/de/USER_GUIDE.md) | 🇮🇳 [हिन्दी](i18n/in/USER_GUIDE.md) | 🇹🇭 [ไทย](i18n/th/USER_GUIDE.md) | 🇺🇦 [Українська](i18n/uk-UA/USER_GUIDE.md) | 🇸🇦 [العربية](i18n/ar/USER_GUIDE.md) | 🇯🇵 [日本語](i18n/ja/USER_GUIDE.md) | 🇻🇳 [Tiếng Việt](i18n/vi/USER_GUIDE.md) | 🇧🇬 [Български](i18n/bg/USER_GUIDE.md) | 🇩🇰 [Dansk](i18n/da/USER_GUIDE.md) | 🇫🇮 [Suomi](i18n/fi/USER_GUIDE.md) | 🇮🇱 [עברית](i18n/he/USER_GUIDE.md) | 🇭🇺 [Magyar](i18n/hu/USER_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/USER_GUIDE.md) | 🇰🇷 [한국어](i18n/ko/USER_GUIDE.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/USER_GUIDE.md) | 🇳🇱 [Nederlands](i18n/nl/USER_GUIDE.md) | 🇳🇴 [Norsk](i18n/no/USER_GUIDE.md) | 🇵🇹 [Português (Portugal)](i18n/pt/USER_GUIDE.md) | 🇷🇴 [Română](i18n/ro/USER_GUIDE.md) | 🇵🇱 [Polski](i18n/pl/USER_GUIDE.md) | 🇸🇰 [Slovenčina](i18n/sk/USER_GUIDE.md) | 🇸🇪 [Svenska](i18n/sv/USER_GUIDE.md) | 🇵🇭 [Filipino](i18n/phi/USER_GUIDE.md) | 🇨🇿 [Čeština](i18n/cs/USER_GUIDE.md) +🌐 **Languages:** 🇺🇸 [English](./USER_GUIDE.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/guides/USER_GUIDE.md) | 🇪🇸 [Español](../i18n/es/docs/guides/USER_GUIDE.md) | 🇫🇷 [Français](../i18n/fr/docs/guides/USER_GUIDE.md) | 🇮🇹 [Italiano](../i18n/it/docs/guides/USER_GUIDE.md) | 🇷🇺 [Русский](../i18n/ru/docs/guides/USER_GUIDE.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/guides/USER_GUIDE.md) | 🇩🇪 [Deutsch](../i18n/de/docs/guides/USER_GUIDE.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/guides/USER_GUIDE.md) | 🇹🇭 [ไทย](../i18n/th/docs/guides/USER_GUIDE.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/guides/USER_GUIDE.md) | 🇸🇦 [العربية](../i18n/ar/docs/guides/USER_GUIDE.md) | 🇯🇵 [日本語](../i18n/ja/docs/guides/USER_GUIDE.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/guides/USER_GUIDE.md) | 🇧🇬 [Български](../i18n/bg/docs/guides/USER_GUIDE.md) | 🇩🇰 [Dansk](../i18n/da/docs/guides/USER_GUIDE.md) | 🇫🇮 [Suomi](../i18n/fi/docs/guides/USER_GUIDE.md) | 🇮🇱 [עברית](../i18n/he/docs/guides/USER_GUIDE.md) | 🇭🇺 [Magyar](../i18n/hu/docs/guides/USER_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/guides/USER_GUIDE.md) | 🇰🇷 [한국어](../i18n/ko/docs/guides/USER_GUIDE.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/guides/USER_GUIDE.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/guides/USER_GUIDE.md) | 🇳🇴 [Norsk](../i18n/no/docs/guides/USER_GUIDE.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/guides/USER_GUIDE.md) | 🇷🇴 [Română](../i18n/ro/docs/guides/USER_GUIDE.md) | 🇵🇱 [Polski](../i18n/pl/docs/guides/USER_GUIDE.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/guides/USER_GUIDE.md) | 🇸🇪 [Svenska](../i18n/sv/docs/guides/USER_GUIDE.md) | 🇵🇭 [Filipino](../i18n/phi/docs/guides/USER_GUIDE.md) | 🇨🇿 [Čeština](../i18n/cs/docs/guides/USER_GUIDE.md) Complete guide for configuring providers, creating combos, integrating CLI tools, and deploying OmniRoute. @@ -15,6 +21,15 @@ Complete guide for configuring providers, creating combos, integrating CLI tools - [Deployment](#-deployment) - [Available Models](#-available-models) - [Advanced Features](#-advanced-features) +- [Auto-Routing (Zero-config)](#-auto-routing-zero-config) +- [MCP & A2A Integration](#-mcp--a2a-integration) +- [Skills System](#-skills-system) +- [Memory System](#-memory-system) +- [Webhooks](#-webhooks) +- [Cloud Agents](#-cloud-agents) +- [Programmatic Management](#-programmatic-management) +- [Internal CLI](#-internal-cli) +- [Desktop Application (Electron)](#-desktop-application-electron) --- @@ -58,7 +73,7 @@ Complete guide for configuring providers, creating combos, integrating CLI tools Combo: "maximize-claude" 1. cc/claude-opus-4-7 (use subscription fully) 2. glm/glm-4.7 (cheap backup when quota out) - 3. if/kimi-k2-thinking (free emergency fallback) + 3. if/kimi-k2 (free emergency fallback) Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total vs. $20 + hitting limits = frustration @@ -70,8 +85,8 @@ vs. $20 + hitting limits = frustration ``` Combo: "free-forever" - 1. gc/gemini-3-flash (180K free/month) - 2. if/kimi-k2-thinking (unlimited free) + 1. gemini-cli/gemini-3-flash-preview (180K free/month) + 2. if/kimi-k2 (unlimited free) 3. qw/qwen3-coder-plus (unlimited free) Monthly cost: $0 @@ -88,7 +103,7 @@ Combo: "always-on" 2. cx/gpt-5.5 (second subscription) 3. glm/glm-4.7 (cheap, resets daily) 4. minimax/MiniMax-M2.1 (cheapest, 5h reset) - 5. if/kimi-k2-thinking (free unlimited) + 5. if/kimi-k2 (free unlimited) Result: 5 layers of fallback = zero downtime Monthly cost: $20-200 (subscriptions) + $10-20 (backup) @@ -100,9 +115,9 @@ Monthly cost: $20-200 (subscriptions) + $10-20 (backup) ``` Combo: "openclaw-free" - 1. if/glm-4.7 (unlimited free) - 2. if/minimax-m2.1 (unlimited free) - 3. if/kimi-k2-thinking (unlimited free) + 1. if/qwen3-coder-plus (unlimited free) + 2. if/deepseek-r1 (unlimited free) + 3. if/kimi-k2 (unlimited free) Monthly cost: $0 Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal... @@ -137,8 +152,10 @@ Dashboard → Providers → Connect Codex → 5-hour + weekly reset Models: - cx/gpt-5-5 - cx/gpt-5-3-codex-spark + cx/gpt-5.5 + cx/gpt-5.4 + cx/gpt-5.3-codex + cx/gpt-5.3-codex-spark ``` #### Gemini CLI (FREE 180K/month!) @@ -149,8 +166,9 @@ Dashboard → Providers → Connect Gemini CLI → 180K completions/month + 1K/day Models: - gc/gemini-3-flash - gc/gemini-3.1-flash-lite-preview + gemini-cli/gemini-3.1-pro-preview + gemini-cli/gemini-3-flash-preview + gemini-cli/gemini-3.1-flash-lite-preview ``` **Best Value:** Huge free tier! Use this before paid tiers. @@ -163,8 +181,10 @@ Dashboard → Providers → Connect GitHub → Monthly reset (1st of month) Models: + gh/gpt-5.5 gh/gpt-5.4 - gh/claude-4.6-sonnet + gh/claude-sonnet-4.6 + gh/claude-opus-4.7 gh/gemini-3.1-pro-preview ``` @@ -206,7 +226,7 @@ Models: ```bash Dashboard → Connect Qoder → OAuth login → Unlimited usage -Models: if/kimi-k2-thinking, if/qwen3-coder-plus, if/glm-4.7, if/minimax-m2, if/deepseek-r1 +Models: if/kimi-k2, if/qwen3-coder-plus, if/qwen3-max, if/qwen3-235b, if/deepseek-r1, if/deepseek-v3.2 ``` #### Kiro (Claude FREE) @@ -242,9 +262,9 @@ Use in CLI: premium-coding ``` Name: free-combo Models: - 1. gc/gemini-3-flash-preview (180K free/month) - 2. if/kimi-k2-thinking (unlimited) - 3. qw/qwen3-coder-plus (unlimited) + 1. gemini-cli/gemini-3-flash-preview (180K free/month) + 2. if/kimi-k2 (unlimited) + 3. qw/coder-model (unlimited) Cost: $0 forever! ``` @@ -293,7 +313,7 @@ Edit `~/.openclaw/openclaw.json`: { "agents": { "defaults": { - "model": { "primary": "omniroute/if/glm-4.7" } + "model": { "primary": "omniroute/if/kimi-k2" } } }, "models": { @@ -302,7 +322,7 @@ Edit `~/.openclaw/openclaw.json`: "baseUrl": "http://localhost:20128/v1", "apiKey": "your-omniroute-api-key", "api": "openai-completions", - "models": [{ "id": "if/glm-4.7", "name": "glm-4.7" }] + "models": [{ "id": "if/kimi-k2", "name": "kimi-k2" }] } } } @@ -432,7 +452,7 @@ Void Linux users can package and install OmniRoute natively using the `xbps-src` ```bash # Template file for 'omniroute' pkgname=omniroute -version=3.2.4 +version=3.8.0 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" @@ -532,8 +552,8 @@ post_install() { | `PORT` | framework default | Service port (`20128` in examples) | | `HOSTNAME` | framework default | Bind host (Docker defaults to `0.0.0.0`) | | `NODE_ENV` | runtime default | Set `production` for deploy | -| `BASE_URL` | `http://localhost:20128` | Server-side internal base URL | -| `CLOUD_URL` | `https://omniroute.dev` | Cloud sync endpoint base URL | +| `NEXT_PUBLIC_BASE_URL` | `http://localhost:20128` | Public base URL surfaced to the dashboard and exposed to the server (replaces legacy `BASE_URL`) | +| `NEXT_PUBLIC_CLOUD_URL` | `https://omniroute.dev` | Cloud sync endpoint base URL (replaces legacy `CLOUD_URL`) | | `API_KEY_SECRET` | `endpoint-proxy-api-key-secret` | HMAC secret for generated API keys | | `REQUIRE_API_KEY` | `false` | Enforce Bearer API key on `/v1/*` | | `ALLOW_API_KEY_REVEAL` | `false` | Allow Api Manager to copy full API keys on demand | @@ -556,45 +576,57 @@ For the full environment variable reference, see the [README](../README.md). <details> <summary><b>View all available models</b></summary> -**Claude Code (`cc/`)** — Pro/Max: `cc/claude-opus-4-7`, `cc/claude-sonnet-4-6`, `cc/claude-haiku-4-5-20251001` +> The list below is curated from `open-sse/config/providerRegistry.ts` for v3.8.0. Cloud catalogs (Gemini, OpenRouter, etc.) are synced dynamically — for the full live catalog open **Dashboard → Providers → [provider] → Available Models** or call `GET /api/models/catalog`. -**Codex (`cx/`)** — Plus/Pro: `cx/gpt-5.5`, `cx/gpt-5.4`, `cx/gpt-5.3-codex-spark`, `cx/gpt-5.3-codex` +**Claude Code (`cc/`)** — Pro/Max OAuth: `cc/claude-opus-4-7`, `cc/claude-opus-4-6`, `cc/claude-opus-4-5-20251101`, `cc/claude-sonnet-4-6`, `cc/claude-sonnet-4-5-20250929`, `cc/claude-haiku-4-5-20251001` -**Gemini CLI (`gc/`)** — FREE: `gc/gemini-3-flash-preview`, `gc/gemini-3.1-flash-lite-preview` +**Codex (`cx/`)** — Plus/Pro OAuth: `cx/gpt-5.5` (+ effort tiers: `gpt-5.5-xhigh`, `gpt-5.5-high`, `gpt-5.5-medium`, `gpt-5.5-low`), `cx/gpt-5.4`, `cx/gpt-5.4-mini`, `cx/gpt-5.3-codex`, `cx/gpt-5.3-codex-spark`, `cx/gpt-5.2` -**GitHub Copilot (`gh/`)**: `gh/gpt-5-5`, `gh/gpt-5-4`, `gh/claude-opus-4.7`, `gh/claude-sonnet-4.6`, `gh/claude-haiku-4.5` +**Gemini CLI (`gemini-cli/`)** — FREE OAuth: `gemini-cli/gemini-3.1-pro-preview`, `gemini-cli/gemini-3.1-pro-preview-customtools`, `gemini-cli/gemini-3-flash-preview`, `gemini-cli/gemini-3.1-flash-lite-preview` -**GLM (`glm/`)** — $0.6/1M: `glm/glm-5.1` +**GitHub Copilot (`gh/`)** — OAuth: `gh/gpt-5.5`, `gh/gpt-5.4`, `gh/gpt-5.4-mini`, `gh/gpt-5-mini`, `gh/gpt-5.3-codex`, `gh/claude-opus-4.7`, `gh/claude-opus-4.6`, `gh/claude-opus-4-5-20251101`, `gh/claude-sonnet-4.6`, `gh/claude-sonnet-4.5`, `gh/claude-haiku-4.5`, `gh/gemini-3.1-pro-preview`, `gh/gemini-3-flash-preview`, `gh/oswe-vscode-prime` -**MiniMax (`minimax/`)** — $0.2/1M: `minimax/MiniMax-M2.7`, `minimax/MiniMax-M2.5` +**Kiro (`kr/`)** — FREE OAuth: `kr/auto-kiro`, `kr/claude-opus-4.7`, `kr/claude-opus-4.6`, `kr/claude-sonnet-4.6`, `kr/claude-sonnet-4.5`, `kr/claude-haiku-4.5`, `kr/deepseek-3.2`, `kr/minimax-m2.5`, `kr/minimax-m2.1`, `kr/glm-5`, `kr/qwen3-coder-next` -**Qoder (`if/`)** — FREE: `if/kimi-k2-thinking`, `if/qwen3-coder-plus`, `if/deepseek-r1` +**Qoder (`if/`)** — FREE OAuth: `if/kimi-k2-0905`, `if/kimi-k2`, `if/qwen3-coder-plus`, `if/qwen3-max`, `if/qwen3-max-preview`, `if/qwen3-vl-plus`, `if/qwen3-32b`, `if/qwen3-235b-a22b-thinking-2507`, `if/qwen3-235b-a22b-instruct`, `if/qwen3-235b`, `if/deepseek-v3.2`, `if/deepseek-v3`, `if/deepseek-r1`, `if/qoder-rome-30ba3b` -**Qwen (`qw/`)**: `qw/qwen3-coder-plus`, `qw/qwen3-coder-flash` +**Qwen (`qw/`)** — FREE OAuth (chat.qwen.ai): `qw/coder-model`, `qw/vision-model` -**Kiro (`kr/`)** — FREE: `kr/claude-sonnet-4.5`, `kr/claude-haiku-4.5` +**GLM (`glm/`, `glm-cn/`, `zai/`, `glmt/`)** — $0.2–0.6/1M: `glm/glm-5.1`, `glm/glm-5`, `glm/glm-5-turbo`, `glm/glm-4.7`, `glm/glm-4.7-flash`, `glm/glm-4.6`, `glm/glm-4.6v`, `glm/glm-4.5`, `glm/glm-4.5v`, `glm/glm-4.5-air` -**DeepSeek (`ds/`)**: `ds/deepseek-v4-pro`, `ds/deepseek-v4-flash` +**MiniMax (`minimax/`, `minimax-cn/`)** — $0.2/1M: `minimax/MiniMax-M2.7`, `minimax/MiniMax-M2.7-highspeed`, `minimax/MiniMax-M2.5`, `minimax/MiniMax-M2.5-highspeed` -**Groq (`groq/`)**: `groq/llama-3.3-70b-versatile`, `groq/llama-4-maverick-17b-128e-instruct` +**Kimi (`kimi/`, `kimi-coding/`, `kimi-coding-apikey/`)** — $9/mo flat or per-use: `kimi/kimi-k2.6`, `kimi/kimi-k2.5` -**xAI (`xai/`)**: `xai/grok-4.3`, `xai/grok-4.20-0309-reasoning`, `xai/grok-4.20-0309-non-reasoning` +**DeepSeek (`ds/`)** — API key: `ds/deepseek-v4-pro`, `ds/deepseek-v4-flash` -**Mistral (`mistral/`)**: `mistral/mistral-large-latest`, `mistral/mistral-medium-3-5`, `mistral/mistral-small-latest`, `mistral/devstral-latest`, `mistral/codestral-latest` +**Groq (`groq/`)** — Ultra-fast: `groq/llama-3.3-70b-versatile`, `groq/meta-llama/llama-4-maverick-17b-128e-instruct`, `groq/qwen/qwen3-32b`, `groq/openai/gpt-oss-120b` -**Perplexity (`pplx/`)**: `pplx/sonar-deep-research`, `pplx/sonar-reasoning-pro`, `pplx/sonar-pro`, `pplx/sonar` +**xAI (`xai/`)** — Grok native: `xai/grok-4.3`, `xai/grok-4.20-multi-agent-0309`, `xai/grok-4.20-0309-reasoning`, `xai/grok-4.20-0309-non-reasoning` -**Together AI (`together/`)**: `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` +**Mistral (`mistral/`)** — EU-hosted: `mistral/mistral-large-latest`, `mistral/mistral-medium-3-5`, `mistral/mistral-small-latest`, `mistral/devstral-latest`, `mistral/codestral-latest` -**Fireworks AI (`fireworks/`)**: `fireworks/accounts/fireworks/models/deepseek-v3p1` +**Perplexity (`pplx/`)** — Search-augmented: `pplx/sonar-deep-research`, `pplx/sonar-reasoning-pro`, `pplx/sonar-pro`, `pplx/sonar` -**Cerebras (`cerebras/`)**: `cerebras/zai-glm-4.7`, `cerebras/gpt-oss-120b` +**Together AI (`together/`)** — Open-source: `together/meta-llama/Llama-3.3-70B-Instruct-Turbo-Free` (free), `together/meta-llama/Llama-Vision-Free`, `together/deepseek-ai/DeepSeek-R1-Distill-Llama-70B-Free`, `together/deepseek-ai/DeepSeek-R1`, `together/Qwen/Qwen3-235B-A22B`, `together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` -**Cohere (`cohere/`)**: `cohere/command-r-plus-08-2024` +**Fireworks AI (`fireworks/`)** — Fast inference: `fireworks/accounts/fireworks/models/kimi-k2p6`, `fireworks/accounts/fireworks/models/minimax-m2p7`, `fireworks/accounts/fireworks/models/qwen3p6-plus`, `fireworks/accounts/fireworks/models/glm-5p1`, `fireworks/accounts/fireworks/models/deepseek-v4-pro` -**NVIDIA NIM (`nvidia/`)**: `nvidia/nvidia/llama-3.3-70b-instruct` +**Cerebras (`cerebras/`)** — Wafer-scale: `cerebras/zai-glm-4.7`, `cerebras/gpt-oss-120b` -**Baidu Qianfan (`qianfan/`)**: `qianfan/ernie-5.1`, `qianfan/ernie-5.0-thinking-latest`, `qianfan/ernie-x1.1` +**Cohere (`cohere/`)** — RAG-focused: `cohere/command-a-reasoning-08-2025`, `cohere/command-a-vision-07-2025`, `cohere/command-a-03-2025`, `cohere/command-r-08-2024` + +**NVIDIA NIM (`nvidia/`)** — Enterprise: `nvidia/z-ai/glm-5.1`, `nvidia/minimaxai/minimax-m2.7`, `nvidia/google/gemma-4-31b-it`, `nvidia/mistralai/mistral-small-4-119b-2603`, `nvidia/mistralai/mistral-large-3-675b-instruct-2512`, `nvidia/qwen/qwen3.5-397b-a17b`, `nvidia/deepseek-ai/deepseek-v4-pro`, `nvidia/openai/gpt-oss-120b`, `nvidia/nvidia/nemotron-3-super-120b-a12b` + +**Baidu Qianfan (`qianfan/`)** — ERNIE: `qianfan/ernie-5.1`, `qianfan/ernie-5.0-thinking-latest`, `qianfan/ernie-x1.1` + +**Ollama Cloud (`ollama-cloud/`)**: `ollama-cloud/deepseek-v4-pro`, `ollama-cloud/deepseek-v4-flash`, `ollama-cloud/kimi-k2.6`, `ollama-cloud/glm-5.1`, `ollama-cloud/minimax-m2.7`, `ollama-cloud/gemma4:31b`, `ollama-cloud/qwen3.5:397b` + +**Gemini (Google Cloud `gemini/`)**: Synced live per API key from Google — no static list. Connect a key in **Dashboard → Providers** then use **Available Models** to import the current catalog (e.g. `gemini/gemini-3-pro`, `gemini/gemini-3-flash`). + +**Other compatible providers** (selected): `cohere`, `databricks`, `snowflake`, `together`, `vertex`, `alibaba`, `bedrock` (via `aws-bedrock`), `azure-ai`, `openrouter` (passthrough catalog), `siliconflow`, `hyperbolic`, `huggingface`, `featherless-ai`, `cloudflare-ai`, `scaleway`, `deepinfra`, `vercel-ai-gateway`, `bazaarlink`, `friendliai`, `nous-research`, `reka`, `volcengine`, `ai21`, `gigachat`. Each maintains its own model list in `providerRegistry.ts` and can be auto-synced when the provider exposes a `/models` endpoint. + +**Note on model IDs:** OmniRoute uses provider-native IDs (`claude-opus-4-7`, `gpt-5.5`, `glm-5.1`, `MiniMax-M2.7`, `kimi-k2.5`, `grok-4.20-0309-reasoning`). Some IDs include dotted versions because that is how the upstream API expects them. If a model is not listed above, run `omniroute models --search <term>` or hit `GET /api/models/catalog` to confirm availability. </details> @@ -665,7 +697,7 @@ Returns models grouped by provider with types (`chat`, `embedding`, `image`). - Sync providers, combos, and settings across devices - Automatic background sync with timeout + fail-fast -- Prefer server-side `BASE_URL`/`CLOUD_URL` in production +- Prefer server-side `NEXT_PUBLIC_BASE_URL`/`NEXT_PUBLIC_CLOUD_URL` in production ### Cloudflare Quick Tunnel @@ -708,7 +740,9 @@ Access via **Dashboard → Translator**. Debug and visualize how OmniRoute trans ### Routing Strategies -Configure via **Dashboard → Settings → Routing**. +Configure via **Dashboard → Settings → Routing**. The dashboard exposes the six most-used strategies; combos and the auto-router internally support a wider set. + +**Dashboard-visible strategies (account-level routing):** | Strategy | Description | | ------------------------------ | ------------------------------------------------------------------------------------------------ | @@ -719,6 +753,19 @@ Configure via **Dashboard → Settings → Routing**. | **Least Used** | Routes to the account with the oldest `lastUsedAt` timestamp, distributing traffic evenly | | **Cost Optimized** | Routes to the account with the lowest priority value, optimizing for lowest-cost providers | +**Advanced combo and auto strategies** (configurable per combo or via `auto/*` prefixes — see [AUTO-COMBO.md](../routing/AUTO-COMBO.md)): + +- `priority` — strict order, never round-robins +- `weighted` — proportional traffic split by per-model weights +- `fill-first` — drain the first model until limits hit +- `round-robin` / `strict-random` / `random` +- `p2c` (Power of Two Choices) +- `least-used` and `cost-optimized` +- `auto` — score-driven across all candidates +- `lkgp` (Last Known Good Provider) — sticks to the last successful model per session +- `context-optimized` — picks the model with the largest free context window +- `context-relay` — chains long-context models for follow-up turns + #### External Sticky Session Header For external session affinity (for example, Claude Code/Codex agents behind reverse proxies), send: @@ -828,16 +875,17 @@ curl -X POST http://localhost:20128/api/db-backups/import \ ### Settings Dashboard -The settings page is organized into 6 tabs for easy navigation: +The settings page is organized into **7 tabs** for easy navigation: -| Tab | Contents | -| -------------- | ------------------------------------------------------------------------------------------------------------- | -| **General** | System storage tools, appearance settings, theme controls, sidebar visibility, and Endpoint tunnel visibility | -| **Security** | Login/Password settings, IP Access Control, API auth for `/models`, and Provider Blocking | -| **Routing** | Global routing strategy (6 options), wildcard model aliases, fallback chains, combo defaults | -| **Resilience** | Request queue, connection cooldown, provider breaker config, and wait-for-cooldown behavior | -| **AI** | Thinking budget configuration, global system prompt injection, prompt cache stats | -| **Advanced** | Global proxy configuration (HTTP/SOCKS5) | +| Tab | Contents | +| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **General** | System storage tools, default behavior, Endpoint tunnel visibility | +| **Appearance** | Theme controls (light/dark/system), sidebar visibility, panel toggles for Cloudflare/Tailscale/ngrok tunnel cards | +| **AI** | Thinking budget configuration, global system prompt injection, prompt cache stats | +| **Security** | Login/Password settings, IP Access Control, API auth for `/models`, Provider Blocking, prompt-injection guard | +| **Routing** | Global routing strategy (Fill First / Round Robin / P2C / Random / Least Used / Cost Optimized), wildcard model aliases, fallback chains, combo defaults | +| **Resilience** | Request queue, connection cooldown, provider breaker config, and wait-for-cooldown behavior | +| **Advanced** | Global proxy configuration (HTTP/SOCKS5), per-provider proxy overrides | --- @@ -880,9 +928,34 @@ curl -X POST http://localhost:20128/v1/audio/transcriptions \ -F "model=deepgram/nova-3" ``` -Available providers: **Deepgram** (`deepgram/`), **AssemblyAI** (`assemblyai/`). +**Speech-to-Text (transcription)** providers: -Supported audio formats: `mp3`, `wav`, `m4a`, `flac`, `ogg`, `webm`. +- `openai/` (whisper-compatible) +- `groq/` (Groq Whisper Turbo) +- `deepgram/` (Nova family) +- `assemblyai/` +- `nvidia/` (Parakeet, Canary) +- `huggingface/` (whisper variants) +- `qwen/` + +**Text-to-Speech (`POST /v1/audio/speech`)** providers: + +- `openai/` (tts-1, tts-1-hd) +- `hyperbolic/` +- `deepgram/` (Aura) +- `nvidia/` (Magpie TTS) +- `elevenlabs/` +- `huggingface/` +- `inworld/` +- `cartesia/` +- `playht/` +- `kie/` +- `aws-polly/` +- `xiaomi-mimo/` +- `coqui/`, `tortoise/` +- `qwen/` + +Supported audio formats for transcription: `mp3`, `wav`, `m4a`, `flac`, `ogg`, `webm`. TTS output formats depend on the provider (mp3, wav, opus, pcm, mulaw). --- @@ -920,6 +993,186 @@ Access via **Dashboard → Health**. Real-time system health overview with 6 car --- +## 🤖 Auto-Routing (Zero-config) + +OmniRoute ships with a **score-driven auto-router** that picks the best model for each request across every connected provider — no combo to maintain. Just send the request with one of the `auto/*` prefixes and OmniRoute will assemble a virtual combo on the fly, scoring candidates on latency, cost, success rate, context fit, model fitness for the task, recent failures, quota, and circuit-breaker state. + +| Prefix | Optimizes for | +| -------------- | ----------------------------------------------------------------------------- | +| `auto` | Balanced default (latency × cost × success rate) | +| `auto/coding` | Coding tasks: prefers Claude, GPT-5, GLM, Kimi, Qwen Coder, DeepSeek coders | +| `auto/cheap` | Lowest $/token, accepts higher latency | +| `auto/fast` | Lowest latency, ignores cost | +| `auto/offline` | Local-only providers (Ollama, vLLM, llama.cpp) — useful for air-gapped setups | +| `auto/smart` | Reasoning quality first (Opus, GPT-5 xhigh, R1, GLM 5.1 reasoning) | +| `auto/lkgp` | "Last Known Good Provider" — sticky to the most recently successful target | + +Example: + +```bash +curl -X POST http://localhost:20128/v1/chat/completions \ + -H "Authorization: Bearer $OMNIROUTE_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "auto/coding", + "messages": [{ "role": "user", "content": "Refactor this Python function" }], + "stream": true + }' +``` + +The auto-router is fully described in [AUTO-COMBO.md](../routing/AUTO-COMBO.md) — including how to tune scoring weights, blacklist providers, and inspect routing decisions in **Dashboard → Auto Combo**. + +--- + +## 🔌 MCP & A2A Integration + +OmniRoute is both an **MCP server** (Model Context Protocol) and an **A2A server** (Agent-to-Agent JSON-RPC 2.0). Any MCP-compatible IDE or agent host can call OmniRoute tools directly — no extra wrapper required. + +### MCP transports + +- **SSE**: `http://localhost:20128/api/mcp/sse` +- **Streamable HTTP**: `http://localhost:20128/api/mcp/stream` +- **stdio**: `omniroute --mcp` (for IDE plugins that prefer stdio) + +### Connect Claude Desktop + +Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on Windows/Linux: + +```json +{ + "mcpServers": { + "omniroute": { + "command": "omniroute", + "args": ["--mcp"] + } + } +} +``` + +### Connect Cursor / Continue / VS Code MCP + +Use the SSE URL `http://localhost:20128/api/mcp/sse` and a Bearer API key generated in **Dashboard → API Manager**. + +### Scopes + +MCP tools are grouped into 10 scopes: `analytics`, `auth`, `billing`, `combos`, `health`, `keys`, `memory`, `models`, `providers`, `system`. Each Bearer key can be limited to specific scopes — see [MCP-SERVER.md](../frameworks/MCP-SERVER.md) for the full tool catalog and [A2A-SERVER.md](../frameworks/A2A-SERVER.md) for the JSON-RPC schema. + +--- + +## 🧠 Skills System + +OmniRoute exposes an extensible **skill framework** (`src/lib/skills/`) so agents and the A2A endpoint can run domain-specific routines (e.g. `code-review`, `summarize`, `extract-facts`, `web-research`). + +- **Marketplace UI** — Browse and install skills from **Dashboard → Skills** +- **Per-key scopes** — Restrict which API keys can invoke which skills +- **Custom skills** — Drop a TypeScript file in `src/lib/a2a/skills/`, register it, and it becomes immediately invocable over A2A + +Full reference: [SKILLS.md](../frameworks/SKILLS.md). + +--- + +## 💾 Memory System + +OmniRoute persists **long-term conversational memory** with hybrid retrieval: + +- **SQLite FTS5** for keyword search across past turns +- **Qdrant vector store** (optional) for semantic recall +- **Automatic fact extraction** — entities, preferences, and decisions are summarized after each session and stored in the `memory_facts` table +- Memories are scoped per API key and per session + +Manage memories in **Dashboard → Memory** (search, edit, export, purge). The HTTP surface (`/api/memory/*`) lets agents push and query facts programmatically — see [MEMORY.md](../frameworks/MEMORY.md). + +--- + +## 🔔 Webhooks + +Subscribe to OmniRoute events for real-time monitoring and automation. + +- Create a webhook in **Dashboard → Webhooks** with target URL and HMAC signing secret +- Available events: `request.completed`, `request.failed`, `provider.unavailable`, `budget.exceeded`, `combo.switched`, `circuit_breaker.opened`, `circuit_breaker.closed` +- Every payload includes `X-OmniRoute-Signature` (HMAC-SHA256) for verification +- Retries: 3 attempts with exponential backoff, then dead-letter queue + +Full schema in [WEBHOOKS.md](../frameworks/WEBHOOKS.md). + +--- + +## ☁️ Cloud Agents + +OmniRoute integrates with cloud coding agents (**OpenAI Codex Cloud**, **Devin**, **Jules**, **Antigravity**) so you can dispatch long-running tasks from the same dashboard that handles your local routing. + +- Create tasks in **Dashboard → Cloud Agents** or via `POST /api/v1/agents/tasks` +- Track status, logs, and artifacts per task +- Bring-your-own API key per provider — credentials never leave the OmniRoute instance + +Full reference: [CLOUD_AGENT.md](../frameworks/CLOUD_AGENT.md). + +--- + +## 🛠️ Programmatic Management + +You can manage every OmniRoute resource (providers, combos, keys, settings) over HTTP using a **Bearer key with the `manage` scope**. + +Generate the key in **Dashboard → API Manager → New Key → Scope: manage**, then: + +```bash +# List providers +curl http://localhost:20128/api/providers \ + -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" + +# Add a provider connection +curl -X POST http://localhost:20128/api/providers \ + -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \ + -H "Content-Type: application/json" \ + -d '{ "provider": "openai", "apiKey": "sk-...", "name": "main" }' + +# Create a combo +curl -X POST http://localhost:20128/api/combos \ + -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \ + -H "Content-Type: application/json" \ + -d '{ "name": "premium", "strategy": "priority", "models": [{ "model": "cc/claude-opus-4-7" }, { "model": "glm/glm-5.1" }] }' + +# List/create API keys +curl http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" +curl -X POST http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \ + -d '{ "name": "ci-bot", "scopes": ["chat"] }' +``` + +See [API_REFERENCE.md](../reference/API_REFERENCE.md) for the full endpoint catalog and request/response schemas. + +--- + +## 💻 Internal CLI + +OmniRoute ships an internal CLI (`omniroute …`) for setup, diagnostics, and runtime control. This is **separate from the "CLI Tools" page in the dashboard**, which configures third-party CLIs (Claude Code, Cursor, Codex, Cline, …) so they can talk to OmniRoute. + +```bash +omniroute setup # Interactive wizard (password, providers, combos) +omniroute setup --non-interactive # CI-friendly +omniroute doctor # Health diagnostics (data dir, DB, providers, ports) +omniroute providers available # List supported providers +omniroute providers list # List configured connections +omniroute providers test <id> # Live test a provider connection +omniroute combos list # List combos +omniroute combos switch <name> # Set default combo +omniroute models # List available models (--json, --search) +omniroute keys add | list | remove # Manage API keys from the terminal +omniroute backup # Snapshot config + DB +omniroute restore [<timestamp>] # Restore from a snapshot +omniroute health # Detailed health (breakers, cache, memory) +omniroute quota # Provider quota usage +omniroute mcp status # MCP server status +omniroute a2a status # A2A server status +omniroute tunnel list|create|stop # Cloudflare/Tailscale/ngrok tunnels +omniroute reset-password # Reset the admin password +omniroute --mcp # Start MCP server over stdio +omniroute --port 3000 # Start the server on a custom port +``` + +Tip: pair `omniroute doctor --json` with your monitoring tool to alert on unhealthy provider connections. + +--- + ## 🖥️ Desktop Application (Electron) OmniRoute is available as a native desktop application for Windows, macOS, and Linux. @@ -968,4 +1221,4 @@ Output → `electron/dist-electron/` | `OMNIROUTE_PORT` | `20128` | Server port | | `OMNIROUTE_MEMORY_MB` | `512` | Node.js heap limit (64–16384 MB) | -📖 Full documentation: [`electron/README.md`](../electron/README.md) +📖 Full documentation: [`electron/README.md`](../../electron/README.md) diff --git a/docs/i18n/ar/CHANGELOG.md b/docs/i18n/ar/CHANGELOG.md index a5a4011886..eefda2a1d8 100644 --- a/docs/i18n/ar/CHANGELOG.md +++ b/docs/i18n/ar/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### الأمان +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### التوثيق + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### التوثيق - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### الأمان - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### الأمان - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### التوثيق - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### التوثيق - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### الأمان - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### الأمان - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### التوثيق - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### الأمان - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### التوثيق - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### الأمان - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### الميزات - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### الأمان - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### الميزات - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### الميزات - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### الأمان - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### الأمان - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### التوثيق - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### التوثيق - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### الميزات - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### الميزات - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### الميزات - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### الأمان - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### الميزات - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### الميزات - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### الميزات - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### الميزات - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### الميزات - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### الميزات - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### الميزات - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### الميزات - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### الأمان - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### الميزات - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### الميزات - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### الميزات - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### الميزات - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### الميزات - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### الميزات - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### التوثيق - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### الميزات - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ar/CONTRIBUTING.md b/docs/i18n/ar/CONTRIBUTING.md index 99445d9934..2f576a9f93 100644 --- a/docs/i18n/ar/CONTRIBUTING.md +++ b/docs/i18n/ar/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ar/README.md b/docs/i18n/ar/README.md index 2979af725a..72df057567 100644 --- a/docs/i18n/ar/README.md +++ b/docs/i18n/ar/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## التوثيق -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ar/docs/ARCHITECTURE.md b/docs/i18n/ar/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ar/docs/ARCHITECTURE.md rename to docs/i18n/ar/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ar/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ar/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ar/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ar/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ar/docs/A2A-SERVER.md b/docs/i18n/ar/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ar/docs/A2A-SERVER.md rename to docs/i18n/ar/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ar/docs/MCP-SERVER.md b/docs/i18n/ar/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ar/docs/MCP-SERVER.md rename to docs/i18n/ar/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ar/docs/FEATURES.md b/docs/i18n/ar/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ar/docs/FEATURES.md rename to docs/i18n/ar/docs/guides/FEATURES.md diff --git a/docs/i18n/ar/docs/I18N.md b/docs/i18n/ar/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ar/docs/I18N.md rename to docs/i18n/ar/docs/guides/I18N.md index b06c7fcfde..12c918a5c0 100644 --- a/docs/i18n/ar/docs/I18N.md +++ b/docs/i18n/ar/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ar/docs/TROUBLESHOOTING.md b/docs/i18n/ar/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ar/docs/TROUBLESHOOTING.md rename to docs/i18n/ar/docs/guides/TROUBLESHOOTING.md index 43fb904f44..8ed817811a 100644 --- a/docs/i18n/ar/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ar/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ar/docs/UNINSTALL.md b/docs/i18n/ar/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ar/docs/UNINSTALL.md rename to docs/i18n/ar/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ar/docs/USER_GUIDE.md b/docs/i18n/ar/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ar/docs/USER_GUIDE.md rename to docs/i18n/ar/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ar/docs/COVERAGE_PLAN.md b/docs/i18n/ar/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ar/docs/COVERAGE_PLAN.md rename to docs/i18n/ar/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ar/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ar/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ar/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ar/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ar/docs/RELEASE_CHECKLIST.md b/docs/i18n/ar/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ar/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ar/docs/ops/RELEASE_CHECKLIST.md index c4230bf085..755d2d1f09 100644 --- a/docs/i18n/ar/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ar/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ar/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ar/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ar/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ar/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ar/docs/API_REFERENCE.md b/docs/i18n/ar/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ar/docs/API_REFERENCE.md rename to docs/i18n/ar/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ar/docs/CLI-TOOLS.md b/docs/i18n/ar/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ar/docs/CLI-TOOLS.md rename to docs/i18n/ar/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ar/docs/ENVIRONMENT.md b/docs/i18n/ar/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ar/docs/ENVIRONMENT.md rename to docs/i18n/ar/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ar/docs/AUTO-COMBO.md b/docs/i18n/ar/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ar/docs/AUTO-COMBO.md rename to docs/i18n/ar/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ar/llm.txt b/docs/i18n/ar/llm.txt index 1821dc6b05..eb130236ee 100644 --- a/docs/i18n/ar/llm.txt +++ b/docs/i18n/ar/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/bg/CHANGELOG.md b/docs/i18n/bg/CHANGELOG.md index 733161f130..4e0dc7fdb9 100644 --- a/docs/i18n/bg/CHANGELOG.md +++ b/docs/i18n/bg/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Сигурност +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Документация + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Документация - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Сигурност - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Сигурност - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Документация - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Документация - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Сигурност - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Сигурност - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Документация - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Сигурност - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Документация - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Сигурност - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Функции - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Сигурност - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Функции - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Функции - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Сигурност - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Сигурност - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Документация - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Документация - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Функции - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Функции - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Функции - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Сигурност - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Функции - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Функции - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Функции - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Функции - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Функции - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Функции - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Функции - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Функции - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Сигурност - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Функции - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Функции - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Функции - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Функции - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Функции - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Функции - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Документация - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Функции - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/bg/CONTRIBUTING.md b/docs/i18n/bg/CONTRIBUTING.md index 37916a0c71..4d9aee0886 100644 --- a/docs/i18n/bg/CONTRIBUTING.md +++ b/docs/i18n/bg/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/bg/README.md b/docs/i18n/bg/README.md index e8812921d9..5fa29ec06e 100644 --- a/docs/i18n/bg/README.md +++ b/docs/i18n/bg/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Документация -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/bg/docs/ARCHITECTURE.md b/docs/i18n/bg/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/bg/docs/ARCHITECTURE.md rename to docs/i18n/bg/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/bg/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/bg/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/bg/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/bg/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/bg/docs/A2A-SERVER.md b/docs/i18n/bg/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/bg/docs/A2A-SERVER.md rename to docs/i18n/bg/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/bg/docs/MCP-SERVER.md b/docs/i18n/bg/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/bg/docs/MCP-SERVER.md rename to docs/i18n/bg/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/bg/docs/FEATURES.md b/docs/i18n/bg/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/bg/docs/FEATURES.md rename to docs/i18n/bg/docs/guides/FEATURES.md diff --git a/docs/i18n/bg/docs/I18N.md b/docs/i18n/bg/docs/guides/I18N.md similarity index 99% rename from docs/i18n/bg/docs/I18N.md rename to docs/i18n/bg/docs/guides/I18N.md index 0ceaabc575..e72d17e859 100644 --- a/docs/i18n/bg/docs/I18N.md +++ b/docs/i18n/bg/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/bg/docs/TROUBLESHOOTING.md b/docs/i18n/bg/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/bg/docs/TROUBLESHOOTING.md rename to docs/i18n/bg/docs/guides/TROUBLESHOOTING.md index e45a1a1257..84d2d262bc 100644 --- a/docs/i18n/bg/docs/TROUBLESHOOTING.md +++ b/docs/i18n/bg/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/bg/docs/UNINSTALL.md b/docs/i18n/bg/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/bg/docs/UNINSTALL.md rename to docs/i18n/bg/docs/guides/UNINSTALL.md diff --git a/docs/i18n/bg/docs/USER_GUIDE.md b/docs/i18n/bg/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/bg/docs/USER_GUIDE.md rename to docs/i18n/bg/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/bg/docs/COVERAGE_PLAN.md b/docs/i18n/bg/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/bg/docs/COVERAGE_PLAN.md rename to docs/i18n/bg/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/bg/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/bg/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/bg/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/bg/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/bg/docs/RELEASE_CHECKLIST.md b/docs/i18n/bg/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/bg/docs/RELEASE_CHECKLIST.md rename to docs/i18n/bg/docs/ops/RELEASE_CHECKLIST.md index ea33f5c610..725dbb5c2e 100644 --- a/docs/i18n/bg/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/bg/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/bg/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/bg/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/bg/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/bg/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/bg/docs/API_REFERENCE.md b/docs/i18n/bg/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/bg/docs/API_REFERENCE.md rename to docs/i18n/bg/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/bg/docs/CLI-TOOLS.md b/docs/i18n/bg/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/bg/docs/CLI-TOOLS.md rename to docs/i18n/bg/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/bg/docs/ENVIRONMENT.md b/docs/i18n/bg/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/bg/docs/ENVIRONMENT.md rename to docs/i18n/bg/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/bg/docs/AUTO-COMBO.md b/docs/i18n/bg/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/bg/docs/AUTO-COMBO.md rename to docs/i18n/bg/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/bg/llm.txt b/docs/i18n/bg/llm.txt index b8d82e19d9..9184a4f896 100644 --- a/docs/i18n/bg/llm.txt +++ b/docs/i18n/bg/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/bn/CHANGELOG.md b/docs/i18n/bn/CHANGELOG.md index dabaada362..571671965b 100644 --- a/docs/i18n/bn/CHANGELOG.md +++ b/docs/i18n/bn/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/bn/CONTRIBUTING.md b/docs/i18n/bn/CONTRIBUTING.md index c1b2e77012..94f31022e0 100644 --- a/docs/i18n/bn/CONTRIBUTING.md +++ b/docs/i18n/bn/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/bn/README.md b/docs/i18n/bn/README.md index bc77d9bbcf..af9bdf9703 100644 --- a/docs/i18n/bn/README.md +++ b/docs/i18n/bn/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/bn/docs/ARCHITECTURE.md b/docs/i18n/bn/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/bn/docs/ARCHITECTURE.md rename to docs/i18n/bn/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/bn/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/bn/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/bn/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/bn/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/bn/docs/A2A-SERVER.md b/docs/i18n/bn/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/bn/docs/A2A-SERVER.md rename to docs/i18n/bn/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/bn/docs/MCP-SERVER.md b/docs/i18n/bn/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/bn/docs/MCP-SERVER.md rename to docs/i18n/bn/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/bn/docs/FEATURES.md b/docs/i18n/bn/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/bn/docs/FEATURES.md rename to docs/i18n/bn/docs/guides/FEATURES.md diff --git a/docs/i18n/bn/docs/I18N.md b/docs/i18n/bn/docs/guides/I18N.md similarity index 99% rename from docs/i18n/bn/docs/I18N.md rename to docs/i18n/bn/docs/guides/I18N.md index 0bfd210478..f1a5ad5def 100644 --- a/docs/i18n/bn/docs/I18N.md +++ b/docs/i18n/bn/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/bn/docs/TROUBLESHOOTING.md b/docs/i18n/bn/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/bn/docs/TROUBLESHOOTING.md rename to docs/i18n/bn/docs/guides/TROUBLESHOOTING.md index 93e367deb6..e1d40bff3f 100644 --- a/docs/i18n/bn/docs/TROUBLESHOOTING.md +++ b/docs/i18n/bn/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/bn/docs/UNINSTALL.md b/docs/i18n/bn/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/bn/docs/UNINSTALL.md rename to docs/i18n/bn/docs/guides/UNINSTALL.md diff --git a/docs/i18n/bn/docs/USER_GUIDE.md b/docs/i18n/bn/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/bn/docs/USER_GUIDE.md rename to docs/i18n/bn/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/bn/docs/COVERAGE_PLAN.md b/docs/i18n/bn/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/bn/docs/COVERAGE_PLAN.md rename to docs/i18n/bn/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/bn/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/bn/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/bn/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/bn/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/bn/docs/RELEASE_CHECKLIST.md b/docs/i18n/bn/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/bn/docs/RELEASE_CHECKLIST.md rename to docs/i18n/bn/docs/ops/RELEASE_CHECKLIST.md index 035f637fb9..adc8b94d58 100644 --- a/docs/i18n/bn/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/bn/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/bn/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/bn/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/bn/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/bn/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/bn/docs/API_REFERENCE.md b/docs/i18n/bn/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/bn/docs/API_REFERENCE.md rename to docs/i18n/bn/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/bn/docs/CLI-TOOLS.md b/docs/i18n/bn/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/bn/docs/CLI-TOOLS.md rename to docs/i18n/bn/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/bn/docs/ENVIRONMENT.md b/docs/i18n/bn/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/bn/docs/ENVIRONMENT.md rename to docs/i18n/bn/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/bn/docs/AUTO-COMBO.md b/docs/i18n/bn/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/bn/docs/AUTO-COMBO.md rename to docs/i18n/bn/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/bn/llm.txt b/docs/i18n/bn/llm.txt index c6c2ed17f2..6ae5bc26b7 100644 --- a/docs/i18n/bn/llm.txt +++ b/docs/i18n/bn/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/cs/CHANGELOG.md b/docs/i18n/cs/CHANGELOG.md index 4c54214645..66d6e4d36e 100644 --- a/docs/i18n/cs/CHANGELOG.md +++ b/docs/i18n/cs/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Bezpečnost +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentace + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentace - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Bezpečnost - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Bezpečnost - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentace - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentace - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Bezpečnost - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Bezpečnost - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentace - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Bezpečnost - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentace - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Bezpečnost - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funkce - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Bezpečnost - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funkce - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funkce - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Bezpečnost - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Bezpečnost - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentace - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentace - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funkce - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funkce - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funkce - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Bezpečnost - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funkce - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funkce - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funkce - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funkce - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funkce - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funkce - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funkce - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funkce - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Bezpečnost - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funkce - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funkce - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funkce - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funkce - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funkce - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funkce - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentace - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funkce - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/cs/CONTRIBUTING.md b/docs/i18n/cs/CONTRIBUTING.md index 1621756f93..1f739e5a3c 100644 --- a/docs/i18n/cs/CONTRIBUTING.md +++ b/docs/i18n/cs/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/cs/README.md b/docs/i18n/cs/README.md index 50f1ba2567..4595656fe9 100644 --- a/docs/i18n/cs/README.md +++ b/docs/i18n/cs/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentace -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/cs/docs/ARCHITECTURE.md b/docs/i18n/cs/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/cs/docs/ARCHITECTURE.md rename to docs/i18n/cs/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/cs/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/cs/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/cs/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/cs/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/cs/docs/A2A-SERVER.md b/docs/i18n/cs/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/cs/docs/A2A-SERVER.md rename to docs/i18n/cs/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/cs/docs/MCP-SERVER.md b/docs/i18n/cs/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/cs/docs/MCP-SERVER.md rename to docs/i18n/cs/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/cs/docs/FEATURES.md b/docs/i18n/cs/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/cs/docs/FEATURES.md rename to docs/i18n/cs/docs/guides/FEATURES.md diff --git a/docs/i18n/cs/docs/I18N.md b/docs/i18n/cs/docs/guides/I18N.md similarity index 99% rename from docs/i18n/cs/docs/I18N.md rename to docs/i18n/cs/docs/guides/I18N.md index 3a15f4f051..ccf62650b5 100644 --- a/docs/i18n/cs/docs/I18N.md +++ b/docs/i18n/cs/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/cs/docs/TROUBLESHOOTING.md b/docs/i18n/cs/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/cs/docs/TROUBLESHOOTING.md rename to docs/i18n/cs/docs/guides/TROUBLESHOOTING.md index 7846a571e7..d4562b2259 100644 --- a/docs/i18n/cs/docs/TROUBLESHOOTING.md +++ b/docs/i18n/cs/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/cs/docs/UNINSTALL.md b/docs/i18n/cs/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/cs/docs/UNINSTALL.md rename to docs/i18n/cs/docs/guides/UNINSTALL.md diff --git a/docs/i18n/cs/docs/USER_GUIDE.md b/docs/i18n/cs/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/cs/docs/USER_GUIDE.md rename to docs/i18n/cs/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/cs/docs/COVERAGE_PLAN.md b/docs/i18n/cs/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/cs/docs/COVERAGE_PLAN.md rename to docs/i18n/cs/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/cs/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/cs/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/cs/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/cs/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/cs/docs/RELEASE_CHECKLIST.md b/docs/i18n/cs/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/cs/docs/RELEASE_CHECKLIST.md rename to docs/i18n/cs/docs/ops/RELEASE_CHECKLIST.md index 3357cc9ff7..6c09e74932 100644 --- a/docs/i18n/cs/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/cs/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/cs/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/cs/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/cs/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/cs/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/cs/docs/API_REFERENCE.md b/docs/i18n/cs/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/cs/docs/API_REFERENCE.md rename to docs/i18n/cs/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/cs/docs/CLI-TOOLS.md b/docs/i18n/cs/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/cs/docs/CLI-TOOLS.md rename to docs/i18n/cs/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/cs/docs/ENVIRONMENT.md b/docs/i18n/cs/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/cs/docs/ENVIRONMENT.md rename to docs/i18n/cs/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/cs/docs/AUTO-COMBO.md b/docs/i18n/cs/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/cs/docs/AUTO-COMBO.md rename to docs/i18n/cs/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/cs/llm.txt b/docs/i18n/cs/llm.txt index 5706410a70..4fc059a249 100644 --- a/docs/i18n/cs/llm.txt +++ b/docs/i18n/cs/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/da/CHANGELOG.md b/docs/i18n/da/CHANGELOG.md index 1ee699b1e4..3233dde285 100644 --- a/docs/i18n/da/CHANGELOG.md +++ b/docs/i18n/da/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Sikkerhed +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentation + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentation - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Sikkerhed - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Sikkerhed - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentation - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentation - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Sikkerhed - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Sikkerhed - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentation - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Sikkerhed - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentation - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Sikkerhed - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funktioner - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Sikkerhed - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funktioner - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funktioner - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Sikkerhed - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Sikkerhed - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentation - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentation - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funktioner - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funktioner - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funktioner - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Sikkerhed - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funktioner - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funktioner - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funktioner - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funktioner - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funktioner - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funktioner - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funktioner - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funktioner - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Sikkerhed - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funktioner - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funktioner - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funktioner - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funktioner - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funktioner - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funktioner - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentation - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funktioner - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/da/CONTRIBUTING.md b/docs/i18n/da/CONTRIBUTING.md index d70bd4813a..4b27f5e962 100644 --- a/docs/i18n/da/CONTRIBUTING.md +++ b/docs/i18n/da/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/da/README.md b/docs/i18n/da/README.md index 9a88f9af24..39f75a1bf7 100644 --- a/docs/i18n/da/README.md +++ b/docs/i18n/da/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentation -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/da/docs/ARCHITECTURE.md b/docs/i18n/da/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/da/docs/ARCHITECTURE.md rename to docs/i18n/da/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/da/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/da/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/da/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/da/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/da/docs/A2A-SERVER.md b/docs/i18n/da/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/da/docs/A2A-SERVER.md rename to docs/i18n/da/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/da/docs/MCP-SERVER.md b/docs/i18n/da/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/da/docs/MCP-SERVER.md rename to docs/i18n/da/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/da/docs/FEATURES.md b/docs/i18n/da/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/da/docs/FEATURES.md rename to docs/i18n/da/docs/guides/FEATURES.md diff --git a/docs/i18n/da/docs/I18N.md b/docs/i18n/da/docs/guides/I18N.md similarity index 99% rename from docs/i18n/da/docs/I18N.md rename to docs/i18n/da/docs/guides/I18N.md index 506128beaf..54632fa3f3 100644 --- a/docs/i18n/da/docs/I18N.md +++ b/docs/i18n/da/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/da/docs/TROUBLESHOOTING.md b/docs/i18n/da/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/da/docs/TROUBLESHOOTING.md rename to docs/i18n/da/docs/guides/TROUBLESHOOTING.md index 28962ce9e6..82639d666e 100644 --- a/docs/i18n/da/docs/TROUBLESHOOTING.md +++ b/docs/i18n/da/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/da/docs/UNINSTALL.md b/docs/i18n/da/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/da/docs/UNINSTALL.md rename to docs/i18n/da/docs/guides/UNINSTALL.md diff --git a/docs/i18n/da/docs/USER_GUIDE.md b/docs/i18n/da/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/da/docs/USER_GUIDE.md rename to docs/i18n/da/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/da/docs/COVERAGE_PLAN.md b/docs/i18n/da/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/da/docs/COVERAGE_PLAN.md rename to docs/i18n/da/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/da/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/da/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/da/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/da/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/da/docs/RELEASE_CHECKLIST.md b/docs/i18n/da/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/da/docs/RELEASE_CHECKLIST.md rename to docs/i18n/da/docs/ops/RELEASE_CHECKLIST.md index cff8961e27..8e07b36937 100644 --- a/docs/i18n/da/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/da/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/da/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/da/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/da/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/da/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/da/docs/API_REFERENCE.md b/docs/i18n/da/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/da/docs/API_REFERENCE.md rename to docs/i18n/da/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/da/docs/CLI-TOOLS.md b/docs/i18n/da/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/da/docs/CLI-TOOLS.md rename to docs/i18n/da/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/da/docs/ENVIRONMENT.md b/docs/i18n/da/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/da/docs/ENVIRONMENT.md rename to docs/i18n/da/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/da/docs/AUTO-COMBO.md b/docs/i18n/da/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/da/docs/AUTO-COMBO.md rename to docs/i18n/da/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/da/llm.txt b/docs/i18n/da/llm.txt index 51dd797797..ec2e3213c3 100644 --- a/docs/i18n/da/llm.txt +++ b/docs/i18n/da/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/de/CHANGELOG.md b/docs/i18n/de/CHANGELOG.md index ae57bf3ab3..3fe31391c0 100644 --- a/docs/i18n/de/CHANGELOG.md +++ b/docs/i18n/de/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Sicherheit +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentation + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentation - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Sicherheit - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Sicherheit - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentation - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentation - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Sicherheit - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Sicherheit - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentation - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Sicherheit - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentation - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Sicherheit - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funktionen - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Sicherheit - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funktionen - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funktionen - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Sicherheit - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Sicherheit - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentation - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentation - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funktionen - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funktionen - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funktionen - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Sicherheit - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funktionen - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funktionen - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funktionen - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funktionen - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funktionen - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funktionen - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funktionen - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funktionen - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Sicherheit - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funktionen - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funktionen - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funktionen - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funktionen - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funktionen - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funktionen - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentation - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funktionen - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/de/CONTRIBUTING.md b/docs/i18n/de/CONTRIBUTING.md index 5497d29106..37ed7ce173 100644 --- a/docs/i18n/de/CONTRIBUTING.md +++ b/docs/i18n/de/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/de/README.md b/docs/i18n/de/README.md index 2db62bf6c2..6834c1de04 100644 --- a/docs/i18n/de/README.md +++ b/docs/i18n/de/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentation -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/de/docs/ARCHITECTURE.md b/docs/i18n/de/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/de/docs/ARCHITECTURE.md rename to docs/i18n/de/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/de/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/de/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/de/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/de/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/de/docs/A2A-SERVER.md b/docs/i18n/de/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/de/docs/A2A-SERVER.md rename to docs/i18n/de/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/de/docs/MCP-SERVER.md b/docs/i18n/de/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/de/docs/MCP-SERVER.md rename to docs/i18n/de/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/de/docs/FEATURES.md b/docs/i18n/de/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/de/docs/FEATURES.md rename to docs/i18n/de/docs/guides/FEATURES.md diff --git a/docs/i18n/de/docs/I18N.md b/docs/i18n/de/docs/guides/I18N.md similarity index 99% rename from docs/i18n/de/docs/I18N.md rename to docs/i18n/de/docs/guides/I18N.md index 84097d26c7..4236e2c2ee 100644 --- a/docs/i18n/de/docs/I18N.md +++ b/docs/i18n/de/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/de/docs/TROUBLESHOOTING.md b/docs/i18n/de/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/de/docs/TROUBLESHOOTING.md rename to docs/i18n/de/docs/guides/TROUBLESHOOTING.md index 7cf0a646e8..d7873c8243 100644 --- a/docs/i18n/de/docs/TROUBLESHOOTING.md +++ b/docs/i18n/de/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/de/docs/UNINSTALL.md b/docs/i18n/de/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/de/docs/UNINSTALL.md rename to docs/i18n/de/docs/guides/UNINSTALL.md diff --git a/docs/i18n/de/docs/USER_GUIDE.md b/docs/i18n/de/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/de/docs/USER_GUIDE.md rename to docs/i18n/de/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/de/docs/COVERAGE_PLAN.md b/docs/i18n/de/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/de/docs/COVERAGE_PLAN.md rename to docs/i18n/de/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/de/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/de/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/de/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/de/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/de/docs/RELEASE_CHECKLIST.md b/docs/i18n/de/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/de/docs/RELEASE_CHECKLIST.md rename to docs/i18n/de/docs/ops/RELEASE_CHECKLIST.md index 3f69840951..f4eb8a8402 100644 --- a/docs/i18n/de/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/de/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/de/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/de/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/de/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/de/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/de/docs/API_REFERENCE.md b/docs/i18n/de/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/de/docs/API_REFERENCE.md rename to docs/i18n/de/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/de/docs/CLI-TOOLS.md b/docs/i18n/de/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/de/docs/CLI-TOOLS.md rename to docs/i18n/de/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/de/docs/ENVIRONMENT.md b/docs/i18n/de/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/de/docs/ENVIRONMENT.md rename to docs/i18n/de/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/de/docs/AUTO-COMBO.md b/docs/i18n/de/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/de/docs/AUTO-COMBO.md rename to docs/i18n/de/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/de/llm.txt b/docs/i18n/de/llm.txt index dc75ee0ef2..649ce828ac 100644 --- a/docs/i18n/de/llm.txt +++ b/docs/i18n/de/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/es/CHANGELOG.md b/docs/i18n/es/CHANGELOG.md index 584b0b0711..1c039bb37e 100644 --- a/docs/i18n/es/CHANGELOG.md +++ b/docs/i18n/es/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/es/CONTRIBUTING.md b/docs/i18n/es/CONTRIBUTING.md index e5f054b239..b8ac893ed2 100644 --- a/docs/i18n/es/CONTRIBUTING.md +++ b/docs/i18n/es/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/es/README.md b/docs/i18n/es/README.md index 6ecc419bbd..00609d63d5 100644 --- a/docs/i18n/es/README.md +++ b/docs/i18n/es/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/es/docs/ARCHITECTURE.md b/docs/i18n/es/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/es/docs/ARCHITECTURE.md rename to docs/i18n/es/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/es/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/es/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/es/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/es/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/es/docs/A2A-SERVER.md b/docs/i18n/es/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/es/docs/A2A-SERVER.md rename to docs/i18n/es/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/es/docs/MCP-SERVER.md b/docs/i18n/es/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/es/docs/MCP-SERVER.md rename to docs/i18n/es/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/es/docs/FEATURES.md b/docs/i18n/es/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/es/docs/FEATURES.md rename to docs/i18n/es/docs/guides/FEATURES.md diff --git a/docs/i18n/es/docs/I18N.md b/docs/i18n/es/docs/guides/I18N.md similarity index 99% rename from docs/i18n/es/docs/I18N.md rename to docs/i18n/es/docs/guides/I18N.md index 628065c212..c9f3a93945 100644 --- a/docs/i18n/es/docs/I18N.md +++ b/docs/i18n/es/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/es/docs/TROUBLESHOOTING.md b/docs/i18n/es/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/es/docs/TROUBLESHOOTING.md rename to docs/i18n/es/docs/guides/TROUBLESHOOTING.md index fc65ae406a..bd261b22d2 100644 --- a/docs/i18n/es/docs/TROUBLESHOOTING.md +++ b/docs/i18n/es/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/es/docs/UNINSTALL.md b/docs/i18n/es/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/es/docs/UNINSTALL.md rename to docs/i18n/es/docs/guides/UNINSTALL.md diff --git a/docs/i18n/es/docs/USER_GUIDE.md b/docs/i18n/es/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/es/docs/USER_GUIDE.md rename to docs/i18n/es/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/es/docs/COVERAGE_PLAN.md b/docs/i18n/es/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/es/docs/COVERAGE_PLAN.md rename to docs/i18n/es/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/es/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/es/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/es/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/es/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/es/docs/RELEASE_CHECKLIST.md b/docs/i18n/es/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/es/docs/RELEASE_CHECKLIST.md rename to docs/i18n/es/docs/ops/RELEASE_CHECKLIST.md index 2d4c11840e..7f0e5ff56d 100644 --- a/docs/i18n/es/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/es/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/es/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/es/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/es/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/es/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/es/docs/API_REFERENCE.md b/docs/i18n/es/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/es/docs/API_REFERENCE.md rename to docs/i18n/es/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/es/docs/CLI-TOOLS.md b/docs/i18n/es/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/es/docs/CLI-TOOLS.md rename to docs/i18n/es/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/es/docs/ENVIRONMENT.md b/docs/i18n/es/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/es/docs/ENVIRONMENT.md rename to docs/i18n/es/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/es/docs/AUTO-COMBO.md b/docs/i18n/es/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/es/docs/AUTO-COMBO.md rename to docs/i18n/es/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/es/llm.txt b/docs/i18n/es/llm.txt index cd810711d3..3535c59e7e 100644 --- a/docs/i18n/es/llm.txt +++ b/docs/i18n/es/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/fa/CHANGELOG.md b/docs/i18n/fa/CHANGELOG.md index 057c405923..c620c1adda 100644 --- a/docs/i18n/fa/CHANGELOG.md +++ b/docs/i18n/fa/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/fa/CONTRIBUTING.md b/docs/i18n/fa/CONTRIBUTING.md index 30a6e8caba..d57949243e 100644 --- a/docs/i18n/fa/CONTRIBUTING.md +++ b/docs/i18n/fa/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/fa/README.md b/docs/i18n/fa/README.md index 57b1f66938..74436b40be 100644 --- a/docs/i18n/fa/README.md +++ b/docs/i18n/fa/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/fa/docs/ARCHITECTURE.md b/docs/i18n/fa/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/fa/docs/ARCHITECTURE.md rename to docs/i18n/fa/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/fa/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/fa/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/fa/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/fa/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/fa/docs/A2A-SERVER.md b/docs/i18n/fa/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/fa/docs/A2A-SERVER.md rename to docs/i18n/fa/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/fa/docs/MCP-SERVER.md b/docs/i18n/fa/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/fa/docs/MCP-SERVER.md rename to docs/i18n/fa/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/fa/docs/FEATURES.md b/docs/i18n/fa/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/fa/docs/FEATURES.md rename to docs/i18n/fa/docs/guides/FEATURES.md diff --git a/docs/i18n/fa/docs/I18N.md b/docs/i18n/fa/docs/guides/I18N.md similarity index 99% rename from docs/i18n/fa/docs/I18N.md rename to docs/i18n/fa/docs/guides/I18N.md index fd8a3bce37..00d108904a 100644 --- a/docs/i18n/fa/docs/I18N.md +++ b/docs/i18n/fa/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/fa/docs/TROUBLESHOOTING.md b/docs/i18n/fa/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/fa/docs/TROUBLESHOOTING.md rename to docs/i18n/fa/docs/guides/TROUBLESHOOTING.md index e573b1b007..2c0ee1b9c1 100644 --- a/docs/i18n/fa/docs/TROUBLESHOOTING.md +++ b/docs/i18n/fa/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/fa/docs/UNINSTALL.md b/docs/i18n/fa/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/fa/docs/UNINSTALL.md rename to docs/i18n/fa/docs/guides/UNINSTALL.md diff --git a/docs/i18n/fa/docs/USER_GUIDE.md b/docs/i18n/fa/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/fa/docs/USER_GUIDE.md rename to docs/i18n/fa/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/fa/docs/COVERAGE_PLAN.md b/docs/i18n/fa/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/fa/docs/COVERAGE_PLAN.md rename to docs/i18n/fa/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/fa/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/fa/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fa/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/fa/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fa/docs/RELEASE_CHECKLIST.md b/docs/i18n/fa/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/fa/docs/RELEASE_CHECKLIST.md rename to docs/i18n/fa/docs/ops/RELEASE_CHECKLIST.md index 545a1c7eb9..8193817209 100644 --- a/docs/i18n/fa/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/fa/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/fa/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/fa/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fa/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/fa/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fa/docs/API_REFERENCE.md b/docs/i18n/fa/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/fa/docs/API_REFERENCE.md rename to docs/i18n/fa/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/fa/docs/CLI-TOOLS.md b/docs/i18n/fa/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/fa/docs/CLI-TOOLS.md rename to docs/i18n/fa/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/fa/docs/ENVIRONMENT.md b/docs/i18n/fa/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/fa/docs/ENVIRONMENT.md rename to docs/i18n/fa/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/fa/docs/AUTO-COMBO.md b/docs/i18n/fa/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/fa/docs/AUTO-COMBO.md rename to docs/i18n/fa/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/fa/llm.txt b/docs/i18n/fa/llm.txt index 9ee7d22c20..79afa4005c 100644 --- a/docs/i18n/fa/llm.txt +++ b/docs/i18n/fa/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/fi/CHANGELOG.md b/docs/i18n/fi/CHANGELOG.md index d7fe8b9116..3b254b82f9 100644 --- a/docs/i18n/fi/CHANGELOG.md +++ b/docs/i18n/fi/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Turvallisuus +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentaatio + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentaatio - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Turvallisuus - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Turvallisuus - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentaatio - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentaatio - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Turvallisuus - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Turvallisuus - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentaatio - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Turvallisuus - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentaatio - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Turvallisuus - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Ominaisuudet - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Turvallisuus - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Ominaisuudet - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Ominaisuudet - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Turvallisuus - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Turvallisuus - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentaatio - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentaatio - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Ominaisuudet - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Ominaisuudet - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Ominaisuudet - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Turvallisuus - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Ominaisuudet - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Ominaisuudet - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Ominaisuudet - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Ominaisuudet - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Ominaisuudet - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Ominaisuudet - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Ominaisuudet - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Ominaisuudet - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Turvallisuus - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Ominaisuudet - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Ominaisuudet - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Ominaisuudet - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Ominaisuudet - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Ominaisuudet - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Ominaisuudet - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentaatio - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Ominaisuudet - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/fi/CONTRIBUTING.md b/docs/i18n/fi/CONTRIBUTING.md index 92e4f26deb..4f717a16e0 100644 --- a/docs/i18n/fi/CONTRIBUTING.md +++ b/docs/i18n/fi/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/fi/README.md b/docs/i18n/fi/README.md index c74cafde9a..7fb1ace251 100644 --- a/docs/i18n/fi/README.md +++ b/docs/i18n/fi/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentaatio -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/fi/docs/ARCHITECTURE.md b/docs/i18n/fi/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/fi/docs/ARCHITECTURE.md rename to docs/i18n/fi/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/fi/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/fi/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/fi/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/fi/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/fi/docs/A2A-SERVER.md b/docs/i18n/fi/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/fi/docs/A2A-SERVER.md rename to docs/i18n/fi/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/fi/docs/MCP-SERVER.md b/docs/i18n/fi/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/fi/docs/MCP-SERVER.md rename to docs/i18n/fi/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/fi/docs/FEATURES.md b/docs/i18n/fi/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/fi/docs/FEATURES.md rename to docs/i18n/fi/docs/guides/FEATURES.md diff --git a/docs/i18n/fi/docs/I18N.md b/docs/i18n/fi/docs/guides/I18N.md similarity index 99% rename from docs/i18n/fi/docs/I18N.md rename to docs/i18n/fi/docs/guides/I18N.md index 7ef69aba8f..f75d692c16 100644 --- a/docs/i18n/fi/docs/I18N.md +++ b/docs/i18n/fi/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/fi/docs/TROUBLESHOOTING.md b/docs/i18n/fi/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/fi/docs/TROUBLESHOOTING.md rename to docs/i18n/fi/docs/guides/TROUBLESHOOTING.md index a4a2994239..52ebbb2a8d 100644 --- a/docs/i18n/fi/docs/TROUBLESHOOTING.md +++ b/docs/i18n/fi/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/fi/docs/UNINSTALL.md b/docs/i18n/fi/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/fi/docs/UNINSTALL.md rename to docs/i18n/fi/docs/guides/UNINSTALL.md diff --git a/docs/i18n/fi/docs/USER_GUIDE.md b/docs/i18n/fi/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/fi/docs/USER_GUIDE.md rename to docs/i18n/fi/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/fi/docs/COVERAGE_PLAN.md b/docs/i18n/fi/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/fi/docs/COVERAGE_PLAN.md rename to docs/i18n/fi/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/fi/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/fi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fi/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/fi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fi/docs/RELEASE_CHECKLIST.md b/docs/i18n/fi/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/fi/docs/RELEASE_CHECKLIST.md rename to docs/i18n/fi/docs/ops/RELEASE_CHECKLIST.md index a83ed9f9f2..12ae28efb8 100644 --- a/docs/i18n/fi/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/fi/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/fi/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/fi/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fi/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/fi/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fi/docs/API_REFERENCE.md b/docs/i18n/fi/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/fi/docs/API_REFERENCE.md rename to docs/i18n/fi/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/fi/docs/CLI-TOOLS.md b/docs/i18n/fi/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/fi/docs/CLI-TOOLS.md rename to docs/i18n/fi/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/fi/docs/ENVIRONMENT.md b/docs/i18n/fi/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/fi/docs/ENVIRONMENT.md rename to docs/i18n/fi/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/fi/docs/AUTO-COMBO.md b/docs/i18n/fi/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/fi/docs/AUTO-COMBO.md rename to docs/i18n/fi/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/fi/llm.txt b/docs/i18n/fi/llm.txt index c720e29c48..cd11e1e45b 100644 --- a/docs/i18n/fi/llm.txt +++ b/docs/i18n/fi/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/fr/CHANGELOG.md b/docs/i18n/fr/CHANGELOG.md index 97d2de860a..280428cc05 100644 --- a/docs/i18n/fr/CHANGELOG.md +++ b/docs/i18n/fr/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Sécurité +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentation + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentation - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Sécurité - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Sécurité - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentation - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentation - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Sécurité - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Sécurité - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentation - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Sécurité - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Sécurité - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Fonctionnalités - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Sécurité - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Fonctionnalités - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Fonctionnalités - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Sécurité - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Sécurité - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentation - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentation - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Fonctionnalités - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Fonctionnalités - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Fonctionnalités - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Sécurité - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Fonctionnalités - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Fonctionnalités - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Fonctionnalités - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Fonctionnalités - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Fonctionnalités - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Fonctionnalités - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Fonctionnalités - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Fonctionnalités - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Sécurité - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Fonctionnalités - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Fonctionnalités - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Fonctionnalités - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Fonctionnalités - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Fonctionnalités - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Fonctionnalités - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentation - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Fonctionnalités - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/fr/CONTRIBUTING.md b/docs/i18n/fr/CONTRIBUTING.md index 01170fa187..53d22d8c58 100644 --- a/docs/i18n/fr/CONTRIBUTING.md +++ b/docs/i18n/fr/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/fr/README.md b/docs/i18n/fr/README.md index 8648ea364e..4621a0d668 100644 --- a/docs/i18n/fr/README.md +++ b/docs/i18n/fr/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentation -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/fr/docs/ARCHITECTURE.md b/docs/i18n/fr/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/fr/docs/ARCHITECTURE.md rename to docs/i18n/fr/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/fr/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/fr/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/fr/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/fr/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/fr/docs/A2A-SERVER.md b/docs/i18n/fr/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/fr/docs/A2A-SERVER.md rename to docs/i18n/fr/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/fr/docs/MCP-SERVER.md b/docs/i18n/fr/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/fr/docs/MCP-SERVER.md rename to docs/i18n/fr/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/fr/docs/FEATURES.md b/docs/i18n/fr/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/fr/docs/FEATURES.md rename to docs/i18n/fr/docs/guides/FEATURES.md diff --git a/docs/i18n/fr/docs/I18N.md b/docs/i18n/fr/docs/guides/I18N.md similarity index 99% rename from docs/i18n/fr/docs/I18N.md rename to docs/i18n/fr/docs/guides/I18N.md index 6e3741d440..2e7c2f2451 100644 --- a/docs/i18n/fr/docs/I18N.md +++ b/docs/i18n/fr/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/fr/docs/TROUBLESHOOTING.md b/docs/i18n/fr/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/fr/docs/TROUBLESHOOTING.md rename to docs/i18n/fr/docs/guides/TROUBLESHOOTING.md index 8f6f96dc22..b5483677da 100644 --- a/docs/i18n/fr/docs/TROUBLESHOOTING.md +++ b/docs/i18n/fr/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/fr/docs/UNINSTALL.md b/docs/i18n/fr/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/fr/docs/UNINSTALL.md rename to docs/i18n/fr/docs/guides/UNINSTALL.md diff --git a/docs/i18n/fr/docs/USER_GUIDE.md b/docs/i18n/fr/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/fr/docs/USER_GUIDE.md rename to docs/i18n/fr/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/fr/docs/COVERAGE_PLAN.md b/docs/i18n/fr/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/fr/docs/COVERAGE_PLAN.md rename to docs/i18n/fr/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/fr/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/fr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fr/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/fr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fr/docs/RELEASE_CHECKLIST.md b/docs/i18n/fr/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/fr/docs/RELEASE_CHECKLIST.md rename to docs/i18n/fr/docs/ops/RELEASE_CHECKLIST.md index 060f96aed5..d0e8d91740 100644 --- a/docs/i18n/fr/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/fr/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/fr/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/fr/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/fr/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/fr/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/fr/docs/API_REFERENCE.md b/docs/i18n/fr/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/fr/docs/API_REFERENCE.md rename to docs/i18n/fr/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/fr/docs/CLI-TOOLS.md b/docs/i18n/fr/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/fr/docs/CLI-TOOLS.md rename to docs/i18n/fr/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/fr/docs/ENVIRONMENT.md b/docs/i18n/fr/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/fr/docs/ENVIRONMENT.md rename to docs/i18n/fr/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/fr/docs/AUTO-COMBO.md b/docs/i18n/fr/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/fr/docs/AUTO-COMBO.md rename to docs/i18n/fr/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/fr/llm.txt b/docs/i18n/fr/llm.txt index 91c42a60a4..d5513feb21 100644 --- a/docs/i18n/fr/llm.txt +++ b/docs/i18n/fr/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/gu/CHANGELOG.md b/docs/i18n/gu/CHANGELOG.md index 8c33126af4..ff126fc75f 100644 --- a/docs/i18n/gu/CHANGELOG.md +++ b/docs/i18n/gu/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/gu/CONTRIBUTING.md b/docs/i18n/gu/CONTRIBUTING.md index 18ee49601d..e59338a470 100644 --- a/docs/i18n/gu/CONTRIBUTING.md +++ b/docs/i18n/gu/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/gu/README.md b/docs/i18n/gu/README.md index 000aa2895c..ab7af0355a 100644 --- a/docs/i18n/gu/README.md +++ b/docs/i18n/gu/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/gu/docs/ARCHITECTURE.md b/docs/i18n/gu/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/gu/docs/ARCHITECTURE.md rename to docs/i18n/gu/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/gu/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/gu/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/gu/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/gu/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/gu/docs/A2A-SERVER.md b/docs/i18n/gu/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/gu/docs/A2A-SERVER.md rename to docs/i18n/gu/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/gu/docs/MCP-SERVER.md b/docs/i18n/gu/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/gu/docs/MCP-SERVER.md rename to docs/i18n/gu/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/gu/docs/FEATURES.md b/docs/i18n/gu/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/gu/docs/FEATURES.md rename to docs/i18n/gu/docs/guides/FEATURES.md diff --git a/docs/i18n/gu/docs/I18N.md b/docs/i18n/gu/docs/guides/I18N.md similarity index 99% rename from docs/i18n/gu/docs/I18N.md rename to docs/i18n/gu/docs/guides/I18N.md index 5888d16a6b..9c5d55e353 100644 --- a/docs/i18n/gu/docs/I18N.md +++ b/docs/i18n/gu/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/gu/docs/TROUBLESHOOTING.md b/docs/i18n/gu/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/gu/docs/TROUBLESHOOTING.md rename to docs/i18n/gu/docs/guides/TROUBLESHOOTING.md index 5d46baabbe..72735de524 100644 --- a/docs/i18n/gu/docs/TROUBLESHOOTING.md +++ b/docs/i18n/gu/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/gu/docs/UNINSTALL.md b/docs/i18n/gu/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/gu/docs/UNINSTALL.md rename to docs/i18n/gu/docs/guides/UNINSTALL.md diff --git a/docs/i18n/gu/docs/USER_GUIDE.md b/docs/i18n/gu/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/gu/docs/USER_GUIDE.md rename to docs/i18n/gu/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/gu/docs/COVERAGE_PLAN.md b/docs/i18n/gu/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/gu/docs/COVERAGE_PLAN.md rename to docs/i18n/gu/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/gu/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/gu/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/gu/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/gu/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/gu/docs/RELEASE_CHECKLIST.md b/docs/i18n/gu/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/gu/docs/RELEASE_CHECKLIST.md rename to docs/i18n/gu/docs/ops/RELEASE_CHECKLIST.md index 9958ba56db..19b13c7330 100644 --- a/docs/i18n/gu/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/gu/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/gu/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/gu/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/gu/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/gu/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/gu/docs/API_REFERENCE.md b/docs/i18n/gu/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/gu/docs/API_REFERENCE.md rename to docs/i18n/gu/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/gu/docs/CLI-TOOLS.md b/docs/i18n/gu/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/gu/docs/CLI-TOOLS.md rename to docs/i18n/gu/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/gu/docs/ENVIRONMENT.md b/docs/i18n/gu/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/gu/docs/ENVIRONMENT.md rename to docs/i18n/gu/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/gu/docs/AUTO-COMBO.md b/docs/i18n/gu/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/gu/docs/AUTO-COMBO.md rename to docs/i18n/gu/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/gu/llm.txt b/docs/i18n/gu/llm.txt index 93ba32e2f9..a18cba9411 100644 --- a/docs/i18n/gu/llm.txt +++ b/docs/i18n/gu/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/he/CHANGELOG.md b/docs/i18n/he/CHANGELOG.md index 06e11b13ba..4a3b9155ba 100644 --- a/docs/i18n/he/CHANGELOG.md +++ b/docs/i18n/he/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### אבטחה +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### תיעוד + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### תיעוד - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### אבטחה - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### אבטחה - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### תיעוד - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### תיעוד - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### אבטחה - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### אבטחה - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### תיעוד - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### אבטחה - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### תיעוד - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### אבטחה - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### תכונות - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### אבטחה - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### תכונות - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### תכונות - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### אבטחה - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### אבטחה - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### תיעוד - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### תיעוד - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### תכונות - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### תכונות - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### תכונות - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### אבטחה - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### תכונות - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### תכונות - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### תכונות - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### תכונות - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### תכונות - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### תכונות - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### תכונות - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### תכונות - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### אבטחה - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### תכונות - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### תכונות - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### תכונות - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### תכונות - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### תכונות - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### תכונות - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### תיעוד - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### תכונות - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/he/CONTRIBUTING.md b/docs/i18n/he/CONTRIBUTING.md index 41057457dd..9601204b67 100644 --- a/docs/i18n/he/CONTRIBUTING.md +++ b/docs/i18n/he/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/he/README.md b/docs/i18n/he/README.md index a3f9901683..a3284424a3 100644 --- a/docs/i18n/he/README.md +++ b/docs/i18n/he/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## תיעוד -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/he/docs/ARCHITECTURE.md b/docs/i18n/he/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/he/docs/ARCHITECTURE.md rename to docs/i18n/he/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/he/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/he/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/he/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/he/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/he/docs/A2A-SERVER.md b/docs/i18n/he/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/he/docs/A2A-SERVER.md rename to docs/i18n/he/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/he/docs/MCP-SERVER.md b/docs/i18n/he/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/he/docs/MCP-SERVER.md rename to docs/i18n/he/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/he/docs/FEATURES.md b/docs/i18n/he/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/he/docs/FEATURES.md rename to docs/i18n/he/docs/guides/FEATURES.md diff --git a/docs/i18n/he/docs/I18N.md b/docs/i18n/he/docs/guides/I18N.md similarity index 99% rename from docs/i18n/he/docs/I18N.md rename to docs/i18n/he/docs/guides/I18N.md index 1c2907f68d..02db6a375e 100644 --- a/docs/i18n/he/docs/I18N.md +++ b/docs/i18n/he/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/he/docs/TROUBLESHOOTING.md b/docs/i18n/he/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/he/docs/TROUBLESHOOTING.md rename to docs/i18n/he/docs/guides/TROUBLESHOOTING.md index 19c167b042..083e96091b 100644 --- a/docs/i18n/he/docs/TROUBLESHOOTING.md +++ b/docs/i18n/he/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/he/docs/UNINSTALL.md b/docs/i18n/he/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/he/docs/UNINSTALL.md rename to docs/i18n/he/docs/guides/UNINSTALL.md diff --git a/docs/i18n/he/docs/USER_GUIDE.md b/docs/i18n/he/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/he/docs/USER_GUIDE.md rename to docs/i18n/he/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/he/docs/COVERAGE_PLAN.md b/docs/i18n/he/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/he/docs/COVERAGE_PLAN.md rename to docs/i18n/he/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/he/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/he/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/he/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/he/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/he/docs/RELEASE_CHECKLIST.md b/docs/i18n/he/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/he/docs/RELEASE_CHECKLIST.md rename to docs/i18n/he/docs/ops/RELEASE_CHECKLIST.md index 5962d37525..e9c052da06 100644 --- a/docs/i18n/he/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/he/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/he/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/he/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/he/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/he/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/he/docs/API_REFERENCE.md b/docs/i18n/he/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/he/docs/API_REFERENCE.md rename to docs/i18n/he/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/he/docs/CLI-TOOLS.md b/docs/i18n/he/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/he/docs/CLI-TOOLS.md rename to docs/i18n/he/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/he/docs/ENVIRONMENT.md b/docs/i18n/he/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/he/docs/ENVIRONMENT.md rename to docs/i18n/he/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/he/docs/AUTO-COMBO.md b/docs/i18n/he/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/he/docs/AUTO-COMBO.md rename to docs/i18n/he/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/he/llm.txt b/docs/i18n/he/llm.txt index 47ade9e353..8831054bbd 100644 --- a/docs/i18n/he/llm.txt +++ b/docs/i18n/he/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/hi/CHANGELOG.md b/docs/i18n/hi/CHANGELOG.md index 89c19e40ae..9062bf5e09 100644 --- a/docs/i18n/hi/CHANGELOG.md +++ b/docs/i18n/hi/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### सुरक्षा +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### दस्तावेज़ + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### दस्तावेज़ - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### सुरक्षा - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### सुरक्षा - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### दस्तावेज़ - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### दस्तावेज़ - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### सुरक्षा - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### सुरक्षा - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### दस्तावेज़ - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### सुरक्षा - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### दस्तावेज़ - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### सुरक्षा - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### विशेषताएं - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### सुरक्षा - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### विशेषताएं - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### विशेषताएं - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### सुरक्षा - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### सुरक्षा - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### दस्तावेज़ - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### दस्तावेज़ - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### विशेषताएं - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### विशेषताएं - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### विशेषताएं - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### सुरक्षा - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### विशेषताएं - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### विशेषताएं - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### विशेषताएं - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### विशेषताएं - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### विशेषताएं - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### विशेषताएं - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### विशेषताएं - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### विशेषताएं - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### सुरक्षा - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### विशेषताएं - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### विशेषताएं - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### विशेषताएं - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### विशेषताएं - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### विशेषताएं - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### विशेषताएं - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### दस्तावेज़ - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### विशेषताएं - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/hi/CONTRIBUTING.md b/docs/i18n/hi/CONTRIBUTING.md index 2a03264ea0..a2b59099b8 100644 --- a/docs/i18n/hi/CONTRIBUTING.md +++ b/docs/i18n/hi/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/hi/README.md b/docs/i18n/hi/README.md index be8b2e4647..e9150cc01a 100644 --- a/docs/i18n/hi/README.md +++ b/docs/i18n/hi/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## दस्तावेज़ -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/hi/docs/ARCHITECTURE.md b/docs/i18n/hi/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/hi/docs/ARCHITECTURE.md rename to docs/i18n/hi/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/hi/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/hi/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/hi/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/hi/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/hi/docs/A2A-SERVER.md b/docs/i18n/hi/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/hi/docs/A2A-SERVER.md rename to docs/i18n/hi/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/hi/docs/MCP-SERVER.md b/docs/i18n/hi/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/hi/docs/MCP-SERVER.md rename to docs/i18n/hi/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/hi/docs/FEATURES.md b/docs/i18n/hi/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/hi/docs/FEATURES.md rename to docs/i18n/hi/docs/guides/FEATURES.md diff --git a/docs/i18n/hi/docs/I18N.md b/docs/i18n/hi/docs/guides/I18N.md similarity index 99% rename from docs/i18n/hi/docs/I18N.md rename to docs/i18n/hi/docs/guides/I18N.md index 4b35d190b0..99819dea66 100644 --- a/docs/i18n/hi/docs/I18N.md +++ b/docs/i18n/hi/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/hi/docs/TROUBLESHOOTING.md b/docs/i18n/hi/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/hi/docs/TROUBLESHOOTING.md rename to docs/i18n/hi/docs/guides/TROUBLESHOOTING.md index 9b2aa8e809..b0a1a63de1 100644 --- a/docs/i18n/hi/docs/TROUBLESHOOTING.md +++ b/docs/i18n/hi/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/hi/docs/UNINSTALL.md b/docs/i18n/hi/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/hi/docs/UNINSTALL.md rename to docs/i18n/hi/docs/guides/UNINSTALL.md diff --git a/docs/i18n/hi/docs/USER_GUIDE.md b/docs/i18n/hi/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/hi/docs/USER_GUIDE.md rename to docs/i18n/hi/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/hi/docs/COVERAGE_PLAN.md b/docs/i18n/hi/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/hi/docs/COVERAGE_PLAN.md rename to docs/i18n/hi/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/hi/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/hi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/hi/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/hi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/hi/docs/RELEASE_CHECKLIST.md b/docs/i18n/hi/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/hi/docs/RELEASE_CHECKLIST.md rename to docs/i18n/hi/docs/ops/RELEASE_CHECKLIST.md index f406a0d7ad..7a114ea0b9 100644 --- a/docs/i18n/hi/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/hi/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/hi/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/hi/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/hi/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/hi/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/hi/docs/API_REFERENCE.md b/docs/i18n/hi/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/hi/docs/API_REFERENCE.md rename to docs/i18n/hi/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/hi/docs/CLI-TOOLS.md b/docs/i18n/hi/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/hi/docs/CLI-TOOLS.md rename to docs/i18n/hi/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/hi/docs/ENVIRONMENT.md b/docs/i18n/hi/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/hi/docs/ENVIRONMENT.md rename to docs/i18n/hi/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/hi/docs/AUTO-COMBO.md b/docs/i18n/hi/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/hi/docs/AUTO-COMBO.md rename to docs/i18n/hi/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/hi/llm.txt b/docs/i18n/hi/llm.txt index 1cb382da90..45b8ecd4f4 100644 --- a/docs/i18n/hi/llm.txt +++ b/docs/i18n/hi/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/hu/CHANGELOG.md b/docs/i18n/hu/CHANGELOG.md index 79f97153c7..aaaa8aad8a 100644 --- a/docs/i18n/hu/CHANGELOG.md +++ b/docs/i18n/hu/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Biztonság +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentáció + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentáció - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Biztonság - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Biztonság - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentáció - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentáció - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Biztonság - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Biztonság - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentáció - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Biztonság - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentáció - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Biztonság - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funkciók - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Biztonság - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funkciók - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funkciók - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Biztonság - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Biztonság - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentáció - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentáció - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funkciók - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funkciók - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funkciók - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Biztonság - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funkciók - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funkciók - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funkciók - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funkciók - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funkciók - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funkciók - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funkciók - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funkciók - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Biztonság - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funkciók - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funkciók - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funkciók - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funkciók - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funkciók - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funkciók - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentáció - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funkciók - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/hu/CONTRIBUTING.md b/docs/i18n/hu/CONTRIBUTING.md index ce8e5b0845..d9c56d890e 100644 --- a/docs/i18n/hu/CONTRIBUTING.md +++ b/docs/i18n/hu/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/hu/README.md b/docs/i18n/hu/README.md index 97ffb36ab0..2d136ac7bb 100644 --- a/docs/i18n/hu/README.md +++ b/docs/i18n/hu/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentáció -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/hu/docs/ARCHITECTURE.md b/docs/i18n/hu/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/hu/docs/ARCHITECTURE.md rename to docs/i18n/hu/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/hu/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/hu/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/hu/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/hu/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/hu/docs/A2A-SERVER.md b/docs/i18n/hu/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/hu/docs/A2A-SERVER.md rename to docs/i18n/hu/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/hu/docs/MCP-SERVER.md b/docs/i18n/hu/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/hu/docs/MCP-SERVER.md rename to docs/i18n/hu/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/hu/docs/FEATURES.md b/docs/i18n/hu/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/hu/docs/FEATURES.md rename to docs/i18n/hu/docs/guides/FEATURES.md diff --git a/docs/i18n/hu/docs/I18N.md b/docs/i18n/hu/docs/guides/I18N.md similarity index 99% rename from docs/i18n/hu/docs/I18N.md rename to docs/i18n/hu/docs/guides/I18N.md index 0b698c8c1e..5ce84e3a10 100644 --- a/docs/i18n/hu/docs/I18N.md +++ b/docs/i18n/hu/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/hu/docs/TROUBLESHOOTING.md b/docs/i18n/hu/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/hu/docs/TROUBLESHOOTING.md rename to docs/i18n/hu/docs/guides/TROUBLESHOOTING.md index b778c8e1dd..ab2f0809e0 100644 --- a/docs/i18n/hu/docs/TROUBLESHOOTING.md +++ b/docs/i18n/hu/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/hu/docs/UNINSTALL.md b/docs/i18n/hu/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/hu/docs/UNINSTALL.md rename to docs/i18n/hu/docs/guides/UNINSTALL.md diff --git a/docs/i18n/hu/docs/USER_GUIDE.md b/docs/i18n/hu/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/hu/docs/USER_GUIDE.md rename to docs/i18n/hu/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/hu/docs/COVERAGE_PLAN.md b/docs/i18n/hu/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/hu/docs/COVERAGE_PLAN.md rename to docs/i18n/hu/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/hu/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/hu/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/hu/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/hu/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/hu/docs/RELEASE_CHECKLIST.md b/docs/i18n/hu/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/hu/docs/RELEASE_CHECKLIST.md rename to docs/i18n/hu/docs/ops/RELEASE_CHECKLIST.md index 338230d9a7..87e24c3438 100644 --- a/docs/i18n/hu/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/hu/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/hu/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/hu/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/hu/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/hu/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/hu/docs/API_REFERENCE.md b/docs/i18n/hu/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/hu/docs/API_REFERENCE.md rename to docs/i18n/hu/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/hu/docs/CLI-TOOLS.md b/docs/i18n/hu/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/hu/docs/CLI-TOOLS.md rename to docs/i18n/hu/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/hu/docs/ENVIRONMENT.md b/docs/i18n/hu/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/hu/docs/ENVIRONMENT.md rename to docs/i18n/hu/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/hu/docs/AUTO-COMBO.md b/docs/i18n/hu/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/hu/docs/AUTO-COMBO.md rename to docs/i18n/hu/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/hu/llm.txt b/docs/i18n/hu/llm.txt index 0b6577ac44..0484dbd925 100644 --- a/docs/i18n/hu/llm.txt +++ b/docs/i18n/hu/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/id/CHANGELOG.md b/docs/i18n/id/CHANGELOG.md index 25687c52f7..d66c092655 100644 --- a/docs/i18n/id/CHANGELOG.md +++ b/docs/i18n/id/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Keamanan +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentasi + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentasi - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Keamanan - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Keamanan - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentasi - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentasi - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Keamanan - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Keamanan - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentasi - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Keamanan - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentasi - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Keamanan - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Fitur - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Keamanan - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Fitur - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Fitur - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Keamanan - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Keamanan - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentasi - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentasi - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Fitur - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Fitur - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Fitur - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Keamanan - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Fitur - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Fitur - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Fitur - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Fitur - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Fitur - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Fitur - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Fitur - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Fitur - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Keamanan - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Fitur - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Fitur - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Fitur - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Fitur - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Fitur - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Fitur - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentasi - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Fitur - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/id/CONTRIBUTING.md b/docs/i18n/id/CONTRIBUTING.md index b3ffe11a1b..b1a724553a 100644 --- a/docs/i18n/id/CONTRIBUTING.md +++ b/docs/i18n/id/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/id/README.md b/docs/i18n/id/README.md index e308128367..71d5194ecd 100644 --- a/docs/i18n/id/README.md +++ b/docs/i18n/id/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentasi -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/id/docs/ARCHITECTURE.md b/docs/i18n/id/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/id/docs/ARCHITECTURE.md rename to docs/i18n/id/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/id/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/id/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/id/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/id/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/id/docs/A2A-SERVER.md b/docs/i18n/id/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/id/docs/A2A-SERVER.md rename to docs/i18n/id/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/id/docs/MCP-SERVER.md b/docs/i18n/id/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/id/docs/MCP-SERVER.md rename to docs/i18n/id/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/id/docs/FEATURES.md b/docs/i18n/id/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/id/docs/FEATURES.md rename to docs/i18n/id/docs/guides/FEATURES.md diff --git a/docs/i18n/id/docs/I18N.md b/docs/i18n/id/docs/guides/I18N.md similarity index 99% rename from docs/i18n/id/docs/I18N.md rename to docs/i18n/id/docs/guides/I18N.md index 77df794c42..910370dcae 100644 --- a/docs/i18n/id/docs/I18N.md +++ b/docs/i18n/id/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/id/docs/TROUBLESHOOTING.md b/docs/i18n/id/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/id/docs/TROUBLESHOOTING.md rename to docs/i18n/id/docs/guides/TROUBLESHOOTING.md index 8c07300e1b..ae8156e5ef 100644 --- a/docs/i18n/id/docs/TROUBLESHOOTING.md +++ b/docs/i18n/id/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/id/docs/UNINSTALL.md b/docs/i18n/id/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/id/docs/UNINSTALL.md rename to docs/i18n/id/docs/guides/UNINSTALL.md diff --git a/docs/i18n/id/docs/USER_GUIDE.md b/docs/i18n/id/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/id/docs/USER_GUIDE.md rename to docs/i18n/id/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/id/docs/COVERAGE_PLAN.md b/docs/i18n/id/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/id/docs/COVERAGE_PLAN.md rename to docs/i18n/id/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/id/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/id/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/id/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/id/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/id/docs/RELEASE_CHECKLIST.md b/docs/i18n/id/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/id/docs/RELEASE_CHECKLIST.md rename to docs/i18n/id/docs/ops/RELEASE_CHECKLIST.md index a0126b813b..f57f20d897 100644 --- a/docs/i18n/id/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/id/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/id/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/id/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/id/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/id/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/id/docs/API_REFERENCE.md b/docs/i18n/id/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/id/docs/API_REFERENCE.md rename to docs/i18n/id/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/id/docs/CLI-TOOLS.md b/docs/i18n/id/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/id/docs/CLI-TOOLS.md rename to docs/i18n/id/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/id/docs/ENVIRONMENT.md b/docs/i18n/id/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/id/docs/ENVIRONMENT.md rename to docs/i18n/id/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/id/docs/AUTO-COMBO.md b/docs/i18n/id/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/id/docs/AUTO-COMBO.md rename to docs/i18n/id/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/id/llm.txt b/docs/i18n/id/llm.txt index 05336cecdb..44eaa9952d 100644 --- a/docs/i18n/id/llm.txt +++ b/docs/i18n/id/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/in/CHANGELOG.md b/docs/i18n/in/CHANGELOG.md index 4dc68a146c..8af184dd43 100644 --- a/docs/i18n/in/CHANGELOG.md +++ b/docs/i18n/in/CHANGELOG.md @@ -15,6 +15,10 @@ ### 🐛 Bug Fixes +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) @@ -1192,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes diff --git a/docs/i18n/in/CONTRIBUTING.md b/docs/i18n/in/CONTRIBUTING.md index 8aa93179c3..da6c1d8ac0 100644 --- a/docs/i18n/in/CONTRIBUTING.md +++ b/docs/i18n/in/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/in/README.md b/docs/i18n/in/README.md index 70c65182ff..486d3210ce 100644 --- a/docs/i18n/in/README.md +++ b/docs/i18n/in/README.md @@ -2256,25 +2256,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## दस्तावेज़ -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/in/docs/ARCHITECTURE.md b/docs/i18n/in/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/in/docs/ARCHITECTURE.md rename to docs/i18n/in/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/in/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/in/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/in/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/in/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/in/docs/A2A-SERVER.md b/docs/i18n/in/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/in/docs/A2A-SERVER.md rename to docs/i18n/in/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/in/docs/MCP-SERVER.md b/docs/i18n/in/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/in/docs/MCP-SERVER.md rename to docs/i18n/in/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/in/docs/FEATURES.md b/docs/i18n/in/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/in/docs/FEATURES.md rename to docs/i18n/in/docs/guides/FEATURES.md diff --git a/docs/i18n/in/docs/I18N.md b/docs/i18n/in/docs/guides/I18N.md similarity index 98% rename from docs/i18n/in/docs/I18N.md rename to docs/i18n/in/docs/guides/I18N.md index 142bd074b2..909472adf2 100644 --- a/docs/i18n/in/docs/I18N.md +++ b/docs/i18n/in/docs/guides/I18N.md @@ -19,6 +19,10 @@ OmniRoute supports **30 languages** with full dashboard UI translation, translat ## आर्किटेक्चर +![Incremental hash-based i18n pipeline](./diagrams/exported/i18n-flow.svg) + +> Source: [diagrams/i18n-flow.mmd](./diagrams/i18n-flow.mmd) + ### Source of Truth - **UI strings**: `src/i18n/messages/en.json` (English source, ~2800 keys) @@ -420,7 +424,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/in/docs/TROUBLESHOOTING.md b/docs/i18n/in/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/in/docs/TROUBLESHOOTING.md rename to docs/i18n/in/docs/guides/TROUBLESHOOTING.md index 78a93de8bb..fab97adffe 100644 --- a/docs/i18n/in/docs/TROUBLESHOOTING.md +++ b/docs/i18n/in/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/in/docs/UNINSTALL.md b/docs/i18n/in/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/in/docs/UNINSTALL.md rename to docs/i18n/in/docs/guides/UNINSTALL.md diff --git a/docs/i18n/in/docs/USER_GUIDE.md b/docs/i18n/in/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/in/docs/USER_GUIDE.md rename to docs/i18n/in/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/in/docs/COVERAGE_PLAN.md b/docs/i18n/in/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/in/docs/COVERAGE_PLAN.md rename to docs/i18n/in/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/in/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/in/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/in/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/in/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/in/docs/RELEASE_CHECKLIST.md b/docs/i18n/in/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/in/docs/RELEASE_CHECKLIST.md rename to docs/i18n/in/docs/ops/RELEASE_CHECKLIST.md index 21bcce8589..1108a3ad61 100644 --- a/docs/i18n/in/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/in/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/in/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/in/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/in/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/in/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/in/docs/API_REFERENCE.md b/docs/i18n/in/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/in/docs/API_REFERENCE.md rename to docs/i18n/in/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/in/docs/CLI-TOOLS.md b/docs/i18n/in/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/in/docs/CLI-TOOLS.md rename to docs/i18n/in/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/in/docs/ENVIRONMENT.md b/docs/i18n/in/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/in/docs/ENVIRONMENT.md rename to docs/i18n/in/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/in/docs/AUTO-COMBO.md b/docs/i18n/in/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/in/docs/AUTO-COMBO.md rename to docs/i18n/in/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/in/llm.txt b/docs/i18n/in/llm.txt index dfe52e8d89..66eeb8744e 100644 --- a/docs/i18n/in/llm.txt +++ b/docs/i18n/in/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/it/CHANGELOG.md b/docs/i18n/it/CHANGELOG.md index 23603a46bf..80ed4a317d 100644 --- a/docs/i18n/it/CHANGELOG.md +++ b/docs/i18n/it/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Sicurezza +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentazione + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentazione - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Sicurezza - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Sicurezza - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentazione - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentazione - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Sicurezza - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Sicurezza - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentazione - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Sicurezza - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentazione - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Sicurezza - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funzionalità - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Sicurezza - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funzionalità - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funzionalità - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Sicurezza - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Sicurezza - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentazione - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentazione - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funzionalità - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funzionalità - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funzionalità - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Sicurezza - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funzionalità - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funzionalità - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funzionalità - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funzionalità - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funzionalità - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funzionalità - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funzionalità - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funzionalità - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Sicurezza - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funzionalità - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funzionalità - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funzionalità - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funzionalità - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funzionalità - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funzionalità - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentazione - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funzionalità - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/it/CONTRIBUTING.md b/docs/i18n/it/CONTRIBUTING.md index 98278a77db..e3cb62b317 100644 --- a/docs/i18n/it/CONTRIBUTING.md +++ b/docs/i18n/it/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/it/README.md b/docs/i18n/it/README.md index 500239cb69..6a6e645ef3 100644 --- a/docs/i18n/it/README.md +++ b/docs/i18n/it/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentazione -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/it/docs/ARCHITECTURE.md b/docs/i18n/it/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/it/docs/ARCHITECTURE.md rename to docs/i18n/it/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/it/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/it/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/it/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/it/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/it/docs/A2A-SERVER.md b/docs/i18n/it/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/it/docs/A2A-SERVER.md rename to docs/i18n/it/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/it/docs/MCP-SERVER.md b/docs/i18n/it/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/it/docs/MCP-SERVER.md rename to docs/i18n/it/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/it/docs/FEATURES.md b/docs/i18n/it/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/it/docs/FEATURES.md rename to docs/i18n/it/docs/guides/FEATURES.md diff --git a/docs/i18n/it/docs/I18N.md b/docs/i18n/it/docs/guides/I18N.md similarity index 99% rename from docs/i18n/it/docs/I18N.md rename to docs/i18n/it/docs/guides/I18N.md index 3d1a1de63d..7b648f8385 100644 --- a/docs/i18n/it/docs/I18N.md +++ b/docs/i18n/it/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/it/docs/TROUBLESHOOTING.md b/docs/i18n/it/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/it/docs/TROUBLESHOOTING.md rename to docs/i18n/it/docs/guides/TROUBLESHOOTING.md index 8c47be6737..85b2d850ba 100644 --- a/docs/i18n/it/docs/TROUBLESHOOTING.md +++ b/docs/i18n/it/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/it/docs/UNINSTALL.md b/docs/i18n/it/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/it/docs/UNINSTALL.md rename to docs/i18n/it/docs/guides/UNINSTALL.md diff --git a/docs/i18n/it/docs/USER_GUIDE.md b/docs/i18n/it/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/it/docs/USER_GUIDE.md rename to docs/i18n/it/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/it/docs/COVERAGE_PLAN.md b/docs/i18n/it/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/it/docs/COVERAGE_PLAN.md rename to docs/i18n/it/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/it/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/it/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/it/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/it/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/it/docs/RELEASE_CHECKLIST.md b/docs/i18n/it/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/it/docs/RELEASE_CHECKLIST.md rename to docs/i18n/it/docs/ops/RELEASE_CHECKLIST.md index d0cc4e3887..45b9e81833 100644 --- a/docs/i18n/it/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/it/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/it/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/it/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/it/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/it/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/it/docs/API_REFERENCE.md b/docs/i18n/it/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/it/docs/API_REFERENCE.md rename to docs/i18n/it/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/it/docs/CLI-TOOLS.md b/docs/i18n/it/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/it/docs/CLI-TOOLS.md rename to docs/i18n/it/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/it/docs/ENVIRONMENT.md b/docs/i18n/it/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/it/docs/ENVIRONMENT.md rename to docs/i18n/it/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/it/docs/AUTO-COMBO.md b/docs/i18n/it/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/it/docs/AUTO-COMBO.md rename to docs/i18n/it/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/it/llm.txt b/docs/i18n/it/llm.txt index e24e2ecf5b..ec64536dc2 100644 --- a/docs/i18n/it/llm.txt +++ b/docs/i18n/it/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ja/CHANGELOG.md b/docs/i18n/ja/CHANGELOG.md index 623fc31eff..6a4450202e 100644 --- a/docs/i18n/ja/CHANGELOG.md +++ b/docs/i18n/ja/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### セキュリティ +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### ドキュメント + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### ドキュメント - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### セキュリティ - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### セキュリティ - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### ドキュメント - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### ドキュメント - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### セキュリティ - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### セキュリティ - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### ドキュメント - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### セキュリティ - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### ドキュメント - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### セキュリティ - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### 機能 - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### セキュリティ - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### 機能 - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### 機能 - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### セキュリティ - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### セキュリティ - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### ドキュメント - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### ドキュメント - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### 機能 - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### 機能 - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### 機能 - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### セキュリティ - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### 機能 - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### 機能 - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### 機能 - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### 機能 - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### 機能 - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### 機能 - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### 機能 - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### 機能 - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### セキュリティ - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### 機能 - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### 機能 - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### 機能 - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### 機能 - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### 機能 - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### 機能 - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### ドキュメント - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### 機能 - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ja/CONTRIBUTING.md b/docs/i18n/ja/CONTRIBUTING.md index 307d2dcb24..6d8f76191e 100644 --- a/docs/i18n/ja/CONTRIBUTING.md +++ b/docs/i18n/ja/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ja/README.md b/docs/i18n/ja/README.md index fb03fcd72d..34ee6a7308 100644 --- a/docs/i18n/ja/README.md +++ b/docs/i18n/ja/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## ドキュメント -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ja/docs/ARCHITECTURE.md b/docs/i18n/ja/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ja/docs/ARCHITECTURE.md rename to docs/i18n/ja/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ja/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ja/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ja/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ja/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ja/docs/A2A-SERVER.md b/docs/i18n/ja/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ja/docs/A2A-SERVER.md rename to docs/i18n/ja/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ja/docs/MCP-SERVER.md b/docs/i18n/ja/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ja/docs/MCP-SERVER.md rename to docs/i18n/ja/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ja/docs/FEATURES.md b/docs/i18n/ja/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ja/docs/FEATURES.md rename to docs/i18n/ja/docs/guides/FEATURES.md diff --git a/docs/i18n/ja/docs/I18N.md b/docs/i18n/ja/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ja/docs/I18N.md rename to docs/i18n/ja/docs/guides/I18N.md index f2c5375bcb..b3c49f1c77 100644 --- a/docs/i18n/ja/docs/I18N.md +++ b/docs/i18n/ja/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ja/docs/TROUBLESHOOTING.md b/docs/i18n/ja/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ja/docs/TROUBLESHOOTING.md rename to docs/i18n/ja/docs/guides/TROUBLESHOOTING.md index e2b27bc989..ba7b61683d 100644 --- a/docs/i18n/ja/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ja/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ja/docs/UNINSTALL.md b/docs/i18n/ja/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ja/docs/UNINSTALL.md rename to docs/i18n/ja/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ja/docs/USER_GUIDE.md b/docs/i18n/ja/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ja/docs/USER_GUIDE.md rename to docs/i18n/ja/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ja/docs/COVERAGE_PLAN.md b/docs/i18n/ja/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ja/docs/COVERAGE_PLAN.md rename to docs/i18n/ja/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ja/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ja/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ja/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ja/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ja/docs/RELEASE_CHECKLIST.md b/docs/i18n/ja/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ja/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ja/docs/ops/RELEASE_CHECKLIST.md index ea7d0f993b..dc46e0a613 100644 --- a/docs/i18n/ja/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ja/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ja/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ja/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ja/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ja/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ja/docs/API_REFERENCE.md b/docs/i18n/ja/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ja/docs/API_REFERENCE.md rename to docs/i18n/ja/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ja/docs/CLI-TOOLS.md b/docs/i18n/ja/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ja/docs/CLI-TOOLS.md rename to docs/i18n/ja/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ja/docs/ENVIRONMENT.md b/docs/i18n/ja/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ja/docs/ENVIRONMENT.md rename to docs/i18n/ja/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ja/docs/AUTO-COMBO.md b/docs/i18n/ja/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ja/docs/AUTO-COMBO.md rename to docs/i18n/ja/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ja/llm.txt b/docs/i18n/ja/llm.txt index b8ecfda395..7d42694266 100644 --- a/docs/i18n/ja/llm.txt +++ b/docs/i18n/ja/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ko/CHANGELOG.md b/docs/i18n/ko/CHANGELOG.md index 33abbb178f..5d5dcb3990 100644 --- a/docs/i18n/ko/CHANGELOG.md +++ b/docs/i18n/ko/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### 보안 +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### 문서 + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### 문서 - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### 보안 - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### 보안 - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### 문서 - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### 문서 - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### 보안 - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### 보안 - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### 문서 - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### 보안 - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### 문서 - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### 보안 - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### 기능 - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### 보안 - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### 기능 - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### 기능 - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### 보안 - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### 보안 - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### 문서 - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### 문서 - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### 기능 - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### 기능 - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### 기능 - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### 보안 - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### 기능 - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### 기능 - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### 기능 - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### 기능 - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### 기능 - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### 기능 - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### 기능 - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### 기능 - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### 보안 - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### 기능 - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### 기능 - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### 기능 - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### 기능 - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### 기능 - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### 기능 - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### 문서 - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### 기능 - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ko/CONTRIBUTING.md b/docs/i18n/ko/CONTRIBUTING.md index d5de24574b..ebe73c8fb3 100644 --- a/docs/i18n/ko/CONTRIBUTING.md +++ b/docs/i18n/ko/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ko/README.md b/docs/i18n/ko/README.md index ffe4cd20fd..63e601edc6 100644 --- a/docs/i18n/ko/README.md +++ b/docs/i18n/ko/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## 문서 -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ko/docs/ARCHITECTURE.md b/docs/i18n/ko/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ko/docs/ARCHITECTURE.md rename to docs/i18n/ko/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ko/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ko/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ko/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ko/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ko/docs/A2A-SERVER.md b/docs/i18n/ko/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ko/docs/A2A-SERVER.md rename to docs/i18n/ko/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ko/docs/MCP-SERVER.md b/docs/i18n/ko/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ko/docs/MCP-SERVER.md rename to docs/i18n/ko/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ko/docs/FEATURES.md b/docs/i18n/ko/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ko/docs/FEATURES.md rename to docs/i18n/ko/docs/guides/FEATURES.md diff --git a/docs/i18n/ko/docs/I18N.md b/docs/i18n/ko/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ko/docs/I18N.md rename to docs/i18n/ko/docs/guides/I18N.md index af5e4fd0bb..fea5b6e87b 100644 --- a/docs/i18n/ko/docs/I18N.md +++ b/docs/i18n/ko/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ko/docs/TROUBLESHOOTING.md b/docs/i18n/ko/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ko/docs/TROUBLESHOOTING.md rename to docs/i18n/ko/docs/guides/TROUBLESHOOTING.md index 245f52fdb2..5e5fcfe9ae 100644 --- a/docs/i18n/ko/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ko/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ko/docs/UNINSTALL.md b/docs/i18n/ko/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ko/docs/UNINSTALL.md rename to docs/i18n/ko/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ko/docs/USER_GUIDE.md b/docs/i18n/ko/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ko/docs/USER_GUIDE.md rename to docs/i18n/ko/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ko/docs/COVERAGE_PLAN.md b/docs/i18n/ko/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ko/docs/COVERAGE_PLAN.md rename to docs/i18n/ko/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ko/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ko/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ko/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ko/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ko/docs/RELEASE_CHECKLIST.md b/docs/i18n/ko/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ko/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ko/docs/ops/RELEASE_CHECKLIST.md index dbfe24caa9..f2d95b262e 100644 --- a/docs/i18n/ko/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ko/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ko/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ko/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ko/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ko/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ko/docs/API_REFERENCE.md b/docs/i18n/ko/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ko/docs/API_REFERENCE.md rename to docs/i18n/ko/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ko/docs/CLI-TOOLS.md b/docs/i18n/ko/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ko/docs/CLI-TOOLS.md rename to docs/i18n/ko/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ko/docs/ENVIRONMENT.md b/docs/i18n/ko/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ko/docs/ENVIRONMENT.md rename to docs/i18n/ko/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ko/docs/AUTO-COMBO.md b/docs/i18n/ko/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ko/docs/AUTO-COMBO.md rename to docs/i18n/ko/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ko/llm.txt b/docs/i18n/ko/llm.txt index 1ce6383a65..3a6fde950b 100644 --- a/docs/i18n/ko/llm.txt +++ b/docs/i18n/ko/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/mr/CHANGELOG.md b/docs/i18n/mr/CHANGELOG.md index bc787d54a6..0fb797a8b4 100644 --- a/docs/i18n/mr/CHANGELOG.md +++ b/docs/i18n/mr/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/mr/CONTRIBUTING.md b/docs/i18n/mr/CONTRIBUTING.md index a4dedc4578..2245c3f831 100644 --- a/docs/i18n/mr/CONTRIBUTING.md +++ b/docs/i18n/mr/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/mr/README.md b/docs/i18n/mr/README.md index 57ec532cab..cda2a91b5c 100644 --- a/docs/i18n/mr/README.md +++ b/docs/i18n/mr/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/mr/docs/ARCHITECTURE.md b/docs/i18n/mr/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/mr/docs/ARCHITECTURE.md rename to docs/i18n/mr/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/mr/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/mr/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/mr/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/mr/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/mr/docs/A2A-SERVER.md b/docs/i18n/mr/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/mr/docs/A2A-SERVER.md rename to docs/i18n/mr/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/mr/docs/MCP-SERVER.md b/docs/i18n/mr/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/mr/docs/MCP-SERVER.md rename to docs/i18n/mr/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/mr/docs/FEATURES.md b/docs/i18n/mr/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/mr/docs/FEATURES.md rename to docs/i18n/mr/docs/guides/FEATURES.md diff --git a/docs/i18n/mr/docs/I18N.md b/docs/i18n/mr/docs/guides/I18N.md similarity index 99% rename from docs/i18n/mr/docs/I18N.md rename to docs/i18n/mr/docs/guides/I18N.md index a1c23e03e7..1604a3fbcf 100644 --- a/docs/i18n/mr/docs/I18N.md +++ b/docs/i18n/mr/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/mr/docs/TROUBLESHOOTING.md b/docs/i18n/mr/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/mr/docs/TROUBLESHOOTING.md rename to docs/i18n/mr/docs/guides/TROUBLESHOOTING.md index 18bfb5a393..42b85cd959 100644 --- a/docs/i18n/mr/docs/TROUBLESHOOTING.md +++ b/docs/i18n/mr/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/mr/docs/UNINSTALL.md b/docs/i18n/mr/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/mr/docs/UNINSTALL.md rename to docs/i18n/mr/docs/guides/UNINSTALL.md diff --git a/docs/i18n/mr/docs/USER_GUIDE.md b/docs/i18n/mr/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/mr/docs/USER_GUIDE.md rename to docs/i18n/mr/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/mr/docs/COVERAGE_PLAN.md b/docs/i18n/mr/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/mr/docs/COVERAGE_PLAN.md rename to docs/i18n/mr/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/mr/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/mr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/mr/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/mr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/mr/docs/RELEASE_CHECKLIST.md b/docs/i18n/mr/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/mr/docs/RELEASE_CHECKLIST.md rename to docs/i18n/mr/docs/ops/RELEASE_CHECKLIST.md index 7ec2d34f16..5028558782 100644 --- a/docs/i18n/mr/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/mr/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/mr/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/mr/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/mr/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/mr/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/mr/docs/API_REFERENCE.md b/docs/i18n/mr/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/mr/docs/API_REFERENCE.md rename to docs/i18n/mr/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/mr/docs/CLI-TOOLS.md b/docs/i18n/mr/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/mr/docs/CLI-TOOLS.md rename to docs/i18n/mr/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/mr/docs/ENVIRONMENT.md b/docs/i18n/mr/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/mr/docs/ENVIRONMENT.md rename to docs/i18n/mr/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/mr/docs/AUTO-COMBO.md b/docs/i18n/mr/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/mr/docs/AUTO-COMBO.md rename to docs/i18n/mr/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/mr/llm.txt b/docs/i18n/mr/llm.txt index 2959f516b5..7e49ce7878 100644 --- a/docs/i18n/mr/llm.txt +++ b/docs/i18n/mr/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ms/CHANGELOG.md b/docs/i18n/ms/CHANGELOG.md index 8eac0b295b..0a7b677bad 100644 --- a/docs/i18n/ms/CHANGELOG.md +++ b/docs/i18n/ms/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Keselamatan +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentasi + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentasi - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Keselamatan - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Keselamatan - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentasi - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentasi - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Keselamatan - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Keselamatan - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentasi - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Keselamatan - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentasi - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Keselamatan - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Ciri-ciri - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Keselamatan - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Ciri-ciri - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Ciri-ciri - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Keselamatan - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Keselamatan - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentasi - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentasi - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Ciri-ciri - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Ciri-ciri - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Ciri-ciri - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Keselamatan - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Ciri-ciri - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Ciri-ciri - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Ciri-ciri - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Ciri-ciri - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Ciri-ciri - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Ciri-ciri - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Ciri-ciri - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Ciri-ciri - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Keselamatan - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Ciri-ciri - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Ciri-ciri - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Ciri-ciri - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Ciri-ciri - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Ciri-ciri - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Ciri-ciri - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentasi - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Ciri-ciri - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ms/CONTRIBUTING.md b/docs/i18n/ms/CONTRIBUTING.md index 01ff8cea11..c1d1b075cc 100644 --- a/docs/i18n/ms/CONTRIBUTING.md +++ b/docs/i18n/ms/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ms/README.md b/docs/i18n/ms/README.md index e72f4836aa..77cd80d5a2 100644 --- a/docs/i18n/ms/README.md +++ b/docs/i18n/ms/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentasi -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ms/docs/ARCHITECTURE.md b/docs/i18n/ms/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ms/docs/ARCHITECTURE.md rename to docs/i18n/ms/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ms/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ms/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ms/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ms/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ms/docs/A2A-SERVER.md b/docs/i18n/ms/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ms/docs/A2A-SERVER.md rename to docs/i18n/ms/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ms/docs/MCP-SERVER.md b/docs/i18n/ms/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ms/docs/MCP-SERVER.md rename to docs/i18n/ms/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ms/docs/FEATURES.md b/docs/i18n/ms/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ms/docs/FEATURES.md rename to docs/i18n/ms/docs/guides/FEATURES.md diff --git a/docs/i18n/ms/docs/I18N.md b/docs/i18n/ms/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ms/docs/I18N.md rename to docs/i18n/ms/docs/guides/I18N.md index 32a7ae2666..3f10814344 100644 --- a/docs/i18n/ms/docs/I18N.md +++ b/docs/i18n/ms/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ms/docs/TROUBLESHOOTING.md b/docs/i18n/ms/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ms/docs/TROUBLESHOOTING.md rename to docs/i18n/ms/docs/guides/TROUBLESHOOTING.md index 783753adda..60d6c32989 100644 --- a/docs/i18n/ms/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ms/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ms/docs/UNINSTALL.md b/docs/i18n/ms/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ms/docs/UNINSTALL.md rename to docs/i18n/ms/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ms/docs/USER_GUIDE.md b/docs/i18n/ms/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ms/docs/USER_GUIDE.md rename to docs/i18n/ms/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ms/docs/COVERAGE_PLAN.md b/docs/i18n/ms/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ms/docs/COVERAGE_PLAN.md rename to docs/i18n/ms/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ms/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ms/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ms/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ms/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ms/docs/RELEASE_CHECKLIST.md b/docs/i18n/ms/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ms/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ms/docs/ops/RELEASE_CHECKLIST.md index 5ce7ee2a1d..0b72bdea50 100644 --- a/docs/i18n/ms/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ms/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ms/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ms/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ms/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ms/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ms/docs/API_REFERENCE.md b/docs/i18n/ms/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ms/docs/API_REFERENCE.md rename to docs/i18n/ms/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ms/docs/CLI-TOOLS.md b/docs/i18n/ms/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ms/docs/CLI-TOOLS.md rename to docs/i18n/ms/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ms/docs/ENVIRONMENT.md b/docs/i18n/ms/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ms/docs/ENVIRONMENT.md rename to docs/i18n/ms/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ms/docs/AUTO-COMBO.md b/docs/i18n/ms/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ms/docs/AUTO-COMBO.md rename to docs/i18n/ms/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ms/llm.txt b/docs/i18n/ms/llm.txt index 0f64418b09..f9746ea806 100644 --- a/docs/i18n/ms/llm.txt +++ b/docs/i18n/ms/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/nl/CHANGELOG.md b/docs/i18n/nl/CHANGELOG.md index a8aabfc653..67fba02475 100644 --- a/docs/i18n/nl/CHANGELOG.md +++ b/docs/i18n/nl/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Beveiliging +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentatie + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentatie - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Beveiliging - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Beveiliging - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentatie - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentatie - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Beveiliging - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Beveiliging - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentatie - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Beveiliging - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentatie - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Beveiliging - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Functies - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Beveiliging - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Functies - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Functies - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Beveiliging - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Beveiliging - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentatie - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentatie - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Functies - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Functies - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Functies - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Beveiliging - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Functies - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Functies - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Functies - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Functies - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Functies - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Functies - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Functies - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Functies - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Beveiliging - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Functies - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Functies - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Functies - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Functies - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Functies - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Functies - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentatie - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Functies - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/nl/CONTRIBUTING.md b/docs/i18n/nl/CONTRIBUTING.md index c4f98b51dd..ca6e96dde6 100644 --- a/docs/i18n/nl/CONTRIBUTING.md +++ b/docs/i18n/nl/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/nl/README.md b/docs/i18n/nl/README.md index 785745103c..466bb310a3 100644 --- a/docs/i18n/nl/README.md +++ b/docs/i18n/nl/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentatie -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/nl/docs/ARCHITECTURE.md b/docs/i18n/nl/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/nl/docs/ARCHITECTURE.md rename to docs/i18n/nl/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/nl/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/nl/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/nl/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/nl/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/nl/docs/A2A-SERVER.md b/docs/i18n/nl/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/nl/docs/A2A-SERVER.md rename to docs/i18n/nl/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/nl/docs/MCP-SERVER.md b/docs/i18n/nl/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/nl/docs/MCP-SERVER.md rename to docs/i18n/nl/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/nl/docs/FEATURES.md b/docs/i18n/nl/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/nl/docs/FEATURES.md rename to docs/i18n/nl/docs/guides/FEATURES.md diff --git a/docs/i18n/nl/docs/I18N.md b/docs/i18n/nl/docs/guides/I18N.md similarity index 99% rename from docs/i18n/nl/docs/I18N.md rename to docs/i18n/nl/docs/guides/I18N.md index 9fd7cf8177..3dd44035b2 100644 --- a/docs/i18n/nl/docs/I18N.md +++ b/docs/i18n/nl/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/nl/docs/TROUBLESHOOTING.md b/docs/i18n/nl/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/nl/docs/TROUBLESHOOTING.md rename to docs/i18n/nl/docs/guides/TROUBLESHOOTING.md index 3d9b54fd47..17d12ce29c 100644 --- a/docs/i18n/nl/docs/TROUBLESHOOTING.md +++ b/docs/i18n/nl/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/nl/docs/UNINSTALL.md b/docs/i18n/nl/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/nl/docs/UNINSTALL.md rename to docs/i18n/nl/docs/guides/UNINSTALL.md diff --git a/docs/i18n/nl/docs/USER_GUIDE.md b/docs/i18n/nl/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/nl/docs/USER_GUIDE.md rename to docs/i18n/nl/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/nl/docs/COVERAGE_PLAN.md b/docs/i18n/nl/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/nl/docs/COVERAGE_PLAN.md rename to docs/i18n/nl/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/nl/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/nl/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/nl/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/nl/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/nl/docs/RELEASE_CHECKLIST.md b/docs/i18n/nl/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/nl/docs/RELEASE_CHECKLIST.md rename to docs/i18n/nl/docs/ops/RELEASE_CHECKLIST.md index 43e0525388..18744d5607 100644 --- a/docs/i18n/nl/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/nl/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/nl/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/nl/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/nl/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/nl/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/nl/docs/API_REFERENCE.md b/docs/i18n/nl/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/nl/docs/API_REFERENCE.md rename to docs/i18n/nl/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/nl/docs/CLI-TOOLS.md b/docs/i18n/nl/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/nl/docs/CLI-TOOLS.md rename to docs/i18n/nl/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/nl/docs/ENVIRONMENT.md b/docs/i18n/nl/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/nl/docs/ENVIRONMENT.md rename to docs/i18n/nl/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/nl/docs/AUTO-COMBO.md b/docs/i18n/nl/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/nl/docs/AUTO-COMBO.md rename to docs/i18n/nl/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/nl/llm.txt b/docs/i18n/nl/llm.txt index 3ebeb0d797..4eac57ed3c 100644 --- a/docs/i18n/nl/llm.txt +++ b/docs/i18n/nl/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/no/CHANGELOG.md b/docs/i18n/no/CHANGELOG.md index 3f49a01660..7c8a3d4dea 100644 --- a/docs/i18n/no/CHANGELOG.md +++ b/docs/i18n/no/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Sikkerhet +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentasjon + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentasjon - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Sikkerhet - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Sikkerhet - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentasjon - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentasjon - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Sikkerhet - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Sikkerhet - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentasjon - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Sikkerhet - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentasjon - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Sikkerhet - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funksjoner - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Sikkerhet - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funksjoner - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funksjoner - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Sikkerhet - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Sikkerhet - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentasjon - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentasjon - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funksjoner - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funksjoner - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funksjoner - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Sikkerhet - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funksjoner - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funksjoner - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funksjoner - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funksjoner - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funksjoner - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funksjoner - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funksjoner - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funksjoner - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Sikkerhet - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funksjoner - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funksjoner - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funksjoner - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funksjoner - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funksjoner - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funksjoner - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentasjon - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funksjoner - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/no/CONTRIBUTING.md b/docs/i18n/no/CONTRIBUTING.md index a801aeb9dd..5459dfed5a 100644 --- a/docs/i18n/no/CONTRIBUTING.md +++ b/docs/i18n/no/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/no/README.md b/docs/i18n/no/README.md index 9e62629c89..9420865d74 100644 --- a/docs/i18n/no/README.md +++ b/docs/i18n/no/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentasjon -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/no/docs/ARCHITECTURE.md b/docs/i18n/no/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/no/docs/ARCHITECTURE.md rename to docs/i18n/no/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/no/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/no/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/no/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/no/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/no/docs/A2A-SERVER.md b/docs/i18n/no/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/no/docs/A2A-SERVER.md rename to docs/i18n/no/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/no/docs/MCP-SERVER.md b/docs/i18n/no/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/no/docs/MCP-SERVER.md rename to docs/i18n/no/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/no/docs/FEATURES.md b/docs/i18n/no/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/no/docs/FEATURES.md rename to docs/i18n/no/docs/guides/FEATURES.md diff --git a/docs/i18n/no/docs/I18N.md b/docs/i18n/no/docs/guides/I18N.md similarity index 99% rename from docs/i18n/no/docs/I18N.md rename to docs/i18n/no/docs/guides/I18N.md index e4d19f8df8..748bbcc3c4 100644 --- a/docs/i18n/no/docs/I18N.md +++ b/docs/i18n/no/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/no/docs/TROUBLESHOOTING.md b/docs/i18n/no/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/no/docs/TROUBLESHOOTING.md rename to docs/i18n/no/docs/guides/TROUBLESHOOTING.md index e90f23b8c9..7cb3399476 100644 --- a/docs/i18n/no/docs/TROUBLESHOOTING.md +++ b/docs/i18n/no/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/no/docs/UNINSTALL.md b/docs/i18n/no/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/no/docs/UNINSTALL.md rename to docs/i18n/no/docs/guides/UNINSTALL.md diff --git a/docs/i18n/no/docs/USER_GUIDE.md b/docs/i18n/no/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/no/docs/USER_GUIDE.md rename to docs/i18n/no/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/no/docs/COVERAGE_PLAN.md b/docs/i18n/no/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/no/docs/COVERAGE_PLAN.md rename to docs/i18n/no/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/no/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/no/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/no/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/no/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/no/docs/RELEASE_CHECKLIST.md b/docs/i18n/no/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/no/docs/RELEASE_CHECKLIST.md rename to docs/i18n/no/docs/ops/RELEASE_CHECKLIST.md index 025006df1e..19919c4f96 100644 --- a/docs/i18n/no/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/no/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/no/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/no/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/no/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/no/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/no/docs/API_REFERENCE.md b/docs/i18n/no/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/no/docs/API_REFERENCE.md rename to docs/i18n/no/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/no/docs/CLI-TOOLS.md b/docs/i18n/no/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/no/docs/CLI-TOOLS.md rename to docs/i18n/no/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/no/docs/ENVIRONMENT.md b/docs/i18n/no/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/no/docs/ENVIRONMENT.md rename to docs/i18n/no/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/no/docs/AUTO-COMBO.md b/docs/i18n/no/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/no/docs/AUTO-COMBO.md rename to docs/i18n/no/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/no/llm.txt b/docs/i18n/no/llm.txt index ee38a5e616..f6845ae8d3 100644 --- a/docs/i18n/no/llm.txt +++ b/docs/i18n/no/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/phi/CHANGELOG.md b/docs/i18n/phi/CHANGELOG.md index a58c91fb5e..e1f5376827 100644 --- a/docs/i18n/phi/CHANGELOG.md +++ b/docs/i18n/phi/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentasyon + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentasyon - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentasyon - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentasyon - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentasyon - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentasyon - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Mga Tampok - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Mga Tampok - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Mga Tampok - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentasyon - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentasyon - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Mga Tampok - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Mga Tampok - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Mga Tampok - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Mga Tampok - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Mga Tampok - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Mga Tampok - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Mga Tampok - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Mga Tampok - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Mga Tampok - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Mga Tampok - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Mga Tampok - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Mga Tampok - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Mga Tampok - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Mga Tampok - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Mga Tampok - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Mga Tampok - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Mga Tampok - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentasyon - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Mga Tampok - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/phi/CONTRIBUTING.md b/docs/i18n/phi/CONTRIBUTING.md index b776a35afb..e7de589cb4 100644 --- a/docs/i18n/phi/CONTRIBUTING.md +++ b/docs/i18n/phi/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/phi/README.md b/docs/i18n/phi/README.md index b85c193aeb..82149249e4 100644 --- a/docs/i18n/phi/README.md +++ b/docs/i18n/phi/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentasyon -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/phi/docs/ARCHITECTURE.md b/docs/i18n/phi/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/phi/docs/ARCHITECTURE.md rename to docs/i18n/phi/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/phi/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/phi/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/phi/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/phi/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/phi/docs/A2A-SERVER.md b/docs/i18n/phi/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/phi/docs/A2A-SERVER.md rename to docs/i18n/phi/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/phi/docs/MCP-SERVER.md b/docs/i18n/phi/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/phi/docs/MCP-SERVER.md rename to docs/i18n/phi/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/phi/docs/FEATURES.md b/docs/i18n/phi/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/phi/docs/FEATURES.md rename to docs/i18n/phi/docs/guides/FEATURES.md diff --git a/docs/i18n/phi/docs/I18N.md b/docs/i18n/phi/docs/guides/I18N.md similarity index 99% rename from docs/i18n/phi/docs/I18N.md rename to docs/i18n/phi/docs/guides/I18N.md index fbd3ac9fd7..d65bd52e3e 100644 --- a/docs/i18n/phi/docs/I18N.md +++ b/docs/i18n/phi/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/phi/docs/TROUBLESHOOTING.md b/docs/i18n/phi/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/phi/docs/TROUBLESHOOTING.md rename to docs/i18n/phi/docs/guides/TROUBLESHOOTING.md index 48964c3a28..645dbd210d 100644 --- a/docs/i18n/phi/docs/TROUBLESHOOTING.md +++ b/docs/i18n/phi/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/phi/docs/UNINSTALL.md b/docs/i18n/phi/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/phi/docs/UNINSTALL.md rename to docs/i18n/phi/docs/guides/UNINSTALL.md diff --git a/docs/i18n/phi/docs/USER_GUIDE.md b/docs/i18n/phi/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/phi/docs/USER_GUIDE.md rename to docs/i18n/phi/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/phi/docs/COVERAGE_PLAN.md b/docs/i18n/phi/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/phi/docs/COVERAGE_PLAN.md rename to docs/i18n/phi/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/phi/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/phi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/phi/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/phi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/phi/docs/RELEASE_CHECKLIST.md b/docs/i18n/phi/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/phi/docs/RELEASE_CHECKLIST.md rename to docs/i18n/phi/docs/ops/RELEASE_CHECKLIST.md index f480c3a133..da3b33e633 100644 --- a/docs/i18n/phi/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/phi/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/phi/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/phi/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/phi/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/phi/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/phi/docs/API_REFERENCE.md b/docs/i18n/phi/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/phi/docs/API_REFERENCE.md rename to docs/i18n/phi/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/phi/docs/CLI-TOOLS.md b/docs/i18n/phi/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/phi/docs/CLI-TOOLS.md rename to docs/i18n/phi/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/phi/docs/ENVIRONMENT.md b/docs/i18n/phi/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/phi/docs/ENVIRONMENT.md rename to docs/i18n/phi/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/phi/docs/AUTO-COMBO.md b/docs/i18n/phi/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/phi/docs/AUTO-COMBO.md rename to docs/i18n/phi/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/phi/llm.txt b/docs/i18n/phi/llm.txt index 970bc2b780..f61b6eef56 100644 --- a/docs/i18n/phi/llm.txt +++ b/docs/i18n/phi/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/pl/CHANGELOG.md b/docs/i18n/pl/CHANGELOG.md index 0c27ebc757..95c895bb31 100644 --- a/docs/i18n/pl/CHANGELOG.md +++ b/docs/i18n/pl/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Bezpieczeństwo +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentacja + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentacja - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Bezpieczeństwo - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Bezpieczeństwo - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentacja - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentacja - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Bezpieczeństwo - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Bezpieczeństwo - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentacja - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Bezpieczeństwo - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentacja - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Bezpieczeństwo - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funkcje - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Bezpieczeństwo - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funkcje - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funkcje - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Bezpieczeństwo - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Bezpieczeństwo - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentacja - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentacja - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funkcje - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funkcje - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funkcje - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Bezpieczeństwo - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funkcje - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funkcje - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funkcje - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funkcje - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funkcje - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funkcje - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funkcje - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funkcje - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Bezpieczeństwo - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funkcje - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funkcje - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funkcje - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funkcje - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funkcje - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funkcje - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentacja - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funkcje - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/pl/CONTRIBUTING.md b/docs/i18n/pl/CONTRIBUTING.md index 6645c79b33..5522097225 100644 --- a/docs/i18n/pl/CONTRIBUTING.md +++ b/docs/i18n/pl/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/pl/README.md b/docs/i18n/pl/README.md index 06a6f3c00e..37bcec15fa 100644 --- a/docs/i18n/pl/README.md +++ b/docs/i18n/pl/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentacja -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/pl/docs/ARCHITECTURE.md b/docs/i18n/pl/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/pl/docs/ARCHITECTURE.md rename to docs/i18n/pl/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/pl/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/pl/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/pl/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/pl/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/pl/docs/A2A-SERVER.md b/docs/i18n/pl/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/pl/docs/A2A-SERVER.md rename to docs/i18n/pl/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/pl/docs/MCP-SERVER.md b/docs/i18n/pl/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/pl/docs/MCP-SERVER.md rename to docs/i18n/pl/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/pl/docs/FEATURES.md b/docs/i18n/pl/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/pl/docs/FEATURES.md rename to docs/i18n/pl/docs/guides/FEATURES.md diff --git a/docs/i18n/pl/docs/I18N.md b/docs/i18n/pl/docs/guides/I18N.md similarity index 99% rename from docs/i18n/pl/docs/I18N.md rename to docs/i18n/pl/docs/guides/I18N.md index 50b29f62a9..fed5b2efc9 100644 --- a/docs/i18n/pl/docs/I18N.md +++ b/docs/i18n/pl/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/pl/docs/TROUBLESHOOTING.md b/docs/i18n/pl/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/pl/docs/TROUBLESHOOTING.md rename to docs/i18n/pl/docs/guides/TROUBLESHOOTING.md index 602fb51932..03529c71ed 100644 --- a/docs/i18n/pl/docs/TROUBLESHOOTING.md +++ b/docs/i18n/pl/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/pl/docs/UNINSTALL.md b/docs/i18n/pl/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/pl/docs/UNINSTALL.md rename to docs/i18n/pl/docs/guides/UNINSTALL.md diff --git a/docs/i18n/pl/docs/USER_GUIDE.md b/docs/i18n/pl/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/pl/docs/USER_GUIDE.md rename to docs/i18n/pl/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/pl/docs/COVERAGE_PLAN.md b/docs/i18n/pl/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/pl/docs/COVERAGE_PLAN.md rename to docs/i18n/pl/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/pl/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/pl/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pl/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/pl/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pl/docs/RELEASE_CHECKLIST.md b/docs/i18n/pl/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/pl/docs/RELEASE_CHECKLIST.md rename to docs/i18n/pl/docs/ops/RELEASE_CHECKLIST.md index b170aa3341..26fb590869 100644 --- a/docs/i18n/pl/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/pl/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/pl/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/pl/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pl/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/pl/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pl/docs/API_REFERENCE.md b/docs/i18n/pl/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/pl/docs/API_REFERENCE.md rename to docs/i18n/pl/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/pl/docs/CLI-TOOLS.md b/docs/i18n/pl/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/pl/docs/CLI-TOOLS.md rename to docs/i18n/pl/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/pl/docs/ENVIRONMENT.md b/docs/i18n/pl/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/pl/docs/ENVIRONMENT.md rename to docs/i18n/pl/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/pl/docs/AUTO-COMBO.md b/docs/i18n/pl/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/pl/docs/AUTO-COMBO.md rename to docs/i18n/pl/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/pl/llm.txt b/docs/i18n/pl/llm.txt index a2347fabd4..5a7bc054bf 100644 --- a/docs/i18n/pl/llm.txt +++ b/docs/i18n/pl/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/pt-BR/CHANGELOG.md b/docs/i18n/pt-BR/CHANGELOG.md index deb79e3b0d..0b95df31f5 100644 --- a/docs/i18n/pt-BR/CHANGELOG.md +++ b/docs/i18n/pt-BR/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Segurança +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentação + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentação - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Segurança - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Segurança - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentação - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentação - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Segurança - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Segurança - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentação - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Segurança - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentação - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Segurança - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Segurança - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Segurança - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Segurança - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentação - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentação - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Segurança - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Segurança - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentação - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/pt-BR/CLAUDE.md b/docs/i18n/pt-BR/CLAUDE.md index 0d33427f74..be71772ef1 100644 --- a/docs/i18n/pt-BR/CLAUDE.md +++ b/docs/i18n/pt-BR/CLAUDE.md @@ -1,233 +1,401 @@ -# CLAUDE.md — AI Agent Session Bootstrap (Português (Brasil)) +# CLAUDE.md (Português (Brasil)) -🌐 **Languages:** 🇺🇸 [English](../../../CLAUDE.md) · 🇸🇦 [ar](../ar/CLAUDE.md) · 🇧🇬 [bg](../bg/CLAUDE.md) · 🇧🇩 [bn](../bn/CLAUDE.md) · 🇨🇿 [cs](../cs/CLAUDE.md) · 🇩🇰 [da](../da/CLAUDE.md) · 🇩🇪 [de](../de/CLAUDE.md) · 🇪🇸 [es](../es/CLAUDE.md) · 🇮🇷 [fa](../fa/CLAUDE.md) · 🇫🇮 [fi](../fi/CLAUDE.md) · 🇫🇷 [fr](../fr/CLAUDE.md) · 🇮🇳 [gu](../gu/CLAUDE.md) · 🇮🇱 [he](../he/CLAUDE.md) · 🇮🇳 [hi](../hi/CLAUDE.md) · 🇭🇺 [hu](../hu/CLAUDE.md) · 🇮🇩 [id](../id/CLAUDE.md) · 🇮🇹 [it](../it/CLAUDE.md) · 🇯🇵 [ja](../ja/CLAUDE.md) · 🇰🇷 [ko](../ko/CLAUDE.md) · 🇮🇳 [mr](../mr/CLAUDE.md) · 🇲🇾 [ms](../ms/CLAUDE.md) · 🇳🇱 [nl](../nl/CLAUDE.md) · 🇳🇴 [no](../no/CLAUDE.md) · 🇵🇭 [phi](../phi/CLAUDE.md) · 🇵🇱 [pl](../pl/CLAUDE.md) · 🇵🇹 [pt](../pt/CLAUDE.md) · 🇧🇷 [pt-BR](../pt-BR/CLAUDE.md) · 🇷🇴 [ro](../ro/CLAUDE.md) · 🇷🇺 [ru](../ru/CLAUDE.md) · 🇸🇰 [sk](../sk/CLAUDE.md) · 🇸🇪 [sv](../sv/CLAUDE.md) · 🇰🇪 [sw](../sw/CLAUDE.md) · 🇮🇳 [ta](../ta/CLAUDE.md) · 🇮🇳 [te](../te/CLAUDE.md) · 🇹🇭 [th](../th/CLAUDE.md) · 🇹🇷 [tr](../tr/CLAUDE.md) · 🇺🇦 [uk-UA](../uk-UA/CLAUDE.md) · 🇵🇰 [ur](../ur/CLAUDE.md) · 🇻🇳 [vi](../vi/CLAUDE.md) · 🇨🇳 [zh-CN](../zh-CN/CLAUDE.md) +🌐 **Languages:** 🇺🇸 [English](../../../CLAUDE.md) · 🇸🇦 [ar](../ar/CLAUDE.md) · 🇧🇬 [bg](../bg/CLAUDE.md) · 🇧🇩 [bn](../bn/CLAUDE.md) · 🇨🇿 [cs](../cs/CLAUDE.md) · 🇩🇰 [da](../da/CLAUDE.md) · 🇩🇪 [de](../de/CLAUDE.md) · 🇪🇸 [es](../es/CLAUDE.md) · 🇮🇷 [fa](../fa/CLAUDE.md) · 🇫🇮 [fi](../fi/CLAUDE.md) · 🇫🇷 [fr](../fr/CLAUDE.md) · 🇮🇳 [gu](../gu/CLAUDE.md) · 🇮🇱 [he](../he/CLAUDE.md) · 🇮🇳 [hi](../hi/CLAUDE.md) · 🇭🇺 [hu](../hu/CLAUDE.md) · 🇮🇩 [id](../id/CLAUDE.md) · 🇮🇩 [in](../in/CLAUDE.md) · 🇮🇹 [it](../it/CLAUDE.md) · 🇯🇵 [ja](../ja/CLAUDE.md) · 🇰🇷 [ko](../ko/CLAUDE.md) · 🇮🇳 [mr](../mr/CLAUDE.md) · 🇲🇾 [ms](../ms/CLAUDE.md) · 🇳🇱 [nl](../nl/CLAUDE.md) · 🇳🇴 [no](../no/CLAUDE.md) · 🇵🇭 [phi](../phi/CLAUDE.md) · 🇵🇱 [pl](../pl/CLAUDE.md) · 🇵🇹 [pt](../pt/CLAUDE.md) · 🇷🇴 [ro](../ro/CLAUDE.md) · 🇷🇺 [ru](../ru/CLAUDE.md) · 🇸🇰 [sk](../sk/CLAUDE.md) · 🇸🇪 [sv](../sv/CLAUDE.md) · 🇰🇪 [sw](../sw/CLAUDE.md) · 🇮🇳 [ta](../ta/CLAUDE.md) · 🇮🇳 [te](../te/CLAUDE.md) · 🇹🇭 [th](../th/CLAUDE.md) · 🇹🇷 [tr](../tr/CLAUDE.md) · 🇺🇦 [uk-UA](../uk-UA/CLAUDE.md) · 🇵🇰 [ur](../ur/CLAUDE.md) · 🇻🇳 [vi](../vi/CLAUDE.md) · 🇨🇳 [zh-CN](../zh-CN/CLAUDE.md) --- -> Quick-start context for AI coding agents. For deep architecture details, see `AGENTS.md`. -> For contribution workflow, see `CONTRIBUTING.md`. +Este arquivo fornece orientações para Claude Code (claude.ai/code) ao trabalhar com código neste repositório. ## Início Rápido ```bash -npm install # Install deps (auto-generates .env from .env.example) -npm run dev # Dev server at http://localhost:20128 -npm run build # Production build (Next.js 16 standalone) -npm run lint # ESLint (0 errors expected; warnings are pre-existing) -npm run typecheck:core # TypeScript check (should be clean) -npm run typecheck:noimplicit:core # Strict check (no implicit any) -npm run test:coverage # Unit tests + coverage gate (60% min) -npm run check # lint + test combined -npm run check:cycles # Detect circular dependencies +npm install # Instalar dependências (gera automaticamente .env a partir de .env.example) +npm run dev # Servidor de desenvolvimento em http://localhost:20128 +npm run build # Build de produção (Next.js 16 standalone) +npm run lint # ESLint (0 erros esperados; avisos são pré-existentes) +npm run typecheck:core # Verificação TypeScript (deve estar limpo) +npm run typecheck:noimplicit:core # Verificação rigorosa (sem any implícito) +npm run test:coverage # Testes unitários + gate de cobertura (75/75/75/70 — declarações/líneas/funções/branches) +npm run check # lint + teste combinados +npm run check:cycles # Detectar dependências circulares ``` -### Running a Single Test +### Executando Testes ```bash -# Node.js native test runner (most tests) -node --import tsx/esm --test tests/unit/your-file.test.mjs +# Arquivo de teste único (executador de teste nativo do Node.js — a maioria dos testes) +node --import tsx/esm --test tests/unit/your-file.test.ts -# Vitest (MCP server, autoCombo, cache) +# Vitest (servidor MCP, autoCombo, cache) npm run test:vitest + +# Todas as suítes +npm run test:all ``` +Para a matriz completa de testes, veja `CONTRIBUTING.md` → "Executando Testes". Para arquitetura profunda, veja `AGENTS.md`. + --- -## Visão Geral +## Projeto em Resumo -**OmniRoute** — unified AI proxy/router. One endpoint, 100+ LLM providers, auto-fallback. +**OmniRoute** — proxy/router de IA unificado. Um endpoint, 160+ provedores de LLM, fallback automático. -| Layer | Location | Purpose | -| --------------- | ------------------------ | ------------------------------------------ | -| API Routes | `src/app/api/v1/` | Next.js App Router — entry points | -| Handlers | `open-sse/handlers/` | Request processing (chat, embeddings, etc) | -| Executors | `open-sse/executors/` | Provider-specific HTTP dispatch | -| Translators | `open-sse/translator/` | Format conversion (OpenAI↔Claude↔Gemini) | -| Services | `open-sse/services/` | Combo routing, rate limits, caching, etc | -| Database | `src/lib/db/` | SQLite domain modules (22 files) | -| Domain/Policy | `src/domain/` | Policy engine, cost rules, fallback logic | -| MCP Server | `open-sse/mcp-server/` | 25 tools, 3 transports, 10 scopes | -| A2A Server | `src/lib/a2a/` | JSON-RPC 2.0 agent protocol | -| Skills | `src/lib/skills/` | Extensible skill framework | -| Memory | `src/lib/memory/` | Persistent conversational memory | -| UI Components | `src/shared/components/` | React components (Tailwind CSS v4) | -| Provider Consts | `src/shared/constants/` | Provider registry (Zod-validated) | -| Validation | `src/shared/validation/` | Zod v4 schemas | -| Tests | `tests/` | Unit, integration, e2e, security, load | +| Camada | Localização | Propósito | +| ---------------- | ----------------------- | -------------------------------------------------------------------------------- | +| Rotas da API | `src/app/api/v1/` | Next.js App Router — pontos de entrada | +| Manipuladores | `open-sse/handlers/` | Processamento de requisições (chat, embeddings, etc) | +| Executores | `open-sse/executors/` | Dispatch HTTP específico do provedor | +| Tradutores | `open-sse/translator/` | Conversão de formato (OpenAI↔Claude↔Gemini) | +| Transformador | `open-sse/transformer/` | API de Respostas ↔ Completações de Chat | +| Serviços | `open-sse/services/` | Roteamento combinado, limites de taxa, cache, etc | +| Banco de Dados | `src/lib/db/` | Módulos de domínio SQLite (45+ arquivos, 55 migrações) | +| Domínio/Política | `src/domain/` | Motor de políticas, regras de custo, lógica de fallback | +| Servidor MCP | `open-sse/mcp-server/` | 37 ferramentas (30 base + 3 memória + 4 habilidades), 3 transportes, ~13 escopos | +| Servidor A2A | `src/lib/a2a/` | Protocolo de agente JSON-RPC 2.0 | +| Habilidades | `src/lib/skills/` | Estrutura de habilidades extensível | +| Memória | `src/lib/memory/` | Memória conversacional persistente | -### Monorepo Layout - -``` -OmniRoute/ # Root package -├── src/ # Next.js 16 app (TypeScript) -├── open-sse/ # @omniroute/open-sse workspace (streaming engine) -├── electron/ # Desktop app (Electron) -├── tests/ # All test suites -├── docs/ # Documentation -└── bin/ # CLI entry point -``` +Monorepo: `src/` (aplicativo Next.js 16), `open-sse/` (workspace do motor de streaming), `electron/` (aplicativo desktop), `tests/`, `bin/` (ponto de entrada CLI). --- -## Request Pipeline (Abbreviated) +## Pipeline de Requisições ``` -Client → /v1/chat/completions (Next.js route) - → CORS → Zod validation → auth? → policy check → prompt injection guard +Cliente → /v1/chat/completions (rota Next.js) + → CORS → validação Zod → auth? → verificação de política → proteção contra injeção de prompt → handleChatCore() [open-sse/handlers/chatCore.ts] - → cache check → rate limit → combo routing? - → resolveComboTargets() → handleSingleModel() per target + → verificação de cache → limite de taxa → roteamento combinado? + → resolveComboTargets() → handleSingleModel() por alvo → translateRequest() → getExecutor() → executor.execute() → fetch() upstream → retry w/ backoff - → response translation → SSE stream or JSON + → tradução da resposta → stream SSE ou JSON + → Se Responses API: responsesTransformer.ts TransformStream ``` +As rotas da API seguem um padrão consistente: `Rota → pré-vôo CORS → validação de corpo Zod → Autenticação opcional (extractApiKey/isValidApiKey) → aplicação de política de chave da API → delegação de manipulador (open-sse)`. Sem middleware global do Next.js — a interceptação é específica da rota. + +**Roteamento combinado** (`open-sse/services/combo.ts`): 14 estratégias (prioridade, ponderada, preenchimento-primeiro, round-robin, P2C, aleatório, menos-usado, otimizado por custo, ciente de reset, estritamente-aleatório, automático, lkgp, otimizado por contexto, retransmissão de contexto). Cada alvo chama `handleSingleModel()`, que envolve `handleChatCore()` com tratamento de erro por alvo e verificações de disjuntor. Veja `docs/routing/AUTO-COMBO.md` para a pontuação Auto-Combo de 9 fatores e `docs/architecture/RESILIENCE_GUIDE.md` para as 3 camadas de resiliência. + --- -## Key Conventions +## Estado de Execução de Resiliência -### Code Style +OmniRoute possui três mecanismos de falha temporária relacionados, mas distintos. Mantenha seu +escopo separado ao depurar o comportamento de roteamento. Veja o +[diagrama de resiliência de 3 camadas](./docs/diagrams/exported/resilience-3layers.svg) +(fonte: [docs/diagrams/resilience-3layers.mmd](./docs/diagrams/resilience-3layers.mmd)) +para um mapa rápido. -- **2 spaces**, semicolons, double quotes, 100 char width, es5 trailing commas -- **Imports**: external → internal (`@/`, `@omniroute/open-sse`) → relative -- **Naming**: files=camelCase/kebab, components=PascalCase, constants=UPPER_SNAKE +### Disjuntor de Provedor -### Database Access +**Escopo**: provedor inteiro, por exemplo, `glm`, `openai`, `anthropic`. -- **Always** go through `src/lib/db/` domain modules -- **Never** write raw SQL in routes or handlers -- **Never** add logic to `src/lib/localDb.ts` (re-export layer only) -- **Never** barrel-import from `localDb.ts` — import specific `db/` modules -- DB singleton: `getDbInstance()` from `src/lib/db/core.ts` (WAL journaling) -- Migrations: `src/lib/db/migrations/` — 21 versioned SQL files +**Propósito**: parar de enviar tráfego para um provedor que está falhando repetidamente no +nível upstream/serviço, para que um provedor não saudável não atrase cada requisição. -### Error Handling +**Implementação**: -- try/catch with specific error types, log with pino context -- Never swallow errors in SSE streams — use abort signals -- Return proper HTTP status codes (4xx/5xx) +- Classe principal: `src/shared/utils/circuitBreaker.ts` +- Fiação de gate/executação de chat: `src/sse/handlers/chatHelpers.ts`, `src/sse/handlers/chat.ts` +- API de status em tempo de execução: `src/app/api/monitoring/health/route.ts` +- Wrappers compartilhados: `open-sse/services/accountFallback.ts` +- Tabela de estado persistido: `domain_circuit_breakers` + +**Estados**: + +- `CLOSED`: tráfego normal é permitido. +- `OPEN`: provedor está temporariamente bloqueado; chamadores recebem uma resposta de circuito-aberto do provedor + ou o roteamento combinado pula para outro alvo. +- `HALF_OPEN`: o tempo limite de reset expirou; permite uma requisição de teste. Sucesso fecha o + disjuntor, falha o abre novamente. + +**Padrões** (`open-sse/config/constants.ts`): + +- Provedores OAuth: limite `3`, tempo limite de reset `60s`. +- Provedores de chave da API: limite `5`, tempo limite de reset `30s`. +- Provedores locais: limite `2`, tempo limite de reset `15s`. + +Somente estados de falha em nível de provedor devem acionar o disjuntor do provedor: + +```ts +(408, 500, 502, 503, 504); +``` + +Não acione o disjuntor do provedor inteiro para erros normais de conta/chave/modelo como a maioria +dos casos `401`, `403` ou `429`. Esses geralmente pertencem ao cooldown de conexão ou bloqueio de modelo. Um erro genérico de provedor de chave da API `403` deve ser recuperável, a menos que seja classificado +como um erro terminal de provedor/conta. + +O disjuntor usa recuperação preguiçosa, não um temporizador em segundo plano. Quando `OPEN` expira, leituras como `getStatus()`, `canExecute()`, e `getRetryAfterMs()` atualizam o estado para +`HALF_OPEN`, para que painéis e construtores de candidatos de combinação não continuem excluindo um +provedor expirado para sempre. + +### Cooldown de Conexão + +**Escopo**: uma conexão de provedor/conta/chave. + +**Propósito**: pular temporariamente uma chave/conta ruim enquanto permite que outras conexões para +o mesmo provedor continuem atendendo requisições. + +**Implementação**: + +- Caminho de escrita/atualização: `src/sse/services/auth.ts::markAccountUnavailable()` +- Seleção/filtragem de conta: `src/sse/services/auth.ts::getProviderCredentials...` +- Cálculo de cooldown: `open-sse/services/accountFallback.ts::checkFallbackError()` +- Configurações: `src/lib/resilience/settings.ts` + +Campos importantes nas conexões de provedor: + +```ts +rateLimitedUntil; +testStatus: "unavailable"; +lastError; +lastErrorType; +errorCode; +backoffLevel; +``` + +Durante a seleção de conta, uma conexão é pulada enquanto: + +```ts +new Date(rateLimitedUntil).getTime() > Date.now(); +``` + +Cooldowns também são preguiçosos: quando `rateLimitedUntil` está no passado, a conexão se torna +elegível novamente. Ao usar com sucesso, `clearAccountError()` limpa `testStatus`, +`rateLimitedUntil`, campos de erro e `backoffLevel`. + +Comportamento padrão de cooldown de conexão: + +- Cooldown base de OAuth: `5s`. +- Cooldown base de chave da API: `3s`. +- Chave da API `429` deve preferir dicas de retry upstream (`Retry-After`, cabeçalhos de reset, ou + texto de reset analisável) quando disponíveis. +- Falhas recuperáveis repetidas usam backoff exponencial: + +```ts +baseCooldownMs * 2 ** failureIndex; +``` + +O guardião anti-thundering-herd impede que falhas concorrentes na mesma conexão +estendam repetidamente o cooldown ou dobrem o incremento de `backoffLevel`. + +Estados terminais não são cooldowns. `banned`, `expired`, e `credits_exhausted` são +destinados a permanecer indisponíveis até que credenciais/configurações mudem ou um operador os redefina. +Não sobrescreva estados terminais com estado de cooldown transitório. + +### Bloqueio de Modelo + +**Escopo**: provedor + conexão + modelo. + +**Propósito**: evitar desabilitar uma conexão inteira quando apenas um modelo está indisponível ou +com limite de cota para essa conexão. + +Exemplos: + +- Provedores de cota por modelo retornando `429`. +- Provedores locais retornando `404` para um modelo ausente. +- Falhas de permissão de modo/modelo específicas do provedor, como modos Grok selecionados. + +O bloqueio de modelo vive em `open-sse/services/accountFallback.ts` e permite que a mesma +conexão continue atendendo outros modelos. + +### Orientações para Depuração + +- Se todas as chaves para um provedor forem puladas, inspecione tanto o estado do disjuntor do provedor quanto o `rateLimitedUntil`/`testStatus` de cada conexão. +- Se um provedor parecer permanentemente excluído após a janela de reset, verifique se o código + está lendo o `state` bruto em vez de usar `getStatus()`/`canExecute()`. +- Se uma chave de provedor falhar, mas outras devem funcionar, prefira o cooldown de conexão em vez + do disjuntor do provedor. +- Se apenas um modelo falhar, prefira o bloqueio de modelo em vez do cooldown de conexão. +- Se um estado deve se recuperar automaticamente, ele deve ter um timestamp futuro/tempo limite de reset e um + caminho de leitura que atualiza o estado expirado. Status permanentes requerem mudanças manuais de credenciais + ou configuração. + +## Convenções Chave + +### Estilo de Código + +- **2 espaços**, ponto e vírgula, aspas duplas, largura de 100 caracteres, vírgulas finais ES5 (aplicadas pelo lint-staged via Prettier) +- **Imports**: externo → interno (`@/`, `@omniroute/open-sse`) → relativo +- **Nomeação**: arquivos=camelCase/kebab, componentes=PascalCase, constantes=UPPER_SNAKE +- **ESLint**: `no-eval`, `no-implied-eval`, `no-new-func` = erro em todo lugar; `no-explicit-any` = aviso em `open-sse/` e `tests/` +- **TypeScript**: `strict: false`, alvo ES2022, módulo esnext, resolução bundler. Preferir tipos explícitos. + +### Banco de Dados + +- **Sempre** passe pelos módulos de domínio em `src/lib/db/` — **nunca** escreva SQL bruto em rotas ou manipuladores +- **Nunca** adicione lógica em `src/lib/localDb.ts` (apenas camada de re-exportação) +- **Nunca** faça importação em lote de `localDb.ts` — importe módulos específicos de `db/` em vez disso +- Singleton de DB: `getDbInstance()` de `src/lib/db/core.ts` (journaling WAL) +- Migrações: `src/lib/db/migrations/` — arquivos SQL versionados, idempotentes, executados em transações + +### Tratamento de Erros + +- try/catch com tipos de erro específicos, registre com contexto pino +- Nunca oculte erros em streams SSE — use sinais de abortar para limpeza +- Retorne códigos de status HTTP apropriados (4xx/5xx) ### Segurança -- **Never** commit secrets/credentials -- **Never** use `eval()`, `new Function()`, or implied eval -- Validate all inputs with Zod schemas -- Encrypt credentials at rest (AES-256-GCM) +- **Nunca** use `eval()`, `new Function()`, ou eval implícito +- Valide todas as entradas com esquemas Zod +- Criptografe credenciais em repouso (AES-256-GCM) +- Lista de negação de cabeçalhos upstream: `src/shared/constants/upstreamHeaders.ts` — mantenha a sanitização, esquemas Zod e testes unitários alinhados ao editar --- -## Common Modification Scenarios +## Cenários Comuns de Modificação -### Adding a New Provider +### Adicionando um Novo Provedor -1. Register in `src/shared/constants/providers.ts` (Zod-validated at load) -2. Add executor in `open-sse/executors/` if custom logic needed -3. Add translator in `open-sse/translator/` if non-OpenAI format -4. Add OAuth config in `src/lib/oauth/constants/oauth.ts` if OAuth-based -5. Register models in `open-sse/config/providerRegistry.ts` -6. Write tests in `tests/unit/` (registration, translation, error handling) +1. Registre em `src/shared/constants/providers.ts` (validado por Zod ao carregar) +2. Adicione executor em `open-sse/executors/` se lógica personalizada for necessária (estenda `BaseExecutor`) +3. Adicione tradutor em `open-sse/translator/` se formato não for OpenAI +4. Adicione configuração OAuth em `src/lib/oauth/constants/oauth.ts` se baseado em OAuth +5. Registre modelos em `open-sse/config/providerRegistry.ts` +6. Escreva testes em `tests/unit/` -### Adding a New API Route +### Adicionando uma Nova Rota de API -1. Create directory under `src/app/api/v1/your-route/` -2. Create `route.ts` with `GET`/`POST` handlers -3. Follow pattern: CORS → Zod body validation → optional auth → handler delegation -4. Handler goes in `open-sse/handlers/` (import from there, not inline) -5. Add tests +1. Crie diretório em `src/app/api/v1/sua-rota/` +2. Crie `route.ts` com manipuladores `GET`/`POST` +3. Siga o padrão: CORS → validação do corpo Zod → autenticação opcional → delegação de manipulador +4. O manipulador vai em `open-sse/handlers/` (importe de lá, não inline) +5. Adicione testes -### Adding a New DB Module +### Adicionando um Novo Módulo de DB -1. Create `src/lib/db/yourModule.ts` -2. Import `getDbInstance` from `./core.ts` -3. Export CRUD functions for your domain table(s) -4. Add migration in `src/lib/db/migrations/` if new tables needed -5. Re-export from `src/lib/localDb.ts` (add to the re-export list only) -6. Write tests +1. Crie `src/lib/db/seuModulo.ts` — importe `getDbInstance` de `./core.ts` +2. Exporte funções CRUD para sua(s) tabela(s) de domínio +3. Adicione migração em `src/lib/db/migrations/` se novas tabelas forem necessárias +4. Re-exporte de `src/lib/localDb.ts` (adicione apenas à lista de re-exportação) +5. Escreva testes -### Adding a New MCP Tool +### Adicionando uma Nova Ferramenta MCP -1. Add tool definition in `open-sse/mcp-server/tools/` -2. Define Zod input schema + async handler -3. Register in tool set (wired by `createMcpServer()`) -4. Assign to appropriate scope(s) -5. Write tests (tool invocation logged to `mcp_audit` table) +1. Adicione definição da ferramenta em `open-sse/mcp-server/tools/` com esquema de entrada Zod + manipulador assíncrono +2. Registre no conjunto de ferramentas (conectado por `createMcpServer()`) +3. Atribua aos escopos apropriados +4. Escreva testes (invocação da ferramenta registrada na tabela `mcp_audit`) -### Adding a New A2A Skill +### Adicionando uma Nova Habilidade A2A -1. Create skill in `src/lib/a2a/skills/` -2. Skill receives task context (messages, metadata) → returns structured result -3. Register in the DB-backed skill registry -4. Write tests +1. Crie habilidade em `src/lib/a2a/skills/` (5 já existem: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) +2. A habilidade recebe contexto de tarefa (mensagens, metadados) → retorna resultado estruturado +3. Registre em `A2A_SKILL_HANDLERS` em `src/lib/a2a/taskExecution.ts` +4. Exponha em `src/app/.well-known/agent.json/route.ts` (Cartão do Agente) +5. Escreva testes em `tests/unit/` +6. Documente na tabela de habilidades em `docs/frameworks/A2A-SERVER.md` + +### Adicionando um Novo Agente de Nuvem + +1. Crie classe de agente em `src/lib/cloudAgent/agents/` estendendo `CloudAgentBase` (3 já existem: codex-cloud, devin, jules) +2. Implemente `createTask`, `getStatus`, `approvePlan`, `sendMessage`, `listSources` +3. Registre em `src/lib/cloudAgent/registry.ts` +4. Adicione tratamento de OAuth/credenciais se necessário (`src/lib/oauth/providers/`) +5. Testes + documente em `docs/frameworks/CLOUD_AGENT.md` + +### Adicionando um Novo Guardrail / Eval / Habilidade / Evento de Webhook + +- Guardrail: `src/lib/guardrails/` → docs: `docs/security/GUARDRAILS.md` +- Conjunto de Eval: `src/lib/evals/` → docs: `docs/frameworks/EVALS.md` +- Habilidade (sandbox): `src/lib/skills/` → docs: `docs/frameworks/SKILLS.md` +- Evento de Webhook: `src/lib/webhookDispatcher.ts` → docs: `docs/frameworks/WEBHOOKS.md` + +## Documentação de Referência + +Para qualquer alteração não trivial, leia primeiro a análise correspondente: + +| Área | Documento | +| --------------------------------------------------- | ----------------------------------------------------------------- | +| Navegação no repositório | `docs/architecture/REPOSITORY_MAP.md` | +| Arquitetura | `docs/architecture/ARCHITECTURE.md` | +| Referência de engenharia | `docs/architecture/CODEBASE_DOCUMENTATION.md` | +| Auto-Combo (pontuação de 9 fatores, 14 estratégias) | `docs/routing/AUTO-COMBO.md` | +| Resiliência (3 mecanismos) | `docs/architecture/RESILIENCE_GUIDE.md` | +| Repetição de raciocínio | `docs/routing/REASONING_REPLAY.md` | +| Estrutura de habilidades | `docs/frameworks/SKILLS.md` | +| Sistema de memória (FTS5 + Qdrant) | `docs/frameworks/MEMORY.md` | +| Agentes de nuvem | `docs/frameworks/CLOUD_AGENT.md` | +| Guardrails (PII / injeção / visão) | `docs/security/GUARDRAILS.md` | +| Avaliações | `docs/frameworks/EVALS.md` | +| Conformidade / auditoria | `docs/security/COMPLIANCE.md` | +| Webhooks | `docs/frameworks/WEBHOOKS.md` | +| Pipeline de autorização | `docs/architecture/AUTHZ_GUIDE.md` | +| Stealth (TLS / impressão digital) | `docs/security/STEALTH_GUIDE.md` | +| Protocolos de agente (A2A / ACP / Nuvem) | `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md` | +| Servidor MCP | `docs/frameworks/MCP-SERVER.md` | +| Servidor A2A | `docs/frameworks/A2A-SERVER.md` | +| Referência de API + OpenAPI | `docs/reference/API_REFERENCE.md` + `docs/reference/openapi.yaml` | +| Catálogo de provedores (gerado automaticamente) | `docs/reference/PROVIDER_REFERENCE.md` | +| Fluxo de lançamento | `docs/ops/RELEASE_CHECKLIST.md` | --- -## Testing Cheat Sheet +## Testes -| What | Command | -| ----------------------- | ------------------------------------------------------- | -| All tests | `npm run test:all` | -| Unit tests | `npm run test:unit` | -| Single file | `node --import tsx/esm --test tests/unit/file.test.mjs` | -| Vitest (MCP, autoCombo) | `npm run test:vitest` | -| E2E (Playwright) | `npm run test:e2e` | -| Protocol E2E (MCP+A2A) | `npm run test:protocols:e2e` | -| Ecosystem | `npm run test:ecosystem` | -| Coverage gate | `npm run test:coverage` (60% min all metrics) | -| Coverage report | `npm run coverage:report` | +| O que | Comando | +| ----------------------- | ------------------------------------------------------------------------------- | +| Testes unitários | `npm run test:unit` | +| Arquivo único | `node --import tsx/esm --test tests/unit/file.test.ts` | +| Vitest (MCP, autoCombo) | `npm run test:vitest` | +| E2E (Playwright) | `npm run test:e2e` | +| Protocolo E2E (MCP+A2A) | `npm run test:protocols:e2e` | +| Ecossistema | `npm run test:ecosystem` | +| Portão de cobertura | `npm run test:coverage` (75/75/75/70 — declarações/líneas/funções/ramificações) | +| Relatório de cobertura | `npm run coverage:report` | -**PR rule**: If you change production code in `src/`, `open-sse/`, `electron/`, or `bin/`, -you must include or update tests in the same PR. +**Regra de PR**: Se você alterar o código de produção em `src/`, `open-sse/`, `electron/` ou `bin/`, você deve incluir ou atualizar testes no mesmo PR. -**Test layer preference**: unit first → integration (multi-module or DB state) → e2e (UI/workflow only). Encode bug reproductions as automated tests before or alongside the fix. +**Preferência de camada de teste**: unitário primeiro → integração (multi-módulo ou estado do DB) → e2e (somente UI/workflow). Codifique reproduções de bugs como testes automatizados antes ou junto com a correção. + +**Política de cobertura do Copilot**: Quando um PR altera o código de produção e a cobertura está abaixo de 75% (declarações/líneas/funções) ou 70% (ramificações), não apenas relate — adicione ou atualize testes, reexecute o portão de cobertura e, em seguida, peça confirmação. Inclua comandos executados, arquivos de teste alterados e o resultado final da cobertura no relatório do PR. --- -## Git Workflow +## Fluxo de Trabalho do Git ```bash -# Never commit directly to main -git checkout -b feat/your-feature -# ... make changes ... -git commit -m "feat: describe your change" -git push -u origin feat/your-feature +# Nunca faça commit diretamente no main +git checkout -b feat/sua-funcionalidade +git commit -m "feat: descreva sua alteração" +git push -u origin feat/sua-funcionalidade ``` -**Branch prefixes**: `feat/`, `fix/`, `refactor/`, `docs/`, `test/`, `chore/` +**Prefixos de branch**: `feat/`, `fix/`, `refactor/`, `docs/`, `test/`, `chore/` -**Commit format** ([Conventional Commits](https://www.conventionalcommits.org/)): +**Formato de commit** (Commits Convencionais): `feat(db): adicionar circuito de interrupção` — escopos: `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, `memory`, `skills` -``` -feat: add circuit breaker for provider calls -fix: resolve JWT secret validation edge case -docs: update AGENTS.md with pipeline internals -test: add MCP tool unit tests -refactor(db): consolidate rate limit tables -``` +**Ganchos do Husky**: -**Scopes**: `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, -`memory`, `skills`. +- **pre-commit**: lint-staged + `check-docs-sync` + `check:any-budget:t11` +- **pre-push**: `npm run test:unit` --- -## Environment +## Ambiente -- **Runtime**: Node.js ≥18 <24, ES Modules -- **TypeScript**: 5.9, target ES2022, module esnext, resolution bundler -- **Path aliases**: `@/*` → `src/`, `@omniroute/open-sse` → `open-sse/` -- **Default port**: 20128 (API + dashboard on same port) -- **Data directory**: `DATA_DIR` env var, defaults to `~/.omniroute/` -- **Key env vars**: `PORT`, `JWT_SECRET`, `INITIAL_PASSWORD`, `REQUIRE_API_KEY`, `APP_LOG_LEVEL` +- **Tempo de Execução**: Node.js ≥20.20.2 <21 || ≥22.22.2 <23 || ≥24 <25, Módulos ES +- **TypeScript**: 5.9+, alvo ES2022, módulo esnext, resolução bundler +- **Aliases de caminho**: `@/*` → `src/`, `@omniroute/open-sse` → `open-sse/`, `@omniroute/open-sse/*` → `open-sse/*` +- **Porta padrão**: 20128 (API + dashboard na mesma porta) +- **Diretório de dados**: variável de ambiente `DATA_DIR`, padrão para `~/.omniroute/` +- **Principais variáveis de ambiente**: `PORT`, `JWT_SECRET`, `API_KEY_SECRET`, `INITIAL_PASSWORD`, `REQUIRE_API_KEY`, `APP_LOG_LEVEL` +- Configuração: `cp .env.example .env` e então gere `JWT_SECRET` (`openssl rand -base64 48`) e `API_KEY_SECRET` (`openssl rand -hex 32`) --- -## Hard Rules (Never Violate) +## Regras Estritas -1. Never commit secrets or credentials -2. Never add logic to `localDb.ts` -3. Never use `eval()` / `new Function()` / implied eval -4. Never commit directly to `main` -5. Never write raw SQL in routes — use `src/lib/db/` modules -6. Never silently swallow errors in SSE streams -7. Always validate inputs with Zod schemas -8. Always include tests when changing production code -9. Coverage must stay ≥60% (statements, lines, functions, branches) +1. Nunca faça commit de segredos ou credenciais +2. Nunca adicione lógica ao `localDb.ts` +3. Nunca use `eval()` / `new Function()` / eval implícito +4. Nunca faça commit diretamente no `main` +5. Nunca escreva SQL bruto em rotas — use módulos `src/lib/db/` +6. Nunca silenciosamente ignore erros em streams SSE +7. Sempre valide entradas com esquemas Zod +8. Sempre inclua testes ao alterar código de produção +9. A cobertura deve permanecer ≥75% (declarações, linhas, funções) / ≥70% (ramificações). Medido atualmente: ~82%. +10. Nunca contorne ganchos do Husky (`--no-verify`, `--no-gpg-sign`) sem aprovação explícita do operador. diff --git a/docs/i18n/pt-BR/CONTRIBUTING.md b/docs/i18n/pt-BR/CONTRIBUTING.md index 675d966ac9..edb8c7bd71 100644 --- a/docs/i18n/pt-BR/CONTRIBUTING.md +++ b/docs/i18n/pt-BR/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/pt-BR/README.md b/docs/i18n/pt-BR/README.md index 1c31271e86..77e48d0334 100644 --- a/docs/i18n/pt-BR/README.md +++ b/docs/i18n/pt-BR/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentação -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/pt-BR/docs/ARCHITECTURE.md b/docs/i18n/pt-BR/docs/ARCHITECTURE.md deleted file mode 100644 index 25f8bca167..0000000000 --- a/docs/i18n/pt-BR/docs/ARCHITECTURE.md +++ /dev/null @@ -1,891 +0,0 @@ -# OmniRoute Architecture (Português (Brasil)) - -🌐 **Languages:** 🇺🇸 [English](../../../../docs/ARCHITECTURE.md) · 🇸🇦 [ar](../../ar/docs/ARCHITECTURE.md) · 🇧🇬 [bg](../../bg/docs/ARCHITECTURE.md) · 🇧🇩 [bn](../../bn/docs/ARCHITECTURE.md) · 🇨🇿 [cs](../../cs/docs/ARCHITECTURE.md) · 🇩🇰 [da](../../da/docs/ARCHITECTURE.md) · 🇩🇪 [de](../../de/docs/ARCHITECTURE.md) · 🇪🇸 [es](../../es/docs/ARCHITECTURE.md) · 🇮🇷 [fa](../../fa/docs/ARCHITECTURE.md) · 🇫🇮 [fi](../../fi/docs/ARCHITECTURE.md) · 🇫🇷 [fr](../../fr/docs/ARCHITECTURE.md) · 🇮🇳 [gu](../../gu/docs/ARCHITECTURE.md) · 🇮🇱 [he](../../he/docs/ARCHITECTURE.md) · 🇮🇳 [hi](../../hi/docs/ARCHITECTURE.md) · 🇭🇺 [hu](../../hu/docs/ARCHITECTURE.md) · 🇮🇩 [id](../../id/docs/ARCHITECTURE.md) · 🇮🇹 [it](../../it/docs/ARCHITECTURE.md) · 🇯🇵 [ja](../../ja/docs/ARCHITECTURE.md) · 🇰🇷 [ko](../../ko/docs/ARCHITECTURE.md) · 🇮🇳 [mr](../../mr/docs/ARCHITECTURE.md) · 🇲🇾 [ms](../../ms/docs/ARCHITECTURE.md) · 🇳🇱 [nl](../../nl/docs/ARCHITECTURE.md) · 🇳🇴 [no](../../no/docs/ARCHITECTURE.md) · 🇵🇭 [phi](../../phi/docs/ARCHITECTURE.md) · 🇵🇱 [pl](../../pl/docs/ARCHITECTURE.md) · 🇵🇹 [pt](../../pt/docs/ARCHITECTURE.md) · 🇧🇷 [pt-BR](../../pt-BR/docs/ARCHITECTURE.md) · 🇷🇴 [ro](../../ro/docs/ARCHITECTURE.md) · 🇷🇺 [ru](../../ru/docs/ARCHITECTURE.md) · 🇸🇰 [sk](../../sk/docs/ARCHITECTURE.md) · 🇸🇪 [sv](../../sv/docs/ARCHITECTURE.md) · 🇰🇪 [sw](../../sw/docs/ARCHITECTURE.md) · 🇮🇳 [ta](../../ta/docs/ARCHITECTURE.md) · 🇮🇳 [te](../../te/docs/ARCHITECTURE.md) · 🇹🇭 [th](../../th/docs/ARCHITECTURE.md) · 🇹🇷 [tr](../../tr/docs/ARCHITECTURE.md) · 🇺🇦 [uk-UA](../../uk-UA/docs/ARCHITECTURE.md) · 🇵🇰 [ur](../../ur/docs/ARCHITECTURE.md) · 🇻🇳 [vi](../../vi/docs/ARCHITECTURE.md) · 🇨🇳 [zh-CN](../../zh-CN/docs/ARCHITECTURE.md) - ---- - -_Last updated: 2026-04-15_ - -## Executive Summary - -OmniRoute is a local AI routing gateway and dashboard built on Next.js. -It provides a single OpenAI-compatible endpoint (`/v1/*`) and routes traffic across multiple upstream providers with translation, fallback, token refresh, and usage tracking. - -Core capabilities: - -- OpenAI-compatible API surface for CLI/tools (100+ providers, 16 executors) -- Request/response translation across provider formats -- Model combo fallback (multi-model sequence) -- Structured combo steps (`provider + model + connection`) with runtime ordering by `compositeTiers` -- Account-level fallback (multi-account per provider) -- Quota preflight and quota-aware P2C account selection in the main chat path -- OAuth + API-key provider connection management (13 OAuth modules) -- Embedding generation via `/v1/embeddings` (6 providers, 9 models) -- Image generation via `/v1/images/generations` (10+ providers, 20+ models) -- Audio transcription via `/v1/audio/transcriptions` (7 providers) -- Text-to-speech via `/v1/audio/speech` (10 providers) -- Video generation via `/v1/videos/generations` (ComfyUI + SD WebUI) -- Music generation via `/v1/music/generations` (ComfyUI) -- Web search via `/v1/search` (5 providers) -- Moderations via `/v1/moderations` -- Reranking via `/v1/rerank` -- Think tag parsing (`<think>...</think>`) for reasoning models -- Response sanitization for strict OpenAI SDK compatibility -- Role normalization (developer→system, system→user) for cross-provider compatibility -- Structured output conversion (json_schema → Gemini responseSchema) -- Local persistence for providers, keys, aliases, combos, settings, pricing (26 DB modules) -- Usage/cost tracking and request logging -- Optional cloud sync for multi-device/state sync -- IP allowlist/blocklist for API access control -- Thinking budget management (passthrough/auto/custom/adaptive) -- Global system prompt injection -- Session tracking and fingerprinting -- Per-account enhanced rate limiting with provider-specific profiles -- Circuit breaker pattern for provider resilience -- Anti-thundering herd protection with mutex locking -- Signature-based request deduplication cache -- Domain layer: cost rules, fallback policy, lockout policy -- Context Relay: session handoff summaries for account rotation continuity -- Domain state persistence (SQLite write-through cache for fallbacks, budgets, lockouts, circuit breakers) -- Policy engine for centralized request evaluation (lockout → budget → fallback) -- Request telemetry with p50/p95/p99 latency aggregation -- Combo target telemetry and historical combo target health via `combo_execution_key` / `combo_step_id` -- Correlation ID (X-Request-Id) for end-to-end tracing -- Compliance audit logging with opt-out per API key -- Eval framework for LLM quality assurance -- Health dashboard with real-time provider circuit breaker status -- MCP Server (25 tools) with 3 transports (stdio/SSE/Streamable HTTP) -- A2A Server (JSON-RPC 2.0 + SSE) with skills and task lifecycle -- Memory system (extraction, injection, retrieval, summarization) -- Skills system (registry, executor, sandbox, built-in skills) -- MITM proxy with certificate management and DNS handling -- Prompt injection guard middleware -- ACP (Agent Communication Protocol) registry -- Modular OAuth providers (13 individual modules under `src/lib/oauth/providers/`) -- Uninstall/full-uninstall scripts -- OAuth environment repair action -- WebSocket bridge for OpenAI-compatible WS clients (`/v1/ws`) -- Sync token management (issue/revoke, ETag-versioned config bundle download) -- GLM Thinking (`glmt`) first-class provider preset -- Hybrid token counting (provider-side `/messages/count_tokens` with estimation fallback) -- Model alias auto-seeding (30+ cross-proxy dialect normalizations at startup) -- Safe outbound fetch with SSRF guard, private URL blocking, and configurable retry -- Cooldown-aware chat retries with configurable `requestRetry` and `maxRetryIntervalSec` -- Runtime environment validation with Zod at startup -- Compliance audit v2 with pagination, provider CRUD events, and SSRF-blocked validation logging - -Primary runtime model: - -- Next.js app routes under `src/app/api/*` implement both dashboard APIs and compatibility APIs -- A shared SSE/routing core in `src/sse/*` + `open-sse/*` handles provider execution, translation, streaming, fallback, and usage - -## Scope and Boundaries - -### In Scope - -- Local gateway runtime -- Dashboard management APIs -- Provider authentication and token refresh -- Request translation and SSE streaming -- Local state + usage persistence -- Optional cloud sync orchestration - -### Out of Scope - -- Cloud service implementation behind `NEXT_PUBLIC_CLOUD_URL` -- Provider SLA/control plane outside local process -- External CLI binaries themselves (Claude CLI, Codex CLI, etc.) - -## Dashboard Surface (Current) - -Main pages under `src/app/(dashboard)/dashboard/`: - -- `/dashboard` — quick start + provider overview -- `/dashboard/endpoint` — endpoint proxy + MCP + A2A + API endpoint tabs -- `/dashboard/providers` — provider connections and credentials -- `/dashboard/combos` — combo strategies, templates, step-based builder, model routing rules, manual persisted ordering -- `/dashboard/costs` — cost aggregation and pricing visibility -- `/dashboard/analytics` — usage analytics, evaluations, combo target health -- `/dashboard/limits` — quota/rate controls -- `/dashboard/cli-tools` — CLI onboarding, runtime detection, config generation -- `/dashboard/agents` — detected ACP agents + custom agent registration -- `/dashboard/media` — image/video/music playground -- `/dashboard/search-tools` — search provider testing and history -- `/dashboard/health` — uptime, circuit breakers, rate limits, quota-monitored sessions -- `/dashboard/logs` — request/proxy/audit/console logs -- `/dashboard/settings` — system settings tabs (general, routing, combo defaults, etc.) -- `/dashboard/api-manager` — API key lifecycle and model permissions - -## High-Level System Context - -```mermaid -flowchart LR - subgraph Clients[Developer Clients] - C1[Claude Code] - C2[Codex CLI] - C3[OpenClaw / Droid / Cline / Continue / Roo] - C4[Custom OpenAI-compatible clients] - BROWSER[Browser Dashboard] - end - - subgraph Router[OmniRoute Local Process] - API[V1 Compatibility API\n/v1/*] - DASH[Dashboard + Management API\n/api/*] - CORE[SSE + Translation Core\nopen-sse + src/sse] - DB[(storage.sqlite)] - UDB[(usage tables + log artifacts)] - end - - subgraph Upstreams[Upstream Providers] - P1[OAuth Providers\nClaude/Codex/Gemini/Qwen/Qoder/GitHub/Kiro/Cursor/Antigravity] - P2[API Key Providers\nOpenAI/Anthropic/OpenRouter/GLM/Kimi/MiniMax\nDeepSeek/Groq/xAI/Mistral/Perplexity\nTogether/Fireworks/Cerebras/Cohere/NVIDIA] - P3[Compatible Nodes\nOpenAI-compatible / Anthropic-compatible] - end - - subgraph Cloud[Optional Cloud Sync] - CLOUD[Cloud Sync Endpoint\nNEXT_PUBLIC_CLOUD_URL] - end - - C1 --> API - C2 --> API - C3 --> API - C4 --> API - BROWSER --> DASH - - API --> CORE - DASH --> DB - CORE --> DB - CORE --> UDB - - CORE --> P1 - CORE --> P2 - CORE --> P3 - - DASH --> CLOUD -``` - -## Core Runtime Components - -## 1) API and Routing Layer (Next.js App Routes) - -Main directories: - -- `src/app/api/v1/*` and `src/app/api/v1beta/*` for compatibility APIs -- `src/app/api/*` for management/configuration APIs -- Next rewrites in `next.config.mjs` map `/v1/*` to `/api/v1/*` - -Important compatibility routes: - -- `src/app/api/v1/chat/completions/route.ts` -- `src/app/api/v1/messages/route.ts` -- `src/app/api/v1/responses/route.ts` -- `src/app/api/v1/models/route.ts` — includes custom models with `custom: true` -- `src/app/api/v1/embeddings/route.ts` — embedding generation (6 providers) -- `src/app/api/v1/images/generations/route.ts` — image generation (4+ providers incl. Antigravity/Nebius) -- `src/app/api/v1/messages/count_tokens/route.ts` -- `src/app/api/v1/providers/[provider]/chat/completions/route.ts` — dedicated per-provider chat -- `src/app/api/v1/providers/[provider]/embeddings/route.ts` — dedicated per-provider embeddings -- `src/app/api/v1/providers/[provider]/images/generations/route.ts` — dedicated per-provider images -- `src/app/api/v1beta/models/route.ts` -- `src/app/api/v1beta/models/[...path]/route.ts` - -Management domains: - -- Auth/settings: `src/app/api/auth/*`, `src/app/api/settings/*` -- Providers/connections: `src/app/api/providers*` -- Provider nodes: `src/app/api/provider-nodes*` -- Custom models: `src/app/api/provider-models` (GET/POST/DELETE) -- Model catalog: `src/app/api/models/route.ts` (GET) -- Proxy config: `src/app/api/settings/proxy` (GET/PUT/DELETE) + `src/app/api/settings/proxy/test` (POST) -- OAuth: `src/app/api/oauth/*` -- Keys/aliases/combos/pricing: `src/app/api/keys*`, `src/app/api/models/alias`, `src/app/api/combos*`, `src/app/api/pricing` -- Usage: `src/app/api/usage/*` -- Sync/cloud: `src/app/api/sync/*`, `src/app/api/cloud/*` -- CLI tooling helpers: `src/app/api/cli-tools/*` -- IP filter: `src/app/api/settings/ip-filter` (GET/PUT) -- Thinking budget: `src/app/api/settings/thinking-budget` (GET/PUT) -- System prompt: `src/app/api/settings/system-prompt` (GET/PUT) -- Sessions: `src/app/api/sessions` (GET) -- Rate limits: `src/app/api/rate-limits` (GET) -- Resilience: `src/app/api/resilience` (GET/PATCH) — request queue, connection cooldown, provider breaker, wait-for-cooldown config -- Resilience reset: `src/app/api/resilience/reset` (POST) — reset provider breakers -- Cache stats: `src/app/api/cache/stats` (GET/DELETE) -- Telemetry: `src/app/api/telemetry/summary` (GET) -- Budget: `src/app/api/usage/budget` (GET/POST) -- Fallback chains: `src/app/api/fallback/chains` (GET/POST/DELETE) -- Compliance audit: `src/app/api/compliance/audit-log` (GET, with pagination + structured metadata) -- Evals: `src/app/api/evals` (GET/POST), `src/app/api/evals/[suiteId]` (GET) -- Policies: `src/app/api/policies` (GET/POST) -- Sync tokens: `src/app/api/sync/tokens` (GET/POST), `src/app/api/sync/tokens/[id]` (GET/DELETE) -- Config bundle: `src/app/api/sync/bundle` (GET, ETag-versioned snapshot of settings/providers/combos/keys) -- WebSocket: `src/app/api/v1/ws/route.ts` — Upgrade handler for OpenAI-compatible WS clients - -## 2) SSE + Translation Core - -Main flow modules: - -- Entry: `src/sse/handlers/chat.ts` -- Core orchestration: `open-sse/handlers/chatCore.ts` -- Provider execution adapters: `open-sse/executors/*` -- Format detection/provider config: `open-sse/services/provider.ts` -- Model parse/resolve: `src/sse/services/model.ts`, `open-sse/services/model.ts` -- Account fallback logic: `open-sse/services/accountFallback.ts` -- Translation registry: `open-sse/translator/index.ts` -- Stream transformations: `open-sse/utils/stream.ts`, `open-sse/utils/streamHandler.ts` -- Usage extraction/normalization: `open-sse/utils/usageTracking.ts` -- Think tag parser: `open-sse/utils/thinkTagParser.ts` -- Embedding handler: `open-sse/handlers/embeddings.ts` -- Embedding provider registry: `open-sse/config/embeddingRegistry.ts` -- Image generation handler: `open-sse/handlers/imageGeneration.ts` -- Image provider registry: `open-sse/config/imageRegistry.ts` -- Response sanitization: `open-sse/handlers/responseSanitizer.ts` -- Role normalization: `open-sse/services/roleNormalizer.ts` - -Services (business logic): - -- Account selection/scoring: `open-sse/services/accountSelector.ts` -- Context lifecycle management: `open-sse/services/contextManager.ts` -- IP filter enforcement: `open-sse/services/ipFilter.ts` -- Session tracking: `open-sse/services/sessionManager.ts` -- Request deduplication: `open-sse/services/signatureCache.ts` -- System prompt injection: `open-sse/services/systemPrompt.ts` -- Thinking budget management: `open-sse/services/thinkingBudget.ts` -- Wildcard model routing: `open-sse/services/wildcardRouter.ts` -- Rate limit management: `open-sse/services/rateLimitManager.ts` -- Circuit breaker: `open-sse/services/circuitBreaker.ts` -- Context handoff: `open-sse/services/contextHandoff.ts` — handoff summary generation and injection for context-relay strategy -- Codex quota fetcher: `open-sse/services/codexQuotaFetcher.ts` — fetches Codex quota for context-relay handoff decisions -- Cooldown-aware retry: `src/sse/services/cooldownAwareRetry.ts` — per-model cooldown retries with configurable `requestRetry` / `maxRetryIntervalSec` -- Safe outbound fetch: `src/shared/network/safeOutboundFetch.ts` — guarded provider/model fetch with SSRF guard, private-URL blocking, retry, and timeout -- Outbound URL guard: `src/shared/network/outboundUrlGuard.ts` — validates provider URLs against private/localhost CIDR ranges -- Provider request defaults: `open-sse/services/providerRequestDefaults.ts` — provider-level `maxTokens`, `temperature`, `thinkingBudgetTokens` defaults -- GLM provider constants: `open-sse/config/glmProvider.ts` — shared GLM models, quota URLs, GLMT timeout/defaults -- Antigravity upstream: `open-sse/config/antigravityUpstream.ts` — base URL and discovery path constants -- Codex client constants: `open-sse/config/codexClient.ts` — versioned user-agent and client-version values -- Model alias seed: `src/lib/modelAliasSeed.ts` — seeds 30+ cross-proxy dialect aliases at startup - -Domain layer modules: - -- Cost rules/budgets: `src/lib/domain/costRules.ts` -- Fallback policy: `src/lib/domain/fallbackPolicy.ts` -- Combo resolver: `src/lib/domain/comboResolver.ts` -- Lockout policy: `src/lib/domain/lockoutPolicy.ts` -- Policy engine: `src/domain/policyEngine.ts` — centralized lockout → budget → fallback evaluation -- Error codes catalog: `src/lib/domain/errorCodes.ts` -- Request ID: `src/lib/domain/requestId.ts` -- Fetch timeout: `src/lib/domain/fetchTimeout.ts` -- Request telemetry: `src/lib/domain/requestTelemetry.ts` -- Compliance/audit: `src/lib/domain/compliance/index.ts` -- Eval runner: `src/lib/domain/evalRunner.ts` -- Domain state persistence: `src/lib/db/domainState.ts` — SQLite CRUD for fallback chains, budgets, cost history, lockout state, circuit breakers - -OAuth provider modules (13 individual files under `src/lib/oauth/providers/`): - -- Registry index: `src/lib/oauth/providers/index.ts` -- Individual providers: `claude.ts`, `codex.ts`, `gemini.ts`, `antigravity.ts`, `qoder.ts`, `qwen.ts`, `kimi-coding.ts`, `github.ts`, `kiro.ts`, `cursor.ts`, `kilocode.ts`, `cline.ts` -- Thin wrapper: `src/lib/oauth/providers.ts` — re-exports from individual modules - -## 3) Persistence Layer - -Primary state DB (SQLite): - -- Core infra: `src/lib/db/core.ts` (better-sqlite3, migrations, WAL) -- Re-export facade: `src/lib/localDb.ts` (thin compatibility layer for callers) -- file: `${DATA_DIR}/storage.sqlite` (or `$XDG_CONFIG_HOME/omniroute/storage.sqlite` when set, else `~/.omniroute/storage.sqlite`) -- entities (tables + KV namespaces): providerConnections, providerNodes, modelAliases, combos, apiKeys, settings, pricing, **customModels**, **proxyConfig**, **ipFilter**, **thinkingBudget**, **systemPrompt** - -Usage persistence: - -- facade: `src/lib/usageDb.ts` (decomposed modules in `src/lib/usage/*`) -- SQLite tables in `storage.sqlite`: `usage_history`, `call_logs`, `proxy_logs` -- optional file artifacts remain for compatibility/debug (`${DATA_DIR}/log.txt`, `${DATA_DIR}/call_logs/`, `<repo>/logs/...`) -- legacy JSON files are migrated to SQLite by startup migrations when present - -Domain State DB (SQLite): - -- `src/lib/db/domainState.ts` — CRUD operations for domain state -- Tables (created in `src/lib/db/core.ts`): `domain_fallback_chains`, `domain_budgets`, `domain_cost_history`, `domain_lockout_state`, `domain_circuit_breakers` -- Write-through cache pattern: in-memory Maps are authoritative at runtime; mutations are written synchronously to SQLite; state is restored from DB on cold start - -## 4) Auth + Security Surfaces - -- Dashboard cookie auth: `src/proxy.ts`, `src/app/api/auth/login/route.ts` -- API key generation/verification: `src/shared/utils/apiKey.ts` -- Provider secrets persisted in `providerConnections` entries -- Outbound proxy support via `open-sse/utils/proxyFetch.ts` (env vars) and `open-sse/utils/networkProxy.ts` (configurable per-provider or global) -- SSRF / outbound URL guard: `src/shared/network/outboundUrlGuard.ts` — blocks private/loopback/link-local ranges for all provider calls -- Runtime env validation: `src/lib/env/runtimeEnv.ts` — Zod schema for all environment variables, surfaced as startup errors/warnings -- Sync tokens: `src/lib/db/syncTokens.ts` — scoped tokens for config bundle download endpoints; backed by `sync_tokens` SQLite table (migration `024_create_sync_tokens.sql`) -- WebSocket handshake auth: `src/lib/ws/handshake.ts` — validates WS upgrade requests via API key or session cookie - -## 5) Cloud Sync - -- Scheduler init: `src/lib/initCloudSync.ts`, `src/shared/services/initializeCloudSync.ts`, `src/shared/services/modelSyncScheduler.ts` -- Periodic task: `src/shared/services/cloudSyncScheduler.ts` -- Periodic task: `src/shared/services/modelSyncScheduler.ts` -- Control route: `src/app/api/sync/cloud/route.ts` - -## Request Lifecycle (`/v1/chat/completions`) - -```mermaid -sequenceDiagram - autonumber - participant Client as CLI/SDK Client - participant Route as /api/v1/chat/completions - participant Chat as src/sse/handlers/chat - participant Core as open-sse/handlers/chatCore - participant Model as Model Resolver - participant Auth as Credential Selector - participant Exec as Provider Executor - participant Prov as Upstream Provider - participant Stream as Stream Translator - participant Usage as usageDb - - Client->>Route: POST /v1/chat/completions - Route->>Chat: handleChat(request) - Chat->>Model: parse/resolve model or combo - - alt Combo model - Chat->>Chat: iterate combo models (handleComboChat) - end - - Chat->>Auth: getProviderCredentials(provider) - Auth-->>Chat: active account + tokens/api key - - Chat->>Core: handleChatCore(body, modelInfo, credentials) - Core->>Core: detect source format - Core->>Core: translate request to target format - Core->>Exec: execute(provider, transformedBody) - Exec->>Prov: upstream API call - Prov-->>Exec: SSE/JSON response - Exec-->>Core: response + metadata - - alt 401/403 - Core->>Exec: refreshCredentials() - Exec-->>Core: updated tokens - Core->>Exec: retry request - end - - Core->>Stream: translate/normalize stream to client format - Stream-->>Client: SSE chunks / JSON response - - Stream->>Usage: extract usage + persist history/log -``` - -## Combo + Account Fallback Flow - -```mermaid -flowchart TD - A[Incoming model string] --> B{Is combo name?} - B -- Yes --> C[Load combo models sequence] - B -- No --> D[Single model path] - - C --> E[Try model N] - E --> F[Resolve provider/model] - D --> F - - F --> G[Select account credentials] - G --> H{Credentials available?} - H -- No --> I[Return provider unavailable] - H -- Yes --> J[Execute request] - - J --> K{Success?} - K -- Yes --> L[Return response] - K -- No --> M{Fallback-eligible error?} - - M -- No --> N[Return error] - M -- Yes --> O[Mark account unavailable cooldown] - O --> P{Another account for provider?} - P -- Yes --> G - P -- No --> Q{In combo with next model?} - Q -- Yes --> E - Q -- No --> R[Return all unavailable] -``` - -Fallback decisions are driven by `open-sse/services/accountFallback.ts` using status codes and error-message heuristics. Combo routing adds one extra guard: provider-scoped 400s such as upstream content-block and role-validation failures are treated as model-local failures so later combo targets can still run. - -## OAuth Onboarding and Token Refresh Lifecycle - -```mermaid -sequenceDiagram - autonumber - participant UI as Dashboard UI - participant OAuth as /api/oauth/[provider]/[action] - participant ProvAuth as Provider Auth Server - participant DB as localDb - participant Test as /api/providers/[id]/test - participant Exec as Provider Executor - - UI->>OAuth: GET authorize or device-code - OAuth->>ProvAuth: create auth/device flow - ProvAuth-->>OAuth: auth URL or device code payload - OAuth-->>UI: flow data - - UI->>OAuth: POST exchange or poll - OAuth->>ProvAuth: token exchange/poll - ProvAuth-->>OAuth: access/refresh tokens - OAuth->>DB: createProviderConnection(oauth data) - OAuth-->>UI: success + connection id - - UI->>Test: POST /api/providers/[id]/test - Test->>Exec: validate credentials / optional refresh - Exec-->>Test: valid or refreshed token info - Test->>DB: update status/tokens/errors - Test-->>UI: validation result -``` - -Refresh during live traffic is executed inside `open-sse/handlers/chatCore.ts` via executor `refreshCredentials()`. - -## Cloud Sync Lifecycle (Enable / Sync / Disable) - -```mermaid -sequenceDiagram - autonumber - participant UI as Endpoint Page UI - participant Sync as /api/sync/cloud - participant DB as localDb - participant Cloud as External Cloud Sync - participant Claude as ~/.claude/settings.json - - UI->>Sync: POST action=enable - Sync->>DB: set cloudEnabled=true - Sync->>DB: ensure API key exists - Sync->>Cloud: POST /sync/{machineId} (providers/aliases/combos/keys) - Cloud-->>Sync: sync result - Sync->>Cloud: GET /{machineId}/v1/verify - Sync-->>UI: enabled + verification status - - UI->>Sync: POST action=sync - Sync->>Cloud: POST /sync/{machineId} - Cloud-->>Sync: remote data - Sync->>DB: update newer local tokens/status - Sync-->>UI: synced - - UI->>Sync: POST action=disable - Sync->>DB: set cloudEnabled=false - Sync->>Cloud: DELETE /sync/{machineId} - Sync->>Claude: switch ANTHROPIC_BASE_URL back to local (if needed) - Sync-->>UI: disabled -``` - -Periodic sync is triggered by `CloudSyncScheduler` when cloud is enabled. - -## Data Model and Storage Map - -```mermaid -erDiagram - SETTINGS ||--o{ PROVIDER_CONNECTION : controls - PROVIDER_NODE ||--o{ PROVIDER_CONNECTION : backs_compatible_provider - PROVIDER_CONNECTION ||--o{ USAGE_ENTRY : emits_usage - - SETTINGS { - boolean cloudEnabled - number stickyRoundRobinLimit - boolean requireLogin - string password_hash - string fallbackStrategy - json rateLimitDefaults - json providerProfiles - } - - PROVIDER_CONNECTION { - string id - string provider - string authType - string name - number priority - boolean isActive - string apiKey - string accessToken - string refreshToken - string expiresAt - string testStatus - string lastError - string rateLimitedUntil - json providerSpecificData - } - - PROVIDER_NODE { - string id - string type - string name - string prefix - string apiType - string baseUrl - } - - MODEL_ALIAS { - string alias - string targetModel - } - - COMBO { - string id - string name - string[] models - } - - API_KEY { - string id - string name - string key - string machineId - } - - USAGE_ENTRY { - string provider - string model - number prompt_tokens - number completion_tokens - string connectionId - string timestamp - } - - CUSTOM_MODEL { - string id - string name - string providerId - } - - PROXY_CONFIG { - string global - json providers - } - - IP_FILTER { - string mode - string[] allowlist - string[] blocklist - } - - THINKING_BUDGET { - string mode - number customBudget - string effortLevel - } - - SYSTEM_PROMPT { - boolean enabled - string prompt - string position - } -``` - -Physical storage files: - -- primary runtime DB: `${DATA_DIR}/storage.sqlite` -- request log lines: `${DATA_DIR}/log.txt` (compat/debug artifact) -- structured call payload archives: `${DATA_DIR}/call_logs/` -- optional translator/request debug sessions: `<repo>/logs/...` - -## Deployment Topology - -```mermaid -flowchart LR - subgraph LocalHost[Developer Host] - CLI[CLI Tools] - Browser[Dashboard Browser] - end - - subgraph ContainerOrProcess[OmniRoute Runtime] - Next[Next.js Server\nPORT=20128] - Core[SSE Core + Executors] - MainDB[(storage.sqlite)] - UsageDB[(usage tables + log artifacts)] - end - - subgraph External[External Services] - Providers[AI Providers] - SyncCloud[Cloud Sync Service] - end - - CLI --> Next - Browser --> Next - Next --> Core - Next --> MainDB - Core --> MainDB - Core --> UsageDB - Core --> Providers - Next --> SyncCloud -``` - -## Module Mapping (Decision-Critical) - -### Route and API Modules - -- `src/app/api/v1/*`, `src/app/api/v1beta/*`: compatibility APIs -- `src/app/api/v1/providers/[provider]/*`: dedicated per-provider routes (chat, embeddings, images) -- `src/app/api/providers*`: provider CRUD, validation, testing -- `src/app/api/provider-nodes*`: custom compatible node management -- `src/app/api/provider-models`: custom model management (CRUD) -- `src/app/api/models/route.ts`: model catalog API (aliases + custom models) -- `src/app/api/oauth/*`: OAuth/device-code flows -- `src/app/api/keys*`: local API key lifecycle -- `src/app/api/models/alias`: alias management -- `src/app/api/combos*`: fallback combo management -- `src/app/api/pricing`: pricing overrides for cost calculation -- `src/app/api/settings/proxy`: proxy configuration (GET/PUT/DELETE) -- `src/app/api/settings/proxy/test`: outbound proxy connectivity test (POST) -- `src/app/api/usage/*`: usage and logs APIs -- `src/app/api/sync/*` + `src/app/api/cloud/*`: cloud sync and cloud-facing helpers -- `src/app/api/cli-tools/*`: local CLI config writers/checkers -- `src/app/api/settings/ip-filter`: IP allowlist/blocklist (GET/PUT) -- `src/app/api/settings/thinking-budget`: thinking token budget config (GET/PUT) -- `src/app/api/settings/system-prompt`: global system prompt (GET/PUT) -- `src/app/api/sessions`: active session listing (GET) -- `src/app/api/rate-limits`: per-account rate limit status (GET) -- `src/app/api/sync/tokens`: sync token CRUD (GET/POST) -- `src/app/api/sync/tokens/[id]`: sync token get/delete (GET/DELETE) -- `src/app/api/sync/bundle`: config bundle download (GET, ETag versioning) -- `src/app/api/v1/ws`: WebSocket upgrade handler for OpenAI-compatible WS clients - -### Routing and Execution Core - -- `src/sse/handlers/chat.ts`: request parse, combo handling, account selection loop -- `open-sse/handlers/chatCore.ts`: translation, executor dispatch, retry/refresh handling, stream setup -- `open-sse/executors/*`: provider-specific network and format behavior - -### Translation Registry and Format Converters - -- `open-sse/translator/index.ts`: translator registry and orchestration -- Request translators: `open-sse/translator/request/*` -- Response translators: `open-sse/translator/response/*` -- Format constants: `open-sse/translator/formats.ts` - -### Persistence - -- `src/lib/db/*`: persistent config/state and domain persistence on SQLite -- `src/lib/localDb.ts`: compatibility re-export for DB modules -- `src/lib/usageDb.ts`: usage history/call logs facade on top of SQLite tables - -## Provider Executor Coverage (Strategy Pattern) - -Each provider has a specialized executor extending `BaseExecutor` (in `open-sse/executors/base.ts`), which provides URL building, header construction, retry with exponential backoff, credential refresh hooks, and the `execute()` orchestration method. - -| Executor | Provider(s) | Special Handling | -| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -| `DefaultExecutor` | OpenAI, Claude, Gemini, Qwen, OpenRouter, GLM, Kimi, MiniMax, DeepSeek, Groq, xAI, Mistral, Perplexity, Together, Fireworks, Cerebras, Cohere, NVIDIA, etc. | Dynamic URL/header config per provider | -| `AntigravityExecutor` | Google Antigravity | Custom project/session IDs, Retry-After parsing | -| `CliProxyApiExecutor` | CLIProxyAPI-compatible providers | Custom auth and protocol handling | -| `CloudflareAiExecutor` | Cloudflare Workers AI | Account ID injection, Neurons-based usage tracking | -| `CodexExecutor` | OpenAI Codex | Injects system instructions, forces reasoning effort | -| `CursorExecutor` | Cursor IDE | ConnectRPC protocol, Protobuf encoding, request signing via checksum | -| `GithubExecutor` | GitHub Copilot | Copilot token refresh, VSCode-mimicking headers | -| `GeminiCLIExecutor` | Gemini CLI | Google OAuth token refresh cycle | -| `KiroExecutor` | AWS CodeWhisperer/Kiro | AWS EventStream binary format → SSE conversion | -| `OpenCodeExecutor` | OpenCode | AI SDK compatible provider setup | -| `PollinationsExecutor` | Pollinations AI | No API key required, rate-limited requests | -| `PuterExecutor` | Puter | Browser-based provider integration | -| `QoderExecutor` | Qoder AI | PAT and OAuth support, multi-model free tier | -| `VertexExecutor` | Google Vertex AI | Service account auth, region-based endpoints | - -All other providers (including custom compatible nodes) use the `DefaultExecutor`. - -## Provider Compatibility Matrix - -| Provider | Format | Auth | Stream | Non-Stream | Token Refresh | Usage API | -| ---------------- | ---------------- | --------------------- | ---------------- | ---------- | ------------- | ------------------ | -| Claude | claude | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Admin only | -| Gemini | gemini | API Key / OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Gemini CLI | gemini-cli | OAuth | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Antigravity | antigravity | OAuth | ✅ | ✅ | ✅ | ✅ Full quota API | -| OpenAI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Codex | openai-responses | OAuth | ✅ forced | ❌ | ✅ | ✅ Rate limits | -| GitHub Copilot | openai | OAuth + Copilot Token | ✅ | ✅ | ✅ | ✅ Quota snapshots | -| Cursor | cursor | Custom checksum | ✅ | ✅ | ❌ | ❌ | -| Kiro | kiro | AWS SSO OIDC | ✅ (EventStream) | ❌ | ✅ | ✅ Usage limits | -| Qwen | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Per request | -| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Per request | -| Kilo Code | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| Cline | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| Kimi Coding | openai | OAuth | ✅ | ✅ | ✅ | ❌ | -| OpenRouter | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| GLM/Kimi/MiniMax | claude | API Key | ✅ | ✅ | ❌ | ❌ | -| DeepSeek | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Groq | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| xAI (Grok) | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Mistral | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Perplexity | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Together AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Fireworks AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cerebras | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cohere | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| NVIDIA NIM | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Cloudflare AI | openai | API Token + Acct ID | ✅ | ✅ | ❌ | ❌ | -| Pollinations | openai | None (no key) | ✅ | ✅ | ❌ | ❌ | -| Scaleway AI | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| LongCat | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Ollama Cloud | openai | API Key (optional) | ✅ | ✅ | ❌ | ❌ | -| HuggingFace | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Nebius | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| SiliconFlow | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Hyperbolic | openai | API Key | ✅ | ✅ | ❌ | ❌ | -| Vertex AI | gemini | Service Account | ✅ | ✅ | ✅ | ⚠️ Cloud Console | -| Puter | openai | API Key | ✅ | ✅ | ❌ | ❌ | - -## Format Translation Coverage - -Detected source formats include: - -- `openai` -- `openai-responses` -- `claude` -- `gemini` - -Target formats include: - -- OpenAI chat/Responses -- Claude -- Gemini/Gemini-CLI/Antigravity envelope -- Kiro -- Cursor - -Translations use **OpenAI as the hub format** — all conversions go through OpenAI as intermediate: - -``` -Source Format → OpenAI (hub) → Target Format -``` - -Translations are selected dynamically based on source payload shape and provider target format. - -Additional processing layers in the translation pipeline: - -- **Response sanitization** — Strips non-standard fields from OpenAI-format responses (both streaming and non-streaming) to ensure strict SDK compliance -- **Role normalization** — Converts `developer` → `system` for non-OpenAI targets; merges `system` → `user` for models that reject the system role (GLM, ERNIE) -- **Think tag extraction** — Parses `<think>...</think>` blocks from content into `reasoning_content` field -- **Structured output** — Converts OpenAI `response_format.json_schema` to Gemini's `responseMimeType` + `responseSchema` - -## Supported API Endpoints - -| Endpoint | Format | Handler | -| -------------------------------------------------- | ------------------ | ------------------------------------------------------------------- | -| `POST /v1/chat/completions` | OpenAI Chat | `src/sse/handlers/chat.ts` | -| `POST /v1/messages` | Claude Messages | Same handler (auto-detected) | -| `POST /v1/responses` | OpenAI Responses | `open-sse/handlers/responsesHandler.ts` | -| `POST /v1/embeddings` | OpenAI Embeddings | `open-sse/handlers/embeddings.ts` | -| `GET /v1/embeddings` | Model listing | API route | -| `POST /v1/images/generations` | OpenAI Images | `open-sse/handlers/imageGeneration.ts` | -| `GET /v1/images/generations` | Model listing | API route | -| `POST /v1/providers/{provider}/chat/completions` | OpenAI Chat | Dedicated per-provider with model validation | -| `POST /v1/providers/{provider}/embeddings` | OpenAI Embeddings | Dedicated per-provider with model validation | -| `POST /v1/providers/{provider}/images/generations` | OpenAI Images | Dedicated per-provider with model validation | -| `POST /v1/messages/count_tokens` | Claude Token Count | API route | -| `GET /v1/models` | OpenAI Models list | API route (chat + embedding + image + custom models) | -| `GET /api/models/catalog` | Catalog | All models grouped by provider + type | -| `POST /v1beta/models/*:streamGenerateContent` | Gemini native | API route | -| `GET/PUT/DELETE /api/settings/proxy` | Proxy Config | Network proxy configuration | -| `POST /api/settings/proxy/test` | Proxy Connectivity | Proxy health/connectivity test endpoint | -| `GET/POST/DELETE /api/provider-models` | Provider Models | Provider model metadata backing custom and managed available models | - -## Bypass Handler - -The bypass handler (`open-sse/utils/bypassHandler.ts`) intercepts known "throwaway" requests from Claude CLI — warmup pings, title extractions, and token counts — and returns a **fake response** without consuming upstream provider tokens. This is triggered only when `User-Agent` contains `claude-cli`. - -## Request Logging and Artifacts - -The older file-based request logger (`open-sse/utils/requestLogger.ts`) is retained only for -legacy compatibility. The current runtime contract uses: - -- `APP_LOG_TO_FILE=true` for application and audit logs written under `<repo>/logs/` -- SQLite-backed call log records in `call_logs` -- `${DATA_DIR}/call_logs/YYYY-MM-DD/...` artifacts when the call log pipeline is enabled - -## Failure Modes and Resilience - -## 1) Account/Provider Availability - -- connection cooldown on retryable upstream failures -- account fallback before failing request -- combo model fallback when current model/provider path is exhausted - -## 2) Token Expiry - -- pre-check and refresh with retry for refreshable providers -- 401/403 retry after refresh attempt in core path - -## 3) Stream Safety - -- disconnect-aware stream controller -- translation stream with end-of-stream flush and `[DONE]` handling -- usage estimation fallback when provider usage metadata is missing - -## 4) Cloud Sync Degradation - -- sync errors are surfaced but local runtime continues -- scheduler has retry-capable logic, but periodic execution currently calls single-attempt sync by default - -## 5) Data Integrity - -- SQLite schema migrations and auto-upgrade hooks at startup -- legacy JSON → SQLite migration compatibility path - -## 6) SSRF / Outbound URL Guard - -- `src/shared/network/outboundUrlGuard.ts` blocks all private/loopback/link-local target URLs before they reach provider executors -- Provider model discovery and validation routes use `src/shared/network/safeOutboundFetch.ts` which applies the guard before every outbound request -- Guard errors surface as `URL_GUARD_BLOCKED` with HTTP 422 and are logged to the compliance audit trail via `providerAudit.ts` - -## Observability and Operational Signals - -Runtime visibility sources: - -- console logs from `src/sse/utils/logger.ts` -- per-request usage aggregates in SQLite (`usage_history`, `call_logs`, `proxy_logs`) -- four-stage detailed payload captures in SQLite (`request_detail_logs`) when `settings.detailed_logs_enabled=true` -- textual request status log in `log.txt` (optional/compat) -- optional application log files under `logs/` when `APP_LOG_TO_FILE=true` -- optional request artifacts under `${DATA_DIR}/call_logs/` when the call log pipeline is enabled -- dashboard usage endpoints (`/api/usage/*`) for UI consumption - -Detailed request payload capture stores up to four JSON payload stages per routed call: - -- raw request received from the client -- translated request actually sent upstream -- provider response reconstructed as JSON; streamed responses are compacted to the final summary plus stream metadata -- final client response returned by OmniRoute; streamed responses are stored in the same compact summary form - -## Security-Sensitive Boundaries - -- JWT secret (`JWT_SECRET`) secures dashboard session cookie verification/signing -- Initial password bootstrap (`INITIAL_PASSWORD`) should be explicitly configured for first-run provisioning -- API key HMAC secret (`API_KEY_SECRET`) secures generated local API key format -- Provider secrets (API keys/tokens) are persisted in local DB and should be protected at filesystem level -- Cloud sync endpoints rely on API key auth + machine id semantics - -## Environment and Runtime Matrix - -Environment variables actively used by code: - -- App/auth: `JWT_SECRET`, `INITIAL_PASSWORD` -- Storage: `DATA_DIR` -- Compatible node behavior: `ALLOW_MULTI_CONNECTIONS_PER_COMPAT_NODE` -- Optional storage base override (Linux/macOS when `DATA_DIR` unset): `XDG_CONFIG_HOME` -- Security hashing: `API_KEY_SECRET`, `MACHINE_ID_SALT` -- Logging: `APP_LOG_TO_FILE`, `APP_LOG_RETENTION_DAYS`, `CALL_LOG_RETENTION_DAYS` -- Sync/cloud URLing: `NEXT_PUBLIC_BASE_URL`, `NEXT_PUBLIC_CLOUD_URL` -- Outbound proxy: `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY` and lowercase variants -- SOCKS5 feature flags: `ENABLE_SOCKS5_PROXY`, `NEXT_PUBLIC_ENABLE_SOCKS5_PROXY` -- Platform/runtime helpers (not app-specific config): `APPDATA`, `NODE_ENV`, `PORT`, `HOSTNAME` - -## Known Architectural Notes - -1. `usageDb` and `localDb` share the same base directory policy (`DATA_DIR` -> `XDG_CONFIG_HOME/omniroute` -> `~/.omniroute`) with legacy file migration. -2. `/api/v1/route.ts` delegates to the same unified catalog builder used by `/api/v1/models` (`src/app/api/v1/models/catalog.ts`) to avoid semantic drift. -3. Request logger writes full headers/body when enabled; treat log directory as sensitive. -4. Cloud behavior depends on correct `NEXT_PUBLIC_BASE_URL` and cloud endpoint reachability. -5. The `open-sse/` directory is published as the `@omniroute/open-sse` **npm workspace package**. Source code imports it via `@omniroute/open-sse/...` (resolved by Next.js `transpilePackages`). File paths in this document still use the directory name `open-sse/` for consistency. -6. Charts in the dashboard use **Recharts** (SVG-based) for accessible, interactive analytics visualizations (model usage bar charts, provider breakdown tables with success rates). -7. E2E tests use **Playwright** (`tests/e2e/`), run via `npm run test:e2e`. Unit tests use **Node.js test runner** (`tests/unit/`), run via `npm run test:unit`. Source code under `src/` is **TypeScript** (`.ts`/`.tsx`); the `open-sse/` workspace remains JavaScript (`.js`). -8. Settings page is organized into 7 tabs: General, Appearance, AI, Security, Routing, Resilience, Advanced. The Resilience page only configures request queue, connection cooldown, provider breaker, and wait-for-cooldown behavior; live breaker runtime state is shown on the Health page. -9. **Context Relay** strategy (`context-relay`) is split across two layers: `combo.ts` decides if a handoff should be generated, `chat.ts` injects the handoff after account resolution. Handoff data lives in `context_handoffs` SQLite table. This split is intentional because only `chat.ts` knows whether the actual account changed. -10. **Proxy enforcement** is now comprehensive: `tokenHealthCheck.ts` resolves proxy per connection, `/api/providers/validate` uses `runWithProxyContext`, and `proxyFetch.ts` uses `undici.fetch()` to maintain dispatcher compatibility on Node 22. -11. **Node.js runtime policy detection**: `/api/settings/require-login` returns `nodeVersion` and `nodeCompatible` fields. The login page renders a warning banner when the runtime falls outside the supported secure Node.js lines. - -## Operational Verification Checklist - -- Build from source: `npm run build` -- Build Docker image: `docker build -t omniroute .` -- Start service and verify: -- `GET /api/settings` -- `GET /api/v1/models` -- CLI target base URL should be `http://<host>:20128/v1` when `PORT=20128` diff --git a/docs/i18n/pt-BR/docs/architecture/ARCHITECTURE.md b/docs/i18n/pt-BR/docs/architecture/ARCHITECTURE.md new file mode 100644 index 0000000000..a1e555f2d1 --- /dev/null +++ b/docs/i18n/pt-BR/docs/architecture/ARCHITECTURE.md @@ -0,0 +1,1149 @@ +# ARCHITECTURE (Português (Brasil)) + +🌐 **Languages:** 🇺🇸 [English](../../../../architecture/ARCHITECTURE.md) · 🇸🇦 [ar](../../../ar/docs/architecture/ARCHITECTURE.md) · 🇧🇬 [bg](../../../bg/docs/architecture/ARCHITECTURE.md) · 🇧🇩 [bn](../../../bn/docs/architecture/ARCHITECTURE.md) · 🇨🇿 [cs](../../../cs/docs/architecture/ARCHITECTURE.md) · 🇩🇰 [da](../../../da/docs/architecture/ARCHITECTURE.md) · 🇩🇪 [de](../../../de/docs/architecture/ARCHITECTURE.md) · 🇪🇸 [es](../../../es/docs/architecture/ARCHITECTURE.md) · 🇮🇷 [fa](../../../fa/docs/architecture/ARCHITECTURE.md) · 🇫🇮 [fi](../../../fi/docs/architecture/ARCHITECTURE.md) · 🇫🇷 [fr](../../../fr/docs/architecture/ARCHITECTURE.md) · 🇮🇳 [gu](../../../gu/docs/architecture/ARCHITECTURE.md) · 🇮🇱 [he](../../../he/docs/architecture/ARCHITECTURE.md) · 🇮🇳 [hi](../../../hi/docs/architecture/ARCHITECTURE.md) · 🇭🇺 [hu](../../../hu/docs/architecture/ARCHITECTURE.md) · 🇮🇩 [id](../../../id/docs/architecture/ARCHITECTURE.md) · 🇮🇩 [in](../../../in/docs/architecture/ARCHITECTURE.md) · 🇮🇹 [it](../../../it/docs/architecture/ARCHITECTURE.md) · 🇯🇵 [ja](../../../ja/docs/architecture/ARCHITECTURE.md) · 🇰🇷 [ko](../../../ko/docs/architecture/ARCHITECTURE.md) · 🇮🇳 [mr](../../../mr/docs/architecture/ARCHITECTURE.md) · 🇲🇾 [ms](../../../ms/docs/architecture/ARCHITECTURE.md) · 🇳🇱 [nl](../../../nl/docs/architecture/ARCHITECTURE.md) · 🇳🇴 [no](../../../no/docs/architecture/ARCHITECTURE.md) · 🇵🇭 [phi](../../../phi/docs/architecture/ARCHITECTURE.md) · 🇵🇱 [pl](../../../pl/docs/architecture/ARCHITECTURE.md) · 🇵🇹 [pt](../../../pt/docs/architecture/ARCHITECTURE.md) · 🇷🇴 [ro](../../../ro/docs/architecture/ARCHITECTURE.md) · 🇷🇺 [ru](../../../ru/docs/architecture/ARCHITECTURE.md) · 🇸🇰 [sk](../../../sk/docs/architecture/ARCHITECTURE.md) · 🇸🇪 [sv](../../../sv/docs/architecture/ARCHITECTURE.md) · 🇰🇪 [sw](../../../sw/docs/architecture/ARCHITECTURE.md) · 🇮🇳 [ta](../../../ta/docs/architecture/ARCHITECTURE.md) · 🇮🇳 [te](../../../te/docs/architecture/ARCHITECTURE.md) · 🇹🇭 [th](../../../th/docs/architecture/ARCHITECTURE.md) · 🇹🇷 [tr](../../../tr/docs/architecture/ARCHITECTURE.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/architecture/ARCHITECTURE.md) · 🇵🇰 [ur](../../../ur/docs/architecture/ARCHITECTURE.md) · 🇻🇳 [vi](../../../vi/docs/architecture/ARCHITECTURE.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/architecture/ARCHITECTURE.md) + +--- + +--- + +title: "Arquitetura do OmniRoute" +version: 3.8.0 +lastUpdated: 2026-05-13 + +--- + +# Arquitetura do OmniRoute + +🌐 **Idiomas:** 🇺🇸 [English](./ARCHITECTURE.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/architecture/ARCHITECTURE.md) | 🇪🇸 [Español](../i18n/es/docs/architecture/ARCHITECTURE.md) | 🇫🇷 [Français](../i18n/fr/docs/architecture/ARCHITECTURE.md) | 🇮🇹 [Italiano](../i18n/it/docs/architecture/ARCHITECTURE.md) | 🇷🇺 [Русский](../i18n/ru/docs/architecture/ARCHITECTURE.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/architecture/ARCHITECTURE.md) | 🇩🇪 [Deutsch](../i18n/de/docs/architecture/ARCHITECTURE.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/architecture/ARCHITECTURE.md) | 🇹🇭 [ไทย](../i18n/th/docs/architecture/ARCHITECTURE.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/architecture/ARCHITECTURE.md) | 🇸🇦 [العربية](../i18n/ar/docs/architecture/ARCHITECTURE.md) | 🇯🇵 [日本語](../i18n/ja/docs/architecture/ARCHITECTURE.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/architecture/ARCHITECTURE.md) | 🇧🇬 [Български](../i18n/bg/docs/architecture/ARCHITECTURE.md) | 🇩🇰 [Dansk](../i18n/da/docs/architecture/ARCHITECTURE.md) | 🇫🇮 [Suomi](../i18n/fi/docs/architecture/ARCHITECTURE.md) | 🇮🇱 [עברית](../i18n/he/docs/architecture/ARCHITECTURE.md) | 🇭🇺 [Magyar](../i18n/hu/docs/architecture/ARCHITECTURE.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/architecture/ARCHITECTURE.md) | 🇰🇷 [한국어](../i18n/ko/docs/architecture/ARCHITECTURE.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/architecture/ARCHITECTURE.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/architecture/ARCHITECTURE.md) | 🇳🇴 [Norsk](../i18n/no/docs/architecture/ARCHITECTURE.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/architecture/ARCHITECTURE.md) | 🇷🇴 [Română](../i18n/ro/docs/architecture/ARCHITECTURE.md) | 🇵🇱 [Polski](../i18n/pl/docs/architecture/ARCHITECTURE.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/architecture/ARCHITECTURE.md) | 🇸🇪 [Svenska](../i18n/sv/docs/architecture/ARCHITECTURE.md) | 🇵🇭 [Filipino](../i18n/phi/docs/architecture/ARCHITECTURE.md) | 🇨🇿 [Čeština](../i18n/cs/docs/architecture/ARCHITECTURE.md) + +_Última atualização: 2026-05-13_ + +## Resumo Executivo + +OmniRoute é um gateway de roteamento de IA local e um painel construído sobre Next.js. +Ele fornece um único endpoint compatível com OpenAI (`/v1/*`) e roteia o tráfego entre vários provedores upstream com tradução, fallback, atualização de token e rastreamento de uso. + +Principais capacidades: + +- Superfície de API compatível com OpenAI para CLI/ferramentas (177 provedores, 31 executores) +- Tradução de solicitação/resposta entre formatos de provedores +- Fallback de combinação de modelos (sequência de múltiplos modelos) +- Etapas de combinação estruturadas (`provedor + modelo + conexão`) com ordenação em tempo de execução por `compositeTiers` +- Fallback em nível de conta (múltiplas contas por provedor) +- Pré-verificação de cota e seleção de conta P2C ciente da cota no caminho principal do chat +- Gerenciamento de conexão de provedor OAuth + chave de API (14 módulos OAuth) +- Geração de embeddings via `/v1/embeddings` (6 provedores, 9 modelos) +- Geração de imagens via `/v1/images/generations` (10+ provedores, 20+ modelos) +- Transcrição de áudio via `/v1/audio/transcriptions` (7 provedores) +- Texto para fala via `/v1/audio/speech` (10 provedores) +- Geração de vídeo via `/v1/videos/generations` (ComfyUI + SD WebUI) +- Geração de música via `/v1/music/generations` (ComfyUI) +- Pesquisa na web via `/v1/search` (5 provedores) +- Moderações via `/v1/moderations` +- Reclassificação via `/v1/rerank` +- Análise de tags de pensamento (``) para modelos de raciocínio +- Sanitização de resposta para compatibilidade estrita com o SDK da OpenAI +- Normalização de papéis (desenvolvedor→sistema, sistema→usuário) para compatibilidade entre provedores +- Conversão de saída estruturada (json_schema → Gemini responseSchema) +- Persistência local para provedores, chaves, aliases, combinações, configurações, preços (26 módulos de DB) +- Rastreamento de uso/custo e registro de solicitações +- Sincronização em nuvem opcional para sincronização de múltiplos dispositivos/estados +- Lista de permissão/bloqueio de IP para controle de acesso à API +- Gerenciamento de orçamento de pensamento (passagem/automático/customizado/adaptativo) +- Injeção de prompt global +- Rastreamento de sessão e identificação +- Limitação de taxa aprimorada por conta com perfis específicos de provedores +- Padrão de disjuntor para resiliência do provedor +- Proteção contra rebanho de trovão com bloqueio mutex +- Cache de deduplicação de solicitação baseado em assinatura +- Camada de domínio: regras de custo, política de fallback, política de bloqueio +- Context Relay: resumos de transferência de sessão para continuidade de rotação de conta +- Persistência de estado de domínio (cache de gravação SQLite para fallbacks, orçamentos, bloqueios, disjuntores) +- Motor de políticas para avaliação centralizada de solicitações (bloqueio → orçamento → fallback) +- Telemetria de solicitações com agregação de latência p50/p95/p99 +- Telemetria de alvo de combinação e saúde histórica do alvo de combinação via `combo_execution_key` / `combo_step_id` +- ID de correlação (X-Request-Id) para rastreamento de ponta a ponta +- Registro de auditoria de conformidade com opção de exclusão por chave de API +- Framework de avaliação para garantia de qualidade de LLM +- Painel de saúde com status de disjuntor de provedor em tempo real +- Servidor MCP (37 ferramentas) com 3 transportes (stdio/SSE/Streamable HTTP) +- Servidor A2A (JSON-RPC 2.0 + SSE) com habilidades e ciclo de vida de tarefas +- Sistema de memória (extração, injeção, recuperação, sumarização) +- Sistema de habilidades (registro, executor, sandbox, habilidades integradas) +- Proxy MITM com gerenciamento de certificados e manipulação de DNS +- Middleware de proteção contra injeção de prompt +- Pipeline de compressão de prompt com Caveman, RTK, pipelines empilhados, combinações de compressão, pacotes de idiomas e análises +- Registro de ACP (Agent Communication Protocol) +- Provedores OAuth modulares (14 módulos individuais sob `src/lib/oauth/providers/`) +- Scripts de desinstalação/desinstalação completa +- Ação de reparo de ambiente OAuth +- Ponte WebSocket para clientes WS compatíveis com OpenAI (`/v1/ws`) +- Gerenciamento de tokens de sincronização (emissão/revogação, download de pacote de configuração versionado por ETag) +- GLM Thinking (`glmt`) preset de provedor de primeira classe +- Contagem híbrida de tokens (contagem de tokens do lado do provedor `/messages/count_tokens` com fallback de estimativa) +- Auto-semeadura de alias de modelo (30+ normalizações de dialeto cross-proxy na inicialização) +- Busca segura de saída com proteção SSRF, bloqueio de URL privada e retry configurável +- Repetições de chat cientes de cooldown com `requestRetry` e `maxRetryIntervalSec` configuráveis +- Validação do ambiente em tempo de execução com Zod na inicialização +- Auditoria de conformidade v2 com paginação, eventos CRUD de provedores e registro de validação bloqueada por SSRF + +Modelo de execução principal: + +- Rotas de aplicativo Next.js sob `src/app/api/*` implementam tanto APIs de painel quanto APIs de compatibilidade +- Um núcleo compartilhado de SSE/roteamento em `src/sse/*` + `open-sse/*` lida com execução de provedores, tradução, streaming, fallback e uso + +## Diagramas de Referência + +Fontes Mermaid canônicas e controladas por versão para a plataforma v3.8.0 estão em +[`docs/diagrams/`](../diagrams/README.md). Dois são reproduzidos abaixo para orientação; +os demais estão vinculados a seus guias específicos de domínio. + +![Pipeline de requisição (/v1/chat/completions)](../diagrams/exported/request-pipeline.svg) + +> Fonte: [diagrams/request-pipeline.mmd](../diagrams/request-pipeline.mmd) + +![Modelo de resiliência em 3 camadas](../diagrams/exported/resilience-3layers.svg) + +> Fonte: [diagrams/resilience-3layers.mmd](../diagrams/resilience-3layers.mmd) — também vinculado a +> [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) e à referência de resiliência `CLAUDE.md`. + +## Escopo e Limites + +### Dentro do Escopo + +- Tempo de execução do gateway local +- APIs de gerenciamento do painel +- Autenticação de provedor e atualização de token +- Tradução de requisições e streaming SSE +- Persistência de estado local + uso +- Orquestração de sincronização em nuvem opcional + +### Fora do Escopo + +- Implementação de serviço em nuvem por trás de `NEXT_PUBLIC_CLOUD_URL` +- SLA do provedor/plano de controle fora do processo local +- Binaries CLI externas em si (Claude CLI, Codex CLI, etc.) + +## Superfície do Painel (Atual) + +Páginas principais em `src/app/(dashboard)/dashboard/`: + +- `/dashboard` — início rápido + visão geral do provedor +- `/dashboard/endpoint` — proxy de endpoint + MCP + A2A + abas de endpoint API +- `/dashboard/providers` — conexões e credenciais do provedor +- `/dashboard/combos` — estratégias de combo, templates, construtor baseado em etapas, regras de roteamento de modelo, ordenação persistida manual +- `/dashboard/auto-combo` — Motor de Auto Combo: pesos de pontuação, pacotes de modo, predefinições de fábrica virtual, telemetria +- `/dashboard/costs` — agregação de custos e visibilidade de preços +- `/dashboard/analytics` — análises de uso, avaliações, saúde do alvo de combo +- `/dashboard/limits` — controles de cota/taxa +- `/dashboard/cli-tools` — integração CLI, detecção de tempo de execução, geração de configuração +- `/dashboard/agents` — agentes ACP detectados + registro de agente personalizado +- `/dashboard/cloud-agents` — tarefas de agente hospedadas na nuvem (Codex Cloud, Devin, Jules) e ciclo de vida da tarefa +- `/dashboard/skills` — registro de habilidades A2A, execução em sandbox, catálogo de habilidades embutido +- `/dashboard/memory` — inspeção e recuperação de memória conversacional persistente +- `/dashboard/webhooks` — assinaturas de webhook de saída, rotação de segredos, estatísticas de tentativas +- `/dashboard/batch` — submissão de trabalho em lote e progresso +- `/dashboard/cache` — estatísticas de cache de leitura e raciocínio, controles de expulsão +- `/dashboard/playground` — playground de chat interativo contra qualquer combo/modelo configurado +- `/dashboard/changelog` — visualizador de changelog no aplicativo (renderiza `CHANGELOG.md`) +- `/dashboard/system` — diagnósticos de tempo de execução, informações de versão, superfície de validação do ambiente +- `/dashboard/onboarding` — assistente de configuração para primeira execução em novas instalações +- `/dashboard/media` — playground de imagem/vídeo/música +- `/dashboard/search-tools` — teste de provedor de busca e histórico +- `/dashboard/health` — tempo de atividade, disjuntores, limites de taxa, sessões monitoradas por cota +- `/dashboard/logs` — logs de requisição/proxy/auditoria/console +- `/dashboard/settings` — abas de configurações do sistema (geral, roteamento, padrões de combo, etc.) +- `/dashboard/context/caveman` — regras de compressão Caveman, pacotes de idioma, visualização e modo de saída +- `/dashboard/context/rtk` — filtros de saída de comando RTK, visualização e configurações de segurança em tempo de execução +- `/dashboard/context/combos` — pipelines de compressão nomeadas atribuídas a combos de roteamento +- `/dashboard/translator` — inspeção de tradutor e visualização de conversão de formato de requisição +- `/dashboard/audit` — navegador de log de auditoria de conformidade com paginação e metadados estruturados +- `/dashboard/usage` — navegador de uso por requisição vinculado a `usage_history` +- `/dashboard/compression` — análises de compressão, estatísticas e atribuição de pipeline +- `/dashboard/api-manager` — ciclo de vida da chave API e permissões de modelo + +## Contexto do Sistema em Alto Nível + +```mermaid +flowchart LR + subgraph Clients[Clientes Desenvolvedores] + C1[Claude Code] + C2[Codex CLI] + C3[OpenClaw / Droid / Cline / Continue / Roo] + C4[Clientes personalizados compatíveis com OpenAI] + BROWSER[Dashboard do Navegador] + end + + subgraph Router[Processo Local OmniRoute] + API[V1 API de Compatibilidade\n/v1/*] + DASH[Dashboard + API de Gerenciamento\n/api/*] + CORE[Núcleo SSE + Tradução\nopen-sse + src/sse] + DB[(storage.sqlite)] + UDB[(tabelas de uso + artefatos de log)] + end + + subgraph Upstreams[Provedores Upstream] + P1[Provedores OAuth\nClaude/Codex/Gemini/Qwen/Qoder/GitHub/Kiro/Cursor/Antigravity] + P2[Provedores de Chave de API\nOpenAI/Anthropic/OpenRouter/GLM/Kimi/MiniMax\nDeepSeek/Groq/xAI/Mistral/Perplexity\nTogether/Fireworks/Cerebras/Cohere/NVIDIA] + P3[Nós Compatíveis\ncompatíveis com OpenAI / compatíveis com Anthropic] + end + + subgraph Cloud[Síncrono em Nuvem Opcional] + CLOUD[Ponto de Síncrono em Nuvem\nNEXT_PUBLIC_CLOUD_URL] + end + + C1 --> API + C2 --> API + C3 --> API + C4 --> API + BROWSER --> DASH + + API --> CORE + DASH --> DB + CORE --> DB + CORE --> UDB + + CORE --> P1 + CORE --> P2 + CORE --> P3 + + DASH --> CLOUD +``` + +## Componentes Centrais de Execução + +## 1) API e Camada de Roteamento (Rotas do App Next.js) + +Principais diretórios: + +- `src/app/api/v1/*` e `src/app/api/v1beta/*` para APIs de compatibilidade +- `src/app/api/*` para APIs de gerenciamento/configuração +- Reescritas do Next em `next.config.mjs` mapeiam `/v1/*` para `/api/v1/*` + +Rotas de compatibilidade importantes: + +- `src/app/api/v1/chat/completions/route.ts` +- `src/app/api/v1/messages/route.ts` +- `src/app/api/v1/responses/route.ts` +- `src/app/api/v1/models/route.ts` — inclui modelos personalizados com `custom: true` +- `src/app/api/v1/embeddings/route.ts` — geração de embeddings (6 provedores) +- `src/app/api/v1/images/generations/route.ts` — geração de imagens (4+ provedores, incluindo Antigravity/Nebius) +- `src/app/api/v1/messages/count_tokens/route.ts` +- `src/app/api/v1/providers/[provider]/chat/completions/route.ts` — chat dedicado por provedor +- `src/app/api/v1/providers/[provider]/embeddings/route.ts` — embeddings dedicados por provedor +- `src/app/api/v1/providers/[provider]/images/generations/route.ts` — imagens dedicadas por provedor +- `src/app/api/v1beta/models/route.ts` +- `src/app/api/v1beta/models/[...path]/route.ts` + +Domínios de gerenciamento: + +- Auth/configurações: `src/app/api/auth/*`, `src/app/api/settings/*` +- Provedores/conexões: `src/app/api/providers*` +- Nós de provedores: `src/app/api/provider-nodes*` +- Modelos personalizados: `src/app/api/provider-models` (GET/POST/DELETE) +- Catálogo de modelos: `src/app/api/models/route.ts` (GET) +- Configuração de proxy: `src/app/api/settings/proxy` (GET/PUT/DELETE) + `src/app/api/settings/proxy/test` (POST) +- OAuth: `src/app/api/oauth/*` +- Chaves/aliases/combos/preços: `src/app/api/keys*`, `src/app/api/models/alias`, `src/app/api/combos*`, `src/app/api/pricing` +- Uso: `src/app/api/usage/*` +- Síncrono/nuvem: `src/app/api/sync/*`, `src/app/api/cloud/*` +- Ferramentas de CLI: `src/app/api/cli-tools/*` +- Filtro de IP: `src/app/api/settings/ip-filter` (GET/PUT) +- Orçamento de pensamento: `src/app/api/settings/thinking-budget` (GET/PUT) +- Prompt do sistema: `src/app/api/settings/system-prompt` (GET/PUT) +- Compressão: `src/app/api/settings/compression`, `src/app/api/compression/*`, e + `src/app/api/context/*` +- Sessões: `src/app/api/sessions` (GET) +- Limites de taxa: `src/app/api/rate-limits` (GET) +- Resiliência: `src/app/api/resilience` (GET/PATCH) — fila de requisições, cooldown de conexão, quebra de provedor, configuração de espera por cooldown +- Redefinição de resiliência: `src/app/api/resilience/reset` (POST) — redefinir quebras de provedores +- Estatísticas de cache: `src/app/api/cache/stats` (GET/DELETE) +- Telemetria: `src/app/api/telemetry/summary` (GET) +- Orçamento: `src/app/api/usage/budget` (GET/POST) +- Cadeias de fallback: `src/app/api/fallback/chains` (GET/POST/DELETE) +- Auditoria de conformidade: `src/app/api/compliance/audit-log` (GET, com paginação + metadados estruturados) +- Avaliações: `src/app/api/evals` (GET/POST), `src/app/api/evals/[suiteId]` (GET) +- Políticas: `src/app/api/policies` (GET/POST) +- Tokens de síncrono: `src/app/api/sync/tokens` (GET/POST), `src/app/api/sync/tokens/[id]` (GET/DELETE) +- Pacote de configuração: `src/app/api/sync/bundle` (GET, snapshot versionado por ETag de configurações/provedores/combos/chaves) +- WebSocket: `src/app/api/v1/ws/route.ts` — manipulador de upgrade para clientes WS compatíveis com OpenAI + +## 2) SSE + Núcleo de Tradução + +Módulos do fluxo principal: + +- Entrada: `src/sse/handlers/chat.ts` +- Orquestração central: `open-sse/handlers/chatCore.ts` +- Adaptadores de execução do provedor: `open-sse/executors/*` +- Detecção de formato/configuração do provedor: `open-sse/services/provider.ts` +- Análise/resolução de modelo: `src/sse/services/model.ts`, `open-sse/services/model.ts` +- Lógica de fallback de conta: `open-sse/services/accountFallback.ts` +- Registro de tradução: `open-sse/translator/index.ts` +- Transformações de stream: `open-sse/utils/stream.ts`, `open-sse/utils/streamHandler.ts` +- Extração/normalização de uso: `open-sse/utils/usageTracking.ts` +- Analisador de tags de pensamento: `open-sse/utils/thinkTagParser.ts` +- Manipulador de embeddings: `open-sse/handlers/embeddings.ts` +- Registro de provedores de embeddings: `open-sse/config/embeddingRegistry.ts` +- Manipulador de geração de imagem: `open-sse/handlers/imageGeneration.ts` +- Registro de provedores de imagem: `open-sse/config/imageRegistry.ts` +- Sanitização de resposta: `open-sse/handlers/responseSanitizer.ts` +- Normalização de papel: `open-sse/services/roleNormalizer.ts` + +Serviços (lógica de negócios): + +- Seleção/classificação de conta: `open-sse/services/accountSelector.ts` +- Gerenciamento do ciclo de vida do contexto: `open-sse/services/contextManager.ts` +- Aplicação de filtro de IP: `open-sse/services/ipFilter.ts` +- Rastreamento de sessão: `open-sse/services/sessionManager.ts` +- Deduplicação de requisições: `open-sse/services/signatureCache.ts` +- Injeção de prompt do sistema: `open-sse/services/systemPrompt.ts` +- Gerenciamento de orçamento de pensamento: `open-sse/services/thinkingBudget.ts` +- Roteamento de modelo curinga: `open-sse/services/wildcardRouter.ts` +- Gerenciamento de limite de taxa: `open-sse/services/rateLimitManager.ts` +- Disjuntor: `open-sse/services/circuitBreaker.ts` +- Transferência de contexto: `open-sse/services/contextHandoff.ts` — geração e injeção de resumo de transferência para estratégia de retransmissão de contexto +- Compressão: `open-sse/services/compression/*` — compressão proativa antes da tradução do provedor; + inclui regras de Caveman, filtros RTK, pipelines empilhados, combos de compressão, estatísticas e validação +- Recuperador de cota Codex: `open-sse/services/codexQuotaFetcher.ts` — recupera a cota Codex para decisões de transferência de contexto +- Retry ciente de cooldown: `src/sse/services/cooldownAwareRetry.ts` — retries de cooldown por modelo com `requestRetry` / `maxRetryIntervalSec` configuráveis +- Fetch seguro de saída: `src/shared/network/safeOutboundFetch.ts` — fetch protegido de provedor/modelo com proteção SSRF, bloqueio de URL privada, retry e timeout +- Guarda de URL de saída: `src/shared/network/outboundUrlGuard.ts` — valida URLs de provedores contra intervalos CIDR de privado/localhost +- Padrões de requisição do provedor: `open-sse/services/providerRequestDefaults.ts` — padrões de `maxTokens`, `temperature`, `thinkingBudgetTokens` a nível de provedor +- Constantes do provedor GLM: `open-sse/config/glmProvider.ts` — modelos GLM compartilhados, URLs de cota, timeout/padrões GLMT +- Upstream Antigravity: `open-sse/config/antigravityUpstream.ts` — constantes de URL base e caminho de descoberta +- Constantes do cliente Codex: `open-sse/config/codexClient.ts` — valores de user-agent e versão do cliente versionados +- Semente de alias de modelo: `src/lib/modelAliasSeed.ts` — semeia 30+ aliases de dialetos cross-proxy na inicialização + +Módulos da camada de domínio: + +- Regras/orçamentos de custo: `src/lib/domain/costRules.ts` +- Política de fallback: `src/lib/domain/fallbackPolicy.ts` +- Resolvedor de combo: `src/lib/domain/comboResolver.ts` +- Política de bloqueio: `src/lib/domain/lockoutPolicy.ts` +- Motor de políticas: `src/domain/policyEngine.ts` — avaliação centralizada de bloqueio → orçamento → fallback +- Catálogo de códigos de erro: `src/lib/domain/errorCodes.ts` +- ID da requisição: `src/lib/domain/requestId.ts` +- Timeout de fetch: `src/lib/domain/fetchTimeout.ts` +- Telemetria de requisição: `src/lib/domain/requestTelemetry.ts` +- Conformidade/auditoria: `src/lib/domain/compliance/index.ts` +- Executor de eval: `src/lib/domain/evalRunner.ts` +- Persistência do estado do domínio: `src/lib/db/domainState.ts` — CRUD SQLite para cadeias de fallback, orçamentos, histórico de custos, estado de bloqueio, disjuntores + +Módulos do provedor OAuth (14 arquivos individuais sob `src/lib/oauth/providers/`): + +- Índice de registro: `src/lib/oauth/providers/index.ts` +- Provedores individuais: `claude.ts`, `codex.ts`, `gemini.ts`, `antigravity.ts`, `qoder.ts`, `qwen.ts`, `kimi-coding.ts`, `github.ts`, `kiro.ts`, `cursor.ts`, `kilocode.ts`, `cline.ts`, `windsurf.ts`, `gitlab-duo.ts` +- Wrapper fino: `src/lib/oauth/providers.ts` — re-exportações de módulos individuais + +## Subsistemas Principais (v3.8.0) + +### A. Motor de Combinação Automática + +O Motor de Combinação Automática pontua e escolhe dinamicamente os alvos de roteamento no momento da solicitação, em vez de depender de uma definição de combinação estática. Ele alimenta a família de prefixos de modelo `auto/*`. + +- Entrada do motor: `open-sse/services/autoCombo/` (`autoComboEngine.ts`, + `scoringEngine.ts`, `virtualFactory.ts`, `modePacks.ts`) +- Resolvedor: `src/domain/comboResolver.ts` (detecção automática do prefixo `auto/`) +- Painel: `/dashboard/auto-combo` +- Telemetria: tabela SQLite `auto_combo_decisions` + +Principais capacidades: + +- **14 estratégias de roteamento** (prioridade, ponderada, preenchimento primeiro, round-robin, P2C, aleatória, + menos utilizada, otimizada por custo, estritamente aleatória, **automática**, lkgp, otimizada por contexto, + relé de contexto, além de um caminho de fallback) — automática é a adição principal na v3.8.0. +- **Pontuação de 9 fatores**: custo, latência p95, taxa de sucesso, margem de cota, proximidade de bloqueio, + estado do disjuntor, falhas recentes, disponibilidade do modelo e afinidade de tags. +- **Fábrica virtual** materializa combinações efêmeras quando nenhuma combinação nomeada correspondente + existe, buscando candidatos de conexões de provedores ativos e saudáveis. +- **Prefixos automáticos**: `auto/coding`, `auto/cheap`, `auto/fast`, `auto/offline`, + `auto/smart`, `auto/lkgp` — cada um respaldado por um perfil de peso ajustado. +- **4 pacotes de modo**: coding, fast, cheap, smart — enviados como configurações de peso pré-definidas + chamáveis a partir do painel. + +Para detalhes algorítmicos completos (fórmulas de fatores, ajuste de peso), consulte +[`docs/routing/AUTO-COMBO.md`](../routing/AUTO-COMBO.md). + +### B. Agentes de Nuvem + +Os Agentes de Nuvem envolvem plataformas de código-agente hospedadas de terceiros (Codex Cloud, Devin, +Jules) por trás de um ciclo de vida de tarefa uniforme baseado em DB. Todos os pontos finais de criação/inspeção +de tarefas requerem autenticação de gerenciamento. + +- Raiz do módulo: `src/lib/cloudAgent/` (`baseAgent.ts`, `registry.ts`, `api.ts`, + `types.ts`, `db.ts`, além de subdiretórios por agente em `agents/`) +- Implementações por agente: `agents/codex/`, `agents/devin/`, `agents/jules/` +- Pontos finais públicos: `/api/v1/agents/tasks/*` (listar/criar/obter/cancelar) +- Pontos finais de gerenciamento: `/api/cloud/*` (provisionamento, status, lote) +- Painel: `/dashboard/cloud-agents` +- Armazenamento: tabela `cloud_agent_tasks` + +Para detalhes de provisionamento por agente e especificidades do OAuth, consulte +[`docs/frameworks/CLOUD_AGENT.md`](../frameworks/CLOUD_AGENT.md). + +### C. Guardrails + +O módulo de guardrails é uma camada de middleware recarregável que inspeciona solicitações +e respostas em busca de PII, injeção de prompt e conteúdo visual inseguro. Violações +interrompem a solicitação com HTTP **503** mais um código de erro estruturado, permitindo +que chamadores subsequentes tentem novamente ou ramifiquem. + +- Raiz do módulo: `src/lib/guardrails/` (`base.ts`, `registry.ts`, `piiMasker.ts`, + `promptInjection.ts`, `visionBridge.ts`, `visionBridgeHelpers.ts`) +- Recarregamento a quente: o registro observa mudanças de configuração e reconstrói a cadeia no local +- Pontos de conexão: entrada do manipulador de chat, manipulador de geração de imagem, sanitizador de resposta +- Contrato HTTP: violações aparecem como `503` com `error.code = "GUARDRAIL_VIOLATION"` + +Para autoria de regras e ajuste de limiares, consulte +[`docs/security/GUARDRAILS.md`](../security/GUARDRAILS.md). + +### D. Camada de Domínio + +O namespace `src/domain/` centraliza decisões de política para que os manipuladores de rota não +precisem montar a lógica de bloqueio/orçamento/fallback por conta própria. + +- Motor de política: `src/domain/policyEngine.ts` — ponto de entrada único para + avaliação pré-execução (bloqueio → orçamento → ordem de fallback) +- Regras de custo: `src/domain/costRules.ts` +- Política de fallback: `src/domain/fallbackPolicy.ts` +- Política de bloqueio: `src/domain/lockoutPolicy.ts` +- Roteamento baseado em tags: `src/domain/tagRouter.ts` +- Resolvedor de combinação: `src/domain/comboResolver.ts` — resolve nomes de combinação, prefixos auto/\* + e alvos de modelo curinga para planos de execução concretos +- Conector de regras de conexão/modelo: `src/domain/connectionModelRules.ts` +- Instantâneas de disponibilidade do modelo: `src/domain/modelAvailability.ts` +- Rastreamento de expiração de provedores: `src/domain/providerExpiration.ts` +- Cache de cota: `src/domain/quotaCache.ts` +- Estado de degradação: `src/domain/degradation.ts` +- Auditoria de configuração: `src/domain/configAudit.ts` +- Construtor de metadados de resposta OmniRoute: `src/domain/omnirouteResponseMeta.ts` +- Subsistema de avaliação: `src/domain/assessment/` — trabalhos de avaliação periódica + +### E. Pipeline de Autorização + +O pipeline de autorização classifica cada solicitação recebida e aplica a +cadeia de políticas apropriada antes do despacho. + +- Entrada do pipeline: `src/server/authz/pipeline.ts` +- Classificador de solicitações: `src/server/authz/classify.ts` — distingue rotas de compatibilidade pública + de rotas de gerenciamento +- Inventário de rotas públicas: `src/shared/constants/publicApiRoutes.ts` +- Políticas: `src/server/authz/policies/` — predicados compostáveis + (`requireApiKey`, `requireManagement`, `requireFreshAuth`, etc.) +- Utilitários de cabeçalho: `src/server/authz/headers.ts` +- Auxiliar de asserção: `src/server/authz/assertAuth.ts` +- Contexto da solicitação: `src/server/authz/context.ts` + +Rotas públicas vs rotas de gerenciamento são uma fronteira rígida: APIs de agente/cooldown e +mutações de provedores requerem autenticação de gerenciamento (HTTP 401 se ausente). + +Para as regras completas de classificação de rotas, consulte +[`docs/architecture/AUTHZ_GUIDE.md`](./AUTHZ_GUIDE.md). + +### F. FSM de Workflow e Roteador Consciente de Tarefas + +Um roteador impulsionado por máquina de estados finitos, posicionado acima da seleção de combinações para direcionar +o tráfego com base na fase de workflow detectada (planejamento, execução, +revisão) e afinidade de tarefas em segundo plano. + +- FSM de Workflow: `open-sse/services/workflowFSM.ts` +- Roteador consciente de tarefas: `open-sse/services/taskAwareRouter.ts` +- Detector de tarefas em segundo plano: `open-sse/services/backgroundTaskDetector.ts` +- Classificador de intenção: `open-sse/services/intentClassifier.ts` + +As transições da FSM alimentam a pontuação do Motor de Combinação Automática, tendendo a modelos mais baratos +para tarefas de background/automação e a modelos mais fortes para turnos interativos de planejamento/revisão. + +### G. Resiliência Específica do Provedor + +Vários provedores enviam módulos dedicados de resiliência e furtividade que se aproveitam das +camadas globais de disjuntor / cooldown de conexão / bloqueio de modelo: + +- Motor Antigravidade 429: `open-sse/services/antigravity429Engine.ts` (rotaciona + identidade, limpa cabeçalhos de resposta, controla créditos/rastreamento de versão via + `antigravityCredits.ts`, `antigravityHeaderScrub.ts`, `antigravityHeaders.ts`, + `antigravityIdentity.ts`, `antigravityObfuscation.ts`, `antigravityVersion.ts`) +- Política de cota ModelScope: `open-sse/services/modelscopePolicy.ts` +- CCH de Código Claude (Handshake de Canal de Compatibilidade): `open-sse/services/claudeCodeCCH.ts`, + além de `claudeCodeCompatible.ts`, `claudeCodeConstraints.ts`, `claudeCodeExtraRemap.ts`, + `claudeCodeToolRemapper.ts` +- Modelagem de impressão digital de Código Claude: `open-sse/services/claudeCodeFingerprint.ts` +- Ofuscação de Código Claude: `open-sse/services/claudeCodeObfuscation.ts` +- Cliente TLS do ChatGPT: `open-sse/services/chatgptTlsClient.ts` (estilo curl-impersonate + para sessões do ChatGPT-Web) +- Cache de imagem do ChatGPT: `open-sse/services/chatgptImageCache.ts` + +Para o guia completo de furtividade e orientações operacionais, consulte +[`docs/security/STEALTH_GUIDE.md`](../security/STEALTH_GUIDE.md). + +### H. Webhooks, Cache de Raciocínio, Cache de Leitura + +- **Webhooks** — despacho de saída para eventos de provedor/conta/tarefa. + - Despachante: `src/lib/webhookDispatcher.ts` + - Armazenamento: tabela SQLite `webhooks` (via `src/lib/db/webhooks.ts`) + - Painel: `/dashboard/webhooks` (assinaturas, segredos, histórico de tentativas) + - Para taxonomia de eventos e semântica de tentativas, consulte [`docs/frameworks/WEBHOOKS.md`](../frameworks/WEBHOOKS.md). +- **Cache de Raciocínio** — blocos de raciocínio reproduzíveis para provedores que emitem + tokens de pensamento (Claude, GLMT, etc.) para que turnos consecutivos possam pular o re-pensamento. + - Camada de DB: `src/lib/db/reasoningCache.ts` + - Camada de serviço: `open-sse/services/reasoningCache.ts` + - Para semântica de reprodução, consulte [`docs/routing/REASONING_REPLAY.md`](../routing/REASONING_REPLAY.md). +- **Cache de Leitura** — cache de resposta de curta duração indexado por assinatura e usado para + colapsar tentativas idênticas de SDKs upstream quebrados. + - Camada de DB: `src/lib/db/readCache.ts` + - Endpoint de estatísticas: `GET /api/cache/stats`, painel em `/dashboard/cache` + +## 3) Camada de Persistência + +Banco de dados de estado primário (SQLite): + +- Infraestrutura principal: `src/lib/db/core.ts` (better-sqlite3, migrações, WAL) +- Fachada de re-exportação: `src/lib/localDb.ts` (camada de compatibilidade fina para chamadores) +- arquivo: `${DATA_DIR}/storage.sqlite` (ou `$XDG_CONFIG_HOME/omniroute/storage.sqlite` quando definido, caso contrário `~/.omniroute/storage.sqlite`) +- entidades (tabelas + namespaces KV): providerConnections, providerNodes, modelAliases, combos, apiKeys, settings, pricing, **customModels**, **proxyConfig**, **ipFilter**, **thinkingBudget**, **systemPrompt** + +Persistência de uso: + +- fachada: `src/lib/usageDb.ts` (módulos decompostos em `src/lib/usage/*`) +- tabelas SQLite em `storage.sqlite`: `usage_history`, `call_logs`, `proxy_logs` +- artefatos de arquivo opcionais permanecem para compatibilidade/debug (`${DATA_DIR}/log.txt`, `${DATA_DIR}/call_logs/`, `<repo>/logs/...`) +- arquivos JSON legados são migrados para SQLite por migrações de inicialização quando presentes + +Banco de dados de estado de domínio (SQLite): + +- `src/lib/db/domainState.ts` — operações CRUD para estado de domínio +- Tabelas (criadas em `src/lib/db/core.ts`): `domain_fallback_chains`, `domain_budgets`, `domain_cost_history`, `domain_lockout_state`, `domain_circuit_breakers` +- Padrão de cache write-through: Maps em memória são autoritativos em tempo de execução; mutações são escritas de forma síncrona no SQLite; estado é restaurado do DB na inicialização a frio + +## 4) Superfícies de Autenticação + Segurança + +- Autenticação de cookie do painel: `src/proxy.ts`, `src/app/api/auth/login/route.ts` +- Geração/verificação de chave de API: `src/shared/utils/apiKey.ts` +- Segredos do provedor persistidos nas entradas de `providerConnections` +- Suporte a proxy de saída via `open-sse/utils/proxyFetch.ts` (variáveis de ambiente) e `open-sse/utils/networkProxy.ts` (configurável por provedor ou global) +- Proteção SSRF / URL de saída: `src/shared/network/outboundUrlGuard.ts` — bloqueia intervalos privados/loopback/link-local para todas as chamadas de provedor +- Validação do ambiente em tempo de execução: `src/lib/env/runtimeEnv.ts` — esquema Zod para todas as variáveis de ambiente, exibido como erros/avisos de inicialização +- Tokens de sincronização: `src/lib/db/syncTokens.ts` — tokens escopados para endpoints de download de pacotes de configuração; respaldados pela tabela SQLite `sync_tokens` (migração `024_create_sync_tokens.sql`) +- Autenticação de handshake WebSocket: `src/lib/ws/handshake.ts` — valida solicitações de upgrade WS via chave de API ou cookie de sessão + +## 5) Sincronização na Nuvem + +- Inicialização do agendador: `src/lib/initCloudSync.ts`, `src/shared/services/initializeCloudSync.ts`, `src/shared/services/modelSyncScheduler.ts` +- Tarefa periódica: `src/shared/services/cloudSyncScheduler.ts` +- Tarefa periódica: `src/shared/services/modelSyncScheduler.ts` +- Rota de controle: `src/app/api/sync/cloud/route.ts` + +## Ciclo de Vida da Solicitação (`/v1/chat/completions`) + +```mermaid +sequenceDiagram + autonumber + participant Client as CLI/SDK Client + participant Route as /api/v1/chat/completions + participant Chat as src/sse/handlers/chat + participant Core as open-sse/handlers/chatCore + participant Model as Model Resolver + participant Auth as Credential Selector + participant Exec as Provider Executor + participant Prov as Upstream Provider + participant Stream as Stream Translator + participant Usage as usageDb + + Client->>Route: POST /v1/chat/completions + Route->>Chat: handleChat(request) + Chat->>Model: parse/resolve model or combo + + alt Combo model + Chat->>Chat: iterate combo models (handleComboChat) + end + + Chat->>Auth: getProviderCredentials(provider) + Auth-->>Chat: active account + tokens/api key + + Chat->>Core: handleChatCore(body, modelInfo, credentials) + Core->>Core: detect source format + Core->>Core: translate request to target format + Core->>Exec: execute(provider, transformedBody) + Exec->>Prov: upstream API call + Prov-->>Exec: SSE/JSON response + Exec-->>Core: response + metadata + + alt 401/403 + Core->>Exec: refreshCredentials() + Exec-->>Core: updated tokens + Core->>Exec: retry request + end + + Core->>Stream: translate/normalize stream to client format + Stream-->>Client: SSE chunks / JSON response + + Stream->>Usage: extract usage + persist history/log +``` + +## Fluxo de Fallback de Combo + Conta + +```mermaid +flowchart TD + A[Modelo de string de entrada] --> B{É nome de combo?} + B -- Sim --> C[Carregar sequência de modelos de combo] + B -- Não --> D[Caminho de modelo único] + + C --> E[Tentar modelo N] + E --> F[Resolver provedor/modelo] + D --> F + + F --> G[Selecionar credenciais da conta] + G --> H{Credenciais disponíveis?} + H -- Não --> I[Retornar provedor indisponível] + H -- Sim --> J[Executar solicitação] + + J --> K{Sucesso?} + K -- Sim --> L[Retornar resposta] + K -- Não --> M{Erro elegível para fallback?} + + M -- Não --> N[Retornar erro] + M -- Sim --> O[Marcar cooldown de conta indisponível] + O --> P{Outra conta para o provedor?} + P -- Sim --> G + P -- Não --> Q{Em combo com o próximo modelo?} + Q -- Sim --> E + Q -- Não --> R[Retornar todas indisponíveis] +``` + +As decisões de fallback são impulsionadas por `open-sse/services/accountFallback.ts` usando códigos de status e heurísticas de mensagens de erro. O roteamento de combo adiciona uma proteção extra: 400s específicos do provedor, como bloqueio de conteúdo upstream e falhas de validação de função, são tratados como falhas locais do modelo para que os alvos de combo posteriores ainda possam ser executados. + +## Ciclo de Vida de Onboarding OAuth e Atualização de Token + +```mermaid +sequenceDiagram + autonumber + participant UI as UI do Dashboard + participant OAuth as /api/oauth/[provedor]/[ação] + participant ProvAuth as Servidor de Autenticação do Provedor + participant DB as localDb + participant Test as /api/providers/[id]/test + participant Exec as Executor do Provedor + + UI->>OAuth: GET autorizar ou código de dispositivo + OAuth->>ProvAuth: criar fluxo de auth/dispositivo + ProvAuth-->>OAuth: URL de auth ou payload de código de dispositivo + OAuth-->>UI: dados do fluxo + + UI->>OAuth: POST trocar ou consultar + OAuth->>ProvAuth: troca de token/consulta + ProvAuth-->>OAuth: tokens de acesso/atualização + OAuth->>DB: createProviderConnection(dados oauth) + OAuth-->>UI: sucesso + id da conexão + + UI->>Test: POST /api/providers/[id]/test + Test->>Exec: validar credenciais / atualização opcional + Exec-->>Test: informações de token válidas ou atualizadas + Test->>DB: atualizar status/tokens/erros + Test-->>UI: resultado da validação +``` + +A atualização durante o tráfego ao vivo é executada dentro de `open-sse/handlers/chatCore.ts` via executor `refreshCredentials()`. + +## Ciclo de Vida de Sincronização na Nuvem (Habilitar / Sincronizar / Desabilitar) + +```mermaid +sequenceDiagram + autonumber + participant UI as UI da Página de Endpoint + participant Sync as /api/sync/cloud + participant DB as localDb + participant Cloud as Sincronização Externa na Nuvem + participant Claude as ~/.claude/settings.json + + UI->>Sync: POST ação=habilitar + Sync->>DB: definir cloudEnabled=true + Sync->>DB: garantir que a chave da API exista + Sync->>Cloud: POST /sync/{machineId} (provedores/aliases/combos/chaves) + Cloud-->>Sync: resultado da sincronização + Sync->>Cloud: GET /{machineId}/v1/verify + Sync-->>UI: habilitado + status de verificação + + UI->>Sync: POST ação=sincronizar + Sync->>Cloud: POST /sync/{machineId} + Cloud-->>Sync: dados remotos + Sync->>DB: atualizar tokens/status locais mais novos + Sync-->>UI: sincronizado + + UI->>Sync: POST ação=desabilitar + Sync->>DB: definir cloudEnabled=false + Sync->>Cloud: DELETE /sync/{machineId} + Sync->>Claude: mudar ANTHROPIC_BASE_URL de volta para local (se necessário) + Sync-->>UI: desabilitado +``` + +A sincronização periódica é acionada por `CloudSyncScheduler` quando a nuvem está habilitada. + +## Modelo de Dados e Mapa de Armazenamento + +```mermaid +erDiagram + SETTINGS ||--o{ PROVIDER_CONNECTION : controla + PROVIDER_NODE ||--o{ PROVIDER_CONNECTION : provedor_compatível + PROVIDER_CONNECTION ||--o{ USAGE_ENTRY : emite_uso + + SETTINGS { + boolean cloudEnabled + number stickyRoundRobinLimit + boolean requireLogin + string password_hash + string fallbackStrategy + json rateLimitDefaults + json providerProfiles + } + + PROVIDER_CONNECTION { + string id + string provider + string authType + string name + number priority + boolean isActive + string apiKey + string accessToken + string refreshToken + string expiresAt + string testStatus + string lastError + string rateLimitedUntil + json providerSpecificData + } + + PROVIDER_NODE { + string id + string type + string name + string prefix + string apiType + string baseUrl + } + + MODEL_ALIAS { + string alias + string targetModel + } + + COMBO { + string id + string name + string[] models + } + + API_KEY { + string id + string name + string key + string machineId + } + + USAGE_ENTRY { + string provider + string model + number prompt_tokens + number completion_tokens + string connectionId + string timestamp + } + + CUSTOM_MODEL { + string id + string name + string providerId + } + + PROXY_CONFIG { + string global + json providers + } + + IP_FILTER { + string mode + string[] allowlist + string[] blocklist + } + + THINKING_BUDGET { + string mode + number customBudget + string effortLevel + } + + SYSTEM_PROMPT { + boolean enabled + string prompt + string position + } +``` + +Arquivos de armazenamento físico: + +- banco de dados de runtime principal: `${DATA_DIR}/storage.sqlite` +- linhas de log de requisições: `${DATA_DIR}/log.txt` (artefato de compatibilidade/debug) +- arquivos de payload de chamadas estruturadas: `${DATA_DIR}/call_logs/` +- sessões de depuração de tradutor/requisição opcionais: `<repo>/logs/...` + +## Topologia de Implantação + +```mermaid +flowchart LR + subgraph LocalHost[Host do Desenvolvedor] + CLI[CLI Tools] + Browser[Navegador do Dashboard] + end + + subgraph ContainerOrProcess[Runtime OmniRoute] + Next[Servidor Next.js\nPORT=20128] + Core[Núcleo SSE + Executores] + MainDB[(storage.sqlite)] + UsageDB[(tabelas de uso + artefatos de log)] + end + + subgraph External[Serviços Externos] + Providers[Provedores de IA] + SyncCloud[Serviço de Sincronização em Nuvem] + end + + CLI --> Next + Browser --> Next + Next --> Core + Next --> MainDB + Core --> MainDB + Core --> UsageDB + Core --> Providers + Next --> SyncCloud +``` + +## Mapeamento de Módulos (Crítico para Decisão) + +### Módulos de Rota e API + +- `src/app/api/v1/*`, `src/app/api/v1beta/*`: APIs de compatibilidade +- `src/app/api/v1/providers/[provider]/*`: rotas dedicadas por provedor (chat, embeddings, imagens) +- `src/app/api/providers*`: CRUD de provedor, validação, teste +- `src/app/api/provider-nodes*`: gerenciamento de nós compatíveis personalizados +- `src/app/api/provider-models`: gerenciamento de modelos personalizados (CRUD) +- `src/app/api/models/route.ts`: API de catálogo de modelos (aliases + modelos personalizados) +- `src/app/api/oauth/*`: fluxos de OAuth/código de dispositivo +- `src/app/api/keys*`: ciclo de vida da chave API local +- `src/app/api/models/alias`: gerenciamento de alias +- `src/app/api/combos*`: gerenciamento de combos de fallback +- `src/app/api/pricing`: substituições de preços para cálculo de custo +- `src/app/api/settings/proxy`: configuração de proxy (GET/PUT/DELETE) +- `src/app/api/settings/proxy/test`: teste de conectividade de proxy de saída (POST) +- `src/app/api/usage/*`: APIs de uso e logs +- `src/app/api/sync/*` + `src/app/api/cloud/*`: sincronização em nuvem e auxiliares voltados para a nuvem +- `src/app/api/cli-tools/*`: escritores/verificadores de configuração CLI local +- `src/app/api/settings/ip-filter`: lista de permissão/bloqueio de IP (GET/PUT) +- `src/app/api/settings/thinking-budget`: configuração do orçamento de tokens de pensamento (GET/PUT) +- `src/app/api/settings/system-prompt`: prompt do sistema global (GET/PUT) +- `src/app/api/settings/compression`: configurações de compressão global (GET/PUT) +- `src/app/api/compression/*`: visualização de compressão, metadados de regras e pacotes de idioma +- `src/app/api/context/caveman/config`: alias de configurações Caveman (GET/PUT) +- `src/app/api/context/rtk/*`: configuração RTK, catálogo de filtros, endpoint de teste e recuperação de saída bruta +- `src/app/api/context/combos*`: CRUD de combos de compressão e atribuições de combos de roteamento +- `src/app/api/context/analytics`: alias de análises de compressão +- `src/app/api/sessions`: listagem de sessões ativas (GET) +- `src/app/api/rate-limits`: status de limite de taxa por conta (GET) +- `src/app/api/sync/tokens`: CRUD de tokens de sincronização (GET/POST) +- `src/app/api/sync/tokens/[id]`: obter/excluir token de sincronização (GET/DELETE) +- `src/app/api/sync/bundle`: download de pacote de configuração (GET, versionamento ETag) +- `src/app/api/v1/ws`: manipulador de atualização WebSocket para clientes WS compatíveis com OpenAI + +### Núcleo de Roteamento e Execução + +- `src/sse/handlers/chat.ts`: análise de requisições, manipulação de combos, loop de seleção de conta +- `open-sse/handlers/chatCore.ts`: tradução, despacho de executores, manipulação de retry/refresh, configuração de stream +- `open-sse/executors/*`: comportamento de rede e formato específico do provedor + +### Registro de Tradução e Conversores de Formato + +- `open-sse/translator/index.ts`: registro e orquestração de tradutores +- Tradutores de requisição: `open-sse/translator/request/*` (9 módulos — `antigravity-to-openai`, `claude-to-gemini`, `claude-to-openai`, `gemini-to-openai`, `openai-responses`, `openai-to-claude`, `openai-to-cursor`, `openai-to-gemini`, `openai-to-kiro`) +- Tradutores de resposta: `open-sse/translator/response/*` (8 módulos — `claude-to-openai`, `cursor-to-openai`, `gemini-to-claude`, `gemini-to-openai`, `kiro-to-openai`, `openai-responses`, `openai-to-antigravity`, `openai-to-claude`) +- Auxiliares: `open-sse/translator/helpers/*` (8 módulos — `claudeHelper`, `geminiHelper`, `geminiToolsSanitizer`, `maxTokensHelper`, `openaiHelper`, `responsesApiHelper`, `schemaCoercion`, `toolCallHelper`) +- Constantes de formato: `open-sse/translator/formats.ts` +- Bootstrap e registro: `open-sse/translator/bootstrap.ts`, `open-sse/translator/registry.ts` +- Auxiliares de formato de imagem: `open-sse/translator/image/` + +### Persistência + +- `src/lib/db/*`: configuração/persistência de estado persistente e persistência de domínio no SQLite +- `src/lib/localDb.ts`: re-exportação de compatibilidade para módulos de DB +- `src/lib/usageDb.ts`: fachada de histórico de uso/logs de chamadas sobre tabelas SQLite + +## Cobertura do Executor do Provedor (Padrão de Estratégia) + +Cada provedor tem um executor especializado que estende `BaseExecutor` (em `open-sse/executors/base.ts`), que fornece construção de URL, construção de cabeçalhos, tentativas com retrocesso exponencial, ganchos de atualização de credenciais e o método de orquestração `execute()`. + +| Executor | Provedor(es) | Tratamento Especial | +| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | +| `DefaultExecutor` | OpenAI, Claude, Gemini, Qwen, OpenRouter, GLM, Kimi, MiniMax, DeepSeek, Groq, xAI, Mistral, Perplexity, Together, Fireworks, Cerebras, Cohere, NVIDIA, etc. | Configuração dinâmica de URL/cabeçalho por provedor | +| `AntigravityExecutor` | Google Antigravity | IDs de projeto/sessão personalizados, análise de Retry-After, ofuscação de 429 | +| `AzureOpenAIExecutor` | Azure OpenAI | Roteamento baseado em implantação, imposição de consulta de api-version | +| `BlackboxWebExecutor` | Blackbox AI (modo web) | Reversão de sessão web com emulação de impressão digital TLS | +| `ChatGPTWebExecutor` | ChatGPT web | Gerenciamento de cliente TLS + cookie de sessão (`chatgptTlsClient.ts`) | +| `ClaudeIdentityExecutor` | Claude.ai (caminho CCH) | Pipelines de restrição + remapeamento de ferramentas, modelagem de impressão digital | +| `CliProxyApiExecutor` | Provedores compatíveis com CLIProxyAPI | Manipulação personalizada de autenticação e protocolo | +| `CloudflareAiExecutor` | Cloudflare Workers AI | Injeção de ID de conta, rastreamento de uso baseado em Neurons | +| `CodexExecutor` | OpenAI Codex | Injeta instruções do sistema, força esforço de raciocínio | +| `CommandCodeExecutor` | Código de Comando | Rotação de cabeçalho por sessão + OAuth | +| `CursorExecutor` | Cursor IDE | Protocolo ConnectRPC, codificação Protobuf, assinatura de requisições via checksum | +| `DevinCliExecutor` | Devin CLI | Conexão do ciclo de vida da tarefa Devin via módulo de agente em nuvem | +| `GeminiCLIExecutor` | Gemini CLI | Ciclo de atualização de token OAuth do Google | +| `GithubExecutor` | GitHub Copilot | Atualização de token do Copilot, cabeçalhos imitando VSCode | +| `GitlabExecutor` | GitLab Duo | Roteamento baseado em projeto + OAuth do GitLab | +| `GlmExecutor` | Z.AI GLM (incl. preset `glmt`) | Consciente do orçamento de pensamento, constantes do preset GLMT | +| `GrokWebExecutor` | xAI Grok web | Reversão de sessão web, seleção de modo (pensar/padrão) | +| `KieExecutor` | KIE | Emissão de token personalizada com âncoras de sessão rotativas | +| `KiroExecutor` | AWS CodeWhisperer/Kiro | Formato binário do AWS EventStream → conversão para SSE | +| `MuseSparkWebExecutor` | Muse Spark (web) | Reversão de sessão web com integração de mensagem de imagem | +| `NlpCloudExecutor` | NLP Cloud | Formato de corpo de requisição específico do provedor | +| `OpenCodeExecutor` | OpenCode | Configuração de provedor compatível com AI SDK | +| `PerplexityWebExecutor` | Perplexity web | Reversão de sessão web para continuidade de chat | +| `PetalsExecutor` | Inferência distribuída Petals | Roteamento de enxame descentralizado | +| `PollinationsExecutor` | Pollinations AI | Nenhuma chave de API necessária, requisições limitadas por taxa | +| `PuterExecutor` | Puter | Integração de provedor baseada em navegador | +| `QoderExecutor` | Qoder AI | Suporte a PAT e OAuth, nível gratuito de múltiplos modelos | +| `VertexExecutor` | Google Vertex AI | Autenticação de conta de serviço, endpoints baseados em região | +| `WindsurfExecutor` | Windsurf (Codeium) | Atualização de token de sessão + OAuth do Codeium | + +Todos os outros provedores (incluindo nós compatíveis personalizados) usam o `DefaultExecutor`. + +## Matriz de Compatibilidade de Provedores + +> **Nota:** A matriz abaixo é uma amostra representativa dos 177 provedores registrados no +> OmniRoute v3.8.0. Para a lista canônica e continuamente atualizada, consulte +> [`docs/reference/PROVIDER_REFERENCE.md`](../reference/PROVIDER_REFERENCE.md) (gerada automaticamente) ou a fonte +> de verdade em `src/shared/constants/providers.ts` (validada pelo Zod no carregamento). + +| Provedor | Formato | Autenticação | Stream | Não-Stream | Atualização de Token | API de Uso | +| ----------------- | ---------------- | -------------------------- | ---------------- | ---------- | -------------------- | ----------------------- | +| Claude | claude | Chave de API / OAuth | ✅ | ✅ | ✅ | ⚠️ Somente Admin | +| Gemini | gemini | Chave de API / OAuth | ✅ | ✅ | ✅ | ⚠️ Console da Nuvem | +| Gemini CLI | gemini-cli | OAuth | ✅ | ✅ | ✅ | ⚠️ Console da Nuvem | +| Antigravity | antigravity | OAuth | ✅ | ✅ | ✅ | ✅ API de cota total | +| OpenAI | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Codex | openai-responses | OAuth | ✅ forçado | ❌ | ✅ | ✅ Limites de taxa | +| GitHub Copilot | openai | OAuth + Token Copilot | ✅ | ✅ | ✅ | ✅ Instantâneas de cota | +| Cursor | cursor | Checksum personalizado | ✅ | ✅ | ❌ | ❌ | +| Kiro | kiro | AWS SSO OIDC | ✅ (EventStream) | ❌ | ✅ | ✅ Limites de uso | +| Qwen | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Por solicitação | +| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Por solicitação | +| Kilo Code | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| Cline | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| Kimi Coding | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| OpenRouter | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| GLM/Kimi/MiniMax | claude | Chave de API | ✅ | ✅ | ❌ | ❌ | +| DeepSeek | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Groq | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| xAI (Grok) | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Mistral | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Perplexity | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Together AI | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Fireworks AI | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Cerebras | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Cohere | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| NVIDIA NIM | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Cloudflare AI | openai | Token de API + ID da conta | ✅ | ✅ | ❌ | ❌ | +| Pollinations | openai | Nenhum (sem chave) | ✅ | ✅ | ❌ | ❌ | +| Scaleway AI | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| LongCat | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Ollama Cloud | openai | Chave de API (opcional) | ✅ | ✅ | ❌ | ❌ | +| HuggingFace | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Nebius | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| SiliconFlow | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Hyperbolic | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Vertex AI | gemini | Conta de Serviço | ✅ | ✅ | ✅ | ⚠️ Console da Nuvem | +| Puter | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Command Code | openai | OAuth | ✅ | ✅ | ✅ | ⚠️ Por solicitação | +| Z.AI / GLM | openai | Chave de API / OAuth | ✅ | ✅ | ❌ | ❌ | +| GLMT (preset) | claude | Chave de API | ✅ | ✅ | ❌ | ⚠️ Por solicitação | +| Kimi Coding | openai | OAuth / Chave de API | ✅ | ✅ | ✅ | ❌ | +| KIE | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Windsurf | openai | OAuth (Codeium) | ✅ | ✅ | ✅ | ⚠️ Por solicitação | +| GitLab Duo | openai | OAuth (GitLab) | ✅ | ✅ | ✅ | ❌ | +| Devin CLI | openai | OAuth | ✅ | ✅ | ✅ | ✅ API de Tarefas | +| Codex Cloud | openai-responses | OAuth | ✅ | ❌ | ✅ | ✅ Limites de taxa | +| Jules | openai | OAuth | ✅ | ✅ | ✅ | ✅ API de Tarefas | +| AgentRouter | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| ChatGPT-Web | openai | Cookie de sessão + TLS | ✅ | ✅ | ❌ | ❌ | +| Grok-Web | openai | Cookie de sessão | ✅ | ✅ | ❌ | ❌ | +| Perplexity-Web | openai | Cookie de sessão | ✅ | ✅ | ❌ | ❌ | +| BlackBox-Web | openai | Cookie de sessão + TLS | ✅ | ✅ | ❌ | ❌ | +| Muse-Spark-Web | openai | Cookie de sessão | ✅ | ✅ | ❌ | ❌ | +| ModelScope | openai | Chave de API | ✅ | ✅ | ❌ | ⚠️ Política de cota | +| BazaarLink | openai | Chave de API | ✅ | ✅ | ❌ | ❌ | +| Petals | openai | Nenhum | ✅ | ✅ | ❌ | ❌ | +| Qoder | openai | OAuth / PAT | ✅ | ✅ | ✅ | ⚠️ Por solicitação | +| OpenCode (Go/Zen) | openai | OAuth | ✅ | ✅ | ✅ | ❌ | +| CLIProxyAPI | openai | Personalizado | ✅ | ✅ | ❌ | ❌ | + +## Cobertura de Tradução de Formato + +Os formatos de origem detectados incluem: + +- `openai` +- `openai-responses` +- `claude` +- `gemini` + +Os formatos de destino incluem: + +- OpenAI chat/Responses +- Claude +- Gemini/Gemini-CLI/Antigravity envelope +- Kiro +- Cursor + +As traduções usam **OpenAI como o formato central** — todas as conversões passam pelo OpenAI como intermediário: + +``` +Formato de Origem → OpenAI (central) → Formato de Destino +``` + +As traduções são selecionadas dinamicamente com base na forma da carga útil de origem e no formato de destino do provedor. + +Camadas de processamento adicionais no pipeline de tradução: + +- **Sanitização de resposta** — Remove campos não padrão das respostas no formato OpenAI (tanto streaming quanto não streaming) para garantir conformidade estrita com o SDK +- **Normalização de função** — Converte `developer` → `system` para destinos que não são OpenAI; mescla `system` → `user` para modelos que rejeitam a função de sistema (GLM, ERNIE) +- **Extração de tag de pensamento** — Analisa blocos ``do conteúdo para o campo`reasoning_content` +- **Saída estruturada** — Converte `response_format.json_schema` do OpenAI para `responseMimeType` + `responseSchema` do Gemini + +## Endpoints da API Suportados + +| Endpoint | Formato | Manipulador | +| -------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------- | +| `POST /v1/chat/completions` | OpenAI Chat | `src/sse/handlers/chat.ts` | +| `POST /v1/messages` | Claude Messages | Mesmo manipulador (detecção automática) | +| `POST /v1/responses` | OpenAI Responses | `open-sse/handlers/responsesHandler.ts` | +| `POST /v1/embeddings` | OpenAI Embeddings | `open-sse/handlers/embeddings.ts` | +| `GET /v1/embeddings` | Listagem de Modelos | Rota da API | +| `POST /v1/images/generations` | OpenAI Images | `open-sse/handlers/imageGeneration.ts` | +| `GET /v1/images/generations` | Listagem de Modelos | Rota da API | +| `POST /v1/providers/{provider}/chat/completions` | OpenAI Chat | Dedicado por provedor com validação de modelo | +| `POST /v1/providers/{provider}/embeddings` | OpenAI Embeddings | Dedicado por provedor com validação de modelo | +| `POST /v1/providers/{provider}/images/generations` | OpenAI Images | Dedicado por provedor com validação de modelo | +| `POST /v1/messages/count_tokens` | Contagem de Tokens Claude | Rota da API | +| `GET /v1/models` | Lista de Modelos OpenAI | Rota da API (chat + embedding + image + modelos personalizados) | +| `GET /api/models/catalog` | Catálogo | Todos os modelos agrupados por provedor + tipo | +| `POST /v1beta/models/*:streamGenerateContent` | Nativo do Gemini | Rota da API | +| `GET/PUT/DELETE /api/settings/proxy` | Configuração de Proxy | Configuração de proxy de rede | +| `POST /api/settings/proxy/test` | Conectividade de Proxy | Endpoint de teste de saúde/conectividade do proxy | +| `GET/POST/DELETE /api/provider-models` | Modelos de Provedor | Metadados do modelo do provedor que suportam modelos disponíveis personalizados e gerenciados | + +## Manipulador de Bypass + +O manipulador de bypass (`open-sse/utils/bypassHandler.ts`) intercepta solicitações conhecidas como "descartáveis" do Claude CLI — pings de aquecimento, extrações de título e contagens de tokens — e retorna uma **resposta falsa** sem consumir tokens do provedor upstream. Isso é acionado apenas quando o `User-Agent` contém `claude-cli`. + +## Registro de Solicitações e Artefatos + +O antigo registrador de solicitações baseado em arquivo (`open-sse/utils/requestLogger.ts`) é mantido apenas para compatibilidade com versões anteriores. O contrato de tempo de execução atual utiliza: + +- `APP_LOG_TO_FILE=true` para logs de aplicação e auditoria escritos em `<repo>/logs/` +- Registros de log de chamadas com suporte a SQLite em `call_logs` +- Artefatos em `${DATA_DIR}/call_logs/YYYY-MM-DD/...` quando o pipeline de log de chamadas está habilitado + +## Modos de Falha e Resiliência + +## 1) Disponibilidade de Conta/Provedor + +- cooldown de conexão em falhas upstream recuperáveis +- fallback de conta antes de falhar a solicitação +- fallback de modelo combinado quando o caminho atual de modelo/provedor é esgotado + +## 2) Expiração de Token + +- pré-verificação e atualização com nova tentativa para provedores atualizáveis +- nova tentativa 401/403 após tentativa de atualização no caminho principal + +## 3) Segurança de Stream + +- controlador de stream ciente de desconexões +- stream de tradução com descarte de fim de stream e tratamento de `[DONE]` +- fallback de estimativa de uso quando os metadados de uso do provedor estão ausentes + +## 4) Degradação de Sincronização em Nuvem + +- erros de sincronização são exibidos, mas o tempo de execução local continua +- o agendador possui lógica capaz de nova tentativa, mas a execução periódica atualmente chama a sincronização de tentativa única por padrão + +## 5) Integridade de Dados + +- migrações de esquema SQLite e ganchos de autoatualização na inicialização +- caminho de compatibilidade de migração legado JSON → SQLite + +## 6) SSRF / Proteção de URL de Saída + +- `src/shared/network/outboundUrlGuard.ts` bloqueia todas as URLs de destino privadas/loopback/link-local antes que elas cheguem aos executores do provedor +- As rotas de descoberta e validação do modelo do provedor usam `src/shared/network/safeOutboundFetch.ts`, que aplica a proteção antes de cada solicitação de saída +- Erros de proteção aparecem como `URL_GUARD_BLOCKED` com HTTP 422 e são registrados na trilha de auditoria de conformidade via `providerAudit.ts` + +## Observabilidade e Sinais Operacionais + +Fontes de visibilidade em tempo de execução: + +- logs do console de `src/sse/utils/logger.ts` +- agregados de uso por solicitação em SQLite (`usage_history`, `call_logs`, `proxy_logs`) +- capturas detalhadas de payload em quatro estágios em SQLite (`request_detail_logs`) quando `settings.detailed_logs_enabled=true` +- log de status de solicitação textual em `log.txt` (opcional/compat) +- arquivos de log de aplicação opcionais em `logs/` quando `APP_LOG_TO_FILE=true` +- artefatos de solicitação opcionais em `${DATA_DIR}/call_logs/` quando o pipeline de log de chamadas está habilitado +- endpoints de uso do dashboard (`/api/usage/*`) para consumo da UI + +A captura detalhada do payload da solicitação armazena até quatro estágios de payload JSON por chamada roteada: + +- solicitação bruta recebida do cliente +- solicitação traduzida realmente enviada para upstream +- resposta do provedor reconstruída como JSON; respostas transmitidas são compactadas para o resumo final mais metadados do stream +- resposta final do cliente retornada pelo OmniRoute; respostas transmitidas são armazenadas na mesma forma de resumo compactado + +## Limites Sensíveis à Segurança + +- O segredo do JWT (`JWT_SECRET`) protege a verificação/assinatura do cookie de sessão do painel +- A senha inicial de bootstrap (`INITIAL_PASSWORD`) deve ser configurada explicitamente para o provisionamento na primeira execução +- O segredo HMAC da chave da API (`API_KEY_SECRET`) protege o formato da chave da API local gerada +- Segredos do provedor (chaves/tokens da API) são persistidos no banco de dados local e devem ser protegidos a nível de sistema de arquivos +- Os endpoints de sincronização em nuvem dependem da autenticação da chave da API + semântica do id da máquina + +## Matriz de Ambiente e Tempo de Execução + +Variáveis de ambiente ativamente usadas pelo código: + +- App/auth: `JWT_SECRET`, `INITIAL_PASSWORD` +- Armazenamento: `DATA_DIR` +- Comportamento compatível do node: `ALLOW_MULTI_CONNECTIONS_PER_COMPAT_NODE` +- Substituição opcional da base de armazenamento (Linux/macOS quando `DATA_DIR` não definido): `XDG_CONFIG_HOME` +- Hashing de segurança: `API_KEY_SECRET`, `MACHINE_ID_SALT` +- Registro: `APP_LOG_TO_FILE`, `APP_LOG_RETENTION_DAYS`, `CALL_LOG_RETENTION_DAYS` +- URL de sincronização/nuvem: `NEXT_PUBLIC_BASE_URL`, `NEXT_PUBLIC_CLOUD_URL` +- Proxy de saída: `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY` e variantes em minúsculas +- Flags de recurso SOCKS5: `ENABLE_SOCKS5_PROXY`, `NEXT_PUBLIC_ENABLE_SOCKS5_PROXY` +- Auxiliares de plataforma/tempo de execução (não configuração específica do app): `APPDATA`, `NODE_ENV`, `PORT`, `HOSTNAME` + +## Notas Arquitetônicas Conhecidas + +1. `usageDb` e `localDb` compartilham a mesma política de diretório base (`DATA_DIR` -> `XDG_CONFIG_HOME/omniroute` -> `~/.omniroute`) com migração de arquivos legados. +2. `/api/v1/route.ts` delega para o mesmo construtor de catálogo unificado usado por `/api/v1/models` (`src/app/api/v1/models/catalog.ts`) para evitar desvios semânticos. +3. O logger de requisições escreve cabeçalhos/corpo completos quando habilitado; trate o diretório de logs como sensível. +4. O comportamento em nuvem depende do correto `NEXT_PUBLIC_BASE_URL` e da acessibilidade do endpoint em nuvem. +5. O diretório `open-sse/` é publicado como o pacote **npm workspace** `@omniroute/open-sse`. O código-fonte o importa via `@omniroute/open-sse/...` (resolvido pelo Next.js `transpilePackages`). Os caminhos de arquivos neste documento ainda usam o nome do diretório `open-sse/` para consistência. +6. Gráficos no painel usam **Recharts** (baseado em SVG) para visualizações analíticas interativas e acessíveis (gráficos de barras de uso de modelo, tabelas de quebra de provedor com taxas de sucesso). +7. Testes E2E usam **Playwright** (`tests/e2e/`), executados via `npm run test:e2e`. Testes unitários usam **Node.js test runner** (`tests/unit/`), executados via `npm run test:unit`. O código-fonte sob `src/` é **TypeScript** (`.ts`/`.tsx`); o workspace `open-sse/` permanece em JavaScript (`.js`). +8. A página de configurações é organizada em 7 abas: Geral, Aparência, IA, Segurança, Roteamento, Resiliência, Avançado. A página de Resiliência configura apenas a fila de requisições, o tempo de espera de conexão, o quebra-provedor e o comportamento de espera; o estado de tempo de execução do quebra ao vivo é mostrado na página de Saúde. +9. A estratégia **Context Relay** (`context-relay`) é dividida em duas camadas: `combo.ts` decide se uma transferência deve ser gerada, `chat.ts` injeta a transferência após a resolução da conta. Os dados da transferência vivem na tabela SQLite `context_handoffs`. Essa divisão é intencional porque apenas `chat.ts` sabe se a conta real mudou. +10. A **imposição de proxy** agora é abrangente: `tokenHealthCheck.ts` resolve o proxy por conexão, `/api/providers/validate` usa `runWithProxyContext`, e `proxyFetch.ts` usa `undici.fetch()` para manter a compatibilidade do despachante no Node 22. +11. **Detecção de política de tempo de execução do Node.js**: `/api/settings/require-login` retorna os campos `nodeVersion` e `nodeCompatible`. A página de login renderiza um banner de aviso quando o tempo de execução está fora das linhas seguras suportadas do Node.js. + +## Lista de Verificação de Verificação Operacional + +- Compilar a partir do código-fonte: `npm run build` +- Construir imagem Docker: `docker build -t omniroute .` +- Iniciar serviço e verificar: +- `GET /api/settings` +- `GET /api/v1/models` +- A URL base do alvo da CLI deve ser `http://<host>:20128/v1` quando `PORT=20128` diff --git a/docs/i18n/pt-BR/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/pt-BR/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/pt-BR/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/pt-BR/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/pt-BR/docs/A2A-SERVER.md b/docs/i18n/pt-BR/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/pt-BR/docs/A2A-SERVER.md rename to docs/i18n/pt-BR/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/pt-BR/docs/MCP-SERVER.md b/docs/i18n/pt-BR/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/pt-BR/docs/MCP-SERVER.md rename to docs/i18n/pt-BR/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/pt-BR/docs/FEATURES.md b/docs/i18n/pt-BR/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/pt-BR/docs/FEATURES.md rename to docs/i18n/pt-BR/docs/guides/FEATURES.md diff --git a/docs/i18n/pt-BR/docs/I18N.md b/docs/i18n/pt-BR/docs/guides/I18N.md similarity index 99% rename from docs/i18n/pt-BR/docs/I18N.md rename to docs/i18n/pt-BR/docs/guides/I18N.md index 2faef1c2c4..4c31b74476 100644 --- a/docs/i18n/pt-BR/docs/I18N.md +++ b/docs/i18n/pt-BR/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/pt-BR/docs/TROUBLESHOOTING.md b/docs/i18n/pt-BR/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/pt-BR/docs/TROUBLESHOOTING.md rename to docs/i18n/pt-BR/docs/guides/TROUBLESHOOTING.md index 6392bd7189..f951053005 100644 --- a/docs/i18n/pt-BR/docs/TROUBLESHOOTING.md +++ b/docs/i18n/pt-BR/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/pt-BR/docs/UNINSTALL.md b/docs/i18n/pt-BR/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/pt-BR/docs/UNINSTALL.md rename to docs/i18n/pt-BR/docs/guides/UNINSTALL.md diff --git a/docs/i18n/pt-BR/docs/USER_GUIDE.md b/docs/i18n/pt-BR/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/pt-BR/docs/USER_GUIDE.md rename to docs/i18n/pt-BR/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/pt-BR/docs/COVERAGE_PLAN.md b/docs/i18n/pt-BR/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/pt-BR/docs/COVERAGE_PLAN.md rename to docs/i18n/pt-BR/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/pt-BR/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/pt-BR/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pt-BR/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/pt-BR/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pt-BR/docs/RELEASE_CHECKLIST.md b/docs/i18n/pt-BR/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/pt-BR/docs/RELEASE_CHECKLIST.md rename to docs/i18n/pt-BR/docs/ops/RELEASE_CHECKLIST.md index 61a72634a5..8154882016 100644 --- a/docs/i18n/pt-BR/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/pt-BR/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/pt-BR/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/pt-BR/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pt-BR/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/pt-BR/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pt-BR/docs/API_REFERENCE.md b/docs/i18n/pt-BR/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/pt-BR/docs/API_REFERENCE.md rename to docs/i18n/pt-BR/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/pt-BR/docs/CLI-TOOLS.md b/docs/i18n/pt-BR/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/pt-BR/docs/CLI-TOOLS.md rename to docs/i18n/pt-BR/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/pt-BR/docs/ENVIRONMENT.md b/docs/i18n/pt-BR/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/pt-BR/docs/ENVIRONMENT.md rename to docs/i18n/pt-BR/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/pt-BR/docs/AUTO-COMBO.md b/docs/i18n/pt-BR/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/pt-BR/docs/AUTO-COMBO.md rename to docs/i18n/pt-BR/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/pt-BR/llm.txt b/docs/i18n/pt-BR/llm.txt index 6d9c9391d3..46c77c9ae2 100644 --- a/docs/i18n/pt-BR/llm.txt +++ b/docs/i18n/pt-BR/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/pt/CHANGELOG.md b/docs/i18n/pt/CHANGELOG.md index f925b7651e..04d780a2d0 100644 --- a/docs/i18n/pt/CHANGELOG.md +++ b/docs/i18n/pt/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Segurança +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentação + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentação - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Segurança - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Segurança - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentação - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentação - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Segurança - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Segurança - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentação - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Segurança - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentação - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Segurança - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Segurança - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Segurança - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Segurança - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentação - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentação - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Segurança - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Segurança - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentação - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/pt/CONTRIBUTING.md b/docs/i18n/pt/CONTRIBUTING.md index f1cc28f27a..9ee21156f9 100644 --- a/docs/i18n/pt/CONTRIBUTING.md +++ b/docs/i18n/pt/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/pt/README.md b/docs/i18n/pt/README.md index 492246346b..ac2ed33e74 100644 --- a/docs/i18n/pt/README.md +++ b/docs/i18n/pt/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentação -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/pt/docs/ARCHITECTURE.md b/docs/i18n/pt/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/pt/docs/ARCHITECTURE.md rename to docs/i18n/pt/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/pt/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/pt/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/pt/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/pt/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/pt/docs/A2A-SERVER.md b/docs/i18n/pt/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/pt/docs/A2A-SERVER.md rename to docs/i18n/pt/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/pt/docs/MCP-SERVER.md b/docs/i18n/pt/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/pt/docs/MCP-SERVER.md rename to docs/i18n/pt/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/pt/docs/FEATURES.md b/docs/i18n/pt/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/pt/docs/FEATURES.md rename to docs/i18n/pt/docs/guides/FEATURES.md diff --git a/docs/i18n/pt/docs/I18N.md b/docs/i18n/pt/docs/guides/I18N.md similarity index 99% rename from docs/i18n/pt/docs/I18N.md rename to docs/i18n/pt/docs/guides/I18N.md index 868e52eca5..d3561b3f39 100644 --- a/docs/i18n/pt/docs/I18N.md +++ b/docs/i18n/pt/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/pt/docs/TROUBLESHOOTING.md b/docs/i18n/pt/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/pt/docs/TROUBLESHOOTING.md rename to docs/i18n/pt/docs/guides/TROUBLESHOOTING.md index 859151adc6..00914abc61 100644 --- a/docs/i18n/pt/docs/TROUBLESHOOTING.md +++ b/docs/i18n/pt/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/pt/docs/UNINSTALL.md b/docs/i18n/pt/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/pt/docs/UNINSTALL.md rename to docs/i18n/pt/docs/guides/UNINSTALL.md diff --git a/docs/i18n/pt/docs/USER_GUIDE.md b/docs/i18n/pt/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/pt/docs/USER_GUIDE.md rename to docs/i18n/pt/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/pt/docs/COVERAGE_PLAN.md b/docs/i18n/pt/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/pt/docs/COVERAGE_PLAN.md rename to docs/i18n/pt/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/pt/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/pt/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pt/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/pt/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pt/docs/RELEASE_CHECKLIST.md b/docs/i18n/pt/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/pt/docs/RELEASE_CHECKLIST.md rename to docs/i18n/pt/docs/ops/RELEASE_CHECKLIST.md index 7da2fdeee8..025b360d9c 100644 --- a/docs/i18n/pt/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/pt/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/pt/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/pt/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/pt/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/pt/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/pt/docs/API_REFERENCE.md b/docs/i18n/pt/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/pt/docs/API_REFERENCE.md rename to docs/i18n/pt/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/pt/docs/CLI-TOOLS.md b/docs/i18n/pt/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/pt/docs/CLI-TOOLS.md rename to docs/i18n/pt/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/pt/docs/ENVIRONMENT.md b/docs/i18n/pt/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/pt/docs/ENVIRONMENT.md rename to docs/i18n/pt/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/pt/docs/AUTO-COMBO.md b/docs/i18n/pt/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/pt/docs/AUTO-COMBO.md rename to docs/i18n/pt/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/pt/llm.txt b/docs/i18n/pt/llm.txt index 8ec2bd2dd5..685f400c65 100644 --- a/docs/i18n/pt/llm.txt +++ b/docs/i18n/pt/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ro/CHANGELOG.md b/docs/i18n/ro/CHANGELOG.md index 95b26b7c07..1b9740a6df 100644 --- a/docs/i18n/ro/CHANGELOG.md +++ b/docs/i18n/ro/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Securitate +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentație + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentație - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Securitate - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Securitate - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentație - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentație - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Securitate - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Securitate - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentație - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Securitate - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentație - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Securitate - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcționalități - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Securitate - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcționalități - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcționalități - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Securitate - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Securitate - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentație - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentație - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcționalități - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcționalități - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcționalități - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Securitate - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcționalități - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcționalități - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcționalități - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcționalități - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcționalități - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcționalități - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcționalități - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcționalități - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Securitate - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcționalități - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcționalități - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcționalități - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcționalități - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcționalități - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcționalități - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentație - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcționalități - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ro/CONTRIBUTING.md b/docs/i18n/ro/CONTRIBUTING.md index 8b8057ed7c..3b590380db 100644 --- a/docs/i18n/ro/CONTRIBUTING.md +++ b/docs/i18n/ro/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ro/README.md b/docs/i18n/ro/README.md index 2c71b54ebd..d093296081 100644 --- a/docs/i18n/ro/README.md +++ b/docs/i18n/ro/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentație -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ro/docs/ARCHITECTURE.md b/docs/i18n/ro/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ro/docs/ARCHITECTURE.md rename to docs/i18n/ro/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ro/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ro/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ro/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ro/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ro/docs/A2A-SERVER.md b/docs/i18n/ro/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ro/docs/A2A-SERVER.md rename to docs/i18n/ro/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ro/docs/MCP-SERVER.md b/docs/i18n/ro/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ro/docs/MCP-SERVER.md rename to docs/i18n/ro/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ro/docs/FEATURES.md b/docs/i18n/ro/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ro/docs/FEATURES.md rename to docs/i18n/ro/docs/guides/FEATURES.md diff --git a/docs/i18n/ro/docs/I18N.md b/docs/i18n/ro/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ro/docs/I18N.md rename to docs/i18n/ro/docs/guides/I18N.md index 75177748a1..e7f6e94720 100644 --- a/docs/i18n/ro/docs/I18N.md +++ b/docs/i18n/ro/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ro/docs/TROUBLESHOOTING.md b/docs/i18n/ro/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ro/docs/TROUBLESHOOTING.md rename to docs/i18n/ro/docs/guides/TROUBLESHOOTING.md index 81043c9a37..298dc196f9 100644 --- a/docs/i18n/ro/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ro/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ro/docs/UNINSTALL.md b/docs/i18n/ro/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ro/docs/UNINSTALL.md rename to docs/i18n/ro/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ro/docs/USER_GUIDE.md b/docs/i18n/ro/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ro/docs/USER_GUIDE.md rename to docs/i18n/ro/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ro/docs/COVERAGE_PLAN.md b/docs/i18n/ro/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ro/docs/COVERAGE_PLAN.md rename to docs/i18n/ro/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ro/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ro/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ro/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ro/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ro/docs/RELEASE_CHECKLIST.md b/docs/i18n/ro/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ro/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ro/docs/ops/RELEASE_CHECKLIST.md index b2bc96dcde..905d05a5da 100644 --- a/docs/i18n/ro/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ro/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ro/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ro/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ro/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ro/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ro/docs/API_REFERENCE.md b/docs/i18n/ro/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ro/docs/API_REFERENCE.md rename to docs/i18n/ro/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ro/docs/CLI-TOOLS.md b/docs/i18n/ro/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ro/docs/CLI-TOOLS.md rename to docs/i18n/ro/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ro/docs/ENVIRONMENT.md b/docs/i18n/ro/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ro/docs/ENVIRONMENT.md rename to docs/i18n/ro/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ro/docs/AUTO-COMBO.md b/docs/i18n/ro/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ro/docs/AUTO-COMBO.md rename to docs/i18n/ro/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ro/llm.txt b/docs/i18n/ro/llm.txt index f888e73889..1c41f6beff 100644 --- a/docs/i18n/ro/llm.txt +++ b/docs/i18n/ro/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ru/CHANGELOG.md b/docs/i18n/ru/CHANGELOG.md index 219bb905bd..6219c06149 100644 --- a/docs/i18n/ru/CHANGELOG.md +++ b/docs/i18n/ru/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Безопасность +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Документация + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Документация - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Безопасность - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Безопасность - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Документация - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Документация - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Безопасность - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Безопасность - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Документация - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Безопасность - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Документация - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Безопасность - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Возможности - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Безопасность - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Возможности - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Возможности - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Безопасность - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Безопасность - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Документация - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Документация - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Возможности - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Возможности - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Возможности - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Безопасность - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Возможности - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Возможности - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Возможности - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Возможности - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Возможности - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Возможности - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Возможности - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Возможности - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Безопасность - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Возможности - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Возможности - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Возможности - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Возможности - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Возможности - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Возможности - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Документация - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Возможности - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ru/CONTRIBUTING.md b/docs/i18n/ru/CONTRIBUTING.md index d9c4fa94e1..4e57f76533 100644 --- a/docs/i18n/ru/CONTRIBUTING.md +++ b/docs/i18n/ru/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ru/README.md b/docs/i18n/ru/README.md index 4a2a384558..2273678d9b 100644 --- a/docs/i18n/ru/README.md +++ b/docs/i18n/ru/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Документация -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ru/docs/ARCHITECTURE.md b/docs/i18n/ru/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ru/docs/ARCHITECTURE.md rename to docs/i18n/ru/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ru/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ru/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ru/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ru/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ru/docs/A2A-SERVER.md b/docs/i18n/ru/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ru/docs/A2A-SERVER.md rename to docs/i18n/ru/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ru/docs/MCP-SERVER.md b/docs/i18n/ru/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ru/docs/MCP-SERVER.md rename to docs/i18n/ru/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ru/docs/FEATURES.md b/docs/i18n/ru/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ru/docs/FEATURES.md rename to docs/i18n/ru/docs/guides/FEATURES.md diff --git a/docs/i18n/ru/docs/I18N.md b/docs/i18n/ru/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ru/docs/I18N.md rename to docs/i18n/ru/docs/guides/I18N.md index cfa5f8d303..87279292f0 100644 --- a/docs/i18n/ru/docs/I18N.md +++ b/docs/i18n/ru/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ru/docs/TROUBLESHOOTING.md b/docs/i18n/ru/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ru/docs/TROUBLESHOOTING.md rename to docs/i18n/ru/docs/guides/TROUBLESHOOTING.md index 9095358ebc..9fa7cd15ad 100644 --- a/docs/i18n/ru/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ru/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ru/docs/UNINSTALL.md b/docs/i18n/ru/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ru/docs/UNINSTALL.md rename to docs/i18n/ru/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ru/docs/USER_GUIDE.md b/docs/i18n/ru/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ru/docs/USER_GUIDE.md rename to docs/i18n/ru/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ru/docs/COVERAGE_PLAN.md b/docs/i18n/ru/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ru/docs/COVERAGE_PLAN.md rename to docs/i18n/ru/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ru/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ru/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ru/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ru/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ru/docs/RELEASE_CHECKLIST.md b/docs/i18n/ru/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ru/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ru/docs/ops/RELEASE_CHECKLIST.md index 71c8666811..5a75c470f4 100644 --- a/docs/i18n/ru/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ru/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ru/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ru/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ru/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ru/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ru/docs/API_REFERENCE.md b/docs/i18n/ru/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ru/docs/API_REFERENCE.md rename to docs/i18n/ru/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ru/docs/CLI-TOOLS.md b/docs/i18n/ru/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ru/docs/CLI-TOOLS.md rename to docs/i18n/ru/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ru/docs/ENVIRONMENT.md b/docs/i18n/ru/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ru/docs/ENVIRONMENT.md rename to docs/i18n/ru/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ru/docs/AUTO-COMBO.md b/docs/i18n/ru/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ru/docs/AUTO-COMBO.md rename to docs/i18n/ru/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ru/llm.txt b/docs/i18n/ru/llm.txt index 5ad11109be..754574a172 100644 --- a/docs/i18n/ru/llm.txt +++ b/docs/i18n/ru/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/sk/CHANGELOG.md b/docs/i18n/sk/CHANGELOG.md index a15a801e54..ea1db32aa7 100644 --- a/docs/i18n/sk/CHANGELOG.md +++ b/docs/i18n/sk/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Bezpečnosť +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentácia + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentácia - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Bezpečnosť - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Bezpečnosť - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentácia - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentácia - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Bezpečnosť - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Bezpečnosť - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentácia - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Bezpečnosť - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentácia - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Bezpečnosť - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funkcie - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Bezpečnosť - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funkcie - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funkcie - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Bezpečnosť - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Bezpečnosť - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentácia - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentácia - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funkcie - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funkcie - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funkcie - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Bezpečnosť - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funkcie - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funkcie - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funkcie - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funkcie - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funkcie - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funkcie - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funkcie - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funkcie - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Bezpečnosť - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funkcie - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funkcie - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funkcie - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funkcie - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funkcie - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funkcie - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentácia - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funkcie - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/sk/CONTRIBUTING.md b/docs/i18n/sk/CONTRIBUTING.md index bd838f7196..677750df6f 100644 --- a/docs/i18n/sk/CONTRIBUTING.md +++ b/docs/i18n/sk/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/sk/README.md b/docs/i18n/sk/README.md index aa3c743a3d..acb0194cec 100644 --- a/docs/i18n/sk/README.md +++ b/docs/i18n/sk/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentácia -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/sk/docs/ARCHITECTURE.md b/docs/i18n/sk/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/sk/docs/ARCHITECTURE.md rename to docs/i18n/sk/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/sk/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/sk/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/sk/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/sk/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/sk/docs/A2A-SERVER.md b/docs/i18n/sk/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/sk/docs/A2A-SERVER.md rename to docs/i18n/sk/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/sk/docs/MCP-SERVER.md b/docs/i18n/sk/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/sk/docs/MCP-SERVER.md rename to docs/i18n/sk/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/sk/docs/FEATURES.md b/docs/i18n/sk/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/sk/docs/FEATURES.md rename to docs/i18n/sk/docs/guides/FEATURES.md diff --git a/docs/i18n/sk/docs/I18N.md b/docs/i18n/sk/docs/guides/I18N.md similarity index 99% rename from docs/i18n/sk/docs/I18N.md rename to docs/i18n/sk/docs/guides/I18N.md index 730fb28193..a606ffe0a0 100644 --- a/docs/i18n/sk/docs/I18N.md +++ b/docs/i18n/sk/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/sk/docs/TROUBLESHOOTING.md b/docs/i18n/sk/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/sk/docs/TROUBLESHOOTING.md rename to docs/i18n/sk/docs/guides/TROUBLESHOOTING.md index cc0df932fd..69e37c671d 100644 --- a/docs/i18n/sk/docs/TROUBLESHOOTING.md +++ b/docs/i18n/sk/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/sk/docs/UNINSTALL.md b/docs/i18n/sk/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/sk/docs/UNINSTALL.md rename to docs/i18n/sk/docs/guides/UNINSTALL.md diff --git a/docs/i18n/sk/docs/USER_GUIDE.md b/docs/i18n/sk/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/sk/docs/USER_GUIDE.md rename to docs/i18n/sk/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/sk/docs/COVERAGE_PLAN.md b/docs/i18n/sk/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/sk/docs/COVERAGE_PLAN.md rename to docs/i18n/sk/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/sk/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/sk/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sk/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/sk/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sk/docs/RELEASE_CHECKLIST.md b/docs/i18n/sk/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/sk/docs/RELEASE_CHECKLIST.md rename to docs/i18n/sk/docs/ops/RELEASE_CHECKLIST.md index 9ed21278c1..80ec87e341 100644 --- a/docs/i18n/sk/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/sk/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/sk/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/sk/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sk/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/sk/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sk/docs/API_REFERENCE.md b/docs/i18n/sk/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/sk/docs/API_REFERENCE.md rename to docs/i18n/sk/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/sk/docs/CLI-TOOLS.md b/docs/i18n/sk/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/sk/docs/CLI-TOOLS.md rename to docs/i18n/sk/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/sk/docs/ENVIRONMENT.md b/docs/i18n/sk/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/sk/docs/ENVIRONMENT.md rename to docs/i18n/sk/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/sk/docs/AUTO-COMBO.md b/docs/i18n/sk/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/sk/docs/AUTO-COMBO.md rename to docs/i18n/sk/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/sk/llm.txt b/docs/i18n/sk/llm.txt index a3415fcd06..0dc07cd167 100644 --- a/docs/i18n/sk/llm.txt +++ b/docs/i18n/sk/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/sv/CHANGELOG.md b/docs/i18n/sv/CHANGELOG.md index 054939b40e..4baacbf190 100644 --- a/docs/i18n/sv/CHANGELOG.md +++ b/docs/i18n/sv/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Säkerhet +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Dokumentation + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Dokumentation - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Säkerhet - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Säkerhet - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Dokumentation - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Dokumentation - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Säkerhet - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Säkerhet - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Dokumentation - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Säkerhet - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Dokumentation - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Säkerhet - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funktioner - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Säkerhet - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funktioner - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funktioner - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Säkerhet - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Säkerhet - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Dokumentation - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Dokumentation - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funktioner - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funktioner - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funktioner - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Säkerhet - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funktioner - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funktioner - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funktioner - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funktioner - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funktioner - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funktioner - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funktioner - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funktioner - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Säkerhet - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funktioner - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funktioner - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funktioner - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funktioner - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funktioner - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funktioner - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Dokumentation - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funktioner - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/sv/CONTRIBUTING.md b/docs/i18n/sv/CONTRIBUTING.md index badf89519f..6509c1f5c3 100644 --- a/docs/i18n/sv/CONTRIBUTING.md +++ b/docs/i18n/sv/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/sv/README.md b/docs/i18n/sv/README.md index 298d243955..887ef03464 100644 --- a/docs/i18n/sv/README.md +++ b/docs/i18n/sv/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Dokumentation -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/sv/docs/ARCHITECTURE.md b/docs/i18n/sv/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/sv/docs/ARCHITECTURE.md rename to docs/i18n/sv/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/sv/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/sv/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/sv/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/sv/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/sv/docs/A2A-SERVER.md b/docs/i18n/sv/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/sv/docs/A2A-SERVER.md rename to docs/i18n/sv/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/sv/docs/MCP-SERVER.md b/docs/i18n/sv/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/sv/docs/MCP-SERVER.md rename to docs/i18n/sv/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/sv/docs/FEATURES.md b/docs/i18n/sv/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/sv/docs/FEATURES.md rename to docs/i18n/sv/docs/guides/FEATURES.md diff --git a/docs/i18n/sv/docs/I18N.md b/docs/i18n/sv/docs/guides/I18N.md similarity index 99% rename from docs/i18n/sv/docs/I18N.md rename to docs/i18n/sv/docs/guides/I18N.md index fb4cc6724e..327e647112 100644 --- a/docs/i18n/sv/docs/I18N.md +++ b/docs/i18n/sv/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/sv/docs/TROUBLESHOOTING.md b/docs/i18n/sv/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/sv/docs/TROUBLESHOOTING.md rename to docs/i18n/sv/docs/guides/TROUBLESHOOTING.md index f9d04efd71..aafabe2f6f 100644 --- a/docs/i18n/sv/docs/TROUBLESHOOTING.md +++ b/docs/i18n/sv/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/sv/docs/UNINSTALL.md b/docs/i18n/sv/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/sv/docs/UNINSTALL.md rename to docs/i18n/sv/docs/guides/UNINSTALL.md diff --git a/docs/i18n/sv/docs/USER_GUIDE.md b/docs/i18n/sv/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/sv/docs/USER_GUIDE.md rename to docs/i18n/sv/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/sv/docs/COVERAGE_PLAN.md b/docs/i18n/sv/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/sv/docs/COVERAGE_PLAN.md rename to docs/i18n/sv/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/sv/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/sv/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sv/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/sv/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sv/docs/RELEASE_CHECKLIST.md b/docs/i18n/sv/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/sv/docs/RELEASE_CHECKLIST.md rename to docs/i18n/sv/docs/ops/RELEASE_CHECKLIST.md index 27a3be9488..8d03464d6e 100644 --- a/docs/i18n/sv/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/sv/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/sv/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/sv/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sv/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/sv/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sv/docs/API_REFERENCE.md b/docs/i18n/sv/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/sv/docs/API_REFERENCE.md rename to docs/i18n/sv/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/sv/docs/CLI-TOOLS.md b/docs/i18n/sv/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/sv/docs/CLI-TOOLS.md rename to docs/i18n/sv/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/sv/docs/ENVIRONMENT.md b/docs/i18n/sv/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/sv/docs/ENVIRONMENT.md rename to docs/i18n/sv/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/sv/docs/AUTO-COMBO.md b/docs/i18n/sv/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/sv/docs/AUTO-COMBO.md rename to docs/i18n/sv/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/sv/llm.txt b/docs/i18n/sv/llm.txt index b5f4d93299..debc38bd6b 100644 --- a/docs/i18n/sv/llm.txt +++ b/docs/i18n/sv/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/sw/CHANGELOG.md b/docs/i18n/sw/CHANGELOG.md index 3e361ecdbc..847e10ff90 100644 --- a/docs/i18n/sw/CHANGELOG.md +++ b/docs/i18n/sw/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/sw/CONTRIBUTING.md b/docs/i18n/sw/CONTRIBUTING.md index 165f664ff1..f05d33b53a 100644 --- a/docs/i18n/sw/CONTRIBUTING.md +++ b/docs/i18n/sw/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/sw/README.md b/docs/i18n/sw/README.md index db067e44ac..3a399c0b72 100644 --- a/docs/i18n/sw/README.md +++ b/docs/i18n/sw/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/sw/docs/ARCHITECTURE.md b/docs/i18n/sw/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/sw/docs/ARCHITECTURE.md rename to docs/i18n/sw/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/sw/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/sw/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/sw/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/sw/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/sw/docs/A2A-SERVER.md b/docs/i18n/sw/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/sw/docs/A2A-SERVER.md rename to docs/i18n/sw/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/sw/docs/MCP-SERVER.md b/docs/i18n/sw/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/sw/docs/MCP-SERVER.md rename to docs/i18n/sw/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/sw/docs/FEATURES.md b/docs/i18n/sw/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/sw/docs/FEATURES.md rename to docs/i18n/sw/docs/guides/FEATURES.md diff --git a/docs/i18n/sw/docs/I18N.md b/docs/i18n/sw/docs/guides/I18N.md similarity index 99% rename from docs/i18n/sw/docs/I18N.md rename to docs/i18n/sw/docs/guides/I18N.md index 74b495c242..ec2ad43df7 100644 --- a/docs/i18n/sw/docs/I18N.md +++ b/docs/i18n/sw/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/sw/docs/TROUBLESHOOTING.md b/docs/i18n/sw/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/sw/docs/TROUBLESHOOTING.md rename to docs/i18n/sw/docs/guides/TROUBLESHOOTING.md index d627ca0715..2e501b3b0d 100644 --- a/docs/i18n/sw/docs/TROUBLESHOOTING.md +++ b/docs/i18n/sw/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/sw/docs/UNINSTALL.md b/docs/i18n/sw/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/sw/docs/UNINSTALL.md rename to docs/i18n/sw/docs/guides/UNINSTALL.md diff --git a/docs/i18n/sw/docs/USER_GUIDE.md b/docs/i18n/sw/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/sw/docs/USER_GUIDE.md rename to docs/i18n/sw/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/sw/docs/COVERAGE_PLAN.md b/docs/i18n/sw/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/sw/docs/COVERAGE_PLAN.md rename to docs/i18n/sw/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/sw/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/sw/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sw/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/sw/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sw/docs/RELEASE_CHECKLIST.md b/docs/i18n/sw/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/sw/docs/RELEASE_CHECKLIST.md rename to docs/i18n/sw/docs/ops/RELEASE_CHECKLIST.md index 2c25414513..f2e36d0e84 100644 --- a/docs/i18n/sw/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/sw/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/sw/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/sw/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/sw/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/sw/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/sw/docs/API_REFERENCE.md b/docs/i18n/sw/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/sw/docs/API_REFERENCE.md rename to docs/i18n/sw/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/sw/docs/CLI-TOOLS.md b/docs/i18n/sw/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/sw/docs/CLI-TOOLS.md rename to docs/i18n/sw/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/sw/docs/ENVIRONMENT.md b/docs/i18n/sw/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/sw/docs/ENVIRONMENT.md rename to docs/i18n/sw/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/sw/docs/AUTO-COMBO.md b/docs/i18n/sw/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/sw/docs/AUTO-COMBO.md rename to docs/i18n/sw/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/sw/llm.txt b/docs/i18n/sw/llm.txt index 95bdcb6513..b155a3eca9 100644 --- a/docs/i18n/sw/llm.txt +++ b/docs/i18n/sw/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ta/CHANGELOG.md b/docs/i18n/ta/CHANGELOG.md index 299368152d..9d804825ce 100644 --- a/docs/i18n/ta/CHANGELOG.md +++ b/docs/i18n/ta/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ta/CONTRIBUTING.md b/docs/i18n/ta/CONTRIBUTING.md index cd3facbcae..188e0d7f56 100644 --- a/docs/i18n/ta/CONTRIBUTING.md +++ b/docs/i18n/ta/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ta/README.md b/docs/i18n/ta/README.md index 0be49d8e50..b1ff3cc743 100644 --- a/docs/i18n/ta/README.md +++ b/docs/i18n/ta/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ta/docs/ARCHITECTURE.md b/docs/i18n/ta/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ta/docs/ARCHITECTURE.md rename to docs/i18n/ta/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ta/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ta/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ta/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ta/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ta/docs/A2A-SERVER.md b/docs/i18n/ta/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ta/docs/A2A-SERVER.md rename to docs/i18n/ta/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ta/docs/MCP-SERVER.md b/docs/i18n/ta/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ta/docs/MCP-SERVER.md rename to docs/i18n/ta/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ta/docs/FEATURES.md b/docs/i18n/ta/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ta/docs/FEATURES.md rename to docs/i18n/ta/docs/guides/FEATURES.md diff --git a/docs/i18n/ta/docs/I18N.md b/docs/i18n/ta/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ta/docs/I18N.md rename to docs/i18n/ta/docs/guides/I18N.md index 13d2f896c0..679e0ae54e 100644 --- a/docs/i18n/ta/docs/I18N.md +++ b/docs/i18n/ta/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ta/docs/TROUBLESHOOTING.md b/docs/i18n/ta/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ta/docs/TROUBLESHOOTING.md rename to docs/i18n/ta/docs/guides/TROUBLESHOOTING.md index cd6d0db066..9ee7d18489 100644 --- a/docs/i18n/ta/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ta/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ta/docs/UNINSTALL.md b/docs/i18n/ta/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ta/docs/UNINSTALL.md rename to docs/i18n/ta/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ta/docs/USER_GUIDE.md b/docs/i18n/ta/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ta/docs/USER_GUIDE.md rename to docs/i18n/ta/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ta/docs/COVERAGE_PLAN.md b/docs/i18n/ta/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ta/docs/COVERAGE_PLAN.md rename to docs/i18n/ta/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ta/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ta/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ta/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ta/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ta/docs/RELEASE_CHECKLIST.md b/docs/i18n/ta/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ta/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ta/docs/ops/RELEASE_CHECKLIST.md index a275cb136a..0e679b7a4b 100644 --- a/docs/i18n/ta/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ta/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ta/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ta/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ta/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ta/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ta/docs/API_REFERENCE.md b/docs/i18n/ta/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ta/docs/API_REFERENCE.md rename to docs/i18n/ta/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ta/docs/CLI-TOOLS.md b/docs/i18n/ta/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ta/docs/CLI-TOOLS.md rename to docs/i18n/ta/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ta/docs/ENVIRONMENT.md b/docs/i18n/ta/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ta/docs/ENVIRONMENT.md rename to docs/i18n/ta/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ta/docs/AUTO-COMBO.md b/docs/i18n/ta/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ta/docs/AUTO-COMBO.md rename to docs/i18n/ta/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ta/llm.txt b/docs/i18n/ta/llm.txt index f7a4ed71ce..e6e7d63861 100644 --- a/docs/i18n/ta/llm.txt +++ b/docs/i18n/ta/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/te/CHANGELOG.md b/docs/i18n/te/CHANGELOG.md index c35c2285ac..223be5d4ca 100644 --- a/docs/i18n/te/CHANGELOG.md +++ b/docs/i18n/te/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/te/CONTRIBUTING.md b/docs/i18n/te/CONTRIBUTING.md index 9898b8ff2e..a543a9422a 100644 --- a/docs/i18n/te/CONTRIBUTING.md +++ b/docs/i18n/te/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/te/README.md b/docs/i18n/te/README.md index fa7c3c41ac..a4df895043 100644 --- a/docs/i18n/te/README.md +++ b/docs/i18n/te/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/te/docs/ARCHITECTURE.md b/docs/i18n/te/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/te/docs/ARCHITECTURE.md rename to docs/i18n/te/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/te/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/te/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/te/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/te/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/te/docs/A2A-SERVER.md b/docs/i18n/te/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/te/docs/A2A-SERVER.md rename to docs/i18n/te/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/te/docs/MCP-SERVER.md b/docs/i18n/te/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/te/docs/MCP-SERVER.md rename to docs/i18n/te/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/te/docs/FEATURES.md b/docs/i18n/te/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/te/docs/FEATURES.md rename to docs/i18n/te/docs/guides/FEATURES.md diff --git a/docs/i18n/te/docs/I18N.md b/docs/i18n/te/docs/guides/I18N.md similarity index 99% rename from docs/i18n/te/docs/I18N.md rename to docs/i18n/te/docs/guides/I18N.md index 336c3be722..41a3fde528 100644 --- a/docs/i18n/te/docs/I18N.md +++ b/docs/i18n/te/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/te/docs/TROUBLESHOOTING.md b/docs/i18n/te/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/te/docs/TROUBLESHOOTING.md rename to docs/i18n/te/docs/guides/TROUBLESHOOTING.md index 5a13f106b3..b2421aaa15 100644 --- a/docs/i18n/te/docs/TROUBLESHOOTING.md +++ b/docs/i18n/te/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/te/docs/UNINSTALL.md b/docs/i18n/te/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/te/docs/UNINSTALL.md rename to docs/i18n/te/docs/guides/UNINSTALL.md diff --git a/docs/i18n/te/docs/USER_GUIDE.md b/docs/i18n/te/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/te/docs/USER_GUIDE.md rename to docs/i18n/te/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/te/docs/COVERAGE_PLAN.md b/docs/i18n/te/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/te/docs/COVERAGE_PLAN.md rename to docs/i18n/te/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/te/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/te/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/te/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/te/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/te/docs/RELEASE_CHECKLIST.md b/docs/i18n/te/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/te/docs/RELEASE_CHECKLIST.md rename to docs/i18n/te/docs/ops/RELEASE_CHECKLIST.md index f3e0f7d363..172905ed12 100644 --- a/docs/i18n/te/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/te/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/te/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/te/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/te/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/te/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/te/docs/API_REFERENCE.md b/docs/i18n/te/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/te/docs/API_REFERENCE.md rename to docs/i18n/te/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/te/docs/CLI-TOOLS.md b/docs/i18n/te/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/te/docs/CLI-TOOLS.md rename to docs/i18n/te/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/te/docs/ENVIRONMENT.md b/docs/i18n/te/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/te/docs/ENVIRONMENT.md rename to docs/i18n/te/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/te/docs/AUTO-COMBO.md b/docs/i18n/te/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/te/docs/AUTO-COMBO.md rename to docs/i18n/te/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/te/llm.txt b/docs/i18n/te/llm.txt index 7a2bdfbcf2..b9d396c2c4 100644 --- a/docs/i18n/te/llm.txt +++ b/docs/i18n/te/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/th/CHANGELOG.md b/docs/i18n/th/CHANGELOG.md index c6f0ad1a37..1c18e1a99f 100644 --- a/docs/i18n/th/CHANGELOG.md +++ b/docs/i18n/th/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### ความปลอดภัย +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### เอกสาร + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### เอกสาร - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### ความปลอดภัย - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### ความปลอดภัย - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### เอกสาร - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### เอกสาร - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### ความปลอดภัย - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### ความปลอดภัย - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### เอกสาร - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### ความปลอดภัย - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### เอกสาร - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### ความปลอดภัย - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### คุณสมบัติ - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### ความปลอดภัย - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### คุณสมบัติ - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### คุณสมบัติ - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### ความปลอดภัย - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### ความปลอดภัย - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### เอกสาร - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### เอกสาร - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### คุณสมบัติ - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### คุณสมบัติ - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### คุณสมบัติ - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### ความปลอดภัย - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### คุณสมบัติ - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### คุณสมบัติ - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### คุณสมบัติ - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### คุณสมบัติ - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### คุณสมบัติ - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### คุณสมบัติ - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### คุณสมบัติ - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### คุณสมบัติ - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### ความปลอดภัย - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### คุณสมบัติ - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### คุณสมบัติ - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### คุณสมบัติ - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### คุณสมบัติ - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### คุณสมบัติ - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### คุณสมบัติ - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### เอกสาร - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### คุณสมบัติ - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/th/CONTRIBUTING.md b/docs/i18n/th/CONTRIBUTING.md index 81f73ea9c3..40d412c63f 100644 --- a/docs/i18n/th/CONTRIBUTING.md +++ b/docs/i18n/th/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/th/README.md b/docs/i18n/th/README.md index 791cc41173..3310941bc0 100644 --- a/docs/i18n/th/README.md +++ b/docs/i18n/th/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## เอกสาร -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/th/docs/ARCHITECTURE.md b/docs/i18n/th/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/th/docs/ARCHITECTURE.md rename to docs/i18n/th/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/th/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/th/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/th/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/th/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/th/docs/A2A-SERVER.md b/docs/i18n/th/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/th/docs/A2A-SERVER.md rename to docs/i18n/th/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/th/docs/MCP-SERVER.md b/docs/i18n/th/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/th/docs/MCP-SERVER.md rename to docs/i18n/th/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/th/docs/FEATURES.md b/docs/i18n/th/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/th/docs/FEATURES.md rename to docs/i18n/th/docs/guides/FEATURES.md diff --git a/docs/i18n/th/docs/I18N.md b/docs/i18n/th/docs/guides/I18N.md similarity index 99% rename from docs/i18n/th/docs/I18N.md rename to docs/i18n/th/docs/guides/I18N.md index 72b1081f7e..ffb13810a5 100644 --- a/docs/i18n/th/docs/I18N.md +++ b/docs/i18n/th/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/th/docs/TROUBLESHOOTING.md b/docs/i18n/th/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/th/docs/TROUBLESHOOTING.md rename to docs/i18n/th/docs/guides/TROUBLESHOOTING.md index e0343f007f..d26154aaad 100644 --- a/docs/i18n/th/docs/TROUBLESHOOTING.md +++ b/docs/i18n/th/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/th/docs/UNINSTALL.md b/docs/i18n/th/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/th/docs/UNINSTALL.md rename to docs/i18n/th/docs/guides/UNINSTALL.md diff --git a/docs/i18n/th/docs/USER_GUIDE.md b/docs/i18n/th/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/th/docs/USER_GUIDE.md rename to docs/i18n/th/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/th/docs/COVERAGE_PLAN.md b/docs/i18n/th/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/th/docs/COVERAGE_PLAN.md rename to docs/i18n/th/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/th/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/th/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/th/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/th/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/th/docs/RELEASE_CHECKLIST.md b/docs/i18n/th/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/th/docs/RELEASE_CHECKLIST.md rename to docs/i18n/th/docs/ops/RELEASE_CHECKLIST.md index 9f31a4e1b7..7295220227 100644 --- a/docs/i18n/th/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/th/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/th/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/th/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/th/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/th/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/th/docs/API_REFERENCE.md b/docs/i18n/th/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/th/docs/API_REFERENCE.md rename to docs/i18n/th/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/th/docs/CLI-TOOLS.md b/docs/i18n/th/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/th/docs/CLI-TOOLS.md rename to docs/i18n/th/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/th/docs/ENVIRONMENT.md b/docs/i18n/th/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/th/docs/ENVIRONMENT.md rename to docs/i18n/th/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/th/docs/AUTO-COMBO.md b/docs/i18n/th/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/th/docs/AUTO-COMBO.md rename to docs/i18n/th/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/th/llm.txt b/docs/i18n/th/llm.txt index fd8a43b8c9..e94e4315a2 100644 --- a/docs/i18n/th/llm.txt +++ b/docs/i18n/th/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/tr/CHANGELOG.md b/docs/i18n/tr/CHANGELOG.md index ae3a94c8ed..6a76f5d58b 100644 --- a/docs/i18n/tr/CHANGELOG.md +++ b/docs/i18n/tr/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Güvenlik +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Belgeler + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Belgeler - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Güvenlik - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Güvenlik - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Belgeler - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Belgeler - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Güvenlik - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Güvenlik - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Belgeler - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Güvenlik - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Belgeler - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Güvenlik - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Özellikler - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Güvenlik - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Özellikler - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Özellikler - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Güvenlik - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Güvenlik - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Belgeler - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Belgeler - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Özellikler - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Özellikler - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Özellikler - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Güvenlik - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Özellikler - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Özellikler - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Özellikler - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Özellikler - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Özellikler - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Özellikler - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Özellikler - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Özellikler - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Güvenlik - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Özellikler - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Özellikler - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Özellikler - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Özellikler - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Özellikler - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Özellikler - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Belgeler - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Özellikler - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/tr/CONTRIBUTING.md b/docs/i18n/tr/CONTRIBUTING.md index 01cb7453ee..2d5a1cf7b1 100644 --- a/docs/i18n/tr/CONTRIBUTING.md +++ b/docs/i18n/tr/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/tr/README.md b/docs/i18n/tr/README.md index 9e73fd82af..7913d08756 100644 --- a/docs/i18n/tr/README.md +++ b/docs/i18n/tr/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Belgeler -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/tr/docs/ARCHITECTURE.md b/docs/i18n/tr/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/tr/docs/ARCHITECTURE.md rename to docs/i18n/tr/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/tr/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/tr/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/tr/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/tr/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/tr/docs/A2A-SERVER.md b/docs/i18n/tr/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/tr/docs/A2A-SERVER.md rename to docs/i18n/tr/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/tr/docs/MCP-SERVER.md b/docs/i18n/tr/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/tr/docs/MCP-SERVER.md rename to docs/i18n/tr/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/tr/docs/FEATURES.md b/docs/i18n/tr/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/tr/docs/FEATURES.md rename to docs/i18n/tr/docs/guides/FEATURES.md diff --git a/docs/i18n/tr/docs/I18N.md b/docs/i18n/tr/docs/guides/I18N.md similarity index 99% rename from docs/i18n/tr/docs/I18N.md rename to docs/i18n/tr/docs/guides/I18N.md index 372ee8fbe6..6ecb94e2af 100644 --- a/docs/i18n/tr/docs/I18N.md +++ b/docs/i18n/tr/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/tr/docs/TROUBLESHOOTING.md b/docs/i18n/tr/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/tr/docs/TROUBLESHOOTING.md rename to docs/i18n/tr/docs/guides/TROUBLESHOOTING.md index 982b8ab94e..626660e0ee 100644 --- a/docs/i18n/tr/docs/TROUBLESHOOTING.md +++ b/docs/i18n/tr/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/tr/docs/UNINSTALL.md b/docs/i18n/tr/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/tr/docs/UNINSTALL.md rename to docs/i18n/tr/docs/guides/UNINSTALL.md diff --git a/docs/i18n/tr/docs/USER_GUIDE.md b/docs/i18n/tr/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/tr/docs/USER_GUIDE.md rename to docs/i18n/tr/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/tr/docs/COVERAGE_PLAN.md b/docs/i18n/tr/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/tr/docs/COVERAGE_PLAN.md rename to docs/i18n/tr/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/tr/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/tr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/tr/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/tr/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/tr/docs/RELEASE_CHECKLIST.md b/docs/i18n/tr/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/tr/docs/RELEASE_CHECKLIST.md rename to docs/i18n/tr/docs/ops/RELEASE_CHECKLIST.md index a9ed14e791..23b681a69e 100644 --- a/docs/i18n/tr/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/tr/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/tr/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/tr/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/tr/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/tr/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/tr/docs/API_REFERENCE.md b/docs/i18n/tr/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/tr/docs/API_REFERENCE.md rename to docs/i18n/tr/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/tr/docs/CLI-TOOLS.md b/docs/i18n/tr/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/tr/docs/CLI-TOOLS.md rename to docs/i18n/tr/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/tr/docs/ENVIRONMENT.md b/docs/i18n/tr/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/tr/docs/ENVIRONMENT.md rename to docs/i18n/tr/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/tr/docs/AUTO-COMBO.md b/docs/i18n/tr/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/tr/docs/AUTO-COMBO.md rename to docs/i18n/tr/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/tr/llm.txt b/docs/i18n/tr/llm.txt index b0d0c12d59..79c79934c0 100644 --- a/docs/i18n/tr/llm.txt +++ b/docs/i18n/tr/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/uk-UA/CHANGELOG.md b/docs/i18n/uk-UA/CHANGELOG.md index d1e855dacc..3dbc00245a 100644 --- a/docs/i18n/uk-UA/CHANGELOG.md +++ b/docs/i18n/uk-UA/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Безпека +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Документація + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Документація - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Безпека - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Безпека - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Документація - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Документація - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Безпека - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Безпека - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Документація - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Безпека - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Документація - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Безпека - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Можливості - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Безпека - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Можливості - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Можливості - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Безпека - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Безпека - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Документація - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Документація - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Можливості - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Можливості - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Можливості - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Безпека - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Можливості - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Можливості - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Можливості - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Можливості - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Можливості - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Можливості - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Можливості - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Можливості - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Безпека - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Можливості - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Можливості - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Можливості - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Можливості - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Можливості - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Можливості - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Документація - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Можливості - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/uk-UA/CONTRIBUTING.md b/docs/i18n/uk-UA/CONTRIBUTING.md index 3429c4b314..62ca1f5c6b 100644 --- a/docs/i18n/uk-UA/CONTRIBUTING.md +++ b/docs/i18n/uk-UA/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/uk-UA/README.md b/docs/i18n/uk-UA/README.md index 164291d59e..2b7cd0488e 100644 --- a/docs/i18n/uk-UA/README.md +++ b/docs/i18n/uk-UA/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Документація -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/uk-UA/docs/ARCHITECTURE.md b/docs/i18n/uk-UA/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/uk-UA/docs/ARCHITECTURE.md rename to docs/i18n/uk-UA/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/uk-UA/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/uk-UA/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/uk-UA/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/uk-UA/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/uk-UA/docs/A2A-SERVER.md b/docs/i18n/uk-UA/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/uk-UA/docs/A2A-SERVER.md rename to docs/i18n/uk-UA/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/uk-UA/docs/MCP-SERVER.md b/docs/i18n/uk-UA/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/uk-UA/docs/MCP-SERVER.md rename to docs/i18n/uk-UA/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/uk-UA/docs/FEATURES.md b/docs/i18n/uk-UA/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/uk-UA/docs/FEATURES.md rename to docs/i18n/uk-UA/docs/guides/FEATURES.md diff --git a/docs/i18n/uk-UA/docs/I18N.md b/docs/i18n/uk-UA/docs/guides/I18N.md similarity index 99% rename from docs/i18n/uk-UA/docs/I18N.md rename to docs/i18n/uk-UA/docs/guides/I18N.md index b468c09940..0b0e77329b 100644 --- a/docs/i18n/uk-UA/docs/I18N.md +++ b/docs/i18n/uk-UA/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/uk-UA/docs/TROUBLESHOOTING.md b/docs/i18n/uk-UA/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/uk-UA/docs/TROUBLESHOOTING.md rename to docs/i18n/uk-UA/docs/guides/TROUBLESHOOTING.md index 067ef13b9b..e1a0a4d0b1 100644 --- a/docs/i18n/uk-UA/docs/TROUBLESHOOTING.md +++ b/docs/i18n/uk-UA/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/uk-UA/docs/UNINSTALL.md b/docs/i18n/uk-UA/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/uk-UA/docs/UNINSTALL.md rename to docs/i18n/uk-UA/docs/guides/UNINSTALL.md diff --git a/docs/i18n/uk-UA/docs/USER_GUIDE.md b/docs/i18n/uk-UA/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/uk-UA/docs/USER_GUIDE.md rename to docs/i18n/uk-UA/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/uk-UA/docs/COVERAGE_PLAN.md b/docs/i18n/uk-UA/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/uk-UA/docs/COVERAGE_PLAN.md rename to docs/i18n/uk-UA/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/uk-UA/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/uk-UA/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/uk-UA/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/uk-UA/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/uk-UA/docs/RELEASE_CHECKLIST.md b/docs/i18n/uk-UA/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/uk-UA/docs/RELEASE_CHECKLIST.md rename to docs/i18n/uk-UA/docs/ops/RELEASE_CHECKLIST.md index c2461ce436..c3905bef2f 100644 --- a/docs/i18n/uk-UA/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/uk-UA/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/uk-UA/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/uk-UA/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/uk-UA/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/uk-UA/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/uk-UA/docs/API_REFERENCE.md b/docs/i18n/uk-UA/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/uk-UA/docs/API_REFERENCE.md rename to docs/i18n/uk-UA/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/uk-UA/docs/CLI-TOOLS.md b/docs/i18n/uk-UA/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/uk-UA/docs/CLI-TOOLS.md rename to docs/i18n/uk-UA/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/uk-UA/docs/ENVIRONMENT.md b/docs/i18n/uk-UA/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/uk-UA/docs/ENVIRONMENT.md rename to docs/i18n/uk-UA/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/uk-UA/docs/AUTO-COMBO.md b/docs/i18n/uk-UA/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/uk-UA/docs/AUTO-COMBO.md rename to docs/i18n/uk-UA/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/uk-UA/llm.txt b/docs/i18n/uk-UA/llm.txt index 424f53a820..99d1ef1648 100644 --- a/docs/i18n/uk-UA/llm.txt +++ b/docs/i18n/uk-UA/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/ur/CHANGELOG.md b/docs/i18n/ur/CHANGELOG.md index 51d28b576f..c2f5801582 100644 --- a/docs/i18n/ur/CHANGELOG.md +++ b/docs/i18n/ur/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Seguridad +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Documentación + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Documentación - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Seguridad - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Seguridad - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Documentación - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Documentación - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Seguridad - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Seguridad - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Documentación - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Seguridad - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Documentación - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Seguridad - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Funcionalidades - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Seguridad - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Funcionalidades - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Funcionalidades - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Seguridad - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Seguridad - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Documentación - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Documentación - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Funcionalidades - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Funcionalidades - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Funcionalidades - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Seguridad - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Funcionalidades - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Funcionalidades - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Funcionalidades - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Funcionalidades - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Funcionalidades - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Funcionalidades - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Funcionalidades - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Seguridad - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Funcionalidades - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Funcionalidades - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Funcionalidades - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Funcionalidades - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Funcionalidades - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Funcionalidades - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Documentación - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Funcionalidades - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/ur/CONTRIBUTING.md b/docs/i18n/ur/CONTRIBUTING.md index 007cd4b863..c9716461fb 100644 --- a/docs/i18n/ur/CONTRIBUTING.md +++ b/docs/i18n/ur/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/ur/README.md b/docs/i18n/ur/README.md index 49c4759369..08020c01b0 100644 --- a/docs/i18n/ur/README.md +++ b/docs/i18n/ur/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Documentación -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/auto-combo.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/ur/docs/ARCHITECTURE.md b/docs/i18n/ur/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/ur/docs/ARCHITECTURE.md rename to docs/i18n/ur/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/ur/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/ur/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/ur/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/ur/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/ur/docs/A2A-SERVER.md b/docs/i18n/ur/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/ur/docs/A2A-SERVER.md rename to docs/i18n/ur/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/ur/docs/MCP-SERVER.md b/docs/i18n/ur/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/ur/docs/MCP-SERVER.md rename to docs/i18n/ur/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/ur/docs/FEATURES.md b/docs/i18n/ur/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/ur/docs/FEATURES.md rename to docs/i18n/ur/docs/guides/FEATURES.md diff --git a/docs/i18n/ur/docs/I18N.md b/docs/i18n/ur/docs/guides/I18N.md similarity index 99% rename from docs/i18n/ur/docs/I18N.md rename to docs/i18n/ur/docs/guides/I18N.md index d2724aef25..793396ba59 100644 --- a/docs/i18n/ur/docs/I18N.md +++ b/docs/i18n/ur/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/ur/docs/TROUBLESHOOTING.md b/docs/i18n/ur/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/ur/docs/TROUBLESHOOTING.md rename to docs/i18n/ur/docs/guides/TROUBLESHOOTING.md index 41dff9595d..43089bfd01 100644 --- a/docs/i18n/ur/docs/TROUBLESHOOTING.md +++ b/docs/i18n/ur/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/ur/docs/UNINSTALL.md b/docs/i18n/ur/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/ur/docs/UNINSTALL.md rename to docs/i18n/ur/docs/guides/UNINSTALL.md diff --git a/docs/i18n/ur/docs/USER_GUIDE.md b/docs/i18n/ur/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/ur/docs/USER_GUIDE.md rename to docs/i18n/ur/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/ur/docs/COVERAGE_PLAN.md b/docs/i18n/ur/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/ur/docs/COVERAGE_PLAN.md rename to docs/i18n/ur/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/ur/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/ur/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ur/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/ur/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ur/docs/RELEASE_CHECKLIST.md b/docs/i18n/ur/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/ur/docs/RELEASE_CHECKLIST.md rename to docs/i18n/ur/docs/ops/RELEASE_CHECKLIST.md index 48dde6bfe8..2d95ec1545 100644 --- a/docs/i18n/ur/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/ur/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/ur/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/ur/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/ur/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/ur/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/ur/docs/API_REFERENCE.md b/docs/i18n/ur/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/ur/docs/API_REFERENCE.md rename to docs/i18n/ur/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/ur/docs/CLI-TOOLS.md b/docs/i18n/ur/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/ur/docs/CLI-TOOLS.md rename to docs/i18n/ur/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/ur/docs/ENVIRONMENT.md b/docs/i18n/ur/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/ur/docs/ENVIRONMENT.md rename to docs/i18n/ur/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/ur/docs/AUTO-COMBO.md b/docs/i18n/ur/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/ur/docs/AUTO-COMBO.md rename to docs/i18n/ur/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/ur/llm.txt b/docs/i18n/ur/llm.txt index f85a35aa5c..3ef46a1705 100644 --- a/docs/i18n/ur/llm.txt +++ b/docs/i18n/ur/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/vi/CHANGELOG.md b/docs/i18n/vi/CHANGELOG.md index 52b084da4d..d3e965b790 100644 --- a/docs/i18n/vi/CHANGELOG.md +++ b/docs/i18n/vi/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### Bảo mật +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### Tài liệu + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### Tài liệu - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### Bảo mật - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### Bảo mật - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### Tài liệu - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### Tài liệu - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### Bảo mật - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### Bảo mật - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### Tài liệu - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### Bảo mật - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### Tài liệu - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### Bảo mật - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### Tính năng - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### Bảo mật - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### Tính năng - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### Tính năng - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### Bảo mật - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### Bảo mật - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### Tài liệu - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### Tài liệu - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### Tính năng - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### Tính năng - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### Tính năng - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### Bảo mật - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### Tính năng - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### Tính năng - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### Tính năng - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### Tính năng - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### Tính năng - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### Tính năng - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### Tính năng - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### Tính năng - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### Bảo mật - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### Tính năng - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### Tính năng - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### Tính năng - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### Tính năng - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### Tính năng - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### Tính năng - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### Tài liệu - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### Tính năng - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/vi/CONTRIBUTING.md b/docs/i18n/vi/CONTRIBUTING.md index 900af1478e..bcfc476f46 100644 --- a/docs/i18n/vi/CONTRIBUTING.md +++ b/docs/i18n/vi/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/vi/README.md b/docs/i18n/vi/README.md index 430c018158..01a5942e79 100644 --- a/docs/i18n/vi/README.md +++ b/docs/i18n/vi/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## Tài liệu -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/vi/docs/ARCHITECTURE.md b/docs/i18n/vi/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/vi/docs/ARCHITECTURE.md rename to docs/i18n/vi/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/vi/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/vi/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/vi/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/vi/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/vi/docs/A2A-SERVER.md b/docs/i18n/vi/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/vi/docs/A2A-SERVER.md rename to docs/i18n/vi/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/vi/docs/MCP-SERVER.md b/docs/i18n/vi/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/vi/docs/MCP-SERVER.md rename to docs/i18n/vi/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/vi/docs/FEATURES.md b/docs/i18n/vi/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/vi/docs/FEATURES.md rename to docs/i18n/vi/docs/guides/FEATURES.md diff --git a/docs/i18n/vi/docs/I18N.md b/docs/i18n/vi/docs/guides/I18N.md similarity index 99% rename from docs/i18n/vi/docs/I18N.md rename to docs/i18n/vi/docs/guides/I18N.md index ba60c90883..6c5492915e 100644 --- a/docs/i18n/vi/docs/I18N.md +++ b/docs/i18n/vi/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/vi/docs/TROUBLESHOOTING.md b/docs/i18n/vi/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/vi/docs/TROUBLESHOOTING.md rename to docs/i18n/vi/docs/guides/TROUBLESHOOTING.md index 1b98324743..3bf2e68129 100644 --- a/docs/i18n/vi/docs/TROUBLESHOOTING.md +++ b/docs/i18n/vi/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/vi/docs/UNINSTALL.md b/docs/i18n/vi/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/vi/docs/UNINSTALL.md rename to docs/i18n/vi/docs/guides/UNINSTALL.md diff --git a/docs/i18n/vi/docs/USER_GUIDE.md b/docs/i18n/vi/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/vi/docs/USER_GUIDE.md rename to docs/i18n/vi/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/vi/docs/COVERAGE_PLAN.md b/docs/i18n/vi/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/vi/docs/COVERAGE_PLAN.md rename to docs/i18n/vi/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/vi/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/vi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/vi/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/vi/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/vi/docs/RELEASE_CHECKLIST.md b/docs/i18n/vi/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/vi/docs/RELEASE_CHECKLIST.md rename to docs/i18n/vi/docs/ops/RELEASE_CHECKLIST.md index da7adf8571..f72ba6c251 100644 --- a/docs/i18n/vi/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/vi/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/vi/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/vi/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/vi/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/vi/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/vi/docs/API_REFERENCE.md b/docs/i18n/vi/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/vi/docs/API_REFERENCE.md rename to docs/i18n/vi/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/vi/docs/CLI-TOOLS.md b/docs/i18n/vi/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/vi/docs/CLI-TOOLS.md rename to docs/i18n/vi/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/vi/docs/ENVIRONMENT.md b/docs/i18n/vi/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/vi/docs/ENVIRONMENT.md rename to docs/i18n/vi/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/vi/docs/AUTO-COMBO.md b/docs/i18n/vi/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/vi/docs/AUTO-COMBO.md rename to docs/i18n/vi/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/vi/llm.txt b/docs/i18n/vi/llm.txt index 2c7dcbd683..e334b63a7e 100644 --- a/docs/i18n/vi/llm.txt +++ b/docs/i18n/vi/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/i18n/zh-CN/CHANGELOG.md b/docs/i18n/zh-CN/CHANGELOG.md index e739c7b20c..2751b31000 100644 --- a/docs/i18n/zh-CN/CHANGELOG.md +++ b/docs/i18n/zh-CN/CHANGELOG.md @@ -10,30 +10,148 @@ ### ✨ New Features -- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation (bumping to `thinkingBudget + 1`) and standard Cloud Code envelope payload sanitization (#2055, #2063) +- **feat(antigravity):** integrate Antigravity provider with dynamic `maxOutputTokens` calculation, identity fingerprinting overhaul, and Cloud Code envelope payload sanitization (#2055, #2063) - **feat(gemini-cli):** add custom projectId support for Gemini CLI transport (UI, DB, executor) (#1991) +- **feat(providers):** add KIE media provider support with dynamic polling, text models, and expanded video models catalog +- **feat(providers):** add Z.AI provider support with GLM quota handling and new quota labels +- **feat(providers):** add 9 new free AI providers — LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi (#2096) +- **feat(providers):** batch delete provider connections via checkbox multi-select (#2094) +- **feat(cursor):** full OpenAI parity — tool calls, streaming, and session management (#2082) +- **feat(cli):** comprehensive CLI enhancement suite with 20+ new commands including `omniroute providers`, `omniroute combos`, `omniroute doctor` (#2074) +- **feat(cli):** add modular CLI setup and provider management commands (#2046) +- **feat(mcp):** add DeepSeek quota and limit monitoring feature (#2089) +- **feat(circuit-breaker):** classify 429 errors and apply per-kind cooldowns (#2116) +- **feat(multi):** manifest-aware tier routing — W1-W4 complete (#2014) +- **feat(combos):** add reset-aware routing strategy for quota-based providers +- **feat(combo):** add context_length input field to combo edit form (#2047) +- **feat(chat):** dynamic tool limit detection with proactive truncation (#2061) +- **feat(sse):** refresh Claude OAuth wire image to claude-cli/2.1.131 (#2011) +- **feat(github):** add `targetFormat: openai-responses` to all GitHub models (#2122) +- **feat(api):** allow configuration via API calls — open management routes to Bearer keys with manage scope (#2103) +- **feat(api):** update API bridge proxy timeout to 600,000ms (#2019) +- **feat(usage):** add service tier breakdown, codex fast service tier analytics, and account for fast tier +- **feat(chat):** add `STREAM_READINESS_TIMEOUT_MS` and integrate into chat handling +- **feat(combo):** add `fallbackDelayMs` to combo configuration and related settings +- **feat(chat):** enhance error handling for semaphore capacity with fallback logic +- **feat(qdrant):** embedding model discovery (#2086) +- **feat(auth):** per-session sticky routing for Codex (#1887) +- **feat(inworld):** enhance Inworld TTS support (#2123) ### 🐛 Bug Fixes +- **fix(pricing):** make `getPricingForModel` fully case-insensitive to ensure custom prices correctly reflect in new incoming requests cost calculations +- **fix(gemini):** prevent `functionDeclarations` from being dropped by the sanitizer when `googleSearch` tool is present (#2077) +- **fix(pollinations):** add `jsonMode: true` flag in the request transformation to enforce correct JSON structure from Pollinations API (#2109) +- **fix(docker):** update Dockerfile to copy `/docs` directory during build ensuring API catalog availability at runtime (#2083) +- **fix(docker):** include OpenAPI spec in runtime image (#2007) +- **fix(providers):** strip OpenAI-specific fields in Kiro translator to prevent 400 errors (#2037) +- **fix(kiro):** normalize tool-use payloads to prevent 400 errors from agents (#2104) +- **fix(kiro):** merge adjacent user history turns after role normalization (#2105) +- **fix(ui):** resolve text contrast issues for zero-config warning banner in light mode (#2050) +- **fix(core):** inject global system prompt correctly into downstream chat completions pipeline (#2080) +- **fix(core):** restore Claude Code adaptive thinking defaults and resolve audio transcription CORS regression +- **fix(routing):** add missing v1beta rewrites to next.config to resolve 404 on Gemini models endpoint (#2102) +- **fix(routing):** fix bare GPT-5.5 routing for Codex-only installations (#2054) +- **fix(routing):** add fuzzy auto-combo routing for `auto/*` model prefix (#2010) - **fix(cache):** optimize cache_control preservation logic and explicitly align tool schema with upstream Claude Code expectations - **fix(db):** preserve legacy SQLite database path on Windows to prevent data loss (#1973) +- **fix(db):** reduce hot-path persistence overhead (#2039) +- **fix(db):** resolve migration conflict by renumbering overlapping migration entries (#2041) - **fix(settings):** resolve model alias persistence double stringification preventing UI updates (#2018) - **fix(routing):** dynamically filter bare model auto-resolution by active provider connections to prevent dead-routing (#2029) - **fix(embeddings):** add Google Gemini embeddings compatibility via OpenAI-compatible endpoint mapping (#2006) +- **fix(sse):** prevent Claude OAuth multi-account correlation via metadata.user_id (#2053) +- **fix(sse):** prevent Claude Code identity cloak overrides and fix fallback resilience (#2053) +- **fix(sse):** classify hour quota errors as QUOTA_EXHAUSTED (#2119) +- **fix(sse):** fix CC-compatible streaming bridge (#2118) +- **fix(antigravity):** sanitize Claude Cloud Code payloads (#2090) +- **fix(antigravity):** add duplex half for streaming bodies +- **fix(antigravity):** align identity protocol and behavior with official AM +- **fix(chatgpt-web):** plumb proxy through to native tls-client (#2022, #2023) +- **fix(codex):** expose native model IDs in catalog (#2012) +- **fix(glm):** add dedicated coding transport (#2087) +- **fix(compression):** support Responses input and expand Spanish compression rules (#2028) +- **fix(catalog):** auto-calculate combo context_length from target model limits (#2030) +- **fix(api):** fix usage analytics and API key identity (#2008, #2092) +- **fix(api-key):** allow Unicode letters in API key name validation (#1996) +- **fix(auth):** allow bootstrap without password (#2048) +- **fix(proxy):** clean up proxy page redundancy and fix 1proxy sync empty body error (#2052) +- **fix(dashboard):** resolve Unknown plan display in Provider Limits +- **fix(usage):** add extensible CURRENCY_SYMBOLS mapping for deepseek currencies +- **fix(runtime):** harden timer handling and model pricing fallback +- **fix(i18n):** complete Simplified Chinese translations (#2115) +- **fix(mitm):** add Linux cert install and skip sudo password when root (#1999) +- **fix(mitm):** prevent stub from loading at runtime via bypass module - **fix:** remove Anthropic-Beta header from non-Anthropic providers to fix identity contamination (#1989) - **fix(cli):** resolve .env loading failure for global npm installations +- **fix(export):** exclude telemetry/usage-history tables from JSON config backups by default to prevent unbounded file growth (#2125) +- **fix:** Follow OpenAI specification, handle throttling in batch and fix UI (#2045) -### 🔒 Security +### 安全 +- **fix(security):** remediate CodeQL vulnerabilities (ReDoS, cryptographic bias, stack trace exposure, and weak password hashing) (#216, #215, #211, #208, #206, #210) - **fix(security):** remediate regex validation backtracking path in core compression cleanup (#1990) - **fix(core):** harden input handling and stabilization for prompt compression edge cases +### 文档 + +- **docs:** add competitive marketing tables and SEO/AEO optimizations to README (#2091) +- **docs:** refresh providers, model catalogs, and docs for v3.8.0 (#2088) +- **docs:** update Claude MD and update GLM-CN max context to 200k (#2027) +- **docs(env):** add `GITLAB_DUO_OAUTH_CLIENT_ID` to `.env.example` (#2031) + ### 🧹 Chores & Maintenance - **chore(providers):** prune redundant local provider icon assets in favor of `@lobehub/icons` web fonts (#1992) +- **chore(providers):** remove deprecated models (#2033) +- **deps:** bump `fast-uri` from 3.1.0 to 3.1.2 (#2078) +- **deps:** bump `hono` from 4.12.14 to 4.12.18 (#2079) - **ci:** skip SonarCloud scan on main pushes to optimize CI time - **test:** stabilize cooldown abort coverage case in integration testing +### 🏆 v3.8.0 Community Contributors + +Thank you to all **38 community contributors** who made v3.8.0 possible! 🎉 + +| Contributor | PRs | Contributions | +| :--------------------------------------------------------- | :-: | :------------------------------------------------------------ | +| [@oyi77](https://github.com/oyi77) | 7 | #2010, #2014, #2041, #2052, #2061, #2074, #2091, #2094, #2096 | +| [@backryun](https://github.com/backryun) | 4 | #1992, #2033, #2088, #2123 | +| [@dhaern](https://github.com/dhaern) | 4 | #2028, #2039, #2087, #2090 | +| [@Tentoxa](https://github.com/Tentoxa) | 2 | #2011, #2053 | +| [@wauputr4](https://github.com/wauputr4) | 2 | #2009, #2046 | +| [@payne0420](https://github.com/payne0420) | 1 | #2082 | +| [@Tr0sT](https://github.com/Tr0sT) | 1 | #2012 | +| [@AveryanAlex](https://github.com/AveryanAlex) | 1 | #2008 | +| [@nickwizard](https://github.com/nickwizard) | 1 | #1991 | +| [@rodrigogbbr-stack](https://github.com/rodrigogbbr-stack) | 1 | #1996 | +| [@NekoMonci12](https://github.com/NekoMonci12) | 1 | #1999 | +| [@congvc-dev](https://github.com/congvc-dev) | 1 | #2004 | +| [@tatsster](https://github.com/tatsster) | 1 | #2007 | +| [@xssdem](https://github.com/xssdem) | 1 | #2023 | +| [@bypanghu](https://github.com/bypanghu) | 1 | #2027 | +| [@herjarsa](https://github.com/herjarsa) | 1 | #2030 | +| [@wucm667](https://github.com/wucm667) | 1 | #2031 | +| [@hartmark](https://github.com/hartmark) | 1 | #2045 | +| [@ddarkr](https://github.com/ddarkr) | 1 | #2047 | +| [@tces1](https://github.com/tces1) | 1 | #2048 | +| [@guanbear](https://github.com/guanbear) | 1 | #2054 | +| [@Gi99lin](https://github.com/Gi99lin) | 1 | #2055 | +| [@ivan-mezentsev](https://github.com/ivan-mezentsev) | 1 | #2063 | +| [@JxnLexn](https://github.com/JxnLexn) | 1 | #2019 | +| [@yoviarpauzi](https://github.com/yoviarpauzi) | 1 | #2092 | +| [@rafacpti23](https://github.com/rafacpti23) | 1 | #2086 | +| [@gleber](https://github.com/gleber) | 1 | #2103 | +| [@rilham97](https://github.com/rilham97) | 1 | #2104 | +| [@Gioxaa](https://github.com/Gioxaa) | 1 | #2105 | +| [@boa-z](https://github.com/boa-z) | 1 | #2115 | +| [@eleata](https://github.com/eleata) | 1 | #2116 | +| [@rdself](https://github.com/rdself) | 1 | #2118 | +| [@clousky2020](https://github.com/clousky2020) | 1 | #2119 | +| [@abhinavjnu](https://github.com/abhinavjnu) | 1 | #2122 | +| [@HoaPham98](https://github.com/HoaPham98) | 1 | #2089 | +| [@05dunski](https://github.com/05dunski) | 1 | #1978 (cherry-picked) | + ## [3.7.9] — 2026-05-03 ### ✨ New Features @@ -102,7 +220,7 @@ - **chore(provider):** Add reka models list (#1956 — thanks @backryun) - **chore(model):** Update new models, Delete Deprecated models (#1949 — thanks @backryun) -### 📝 Documentation +### 文档 - **docs(compression):** document RTK+Caveman stacked savings ranges @@ -201,7 +319,7 @@ - **feat(db):** auto-restore probe-failed database on startup to prevent data loss after failed upgrades (#1810) - **feat(analytics):** add cost-based usage insights and activity streaks in the analytics dashboard -### 🔒 Security +### 安全 - **fix(security):** resolve ReDoS vulnerability in Codex executor regex patterns (#1797, #1789) @@ -354,7 +472,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(proxy):** implement bulk proxy import via pipe-delimited parser with update-or-create (upsert) logic and real-time preview table - **feat(pwa):** add fullscreen installable PWA with manifest, service worker, and cross-platform app icons (#1728) -### 🔒 Security +### 安全 - **security:** replace insecure `Math.random` with `crypto.getRandomValues` for fallback UUID generation to resolve CodeQL CWE-338 finding (#182) @@ -519,7 +637,7 @@ We identified that **155 community PRs** across the entire project history (from - **fix(transport):** Prevent memory bloat and database exhaustion from large, fragmented streaming responses. Implemented `ByteQueue` in `kiro.ts` for zero-copy binary accumulation, refactored `antigravity.ts` for incremental SSE parsing, and enforced a strict 512KB tiered truncation limit (`MAX_CALL_LOG_ARTIFACT_BYTES`) on stream request logs and call artifacts (#1647). - **chore(ci):** Update build environment dependencies — bump Node to `24.15.0`, `actions/checkout@v6`, `docker/build-push-action@v7`, pin `actions/setup-python` to major tag (#1646 — thanks @backryun). -### 📝 Documentation +### 文档 - **docs(env):** Add `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` to `.env.example` with documentation for LM Studio and other local provider use cases (#1623). @@ -669,7 +787,7 @@ We identified that **155 community PRs** across the entire project history (from - **test(next):** Align transpile package expectations for the Next.js standalone build. - **test(ci):** Fix CI-only test failures from environment differences — clear `INITIAL_PASSWORD` and `JWT_SECRET` in integration tests, handle `XDG_CONFIG_HOME` for guide-settings tests. -### 📚 Documentation +### 文档 - **docs:** Update the root changelog with all release-branch changes through 2026-04-24, including PRs #1544, #1555, #1551, #1550, #1548, #1547, #1541, #1538, #1536, and #1527. - **docs:** Fix broken README and localized documentation links. (#1536) @@ -811,7 +929,7 @@ We identified that **155 community PRs** across the entire project history (from - **feat(providers):** Expand image provider registry with extended model support including SD3.5, FLUX, and DALL-E 3 HD configurations - **feat(combos):** Add new routing strategies and full i18n support for agent features section across 31 languages -### 🔒 Security +### 安全 - **security:** Resolve 18 GitHub CodeQL scan alerts including ReDoS, incomplete sanitization, and bad HTML filtering regexp patterns - **fix(auth):** Seal privilege escalation vector by enforcing JWT session checking exclusively on `/api/keys` management endpoints (#1353) @@ -1078,7 +1196,7 @@ We identified that **155 community PRs** across the entire project history (from - **Duplicate `auto` in Combo Strategy Schema:** Removed duplicate `"auto"` entry from `comboStrategySchema` (was listed on both line 104 and 108). Harmless to Zod runtime but cleaned up to avoid confusion. Schema now has exactly 13 unique strategy values - **Legacy Combo Refs Normalization:** Fixed combo step normalization to preserve legacy string combo references during CRUD operations, preventing data loss when editing combos created before the v2 step architecture -### 🔒 Security +### 安全 - **Auth Bypass on Backup Routes (Critical):** Added `isAuthenticated` guards to `/api/db-backups/exportAll` (full database export) and `/api/db-backups` (list, create, and restore backups) — both were previously accessible without authentication - **Auth Guard on Translator Save:** Added `isAuthenticated` guard to `/api/translator/save` for defense-in-depth consistency @@ -1192,7 +1310,7 @@ We identified that **155 community PRs** across the entire project history (from - **33 New API Key Providers:** Massive provider expansion adding DeepInfra, Vercel AI Gateway, Lambda AI, SambaNova, nScale, OVHcloud AI, Baseten, PublicAI, Moonshot AI, Meta Llama API, v0 (Vercel), Morph, Featherless AI, FriendliAI, LlamaGate, Galadriel, Weights & Biases Inference, Volcengine, AI21 Labs, Venice.ai, Codestral, Upstage, Maritalk, Xiaomi MiMo, Inference.net, NanoGPT, Predibase, Bytez, Heroku AI, Databricks, Snowflake Cortex, and GigaChat (Sber). OmniRoute now supports **100+ providers** (4 Free + 8 OAuth + 91 API Key + Custom compatible) - **Global Email Privacy Toggle:** Added a persistent eye-icon toggle button across all dashboard pages (Providers, Usage Limits, Playground) that reveals or hides masked email addresses. Toggle state is stored in localStorage and synced globally via Zustand store - **Documentation Refresh:** Updated README, ARCHITECTURE, FEATURES, AGENTS.md, and API_REFERENCE for v3.6.2 with accurate provider counts (100+), new executor list, and system API documentation -- **Uninstall Guide:** Created comprehensive `docs/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) +- **Uninstall Guide:** Created comprehensive `docs/guides/UNINSTALL.md` covering clean uninstallation for all deployment methods (npm, Docker, Electron, source) ### 🐛 Bug Fixes @@ -1483,7 +1601,7 @@ We identified that **155 community PRs** across the entire project history (from - **Updated Sub-dependencies:** Bumped `hono` to `4.12.12` and `@hono/node-server` to `1.19.13` to patch critical security gaps (#1063, #1064, #1067, #1068). -### 📚 Documentation +### 文档 - **Documentation Synchronization:** Updated system documentation (README, Architecture, Features, Tools, Troubleshooting) and synced `i18n` configurations to match the v3.5.5 context relay patterns and proxy troubleshooting steps. - **Context Relay Delivery Notes:** Documented the current architecture, runtime flow, and Codex-focused scope in the feature docs, changelog, and agent guidance. @@ -1559,7 +1677,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.5.3] - 2026-04-07 -### Security +### 安全 - **Vulnerabilities:** Fully remediated 12 High-Severity CodeQL vulnerabilities by migrating from Math.random to `crypto.randomUUID()`, wrapping SSE injection points with aggressive backslash escaping, sanitizing trailing HTTP fragments, and enforcing rigid SSRF HTTP verification schemes across internal routes. - **Dependencies:** Upgraded Next.js to `^16.2.2` and Vite to `>=8.0.5` resolving critical DoS, arbitrary file reads and CSRF vectors in the build/server environments. @@ -1575,7 +1693,7 @@ We identified that **155 community PRs** across the entire project history (from - **CI/CD Stabilization:** Prevented random GitHub Runner freezes by decoupling sharded processes, adjusting test concurrencies, unref-ing active connections on server teardown, and strictly capping job timeout durations. -### Documentation +### 文档 - **I18n Engine:** Synchronized and pushed deep Machine Translation updates across all 32 natively-supported languages (682 translation nodes aligned). @@ -1736,7 +1854,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.8] — 2026-04-03 -### Security +### 安全 - Fully remediated all outstanding Github Advanced Security (CodeQL) findings and Dependabot alerts. - Fixed insecure randomness vulnerabilities by migrating from `Math.random` to `crypto.randomUUID()`. @@ -1748,7 +1866,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.7] — 2026-04-03 -### Features +### 功能特点 - Added `Cryptography` node to Monitoring and MCP health checks (#798) - Hardened model-catalog route permissions mapping (`/models`) (#781) @@ -1764,7 +1882,7 @@ We identified that **155 community PRs** across the entire project history (from - Fixed MCP standalone module-resolution (`ERR_MODULE_NOT_FOUND`) via `esbuild` (#936) - Fixed NVIDIA NIM routing credential resolution alias mismatch (#931) -### Security +### 安全 - Added safe strict input boundary protection against raw `shell: true` remote-code execution injections. @@ -2011,7 +2129,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.4.0] - 2026-03-31 -### 🚀 Features +### 功能特点 - **Subscription Utilization Analytics:** Added quota snapshot time-series tracking, Provider Utilization and Combo Health tabs with recharts visualizations, and corresponding API endpoints (#847) - **SQLite Backup Control:** New `OMNIROUTE_DISABLE_AUTO_BACKUP` env flag to disable automatic SQLite backups (#846) @@ -2063,7 +2181,7 @@ We identified that **155 community PRs** across the entire project history (from ## [3.3.8] - 2026-03-30 -### 🚀 Features +### 功能特点 - **Models API Filtering:** Endpoint `/v1/models` now dynamically filters its list based on the permissions tied to the `Authorization: Bearer <token>` when restricted access is on (#781) - **Qoder Integration:** Native integration for Qoder AI natively replacing the legacy iFlow platform mappings (#660) @@ -2889,7 +3007,7 @@ We identified that **155 community PRs** across the entire project history (from - **NaN tokens in Claude Code / client responses (#617):** - `sanitizeUsage()` now cross-maps `input_tokens`→`prompt_tokens` and `output_tokens`→`completion_tokens` before the whitelist filter, fixing responses showing NaN/0 token counts when providers return Claude-style usage field names -### 🔒 Security +### 安全 - Updated `yaml` package to fix stack overflow vulnerability (GHSA-48c2-rrv3-qjmp) @@ -3565,7 +3683,7 @@ docker pull diegosouzapw/omniroute:3.0.0 - **SVG fallback**: `ProviderIcon` component updated with 4-tier strategy: Lobehub → PNG → SVG → Generic icon - **Agents fingerprinting**: Synced with CLI tools — added droid, openclaw, copilot, opencode to fingerprint list (14 total) -### 🔒 Security +### 安全 - **CVE fix**: Resolved dompurify XSS vulnerability (GHSA-v2wj-7wpq-c8vv) via npm overrides forcing `dompurify@^3.3.2` - `npm audit` now reports **0 vulnerabilities** @@ -3928,7 +4046,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **#510** — Windows: MSYS2/Git-Bash paths (`/c/Program Files/...`) are now normalized to `C:\Program Files\...` - **#492** — `omniroute` CLI now detects `mise`/`nvm` when `app/server.js` is missing and shows targeted fix -### 📖 Documentation +### 文档 - **#513** — Docker password reset: `INITIAL_PASSWORD` env var workaround documented - **#520** — pnpm: `pnpm approve-builds better-sqlite3` documented @@ -4025,7 +4143,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **feat(executors/cloudflare-ai)**: New `CloudflareAIExecutor` — dynamic URL construction requires `accountId` in provider credentials - **feat(executors)**: Register `pollinations`, `pol`, `cloudflare-ai`, `cf` executor mappings -### 📝 Documentation +### 文档 - **docs(readme)**: Expanded free combo stack to 11 providers ($0 forever) - **docs(readme)**: Added 4 new free provider sections (LongCat, Pollinations, Cloudflare AI, Scaleway) with model tables @@ -4177,7 +4295,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **OAuth batch test crash** (ERR_CONNECTION_REFUSED): Replaced sequential for-loop with 5-connection concurrency limit + 30s per-connection timeout via `Promise.race()` + `Promise.allSettled()`. Prevents server crash when testing large OAuth provider groups (~30+ connections). -### Features +### 功能特点 - **"Test All" button on provider pages**: Individual provider pages (e.g., `/providers/codex`) now show a "Test All" button in the Connections header when there are 2+ connections. Uses `POST /api/providers/test-batch` with `{mode: "provider", providerId}`. Results displayed in a modal with pass/fail summary and per-connection diagnosis. @@ -4205,7 +4323,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Merge PR #494 (MiniMax role fix), fix KIRO MITM dashboard, triage 8 issues. -### Features +### 功能特点 - **MiniMax developer→system role fix** (PR #494 by @zhangqiang8vip): Per-model `preserveDeveloperRole` toggle. Adds "Compatibility" UI in providers page. Fixes 422 "role param error" for MiniMax and similar gateways. - **roleNormalizer**: `normalizeDeveloperRole()` now accepts `preserveDeveloperRole` parameter with tri-state behavior (undefined=keep, true=keep, false=convert). @@ -4261,7 +4379,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Gemini CLI deprecation, VM guide i18n fix, dependabot security fix, provider schema expansion. -### Features +### 功能特点 - **Gemini CLI Deprecation** (#462): Mark `gemini-cli` provider as deprecated with warning — Google restricts third-party OAuth usage from March 2026 - **Provider Schema** (#462): Expand Zod validation with `deprecated`, `deprecationReason`, `hasFree`, `freeNote`, `authHint`, `apiHint` optional fields @@ -4270,7 +4388,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **VM Guide i18n** (#471): Add `VM_DEPLOYMENT_GUIDE.md` to i18n translation pipeline, regenerate all 30 locale translations from English source (were stuck in Portuguese) -### Security +### 安全 - **deps**: Bump `flatted` 3.3.3 → 3.4.2 — fixes CWE-1321 prototype pollution (#484, @dependabot) @@ -4290,7 +4408,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Czech i18n, SSE protocol fix, VM guide translation. -### Features +### 功能特点 - **Czech Language** (#482): Full Czech (cs) i18n — 22 docs, 2606 UI strings, language switcher updates (@zen0bit) - **VM Deployment Guide**: Translated from Portuguese to English as the source document (@zen0bit) @@ -4309,7 +4427,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: 2 merged PRs, model aliases routing fix, log export, and issue triage. -### Features +### 功能特点 - **Log Export**: New Export button on `/dashboard/logs` with time range dropdown (1h, 6h, 12h, 24h). Downloads JSON of request/proxy/call logs via `/api/logs/export` API (#user-request) @@ -4329,7 +4447,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Five community PRs — streaming call log fixes, Kiro compatibility, cache token analytics, Chinese translation, and configurable tool call IDs. -### ✨ Features +### 功能特点 - **feat(logs)**: Call log response content now correctly accumulated from raw provider chunks (OpenAI/Claude/Gemini) before translation, fixing empty response payloads in streaming mode (#470, @zhangqiang8vip) - **feat(providers)**: Per-model configurable 9-char tool call ID normalization (Mistral-style) — only models with the option enabled get truncated IDs (#470) @@ -4359,7 +4477,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Bailian Coding Plan provider with editable base URLs, plus community contributions for Alibaba Cloud and Kimi Coding. -### ✨ Features +### 功能特点 - **feat(providers)**: Added Bailian Coding Plan (`bailian-coding-plan`) — Alibaba Model Studio with Anthropic-compatible API. Static catalog of 8 models including Qwen3.5 Plus, Qwen3 Coder, MiniMax M2.5, GLM 5, and Kimi K2.5. Includes custom auth validation (400=valid, 401/403=invalid) (#467, @Mind-Dragon) - **feat(admin)**: Editable default URL in Provider Admin create/edit flows — users can configure custom base URLs per connection. Persisted in `providerSpecificData.baseUrl` with Zod schema validation rejecting non-http(s) schemes (#467) @@ -4374,7 +4492,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Two new community-contributed providers (Alibaba Cloud Coding, Kimi Coding API-key) and Docker pino fix. -### ✨ Features +### 功能特点 - **feat(providers)**: Added Alibaba Cloud Coding Plan support with two OpenAI-compatible endpoints — `alicode` (China) and `alicode-intl` (International), each with 8 models (#465, @dtk1985) - **feat(providers)**: Added dedicated `kimi-coding-apikey` provider path — API-key-based Kimi Coding access is no longer forced through OAuth-only `kimi-coding` route. Includes registry, constants, models API, config, and validation test (#463, @Mind-Dragon) @@ -4399,7 +4517,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Codex responses subpath passthrough natively supported, Windows MITM crash fixed, and Combos agent schemas adjusted. -### ✨ Features +### 功能特点 - **feat(codex)**: Native responses subpath passthrough for Codex — natively routes `POST /v1/responses/compact` to Codex upstream, maintaining Claude Code compatibility without stripping the `/compact` suffix (#457) @@ -4439,7 +4557,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(budget)**: "Save Limits" no longer returns 422 — `warningThreshold` is now correctly sent as fraction (0–1) instead of percentage (0–100) (#451) - **fix(combos)**: `<omniModel>` internal cache tag is now stripped before forwarding requests to providers, preventing cache session breaks (#454) -### ✨ Features +### 功能特点 - **feat(combos)**: Agent Features section added to combo create/edit modal — expose `system_message` override, `tool_filter_regex`, and `context_cache_protection` directly from the dashboard (#454) @@ -4495,7 +4613,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: Search Tools dashboard, i18n fixes, Copilot limits, Serper validation fix. -### 🚀 Features +### 功能特点 - **feat(search)**: Add Search Playground (10th endpoint), Search Tools page with Compare Providers/Rerank Pipeline/Search History, local rerank routing, auth guards on search API (#443 by @Regis-RCR) - New route: `/dashboard/search-tools` @@ -4595,7 +4713,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - DB migration: `request_type` column on `call_logs` for non-chat request tracking - Zod validation (`v1SearchSchema`), auth-gated, cost recorded via `recordCost()` -### 🔒 Security +### 安全 - **deps**: Next.js 16.1.6 → 16.1.7 — fixes 6 CVEs: - **Critical**: CVE-2026-29057 (HTTP request smuggling via http-proxy) @@ -4725,7 +4843,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **005_combo_agent_fields.sql**: `ALTER TABLE combos ADD COLUMN system_message TEXT DEFAULT NULL`, `tool_filter_regex TEXT DEFAULT NULL`, `context_cache_protection INTEGER DEFAULT 0` - **006_detailed_request_logs.sql**: New `request_detail_logs` table with 500-entry ring-buffer trigger, opt-in via settings toggle -### ✨ Features +### 功能特点 - **feat(combo)**: System Message Override per Combo (#399 — `system_message` field replaces or injects system prompt before forwarding to provider) - **feat(combo)**: Tool Filter Regex per Combo (#399 — `tool_filter_regex` keeps only tools matching pattern; supports OpenAI + Anthropic formats) @@ -4740,7 +4858,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > Sprint: SSE improvements, local provider_nodes extensions, proxy registry, Claude passthrough fixes. -### ✨ Features +### 功能特点 - **feat(health)**: Background health check for local `provider_nodes` with exponential backoff (30s→300s) and `Promise.allSettled` to avoid blocking (#423, @Regis-RCR) - **feat(embeddings)**: Route `/v1/embeddings` to local `provider_nodes` — `buildDynamicEmbeddingProvider()` with hostname validation (#422, @Regis-RCR) @@ -4882,7 +5000,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Turbopack hash-strip now runs at **compile time** for ALL packages — not just `better-sqlite3`. Step 5.6 in `prepublish.mjs` walks every `.js` in `app/.next/server/` and strips the 16-char hex suffix from any hashed `require()`. Fixes `zod-dcb22c...`, `pino-...`, etc. MODULE_NOT_FOUND on global npm installs. Closes #398 - **fix(deploy)**: PM2 on both VPS was pointing to stale git-clone directories. Reconfigured to `app/server.js` in the npm global package. Updated `/deploy-vps` workflow to use `npm pack + scp` (npm registry rejects 299MB packages). -### ✨ Features +### 功能特点 - **feat(provider)**: Synthetic ([synthetic.new](https://synthetic.new)) — privacy-focused OpenAI-compatible inference. `passthroughModels: true` for dynamic HuggingFace model catalog. Initial models: Kimi K2.5, MiniMax M2.5, GLM 4.7, DeepSeek V3.2. (PR #404 by @Regis-RCR) @@ -4912,7 +5030,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(build)**: Extended webpack `externals` hash-strip to cover ALL `serverExternalPackages`, not just `better-sqlite3`. Next.js 16 Turbopack hashes `zod`, `pino`, and every other server-external package into names like `zod-dcb22c6336e0bc69` that don't exist in `node_modules` at runtime. A HASH_PATTERN regex catch-all now strips the 16-char suffix and falls back to the base package name. Also added `NEXT_PRIVATE_BUILD_WORKER=0` in `prepublish.mjs` to reinforce webpack mode, plus a post-build scan that reports any remaining hashed refs. (#396, #398, PR #403) - **fix(chat)**: Anthropic-format tool names (`tool.name` without `.function` wrapper) were silently dropped by the empty-name filter introduced in #346. LiteLLM proxies requests with `anthropic/` prefix in Anthropic Messages API format, causing all tools to be filtered and Anthropic to return `400: tool_choice.any may only be specified while providing tools`. Fixed by falling back to `tool.name` when `tool.function.name` is absent. Added 8 regression unit tests. (PR #397) -### ✨ Features +### 功能特点 - **feat(api)**: Custom endpoint paths for OpenAI-compatible provider nodes — configure `chatPath` and `modelsPath` per node (e.g. `/v4/chat/completions`) in the provider connection UI. Includes a DB migration (`003_provider_node_custom_paths.sql`) and URL path sanitization (no `..` traversal, must start with `/`). (PR #400) - **feat(provider)**: Alibaba Cloud DashScope added as OpenAI-compatible provider. International endpoint: `dashscope-intl.aliyuncs.com/compatible-mode/v1`. 12 models: `qwen-max`, `qwen-plus`, `qwen-turbo`, `qwen3-coder-plus/flash`, `qwq-plus`, `qwq-32b`, `qwen3-32b`, `qwen3-235b-a22b`. Auth: Bearer API key. @@ -4971,7 +5089,7 @@ OmniRoute now automatically refreshes model lists for connected providers every - **fix(oauth)**: Qoder (and other providers that redirect to their own UI) no longer leave the OAuth modal stuck at "Waiting for Authorization" — popup-closed detector auto-transitions to manual URL input mode (#344) - **fix(logs)**: Request log table is now readable in light mode — status badges, token counts, and combo tags use adaptive `dark:` color classes (#378) -### ✨ Features +### 功能特点 - **feat(kiro)**: Kiro credit tracking added to usage fetcher — queries `getUserCredits` from AWS CodeWhisperer endpoint (#337) @@ -5372,7 +5490,7 @@ OmniRoute now automatically refreshes model lists for connected providers every > **Major release** — Free Stack ecosystem, transcription playground overhaul, 44+ providers, comprehensive free tier documentation, and UI improvements across the board. -### ✨ Features +### 功能特点 - **Combos: Free Stack template** — New 4th template "Free Stack ($0)" using round-robin across Kiro + Qoder + Qwen + Gemini CLI. Suggests the pre-built zero-cost combo on first use. - **Media/Transcription: Deepgram as default** — Deepgram (Nova 3, $200 free) is now the default transcription provider. AssemblyAI ($50 free) and Groq Whisper (free forever) shown with free credit badges. @@ -5383,7 +5501,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.16] - 2026-03-13 -### 📖 Documentation +### 文档 - **README: 44+ Providers** — Updated all 3 occurrences of "36+ providers" to "44+" reflecting the actual codebase count (44 providers in providers.ts) - **README: New Section "🆓 Free Models — What You Actually Get"** — Added 7-provider table with per-model rate limits for: Kiro (Claude unlimited via AWS Builder ID), Qoder (5 models unlimited), Qwen (4 models unlimited), Gemini CLI (180K/mo), NVIDIA NIM (~40 RPM dev-forever), Cerebras (1M tok/day / 60K TPM), Groq (30 RPM / 14.4K RPD). Includes the \/usr/bin/bash Ultimate Free Stack combo recommendation. @@ -5393,7 +5511,7 @@ OmniRoute now automatically refreshes model lists for connected providers every ## [2.3.15] - 2026-03-13 -### ✨ Features +### 功能特点 - **Auto-Combo Dashboard (Tier Priority)**: Added `🏷️ Tier` as the 7th scoring factor label in the `/dashboard/auto-combo` factor breakdown display — all 7 Auto-Combo scoring factors are now visible. - **i18n — autoCombo section**: Added 20 new translation keys for the Auto-Combo dashboard (`title`, `status`, `modePack`, `providerScores`, `factorTierPriority`, etc.) to all 30 language files. diff --git a/docs/i18n/zh-CN/CONTRIBUTING.md b/docs/i18n/zh-CN/CONTRIBUTING.md index 2ee612ad35..59ed06cb8a 100644 --- a/docs/i18n/zh-CN/CONTRIBUTING.md +++ b/docs/i18n/zh-CN/CONTRIBUTING.md @@ -153,7 +153,7 @@ Coverage notes: - If a PR changes production code in `src/`, `open-sse/`, `electron/`, or `bin/`, it must add or update automated tests in the same PR - `npm run coverage:report` prints the detailed file-by-file report from the latest coverage run - `npm run test:coverage:legacy` preserves the older metric for historical comparison -- See `docs/COVERAGE_PLAN.md` for the phased coverage improvement roadmap +- See `docs/ops/COVERAGE_PLAN.md` for the phased coverage improvement roadmap ### Pull Request Requirements @@ -305,7 +305,7 @@ Releases are managed via the `/generate-release` workflow. When a new GitHub Rel ## Getting Help -- **Architecture**: See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) -- **API Reference**: See [`docs/API_REFERENCE.md`](docs/API_REFERENCE.md) +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](docs/reference/API_REFERENCE.md) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **ADRs**: See `docs/adr/` for architectural decision records diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md index 246cd3bc1f..2152d28b8b 100644 --- a/docs/i18n/zh-CN/README.md +++ b/docs/i18n/zh-CN/README.md @@ -2267,25 +2267,25 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux ## 文档 -| Document | Description | -| -------------------------------------------------------- | --------------------------------------------------- | -| [User Guide](docs/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | -| [API Reference](docs/API_REFERENCE.md) | All endpoints with examples | -| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | -| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | -| [Auto-Combo Engine](docs/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | -| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | -| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions | -| [Architecture](docs/ARCHITECTURE.md) | System architecture and internals | -| [Codebase Documentation](docs/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | -| [Uninstall Guide](docs/UNINSTALL.md) | Clean removal for all install methods | -| [Environment Config](docs/ENVIRONMENT.md) | Complete `.env` variables and references | -| [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 | -| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Pre-release validation steps | +| Document | Description | +| --------------------------------------------------------------------- | --------------------------------------------------- | +| [User Guide](docs/guides/USER_GUIDE.md) | Providers, combos, CLI integration, deployment | +| [API Reference](docs/reference/API_REFERENCE.md) | All endpoints with examples | +| [MCP Server](open-sse/mcp-server/README.md) | 25 MCP tools, IDE configs, Python/TS/Go clients | +| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 protocol, skills, streaming, task mgmt | +| [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) | 6-factor scoring, mode packs, self-healing | +| [Context Relay](docs/features/context-relay.md) | Session handoff strategy for account rotation | +| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Common problems and solutions | +| [Architecture](docs/architecture/ARCHITECTURE.md) | System architecture and internals | +| [Codebase Documentation](docs/architecture/CODEBASE_DOCUMENTATION.md) | Beginner-friendly codebase walkthrough | +| [Uninstall Guide](docs/guides/UNINSTALL.md) | Clean removal for all install methods | +| [Environment Config](docs/reference/ENVIRONMENT.md) | Complete `.env` variables and references | +| [Contributing](CONTRIBUTING.md) | Development setup and guidelines | +| [OpenAPI Spec](docs/reference/openapi.yaml) | OpenAPI 3.0 specification | +| [Security Policy](SECURITY.md) | Vulnerability reporting and security practices | +| [VM Deployment](docs/ops/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup | +| [Features Gallery](docs/guides/FEATURES.md) | Visual dashboard tour with screenshots | +| [Release Checklist](docs/ops/RELEASE_CHECKLIST.md) | Pre-release validation steps | --- diff --git a/docs/i18n/zh-CN/docs/ARCHITECTURE.md b/docs/i18n/zh-CN/docs/architecture/ARCHITECTURE.md similarity index 100% rename from docs/i18n/zh-CN/docs/ARCHITECTURE.md rename to docs/i18n/zh-CN/docs/architecture/ARCHITECTURE.md diff --git a/docs/i18n/zh-CN/docs/CODEBASE_DOCUMENTATION.md b/docs/i18n/zh-CN/docs/architecture/CODEBASE_DOCUMENTATION.md similarity index 100% rename from docs/i18n/zh-CN/docs/CODEBASE_DOCUMENTATION.md rename to docs/i18n/zh-CN/docs/architecture/CODEBASE_DOCUMENTATION.md diff --git a/docs/i18n/zh-CN/docs/A2A-SERVER.md b/docs/i18n/zh-CN/docs/frameworks/A2A-SERVER.md similarity index 100% rename from docs/i18n/zh-CN/docs/A2A-SERVER.md rename to docs/i18n/zh-CN/docs/frameworks/A2A-SERVER.md diff --git a/docs/i18n/zh-CN/docs/MCP-SERVER.md b/docs/i18n/zh-CN/docs/frameworks/MCP-SERVER.md similarity index 100% rename from docs/i18n/zh-CN/docs/MCP-SERVER.md rename to docs/i18n/zh-CN/docs/frameworks/MCP-SERVER.md diff --git a/docs/i18n/zh-CN/docs/FEATURES.md b/docs/i18n/zh-CN/docs/guides/FEATURES.md similarity index 100% rename from docs/i18n/zh-CN/docs/FEATURES.md rename to docs/i18n/zh-CN/docs/guides/FEATURES.md diff --git a/docs/i18n/zh-CN/docs/I18N.md b/docs/i18n/zh-CN/docs/guides/I18N.md similarity index 99% rename from docs/i18n/zh-CN/docs/I18N.md rename to docs/i18n/zh-CN/docs/guides/I18N.md index 955d694262..d613d8db72 100644 --- a/docs/i18n/zh-CN/docs/I18N.md +++ b/docs/i18n/zh-CN/docs/guides/I18N.md @@ -420,7 +420,7 @@ The generator originally used `code: "in"` (deprecated Google Translate code) fo ### `docs/i18n/README.md` Is Auto-Generated -The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/I18N.md` (this file) for hand-written documentation that should persist. +The `docs/i18n/README.md` file is completely regenerated by `generate-multilang.mjs docs`. Any manual edits will be lost. Use `docs/guides/I18N.md` (this file) for hand-written documentation that should persist. ### External Untranslatable Keys List diff --git a/docs/i18n/zh-CN/docs/TROUBLESHOOTING.md b/docs/i18n/zh-CN/docs/guides/TROUBLESHOOTING.md similarity index 98% rename from docs/i18n/zh-CN/docs/TROUBLESHOOTING.md rename to docs/i18n/zh-CN/docs/guides/TROUBLESHOOTING.md index dbac2c443f..40cb6e53ef 100644 --- a/docs/i18n/zh-CN/docs/TROUBLESHOOTING.md +++ b/docs/i18n/zh-CN/docs/guides/TROUBLESHOOTING.md @@ -335,7 +335,7 @@ You can ignore this section if you do not run RAG or agent pipelines behind Omni ## Still Stuck? - **GitHub Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) -- **Architecture**: See [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details -- **API Reference**: See [`docs/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints +- **Architecture**: See [`docs/architecture/ARCHITECTURE.md`](ARCHITECTURE.md) for internal details +- **API Reference**: See [`docs/reference/API_REFERENCE.md`](API_REFERENCE.md) for all endpoints - **Health Dashboard**: Check **Dashboard → Health** for real-time system status - **Translator**: Use **Dashboard → Translator** to debug format issues diff --git a/docs/i18n/zh-CN/docs/UNINSTALL.md b/docs/i18n/zh-CN/docs/guides/UNINSTALL.md similarity index 100% rename from docs/i18n/zh-CN/docs/UNINSTALL.md rename to docs/i18n/zh-CN/docs/guides/UNINSTALL.md diff --git a/docs/i18n/zh-CN/docs/USER_GUIDE.md b/docs/i18n/zh-CN/docs/guides/USER_GUIDE.md similarity index 100% rename from docs/i18n/zh-CN/docs/USER_GUIDE.md rename to docs/i18n/zh-CN/docs/guides/USER_GUIDE.md diff --git a/docs/i18n/zh-CN/docs/COVERAGE_PLAN.md b/docs/i18n/zh-CN/docs/ops/COVERAGE_PLAN.md similarity index 100% rename from docs/i18n/zh-CN/docs/COVERAGE_PLAN.md rename to docs/i18n/zh-CN/docs/ops/COVERAGE_PLAN.md diff --git a/docs/i18n/zh-CN/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/i18n/zh-CN/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/zh-CN/docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/i18n/zh-CN/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/zh-CN/docs/RELEASE_CHECKLIST.md b/docs/i18n/zh-CN/docs/ops/RELEASE_CHECKLIST.md similarity index 94% rename from docs/i18n/zh-CN/docs/RELEASE_CHECKLIST.md rename to docs/i18n/zh-CN/docs/ops/RELEASE_CHECKLIST.md index 218b7a6fc2..5f60e67283 100644 --- a/docs/i18n/zh-CN/docs/RELEASE_CHECKLIST.md +++ b/docs/i18n/zh-CN/docs/ops/RELEASE_CHECKLIST.md @@ -16,14 +16,14 @@ Use this checklist before tagging or publishing a new OmniRoute release. ## API Docs -1. Update `docs/openapi.yaml`: +1. Update `docs/reference/openapi.yaml`: - `info.version` must equal `package.json` version. 2. Validate endpoint examples if API contracts changed. ## Runtime Docs -1. Review `docs/ARCHITECTURE.md` for storage/runtime drift. -2. Review `docs/TROUBLESHOOTING.md` for env var and operational drift. +1. Review `docs/architecture/ARCHITECTURE.md` for storage/runtime drift. +2. Review `docs/guides/TROUBLESHOOTING.md` for env var and operational drift. 3. Verify the release/runtime Node.js version still satisfies the supported secure floor: - `>=20.20.2 <21` or `>=22.22.2 <23` - `npm run check:node-runtime` diff --git a/docs/i18n/zh-CN/docs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/zh-CN/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 100% rename from docs/i18n/zh-CN/docs/VM_DEPLOYMENT_GUIDE.md rename to docs/i18n/zh-CN/docs/ops/VM_DEPLOYMENT_GUIDE.md diff --git a/docs/i18n/zh-CN/docs/API_REFERENCE.md b/docs/i18n/zh-CN/docs/reference/API_REFERENCE.md similarity index 100% rename from docs/i18n/zh-CN/docs/API_REFERENCE.md rename to docs/i18n/zh-CN/docs/reference/API_REFERENCE.md diff --git a/docs/i18n/zh-CN/docs/CLI-TOOLS.md b/docs/i18n/zh-CN/docs/reference/CLI-TOOLS.md similarity index 100% rename from docs/i18n/zh-CN/docs/CLI-TOOLS.md rename to docs/i18n/zh-CN/docs/reference/CLI-TOOLS.md diff --git a/docs/i18n/zh-CN/docs/ENVIRONMENT.md b/docs/i18n/zh-CN/docs/reference/ENVIRONMENT.md similarity index 100% rename from docs/i18n/zh-CN/docs/ENVIRONMENT.md rename to docs/i18n/zh-CN/docs/reference/ENVIRONMENT.md diff --git a/docs/i18n/zh-CN/docs/AUTO-COMBO.md b/docs/i18n/zh-CN/docs/routing/AUTO-COMBO.md similarity index 100% rename from docs/i18n/zh-CN/docs/AUTO-COMBO.md rename to docs/i18n/zh-CN/docs/routing/AUTO-COMBO.md diff --git a/docs/i18n/zh-CN/llm.txt b/docs/i18n/zh-CN/llm.txt index 3eab3bd1b7..2d40e8ea35 100644 --- a/docs/i18n/zh-CN/llm.txt +++ b/docs/i18n/zh-CN/llm.txt @@ -4,7 +4,7 @@ --- -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -16,9 +16,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -45,7 +45,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -186,7 +186,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -286,24 +286,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -319,7 +320,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -349,25 +350,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -386,7 +386,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -440,15 +440,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -468,6 +468,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -475,3 +502,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/docs/COVERAGE_PLAN.md b/docs/ops/COVERAGE_PLAN.md similarity index 57% rename from docs/COVERAGE_PLAN.md rename to docs/ops/COVERAGE_PLAN.md index 2c639045fe..32bb9dde71 100644 --- a/docs/COVERAGE_PLAN.md +++ b/docs/ops/COVERAGE_PLAN.md @@ -1,6 +1,14 @@ +--- +title: "Test Coverage Plan" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # Test Coverage Plan -Last updated: 2026-03-28 +Last updated: 2026-05-13 + +> Status measured on 2026-05-13: lines 82.58%, statements 82.58%, functions 84.23%, branches 75.22%. Phases 1-5 are complete. Current focus is Phase 6 (>=85%) and Phase 7 (>=90%). ## Baseline @@ -10,7 +18,7 @@ There are multiple coverage numbers depending on how the report is computed. For | -------------------- | ----------------------------------------------------- | -----------------: | -------: | --------: | --------------------------------------------------- | | Legacy | Old `npm run test:coverage` | 79.42% | 75.15% | 67.94% | Inflated: counts test files and excludes `open-sse` | | Diagnostic | Source-only, excluding tests and excluding `open-sse` | 68.16% | 63.55% | 64.06% | Useful only to isolate `src/**` | -| Recommended baseline | Source-only, excluding tests and including `open-sse` | 56.95% | 66.05% | 57.80% | This is the project-wide baseline to improve | +| Recommended baseline | Source-only, excluding tests and including `open-sse` | 82.58% | 75.22% | 84.23% | This is the project-wide baseline to improve | The recommended baseline is the number to optimize against. @@ -34,50 +42,51 @@ The recommended baseline is the number to optimize against. ## Milestones -| Phase | Target | Focus | -| ------- | ---------------------: | ------------------------------------------------- | -| Phase 1 | 60% statements / lines | Quick wins and low-risk utility coverage | -| Phase 2 | 65% statements / lines | DB and route foundations | -| Phase 3 | 70% statements / lines | Provider validation and usage analytics | -| Phase 4 | 75% statements / lines | `open-sse` translators and helpers | -| Phase 5 | 80% statements / lines | `open-sse` handlers and executor branches | -| Phase 6 | 85% statements / lines | Harder edge cases, branch debt, regression suites | -| Phase 7 | 90% statements / lines | Final sweep, gap closure, strict ratchet | +| Phase | Target | Focus | Status | +| ------- | ---------------------: | ------------------------------------------------- | ---------- | +| Phase 1 | 60% statements / lines | Quick wins and low-risk utility coverage | ✅ Done | +| Phase 2 | 65% statements / lines | DB and route foundations | ✅ Done | +| Phase 3 | 70% statements / lines | Provider validation and usage analytics | ✅ Done | +| Phase 4 | 75% statements / lines | `open-sse` translators and helpers | ✅ Done | +| Phase 5 | 80% statements / lines | `open-sse` handlers and executor branches | ✅ Done | +| Phase 6 | 85% statements / lines | Harder edge cases, branch debt, regression suites | In progress | +| Phase 7 | 90% statements / lines | Final sweep, gap closure, strict ratchet | Pending | Branches and functions should ratchet upward with each phase, but the primary hard target is statements / lines. ## Priority hotspots -These files or areas offer the best return for the next phases: +These files have the lowest line coverage today (< 60%) and offer the best return for Phases 6-7. Generated from `coverage/coverage-summary.json` on 2026-05-13: -1. `open-sse/handlers` - - `chatCore.ts` at 7.57% - - Overall directory at 29.07% -2. `open-sse/translator/request` - - Overall directory at 36.39% - - Many translators are still near single-digit coverage -3. `open-sse/translator/response` - - Overall directory at 8.07% -4. `open-sse/executors` - - Overall directory at 36.62% -5. `src/lib/db` - - `models.ts` at 20.66% - - `registeredKeys.ts` at 34.46% - - `modelComboMappings.ts` at 36.25% - - `settings.ts` at 46.40% - - `webhooks.ts` at 33.33% -6. `src/lib/usage` - - `usageHistory.ts` at 21.12% - - `usageStats.ts` at 9.56% - - `costCalculator.ts` at 30.00% -7. `src/lib/providers` - - `validation.ts` at 41.16% -8. Low-risk utility and API files for early gains - - `src/shared/utils/upstreamError.ts` - - `src/shared/utils/apiAuth.ts` - - `src/lib/api/errorResponse.ts` - - `src/app/api/settings/require-login/route.ts` - - `src/app/api/providers/[id]/models/route.ts` +| # | File | Lines % | +| --- | ----------------------------------------------------------------- | ------: | +| 1 | `open-sse/services/compression/validation.ts` | 7.87% | +| 2 | `src/app/api/v1/batches/route.ts` | 9.67% | +| 3 | `src/app/docs/components/FeedbackWidget.tsx` | 9.80% | +| 4 | `open-sse/services/compression/toolResultCompressor.ts` | 10.00% | +| 5 | `src/app/docs/components/DocCodeBlocks.tsx` | 10.63% | +| 6 | `open-sse/services/compression/engines/rtk/lineFilter.ts` | 10.96% | +| 7 | `open-sse/services/specificityRules.ts` | 11.28% | +| 8 | `src/mitm/systemCommands.ts` | 12.19% | +| 9 | `open-sse/services/compression/aggressive.ts` | 12.77% | +| 10 | `src/app/api/v1/batches/[id]/cancel/route.ts` | 12.98% | +| 11 | `open-sse/services/compression/progressiveAging.ts` | 13.26% | +| 12 | `open-sse/services/compression/engines/rtk/smartTruncate.ts` | 13.43% | +| 13 | `open-sse/services/compression/engines/rtk/deduplicator.ts` | 13.51% | +| 14 | `src/lib/cloudAgent/agents/jules.ts` | 13.52% | +| 15 | `open-sse/services/compression/lite.ts` | 14.46% | +| 16 | `src/app/api/v1/rerank/route.ts` | 14.94% | +| 17 | `open-sse/services/compression/preservation.ts` | 15.07% | +| 18 | `src/lib/cloudAgent/agents/codex.ts` | 15.54% | +| 19 | `open-sse/services/tierResolver.ts` | 16.66% | +| 20 | `src/app/docs/components/DocsLazyWrapper.tsx` | 16.66% | + +Themes for Phases 6-7: + +- `open-sse/services/compression/**` is the densest cluster of low coverage and dominates the remaining gap. +- Batch and rerank API routes (`src/app/api/v1/batches/**`, `src/app/api/v1/rerank/route.ts`) need handler-level tests. +- Cloud agent adapters (`src/lib/cloudAgent/agents/jules.ts`, `codex.ts`) and `tierResolver.ts` need scenario tests. +- Docs UI components and `src/mitm/systemCommands.ts` are lower priority but cheap branch wins. ## Execution checklist @@ -148,18 +157,26 @@ These files or areas offer the best return for the next phases: Update `npm run test:coverage` thresholds only after the project actually exceeds the next milestone with a comfortable buffer. -Recommended ratchet sequence: +**Current gate (as of 2026-05-13):** `npm run test:coverage` enforces **75 statements / 75 lines / 75 functions / 70 branches**. This is the conservative ratchet against the measured baseline (82.58% / 82.58% / 84.23% / 75.22%) and preserves headroom for transient flakiness. + +For ad-hoc threshold checks against the latest report use: + +```bash +node scripts/check/test-report-summary.mjs --threshold 75 +``` + +Recommended ratchet sequence (order is `statements-lines / branches / functions`): 1. 55/60/55 2. 60/62/58 3. 65/64/62 4. 70/66/66 -5. 75/70/72 +5. 75/70/72 <-- current gate (75/70/75) 6. 80/75/78 7. 85/80/84 8. 90/85/88 -Order is `statements-lines / branches / functions`. +Next ratchet target is `80/75/78` once branch coverage holds above 78% for two consecutive runs. ## Known gap diff --git a/docs/FLY_IO_DEPLOYMENT_GUIDE.md b/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md similarity index 63% rename from docs/FLY_IO_DEPLOYMENT_GUIDE.md rename to docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md index 5d48c42093..d9a40a64c8 100644 --- a/docs/FLY_IO_DEPLOYMENT_GUIDE.md +++ b/docs/ops/FLY_IO_DEPLOYMENT_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "OmniRoute Fly.io 部署指南" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute Fly.io 部署指南 本文档记录 OmniRoute 在 Fly.io 上的实际部署方法，适用于两类场景： @@ -85,7 +91,7 @@ flyctl version ### 4.1 获取代码并进入目录 ```powershell -git clone https://github.com/xiaoge1688/OmniRoute.git +git clone https://github.com/diegosouzapw/OmniRoute.git cd OmniRoute ``` @@ -139,6 +145,7 @@ flyctl deploy - `JWT_SECRET` - `MACHINE_ID_SALT` - `NEXT_PUBLIC_BASE_URL` +- `OMNIROUTE_WS_BRIDGE_SECRET` (生产环境必需 / required in production / obrigatório em produção — 用于 WebSocket 桥接鉴权 / used for WebSocket bridge authentication) - `STORAGE_ENCRYPTION_KEY` ### 5.2 关于 `INITIAL_PASSWORD` @@ -162,20 +169,21 @@ flyctl deploy 建议放入 Fly Secrets： -| 变量名 | 是否推荐 | 说明 | -| --- | --- | --- | -| `API_KEY_SECRET` | 必需 | API Key 生成与校验使用 | -| `JWT_SECRET` | 必需 | 登录态和 JWT 签名使用 | -| `STORAGE_ENCRYPTION_KEY` | 强烈推荐 | 加密存储敏感连接信息 | -| `MACHINE_ID_SALT` | 推荐 | 生成稳定机器标识 | -| `INITIAL_PASSWORD` | 可选 | 首次部署时直接指定后台初始密码 | -| OAuth/API 私密凭证 | 按需 | 各类外部平台鉴权配置 | +| 变量名 | 是否推荐 | 说明 | +| ---------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------- | +| `API_KEY_SECRET` | 必需 | API Key 生成与校验使用 | +| `JWT_SECRET` | 必需 | 登录态和 JWT 签名使用 | +| `OMNIROUTE_WS_BRIDGE_SECRET` | 生产必需 (required / obrigatório) | WebSocket 桥接鉴权密钥 (WebSocket bridge auth / chave de autenticação da ponte WebSocket) | +| `STORAGE_ENCRYPTION_KEY` | 强烈推荐 | 加密存储敏感连接信息 | +| `MACHINE_ID_SALT` | 推荐 | 生成稳定机器标识 | +| `INITIAL_PASSWORD` | 可选 | 首次部署时直接指定后台初始密码 | +| OAuth/API 私密凭证 | 按需 | 各类外部平台鉴权配置 | ### 6.2 当前项目推荐值 -| 变量名 | 推荐值 | -| --- | --- | -| `DATA_DIR` | `/data` | +| 变量名 | 推荐值 | +| ---------------------- | --------------------------- | +| `DATA_DIR` | `/data` | | `NEXT_PUBLIC_BASE_URL` | `https://omniroute.fly.dev` | 说明： @@ -183,6 +191,34 @@ flyctl deploy - `DATA_DIR=/data` 非常关键，必须与 Fly Volume 挂载点一致 - `NEXT_PUBLIC_BASE_URL` 用于调度器和前端回调等场景 +### 6.3 OAuth 回调地址配置 (OAuth callback URL / URL de callback OAuth) + +如果你需要在 Fly.io 部署上启用 OAuth 登录类的 provider（例如 Antigravity、Gemini、Cursor 等），必须确保以下两点： +(If you need to enable OAuth-based providers — e.g. Antigravity, Gemini, Cursor — on the Fly.io deployment, make sure of the following two points. / Se precisar habilitar providers via OAuth — p.ex. Antigravity, Gemini, Cursor — na implantação Fly.io, garanta os dois pontos abaixo.) + +1. **设置 `NEXT_PUBLIC_BASE_URL` 指向你公开的 HTTPS 域名 (set `NEXT_PUBLIC_BASE_URL` to the public HTTPS domain / defina `NEXT_PUBLIC_BASE_URL` para o domínio HTTPS público)** + + ```powershell + flyctl secrets set NEXT_PUBLIC_BASE_URL=https://omniroute.fly.dev -a omniroute + ``` + + 如果你使用了自定义域名 (if using a custom domain / se usar um domínio personalizado)，请替换为对应域名 (e.g. `https://omniroute.yourdomain.com`)。 + +2. **在 provider 控制台配置回调 URL (configure the callback URL on the provider console / configure a URL de callback no painel do provider)** + + 通常格式为 (typical format / formato típico)： + + ```text + <NEXT_PUBLIC_BASE_URL>/api/oauth/<provider>/callback + ``` + + 例如 (e.g. / p.ex.)： + - `https://omniroute.fly.dev/api/oauth/gemini/callback` + - `https://omniroute.fly.dev/api/oauth/antigravity/callback` + - `https://omniroute.fly.dev/api/oauth/cursor/callback` + + 如果 `NEXT_PUBLIC_BASE_URL` 与 provider 控制台中注册的回调 URL 不一致，OAuth 流程会在浏览器回跳阶段失败 (mismatch between `NEXT_PUBLIC_BASE_URL` and the registered callback URL will cause OAuth to fail at the browser redirect step / divergência entre `NEXT_PUBLIC_BASE_URL` e a URL de callback registrada quebra o OAuth no redirect do navegador)。 + --- ## 7. 一键设置参数 @@ -199,17 +235,29 @@ $apiKeySecret = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Min $jwtSecret = [Convert]::ToHexString((1..64 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower() $machineIdSalt = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower() $storageKey = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower() +$wsBridgeSecret = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower() flyctl secrets set ` API_KEY_SECRET=$apiKeySecret ` JWT_SECRET=$jwtSecret ` MACHINE_ID_SALT=$machineIdSalt ` STORAGE_ENCRYPTION_KEY=$storageKey ` + OMNIROUTE_WS_BRIDGE_SECRET=$wsBridgeSecret ` DATA_DIR=/data ` NEXT_PUBLIC_BASE_URL=https://omniroute.fly.dev ` -a omniroute ``` +在 Linux / macOS 上，也可以直接用 `openssl rand -hex 32` 生成 (on Linux / macOS, you can also use `openssl rand -hex 32` / em Linux / macOS, também é possível usar `openssl rand -hex 32`)： + +```bash +flyctl secrets set OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -hex 32) -a omniroute +``` + +说明 (notes / observações)： + +- `OMNIROUTE_WS_BRIDGE_SECRET` 在生产环境必需，缺失会导致 WebSocket 桥接握手失败 (required in production; missing it breaks WebSocket bridge handshake / obrigatório em produção; sem ele o handshake da ponte WebSocket falha) + 如果你还要加初始密码： ```powershell @@ -282,6 +330,8 @@ git describe --tags --always git show --no-patch --oneline v3.4.7 ``` +> 注 (note / nota)：当前项目版本为 `v3.8.0` (current project version is `v3.8.0` / a versão atual do projeto é `v3.8.0`)。下文中的 `v3.4.7` 仅为历史示例 (the `v3.4.7` references below are kept as historical examples only / as referências a `v3.4.7` abaixo são apenas exemplos históricos)；实际发布时请使用 `:latest` 或当前版本标签 (e.g. `:v3.8.0`) (use `:latest` or the current version tag — e.g. `:v3.8.0` — for actual releases / use `:latest` ou a tag da versão atual — p.ex. `:v3.8.0` — em releases reais)。 + 如果你想合并上游最新 `main`，并强制保留 fork 当前的 `fly.toml`，可按下面流程执行： ```powershell @@ -319,7 +369,7 @@ git merge-base --is-ancestor v3.4.7 upstream/main 6. `flyctl status -a omniroute` 7. `flyctl logs --no-tail -a omniroute` -这就是当前项目升级到 `v3.4.7` 时使用的实际流程。 +这就是当前项目升级到 `v3.4.7` 时使用的实际流程 (示例为历史版本，当前实际版本是 `v3.8.0` / example refers to a historical version; the current actual version is `v3.8.0` / o exemplo refere-se a uma versão histórica; a versão atual é `v3.8.0`)。 --- diff --git a/docs/PROXY_GUIDE.md b/docs/ops/PROXY_GUIDE.md similarity index 94% rename from docs/PROXY_GUIDE.md rename to docs/ops/PROXY_GUIDE.md index 025da1e6af..4c7f7b05a4 100644 --- a/docs/PROXY_GUIDE.md +++ b/docs/ops/PROXY_GUIDE.md @@ -1,3 +1,9 @@ +--- +title: "🌐 OmniRoute Proxy Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # 🌐 OmniRoute Proxy Guide > **Bypass geographic blocks, protect your identity, and route AI traffic through any proxy — with zero configuration complexity.** @@ -10,7 +16,7 @@ OmniRoute includes a full-featured proxy management system that lets you route u - [Why Use Proxies?](#why-use-proxies) - [Architecture Overview](#architecture-overview) -- [3-Level Proxy System](#3-level-proxy-system) +- [4-Level Proxy System](#4-level-proxy-system) - [Proxy Registry (CRUD)](#proxy-registry-crud) - [1proxy Free Marketplace](#1proxy-free-proxy-marketplace) - [Proxy Rotation](#proxy-rotation) @@ -78,7 +84,7 @@ Even outside blocked regions, proxies are useful for: --- -## 3-Level Proxy System +## 4-Level Proxy System OmniRoute supports proxy configuration at **four independent scopes**, resolved in priority order: @@ -471,6 +477,10 @@ curl -X PUT "http://localhost:20128/api/upstream-proxy/openai" \ | `GET` | `/api/v1/management/proxies/assignments` | List assignments | | `GET` | `/api/v1/management/proxies/health` | Proxy health stats | +### Tunnels API + +For exposing your OmniRoute instance to the public internet (Cloudflare/ngrok/Tailscale) instead of routing outbound through a proxy, see [TUNNELS_GUIDE.md](./TUNNELS_GUIDE.md). The tunnel REST API lives under `/api/tunnels/{cloudflared,ngrok,tailscale}/*` and is orthogonal to the outbound proxy chain documented above. + ### 1proxy API | Method | Endpoint | Description | @@ -495,13 +505,13 @@ curl -X PUT "http://localhost:20128/api/upstream-proxy/openai" \ ## Environment Variables -| Variable | Default | Description | -| -------------------------------- | ------------------------------------- | ------------------------------- | -| `ENABLE_SOCKS5_PROXY` | `false` | Enable SOCKS5 proxy support | -| `ONEPROXY_ENABLED` | `true` | Enable 1proxy integration | -| `ONEPROXY_API_URL` | `https://1proxy-api.aitradepulse.com` | 1proxy API endpoint | -| `ONEPROXY_MAX_PROXIES` | `500` | Maximum proxies to sync | -| `ONEPROXY_MIN_QUALITY_THRESHOLD` | `50` | Minimum quality score to import | +| Variable | Default | Description | +| -------------------------------- | ------------------------------------- | -------------------------------------------------------------- | +| `ENABLE_SOCKS5_PROXY` | `true` | Enable SOCKS5 proxy support (default `true` in `.env.example`) | +| `ONEPROXY_ENABLED` | `true` | Enable 1proxy integration | +| `ONEPROXY_API_URL` | `https://1proxy-api.aitradepulse.com` | 1proxy API endpoint | +| `ONEPROXY_MAX_PROXIES` | `500` | Maximum proxies to sync | +| `ONEPROXY_MIN_QUALITY_THRESHOLD` | `50` | Minimum quality score to import | --- @@ -591,6 +601,6 @@ CREATE TABLE proxy_assignments ( > 📖 **Related documentation:** > -> - [User Guide](USER_GUIDE.md) — General setup and configuration -> - [API Reference](API_REFERENCE.md) — Full API documentation -> - [Environment Config](ENVIRONMENT.md) — All environment variables +> - [User Guide](../guides/USER_GUIDE.md) — General setup and configuration +> - [API Reference](../reference/API_REFERENCE.md) — Full API documentation +> - [Environment Config](../reference/ENVIRONMENT.md) — All environment variables diff --git a/docs/ops/RELEASE_CHECKLIST.md b/docs/ops/RELEASE_CHECKLIST.md new file mode 100644 index 0000000000..9756c01ac2 --- /dev/null +++ b/docs/ops/RELEASE_CHECKLIST.md @@ -0,0 +1,217 @@ +--- +title: "Release Checklist" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Release Checklist + +> **Last updated:** 2026-05-13 — v3.8.0 +> Streamlined release flow that leverages Claude Code skills for automation. + +## TL;DR + +```bash +# 1. Bump version + generate CHANGELOG (skill) +/version-bump-cc patch # or minor/major + +# 2. Run quality gate locally +npm run check # lint + tests +npm run test:coverage # full coverage gate (75/75/75/70) + +# 3. Build & smoke +npm run build +npm run test:e2e # optional but recommended + +# 4. Generate release (skill) +/generate-release-cc + +# 5. Deploy (skill) +/deploy-vps-both-cc # or akamai-cc / local-cc + +# 6. Capture release evidences (skill) +/capture-release-evidences-cc +``` + +## Detailed Checklist + +### Pre-release + +- [ ] All PRs targeted to this release are merged to `release/vX.Y.0` +- [ ] All open Linear/issue items for this version are closed or pushed to next milestone +- [ ] CI green on `release/vX.Y.0` branch +- [ ] No `TODO(release)` markers in code: `grep -r "TODO(release)" src/ open-sse/` +- [ ] Docker base image up to date (currently `node:24.15.0-trixie-slim`) + +### Version & Changelog + +- [ ] Run `/version-bump-cc <patch|minor|major>` (Claude Code skill) + - Bumps `package.json`, `electron/package.json` + - Regenerates `CHANGELOG.md` from git commits since last tag + - Updates README.md badges +- [ ] Manually review CHANGELOG.md and clean up commit messages if needed +- [ ] Ensure the latest semver section in `CHANGELOG.md` equals `package.json` version +- [ ] Keep `## [Unreleased]` as the first changelog section for upcoming work +- [ ] Update `docs/reference/openapi.yaml` → `info.version` must equal `package.json` version + +### Code Quality + +- [ ] `npm run lint` — 0 errors (warnings are pre-existing) +- [ ] `npm run typecheck:core` — clean +- [ ] `npm run typecheck:noimplicit:core` — clean (strict) +- [ ] `npm run check:cycles` — no circular deps +- [ ] `npm run check:any-budget:t11` — within budget +- [ ] `npm run check:route-validation:t06` — clean +- [ ] `npm run check:node-runtime` — supported floor met (`>=20.20.2 <21`, `>=22.22.2 <23`, `>=24.0.0 <25`) + +### Testing + +- [ ] `npm run test:unit` — pass +- [ ] `npm run test:vitest` — pass (MCP server, autoCombo, cache) +- [ ] `npm run test:coverage` — gate 75/75/75/70 satisfied (statements/lines/functions/branches) +- [ ] `npm run test:integration` — pass (if changes touch DB / handlers) +- [ ] `npm run test:e2e` — pass (UI changes) +- [ ] `npm run test:protocols:e2e` — pass (MCP/A2A changes) +- [ ] `npm run test:ecosystem` — pass + +### Hooks (Husky validated) + +Husky hooks live in `.husky/` and run automatically on git operations. + +- **pre-commit:** `npx lint-staged + node scripts/check/check-docs-sync.mjs + npm run check:any-budget:t11` +- **pre-push:** currently disabled (commented out). When re-enabled, runs `npm run test:unit`. + - Run `npm run test:unit` manually before pushing release branches. + +If a hook fails: fix the underlying issue, don't bypass with `--no-verify`. + +### Conventional Commits + +All release-bound commits must follow `type(scope): subject` format. + +**Valid types:** `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `perf`, `style`, `ci` + +**Valid scopes:** `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, `memory`, `skills`, `cloud-agent`, `guardrails`, `compression`, `auto-combo`, `resilience`, `providers`, `executors`, `translator`, `domain`, `authz` + +Breaking changes: add `BREAKING CHANGE:` footer or `!` after the scope (e.g. `feat(api)!: drop /v0`). + +### Documentation + +- [ ] `npm run check:docs-sync` passes (auto-run by pre-commit) +- [ ] `npm run check:docs-all` passes (umbrella: docs-sync + docs-counts + env-doc-sync + deprecated-versions + doc-links) +- [ ] `npm run check:env-doc-sync` exits 0 — code ↔ `.env.example` ↔ `docs/reference/ENVIRONMENT.md` env contract is intact +- [ ] `npm run check:doc-links` exits 0 — no broken internal markdown references after restructuring +- [ ] `docs/architecture/ARCHITECTURE.md` reviewed for storage/runtime drift +- [ ] `docs/guides/TROUBLESHOOTING.md` reviewed for env var and operational drift +- [ ] If `.env.example` changed: `docs/reference/ENVIRONMENT.md` updated +- [ ] If new feature has a UI: `docs/guides/USER_GUIDE.md` mentions it +- [ ] If new feature has API: `docs/reference/API_REFERENCE.md` + `docs/reference/openapi.yaml` updated +- [ ] If new feature is a module: dedicated `docs/<MODULE>.md` exists +- [ ] If breaking change: `docs/guides/TROUBLESHOOTING.md` has migration note + +### i18n + +- [ ] `npm run i18n:check` exits 0 — translation state (`.i18n-state.json`) in sync with source docs (no drifted sources in strict mode; warn-mode advisory is acceptable for last-minute doc touch-ups, but should be 0 before tagging) +- [ ] `npm run i18n:check-ui-coverage` exits 0 — every UI locale at or above the 80% coverage floor +- [ ] `npm run i18n:sync-ui:dry` reports 0 missing keys across all 40 locales +- [ ] If source English docs changed, run `npm run i18n:run` (requires `OMNIROUTE_TRANSLATION_API_KEY` in `.env`) before tagging +- [ ] Translation contributions can be deferred to next release if minor (track in CHANGELOG) + +### Database Migrations + +- [ ] If `src/lib/db/migrations/` has new files: + - [ ] Each migration is idempotent (`CREATE TABLE IF NOT EXISTS`, etc.) + - [ ] Migrations wrapped in transactions + - [ ] Numbered correctly (no gaps in sequence) +- [ ] Test on fresh install: delete `~/.omniroute/omniroute.db` and run `npm run dev` +- [ ] Test on existing install: backup DB, run migration, verify schema +- [ ] WAL files (`-wal`, `-shm`) handled correctly if migration rewrites tables + +### Provider Catalog (Zod-validated) + +- [ ] `src/shared/constants/providers.ts` Zod schema valid at load time + - [ ] All providers have required fields (`id`, `label`, `kind`, etc.) + - [ ] `freeNote` provided for new free providers + - [ ] OAuth providers have `oauthConfig` registered in `src/lib/oauth/constants/oauth.ts` +- [ ] If new provider added: corresponding executor in `open-sse/executors/` +- [ ] If non-OpenAI format: translator in `open-sse/translator/` +- [ ] Models registered in `open-sse/config/providerRegistry.ts` +- [ ] Unit tests in `tests/unit/` cover provider classification and routing + +### Desktop (Electron) + +If `electron/` changed: + +- [ ] `npm run electron:smoke:packaged` passes +- [ ] Builds tested for at least one of `:win`, `:mac`, `:linux` +- [ ] Code signing certs not expired (if signing) +- [ ] `electron/package.json` version matches root `package.json` +- [ ] Auto-update channel pointer updated if releasing to `stable` + +### Artifact Validation + +- [ ] `npm run build:cli` succeeds +- [ ] `npm run check:pack-artifact` clean — no `app.__qa_backup`, `scripts/scratch`, `package-lock.json`, or other local residue +- [ ] `npm run build` produces a working standalone Next.js bundle + +### Tagging & Release + +- [ ] Run `/generate-release-cc` (Claude Code skill): + - Creates tag `vX.Y.Z` + - Pushes tag and branch + - Opens GitHub Release with changelog body + - Attaches Electron installers (if built) +- [ ] Or manually: + ```bash + git tag -a vX.Y.Z -m "Release vX.Y.Z" + git push origin vX.Y.Z + gh release create vX.Y.Z --notes-from-tag + ``` + +### Deploy + +- [ ] Use deploy skill that matches target: + - `/deploy-vps-local-cc` — local VPS (192.168.0.15) + - `/deploy-vps-akamai-cc` — Akamai VPS (69.164.221.35) + - `/deploy-vps-both-cc` — both +- [ ] Smoke test deployed instance: + - Open `/dashboard/health` → check version string matches release + - Run a `/v1/chat/completions` request against a known provider + - Verify `/api/monitoring/health` returns `CLOSED` circuit breakers + - Confirm MCP transports respond (`/mcp` HTTP, `/mcp-sse` SSE) + +### Post-release + +- [ ] Run `/capture-release-evidences-cc` (Claude Code skill) + - Captures WebP screenshots/recordings of new features + - Attaches to release notes / blog post +- [ ] Update GitHub Discussions / Discord with release announcement +- [ ] Open milestone for next version +- [ ] If critical: pin discussion or post in `news.json` for in-app banner + +## Rollback + +If release has critical issue: + +1. `gh release edit vX.Y.Z --prerelease` (marks as not latest) +2. `git tag -d vX.Y.Z && git push --delete origin vX.Y.Z` (only if not yet adopted by users) +3. Or: hotfix on `release/vX.Y.0` → patch release `vX.Y.(Z+1)` +4. Communicate in GitHub Discussions and Discord immediately + +## Hard Rules + +- Never commit directly to `main` +- Never use `git push --force` to `main` or `release/*` branches +- Never skip Husky hooks (`--no-verify`) +- Never commit secrets, credentials, or `.env` files +- Coverage must stay ≥75/75/75/70 (statements/lines/functions/branches) +- Always include or update tests when changing production code in `src/`, `open-sse/`, `electron/`, or `bin/` + +## Automated Sync Check + +Run the docs sync guard locally before opening a PR: + +```bash +npm run check:docs-sync +``` + +CI also runs this check in `.github/workflows/ci.yml` (lint job). diff --git a/docs/ops/TUNNELS_GUIDE.md b/docs/ops/TUNNELS_GUIDE.md new file mode 100644 index 0000000000..1861a0fa79 --- /dev/null +++ b/docs/ops/TUNNELS_GUIDE.md @@ -0,0 +1,287 @@ +--- +title: "Tunnels Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Tunnels Guide + +> **Source of truth:** `src/lib/{cloudflaredTunnel,ngrokTunnel,tailscaleTunnel}.ts`, `src/app/api/tunnels/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute can expose its local server (`http://localhost:20128`) to the public +internet via three tunnel backends. This is useful for: + +- OAuth callbacks from cloud providers (Antigravity, Gemini, Cursor) that need a + publicly reachable redirect URL. +- Sharing your local instance with teammates without deploying a VM. +- Mobile, remote, or cross-network testing. + +All three backends are managed in-process — OmniRoute starts/stops the underlying +binary or SDK from the dashboard or REST API. No reverse-proxy or systemd setup +is required. + +## Backends at a glance + +| Backend | Persistence | Cost | Setup | +| --------------------------- | ------------------------------------------------------ | ----------------- | ----------------------------------------------- | +| **Cloudflare Quick Tunnel** | Ephemeral (URL changes each restart) | Free | Zero — auto-installs `cloudflared` | +| **ngrok** | Stable while a paid plan or fixed domain is configured | Free tier + paid | Requires ngrok account + authtoken | +| **Tailscale Funnel** | Stable per node within your tailnet | Free for personal | Requires Tailscale install + login + Funnel ACL | + +The implementations live in `src/lib/cloudflaredTunnel.ts`, +`src/lib/ngrokTunnel.ts`, and `src/lib/tailscaleTunnel.ts`. All three return a +common-shaped `status` object with `phase`, `running`, `publicUrl`, `apiUrl`, +`targetUrl`, and `lastError` fields, so the dashboard can render them uniformly. + +## 1. Cloudflare Tunnel (Quick Tunnel) + +`src/lib/cloudflaredTunnel.ts` runs `cloudflared tunnel --url +http://localhost:<apiPort>` as a child process and parses the assigned +`*.trycloudflare.com` URL from stdout. + +Key behaviors: + +- **Auto-install.** On first use, OmniRoute downloads the latest `cloudflared` + binary from the official GitHub releases (managed install lives under + `DATA_DIR/cloudflared/`). SHA256 of the downloaded asset is verified against the + release manifest before execution. +- **Quick-tunnel only.** The current implementation runs only the + `--url`-style quick tunnel. Named/persistent tunnels (`cloudflared tunnel +login` + `cloudflared tunnel route dns ...`) are not orchestrated by + OmniRoute. URLs are ephemeral and will change every restart. +- **Process supervision.** The cloudflared PID and resolved URL are persisted to + `cloudflared-state.json` so the dashboard can resume status across reloads. + +### Enable / disable via REST + +The endpoint uses an `{action: "enable" | "disable"}` body, not separate +`start`/`stop` paths. Management auth (admin session or admin API key) is +required. + +```bash +# Enable +curl -X POST http://localhost:20128/api/tunnels/cloudflared \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"action":"enable"}' + +# Status +curl http://localhost:20128/api/tunnels/cloudflared \ + -H "Cookie: auth_token=..." + +# Disable +curl -X POST http://localhost:20128/api/tunnels/cloudflared \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"action":"disable"}' +``` + +Or via dashboard: **Settings → Tunnels → Cloudflare**. + +### Optional env vars + +| Variable | Purpose | +| ---------------------------------------------------- | ------------------------------------------------------------------------------------- | +| `CLOUDFLARED_BIN` | Override the binary path. If set and valid, OmniRoute uses it instead of downloading. | +| `CLOUDFLARED_PROTOCOL` / `TUNNEL_TRANSPORT_PROTOCOL` | Transport protocol (default `http2`). | + +## 2. ngrok + +`src/lib/ngrokTunnel.ts` uses the **`@ngrok/ngrok` SDK** (in-process, no CLI +subprocess). The native module is imported lazily on first start so platforms +without prebuilt binaries do not break the app at boot. + +### Prerequisites + +1. Sign up at <https://ngrok.com>. +2. Copy your authtoken from the ngrok dashboard. +3. Provide it either via: + - `.env`: `NGROK_AUTHTOKEN=<token>`, or + - Dashboard: **Settings → Tunnels → ngrok**, or + - REST body (one-shot): `{"action":"enable","authToken":"<token>"}`. + +If neither is configured, status returns `phase: "needs_auth"`. + +### Enable / disable via REST + +```bash +# Enable (uses NGROK_AUTHTOKEN from env) +curl -X POST http://localhost:20128/api/tunnels/ngrok \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"action":"enable"}' + +# Enable with inline token +curl -X POST http://localhost:20128/api/tunnels/ngrok \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"action":"enable","authToken":"2abc..."}' + +# Status +curl http://localhost:20128/api/tunnels/ngrok \ + -H "Cookie: auth_token=..." + +# Disable +curl -X POST http://localhost:20128/api/tunnels/ngrok \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"action":"disable"}' +``` + +The response includes the assigned `publicUrl` (e.g. +`https://abcd-1234.ngrok-free.app`). Custom domains, regions, and policy rules +must be configured in the ngrok dashboard — OmniRoute itself only forwards the +local target URL to the SDK. + +## 3. Tailscale Funnel + +`src/lib/tailscaleTunnel.ts` orchestrates the system `tailscale` CLI to expose +the local API port via **Funnel** (Tailscale's public-internet egress for serve). +It supports the full lifecycle: install, login, daemon start, enable, disable. + +The implementation invokes `tailscale funnel --bg <port>` (background mode). The +public URL has the shape `https://<machine>.<tailnet>.ts.net/`. + +### Prerequisites + +1. Install Tailscale (or let OmniRoute do it — see `install` endpoint below). +2. Sign in (`tailscale login` or via OmniRoute's `login` endpoint). +3. Enable Funnel for your tailnet in the Tailscale admin console: + <https://login.tailscale.com/admin/settings/features>. + +On Linux and macOS the daemon (`tailscaled`) requires `sudo` to control. The +POST endpoints accept an optional `sudoPassword` field which is forwarded to +OmniRoute's MITM password cache (`getCachedPassword` / `setCachedPassword`) for +the duration of the call. Windows uses the default service install at +`C:\Program Files\Tailscale\tailscale.exe`. + +### REST endpoints + +Tailscale has a richer surface than the other backends because installation, +login, daemon, and tunnel are separate concerns. + +| Endpoint | Method | Purpose | +| ------------------------------------- | ------ | --------------------------------------------------------------- | +| `/api/tunnels/tailscale` | `GET` | Aggregated tunnel status (`phase`, `tunnelUrl`, `apiUrl`, etc.) | +| `/api/tunnels/tailscale/check` | `GET` | Lower-level check: installed? logged in? daemon running? | +| `/api/tunnels/tailscale/install` | `POST` | Install Tailscale (SSE-streamed progress events) — Linux/macOS | +| `/api/tunnels/tailscale/start-daemon` | `POST` | Start `tailscaled` on Linux/macOS | +| `/api/tunnels/tailscale/login` | `POST` | Begin login flow; returns `authUrl` to open in a browser | +| `/api/tunnels/tailscale/enable` | `POST` | Start the Funnel for the API port | +| `/api/tunnels/tailscale/disable` | `POST` | Stop the Funnel | + +All Tailscale endpoints require management auth (see `routeUtils.ts :: +requireTailscaleAuth`). + +Example enable: + +```bash +curl -X POST http://localhost:20128/api/tunnels/tailscale/enable \ + -H "Content-Type: application/json" \ + -H "Cookie: auth_token=..." \ + -d '{"sudoPassword":"<linux-pwd>","port":20128}' +``` + +If Funnel is not enabled in the admin console, the response includes +`funnelNotEnabled: true` plus an `enableUrl` to open in a browser. + +### Optional env vars + +| Variable | Purpose | +| --------------- | ------------------------------------ | +| `TAILSCALE_BIN` | Override the `tailscale` binary path | + +## Endpoint summary + +| Endpoint | Method | Body | Auth | +| ------------------------------------- | ------ | ----------------------------------- | ---------- | +| `/api/tunnels/cloudflared` | `GET` | — | management | +| `/api/tunnels/cloudflared` | `POST` | `{action: "enable" \| "disable"}` | management | +| `/api/tunnels/ngrok` | `GET` | — | management | +| `/api/tunnels/ngrok` | `POST` | `{action, authToken?}` | management | +| `/api/tunnels/tailscale` | `GET` | — | management | +| `/api/tunnels/tailscale/check` | `GET` | — | management | +| `/api/tunnels/tailscale/install` | `POST` | `{sudoPassword?}` (SSE) | management | +| `/api/tunnels/tailscale/start-daemon` | `POST` | `{sudoPassword?}` | management | +| `/api/tunnels/tailscale/login` | `POST` | `{hostname?}` | management | +| `/api/tunnels/tailscale/enable` | `POST` | `{sudoPassword?, hostname?, port?}` | management | +| `/api/tunnels/tailscale/disable` | `POST` | `{sudoPassword?}` | management | + +There is no central `/api/settings/tunnels` endpoint — each backend is +independent. + +## OAuth callback considerations + +When you expose OmniRoute through a tunnel, the dashboard and OAuth flows must +build callback URLs against the **public** hostname, not `localhost`. Otherwise +the OAuth provider redirects the user back to a URL its servers cannot reach, +and the handshake fails. + +Set: + +```bash +NEXT_PUBLIC_BASE_URL=https://<your-tunnel-host> +``` + +and restart OmniRoute before initiating OAuth. For ephemeral Cloudflare Quick +Tunnels the URL changes after every restart, so prefer ngrok with a reserved +domain or Tailscale Funnel for production OAuth use. + +## Health and monitoring + +The dashboard surfaces tunnel state under **Settings → Tunnels**: + +- Active backend(s) and current `phase` (`stopped`, `starting`, `running`, + `needs_auth`, `error`). +- The current public URL and the derived API URL (`<publicUrl>/v1`). +- The local target URL the tunnel is forwarding to. +- Last error message, if any. + +For programmatic monitoring poll the per-backend `GET` endpoints. Running more +than one backend simultaneously is allowed; OmniRoute will track each +independently. + +## Troubleshooting + +### "cloudflared binary not found" + +OmniRoute attempts to auto-install on first use. If the install is blocked +(restricted network, no GitHub access), download `cloudflared` manually from +<https://github.com/cloudflare/cloudflared/releases> and set +`CLOUDFLARED_BIN=/path/to/cloudflared`. + +### "ngrok: authtoken required" + +`phase: "needs_auth"` means no authtoken was found. Set `NGROK_AUTHTOKEN` in +`.env`, configure it via the dashboard, or pass `authToken` in the enable POST +body. + +### "tailscale: funnel not enabled" + +When the enable response includes `funnelNotEnabled: true`, Funnel is disabled +for your tailnet. Open the returned `enableUrl` (or the admin console feature +page) and toggle Funnel on. + +### Tunnel URL changes break OAuth + +Use ngrok with a reserved domain or Tailscale Funnel (both stable per-node). +Cloudflare Quick Tunnels are ephemeral by design and not recommended for +long-lived OAuth callbacks. + +### Permission denied on Linux/macOS for Tailscale + +`tailscaled` needs root. Provide `sudoPassword` to the relevant POST endpoint, +or run the daemon yourself (`sudo systemctl start tailscaled`). + +## See also + +- [PROXY_GUIDE.md](./PROXY_GUIDE.md) — outbound proxy (1proxy, SOCKS5, HTTP) for + egress traffic. +- [ENVIRONMENT.md](../reference/ENVIRONMENT.md) — full list of env vars including + `NEXT_PUBLIC_BASE_URL`. +- [FLY_IO_DEPLOYMENT_GUIDE.md](./FLY_IO_DEPLOYMENT_GUIDE.md), + [DOCKER_GUIDE.md](../guides/DOCKER_GUIDE.md) — alternatives to tunneling for stable + public hosting. +- Source: `src/lib/{cloudflaredTunnel,ngrokTunnel,tailscaleTunnel}.ts`, + `src/app/api/tunnels/`. diff --git a/docs/VM_DEPLOYMENT_GUIDE.md b/docs/ops/VM_DEPLOYMENT_GUIDE.md similarity index 75% rename from docs/VM_DEPLOYMENT_GUIDE.md rename to docs/ops/VM_DEPLOYMENT_GUIDE.md index 7e968f90ee..69a4cba1fe 100644 --- a/docs/VM_DEPLOYMENT_GUIDE.md +++ b/docs/ops/VM_DEPLOYMENT_GUIDE.md @@ -1,6 +1,12 @@ +--- +title: "OmniRoute — Deployment Guide on VM with Cloudflare" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + # OmniRoute — Deployment Guide on VM with Cloudflare -🌐 **Languages:** 🇺🇸 [English](VM_DEPLOYMENT_GUIDE.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/VM_DEPLOYMENT_GUIDE.md) | 🇪🇸 [Español](i18n/es/VM_DEPLOYMENT_GUIDE.md) | 🇫🇷 [Français](i18n/fr/VM_DEPLOYMENT_GUIDE.md) | 🇮🇹 [Italiano](i18n/it/VM_DEPLOYMENT_GUIDE.md) | 🇷🇺 [Русский](i18n/ru/VM_DEPLOYMENT_GUIDE.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/VM_DEPLOYMENT_GUIDE.md) | 🇩🇪 [Deutsch](i18n/de/VM_DEPLOYMENT_GUIDE.md) | 🇮🇳 [हिन्दी](i18n/in/VM_DEPLOYMENT_GUIDE.md) | 🇹🇭 [ไทย](i18n/th/VM_DEPLOYMENT_GUIDE.md) | 🇺🇦 [Українська](i18n/uk-UA/VM_DEPLOYMENT_GUIDE.md) | 🇸🇦 [العربية](i18n/ar/VM_DEPLOYMENT_GUIDE.md) | 🇯🇵 [日本語](i18n/ja/VM_DEPLOYMENT_GUIDE.md) | 🇻🇳 [Tiếng Việt](i18n/vi/VM_DEPLOYMENT_GUIDE.md) | 🇧🇬 [Български](i18n/bg/VM_DEPLOYMENT_GUIDE.md) | 🇩🇰 [Dansk](i18n/da/VM_DEPLOYMENT_GUIDE.md) | 🇫🇮 [Suomi](i18n/fi/VM_DEPLOYMENT_GUIDE.md) | 🇮🇱 [עברית](i18n/he/VM_DEPLOYMENT_GUIDE.md) | 🇭🇺 [Magyar](i18n/hu/VM_DEPLOYMENT_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/VM_DEPLOYMENT_GUIDE.md) | 🇰🇷 [한국어](i18n/ko/VM_DEPLOYMENT_GUIDE.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/VM_DEPLOYMENT_GUIDE.md) | 🇳🇱 [Nederlands](i18n/nl/VM_DEPLOYMENT_GUIDE.md) | 🇳🇴 [Norsk](i18n/no/VM_DEPLOYMENT_GUIDE.md) | 🇵🇹 [Português (Portugal)](i18n/pt/VM_DEPLOYMENT_GUIDE.md) | 🇷🇴 [Română](i18n/ro/VM_DEPLOYMENT_GUIDE.md) | 🇵🇱 [Polski](i18n/pl/VM_DEPLOYMENT_GUIDE.md) | 🇸🇰 [Slovenčina](i18n/sk/VM_DEPLOYMENT_GUIDE.md) | 🇸🇪 [Svenska](i18n/sv/VM_DEPLOYMENT_GUIDE.md) | 🇵🇭 [Filipino](i18n/phi/VM_DEPLOYMENT_GUIDE.md) | 🇨🇿 [Čeština](i18n/cs/VM_DEPLOYMENT_GUIDE.md) +🌐 **Languages:** 🇺🇸 [English](./VM_DEPLOYMENT_GUIDE.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇪🇸 [Español](../i18n/es/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇫🇷 [Français](../i18n/fr/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇮🇹 [Italiano](../i18n/it/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇷🇺 [Русский](../i18n/ru/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇩🇪 [Deutsch](../i18n/de/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇹🇭 [ไทย](../i18n/th/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇸🇦 [العربية](../i18n/ar/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇯🇵 [日本語](../i18n/ja/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇧🇬 [Български](../i18n/bg/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇩🇰 [Dansk](../i18n/da/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇫🇮 [Suomi](../i18n/fi/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇮🇱 [עברית](../i18n/he/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇭🇺 [Magyar](../i18n/hu/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇰🇷 [한국어](../i18n/ko/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇳🇴 [Norsk](../i18n/no/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇷🇴 [Română](../i18n/ro/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇵🇱 [Polski](../i18n/pl/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇸🇪 [Svenska](../i18n/sv/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇵🇭 [Filipino](../i18n/phi/docs/ops/VM_DEPLOYMENT_GUIDE.md) | 🇨🇿 [Čeština](../i18n/cs/docs/ops/VM_DEPLOYMENT_GUIDE.md) Complete guide to install and configure OmniRoute on a VM (VPS) with domain managed via Cloudflare. @@ -54,7 +60,7 @@ apt install -y ca-certificates curl gnupg 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 +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 ``` @@ -91,7 +97,7 @@ mkdir -p /opt/omniroute ### 2.2 Create environment variables file ```bash -cat > /opt/omniroute/.env << ‘EOF’ +cat > /opt/omniroute/.env << 'EOF' # === Security === JWT_SECRET=CHANGE-TO-A-UNIQUE-64-CHAR-SECRET-KEY INITIAL_PASSWORD=YourSecurePassword123! @@ -99,13 +105,13 @@ API_KEY_SECRET=REPLACE-WITH-ANOTHER-SECRET-KEY STORAGE_ENCRYPTION_KEY=REPLACE-WITH-THIRD-SECRET-KEY STORAGE_ENCRYPTION_KEY_VERSION=v1 MACHINE_ID_SALT=CHANGE-TO-A-UNIQUE-SALT +OMNIROUTE_WS_BRIDGE_SECRET=REPLACE-WITH-WS-BRIDGE-SECRET # REQUIRED em produção: usado pelo Codex Responses WS bridge # === App === PORT=20128 NODE_ENV=production HOSTNAME=0.0.0.0 DATA_DIR=/app/data -STORAGE_DRIVER=sqlite APP_LOG_TO_FILE=true AUTH_COOKIE_SECURE=false REQUIRE_API_KEY=false @@ -173,7 +179,7 @@ chmod 600 /etc/nginx/ssl/origin.key ### 3.2 Nginx Configuration ```bash -cat > /etc/nginx/sites-available/omniroute << ‘NGINX’ +cat > /etc/nginx/sites-available/omniroute << 'NGINX' # Default server — blocks direct access via IP server { listen 80 default_server; @@ -208,7 +214,7 @@ server { # WebSocket support proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection “upgrade”; + proxy_set_header Connection "upgrade"; # SSE (Server-Sent Events) — streaming AI responses proxy_buffering off; @@ -315,7 +321,7 @@ docker run --rm -v omniroute-data:/data -v $(pwd):/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 /” + alpine sh -c "rm -rf /data/* && tar xzf /backup/omniroute-data-YYYY-MM-DD.tar.gz -C /" docker start omniroute ``` @@ -326,7 +332,7 @@ docker start omniroute ### Restrict nginx to Cloudflare IPs ```bash -cat > /etc/nginx/cloudflare-ips.conf << ‘CF’ +cat > /etc/nginx/cloudflare-ips.conf << 'CF' # Cloudflare IPv4 ranges — update periodically # https://www.cloudflare.com/ips-v4/ set_real_ip_from 173.245.48.0/20; @@ -391,7 +397,7 @@ npx wrangler login npx wrangler deploy ``` -See the full documentation at [omnirouteCloud/README.md](../omnirouteCloud/README.md). +See also [TUNNELS_GUIDE.md](./TUNNELS_GUIDE.md) for the in-repo Cloudflare Tunnel walkthrough. The standalone `omnirouteCloud/` worker lives in a separate companion repo. --- diff --git a/docs/reference/API_REFERENCE.md b/docs/reference/API_REFERENCE.md new file mode 100644 index 0000000000..719f4a8d07 --- /dev/null +++ b/docs/reference/API_REFERENCE.md @@ -0,0 +1,872 @@ +--- +title: "API Reference" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# API Reference + +🌐 **Languages:** 🇺🇸 [English](./API_REFERENCE.md) | 🇧🇷 [Português (Brasil)](../i18n/pt-BR/docs/reference/API_REFERENCE.md) | 🇪🇸 [Español](../i18n/es/docs/reference/API_REFERENCE.md) | 🇫🇷 [Français](../i18n/fr/docs/reference/API_REFERENCE.md) | 🇮🇹 [Italiano](../i18n/it/docs/reference/API_REFERENCE.md) | 🇷🇺 [Русский](../i18n/ru/docs/reference/API_REFERENCE.md) | 🇨🇳 [中文 (简体)](../i18n/zh-CN/docs/reference/API_REFERENCE.md) | 🇩🇪 [Deutsch](../i18n/de/docs/reference/API_REFERENCE.md) | 🇮🇳 [हिन्दी](../i18n/in/docs/reference/API_REFERENCE.md) | 🇹🇭 [ไทย](../i18n/th/docs/reference/API_REFERENCE.md) | 🇺🇦 [Українська](../i18n/uk-UA/docs/reference/API_REFERENCE.md) | 🇸🇦 [العربية](../i18n/ar/docs/reference/API_REFERENCE.md) | 🇯🇵 [日本語](../i18n/ja/docs/reference/API_REFERENCE.md) | 🇻🇳 [Tiếng Việt](../i18n/vi/docs/reference/API_REFERENCE.md) | 🇧🇬 [Български](../i18n/bg/docs/reference/API_REFERENCE.md) | 🇩🇰 [Dansk](../i18n/da/docs/reference/API_REFERENCE.md) | 🇫🇮 [Suomi](../i18n/fi/docs/reference/API_REFERENCE.md) | 🇮🇱 [עברית](../i18n/he/docs/reference/API_REFERENCE.md) | 🇭🇺 [Magyar](../i18n/hu/docs/reference/API_REFERENCE.md) | 🇮🇩 [Bahasa Indonesia](../i18n/id/docs/reference/API_REFERENCE.md) | 🇰🇷 [한국어](../i18n/ko/docs/reference/API_REFERENCE.md) | 🇲🇾 [Bahasa Melayu](../i18n/ms/docs/reference/API_REFERENCE.md) | 🇳🇱 [Nederlands](../i18n/nl/docs/reference/API_REFERENCE.md) | 🇳🇴 [Norsk](../i18n/no/docs/reference/API_REFERENCE.md) | 🇵🇹 [Português (Portugal)](../i18n/pt/docs/reference/API_REFERENCE.md) | 🇷🇴 [Română](../i18n/ro/docs/reference/API_REFERENCE.md) | 🇵🇱 [Polski](../i18n/pl/docs/reference/API_REFERENCE.md) | 🇸🇰 [Slovenčina](../i18n/sk/docs/reference/API_REFERENCE.md) | 🇸🇪 [Svenska](../i18n/sv/docs/reference/API_REFERENCE.md) | 🇵🇭 [Filipino](../i18n/phi/docs/reference/API_REFERENCE.md) | 🇨🇿 [Čeština](../i18n/cs/docs/reference/API_REFERENCE.md) + +Complete reference for all OmniRoute API endpoints. + +--- + +## Table of Contents + +- [Chat Completions](#chat-completions) +- [Embeddings](#embeddings) +- [Image Generation](#image-generation) +- [List Models](#list-models) +- [Compatibility Endpoints](#compatibility-endpoints) +- [Files API](#files-api) +- [Batches API](#batches-api) +- [Search API](#search-api) +- [WebSocket Streaming](#websocket-streaming) +- [Quotas & Issues Reporting](#quotas--issues-reporting) +- [Semantic Cache](#semantic-cache) +- [Dashboard & Management](#dashboard--management) +- [Combo Management](#combo-management) +- [Webhooks](#webhooks) +- [Registered Keys (Auto-Management)](#registered-keys-auto-management) +- [Agents Protocol](#agents-protocol) +- [Management Proxies](#management-proxies) +- [Resilience (extended)](#resilience-extended) +- [Skills](#skills) +- [Memory](#memory) +- [MCP Server](#mcp-server) +- [A2A Server](#a2a-server) +- [Cloud, Evals & Assess](#cloud-evals--assess) +- [Request Processing](#request-processing) +- [Authentication](#authentication) + +--- + +## Chat Completions + +```bash +POST /v1/chat/completions +Authorization: Bearer your-api-key +Content-Type: application/json + +{ + "model": "cc/claude-opus-4-6", + "messages": [ + {"role": "user", "content": "Write a function to..."} + ], + "stream": true +} +``` + +### Custom Headers + +| Header | Direction | Description | +| ------------------------ | --------- | ------------------------------------------------ | +| `X-OmniRoute-No-Cache` | Request | Set to `true` to bypass cache | +| `X-OmniRoute-Progress` | Request | Set to `true` for progress events | +| `X-Session-Id` | Request | Sticky session key for external session affinity | +| `x_session_id` | Request | Underscore variant also accepted (direct HTTP) | +| `Idempotency-Key` | Request | Dedup key (5s window) | +| `X-Request-Id` | Request | Alternative dedup key | +| `X-OmniRoute-Cache` | Response | `HIT` or `MISS` (non-streaming) | +| `X-OmniRoute-Idempotent` | Response | `true` if deduplicated | +| `X-OmniRoute-Progress` | Response | `enabled` if progress tracking on | +| `X-OmniRoute-Session-Id` | Response | Effective session ID used by OmniRoute | + +> Nginx note: if you rely on underscore headers (for example `x_session_id`), enable `underscores_in_headers on;`. + +--- + +## Embeddings + +```bash +POST /v1/embeddings +Authorization: Bearer your-api-key +Content-Type: application/json + +{ + "model": "nebius/Qwen/Qwen3-Embedding-8B", + "input": "The food was delicious" +} +``` + +Available providers: Nebius, OpenAI, Mistral, Together AI, Fireworks, NVIDIA, **OpenRouter**, **GitHub Models**. + +```bash +# List all embedding models +GET /v1/embeddings +``` + +--- + +## Image Generation + +```bash +POST /v1/images/generations +Authorization: Bearer your-api-key +Content-Type: application/json + +{ + "model": "openai/gpt-image-2", + "prompt": "A beautiful sunset over mountains", + "size": "1024x1024" +} +``` + +Available providers: OpenAI (GPT Image 2), xAI (Grok Image), Together AI (FLUX), Fireworks AI, Nebius (FLUX), Hyperbolic, NanoBanana, **OpenRouter**, SD WebUI (local), ComfyUI (local). + +```bash +# List all image models +GET /v1/images/generations +``` + +--- + +## List Models + +```bash +GET /v1/models +Authorization: Bearer your-api-key + +→ Returns all chat, embedding, and image models + combos in OpenAI format +``` + +--- + +## Compatibility Endpoints + +| Method | Path | Format | +| ------ | --------------------------- | ------------------------------- | +| POST | `/v1/chat/completions` | OpenAI | +| POST | `/v1/messages` | Anthropic | +| POST | `/v1/responses` | OpenAI Responses | +| POST | `/v1/embeddings` | OpenAI | +| POST | `/v1/images/generations` | OpenAI Images | +| POST | `/v1/images/edits` | OpenAI Images (edit/inpaint) | +| POST | `/v1/videos/generations` | OpenAI-style video generation | +| POST | `/v1/music/generations` | OpenAI-style music generation | +| POST | `/v1/audio/transcriptions` | OpenAI Audio (STT) | +| POST | `/v1/audio/speech` | OpenAI TTS (returns audio body) | +| POST | `/v1/rerank` | Cohere/Voyage-style rerank | +| POST | `/v1/moderations` | OpenAI Moderations | +| GET | `/v1/models` | OpenAI | +| POST | `/v1/messages/count_tokens` | Anthropic | +| GET | `/v1beta/models` | Gemini | +| POST | `/v1beta/models/{...path}` | Gemini generateContent | +| POST | `/v1/api/chat` | Ollama | + +All POST routes follow the same shape: `Bearer your-api-key` + Zod-validated JSON body (`v1RerankSchema`, `v1ModerationSchema`, `v1AudioSpeechSchema`, etc., see `src/shared/validation/schemas.ts`). 4xx is returned on schema failure. + +```bash +# Rerank +POST /v1/rerank { "model": "cohere/rerank-3", "query": "...", "documents": ["..."] } + +# Moderations +POST /v1/moderations { "model": "omni-moderation-latest", "input": "..." } + +# TTS — returns audio/mpeg (or requested format) body +POST /v1/audio/speech { "model": "openai/tts-1", "input": "Hello", "voice": "alloy" } + +# Image edit (multipart) +POST /v1/images/edits -F image=@input.png -F prompt="..." -F mask=@mask.png + +# Video / music generation (provider-prefixed model id) +POST /v1/videos/generations { "model": "runway/gen-3", "prompt": "..." } +POST /v1/music/generations { "model": "suno/v3.5", "prompt": "..." } +``` + +### Dedicated Provider Routes + +```bash +POST /v1/providers/{provider}/chat/completions +POST /v1/providers/{provider}/embeddings +POST /v1/providers/{provider}/images/generations +``` + +The provider prefix is auto-added if missing. Mismatched models return `400`. + +--- + +## Files API + +OpenAI-compatible files endpoint for batch input/output and file-purpose uploads. + +| Method | Path | Description | +| ------ | ------------------------ | ------------------------------------------------------------------------------------------------------------- | +| POST | `/v1/files` | Upload a file (multipart: `file`, `purpose`, `expires_after[anchor]`, `expires_after[seconds]`) — 512 MiB max | +| GET | `/v1/files` | List files for the authenticated API key | +| GET | `/v1/files/[id]` | Retrieve a file's metadata | +| DELETE | `/v1/files/[id]` | Delete a file | +| GET | `/v1/files/[id]/content` | Stream the raw file body back | + +**Auth:** Bearer API key — files are scoped per-API-key via `getApiKeyRequestScope`. + +--- + +## Batches API + +OpenAI-compatible batch processing. + +| Method | Path | Description | +| ------ | ------------------------- | --------------------------------------------------------------------------------------------------------- | +| POST | `/v1/batches` | Create batch — body validated by `v1BatchCreateSchema` (`input_file_id`, `endpoint`, `completion_window`) | +| GET | `/v1/batches` | List batches | +| GET | `/v1/batches/[id]` | Retrieve batch status + `request_counts` | +| DELETE | `/v1/batches/[id]` | Delete a finished/failed batch | +| POST | `/v1/batches/[id]/cancel` | Cancel an in-progress batch | + +**Auth:** Bearer API key. Batches are scoped per-API-key. + +--- + +## Search API + +Web/search provider abstraction (Tavily, Brave, Exa, Serper, etc.). + +| Method | Path | Description | +| ------ | ---------------------- | ------------------------------------------------------------------------------------ | +| GET | `/v1/search` | List configured search providers + capabilities | +| POST | `/v1/search` | Run a search query — body validated by `v1SearchSchema`, supports caching/coalescing | +| GET | `/v1/search/analytics` | Per-provider hit/latency/cache stats | + +**Auth:** Bearer API key (`extractApiKey` + `isValidApiKey`). Search policy enforced via `enforceApiKeyPolicy`. + +--- + +## WebSocket Streaming + +```bash +GET /v1/ws?handshake=1 +``` + +Validates a WebSocket upgrade handshake and returns the wire protocol example messages (`request`, `cancel`). Actual WS frames are handled by the bundled WS server outside the Next.js route table. + +**Auth:** Bearer API key during handshake. + +--- + +## Quotas & Issues Reporting + +| Method | Path | Description | +| ------ | ------------------- | ------------------------------------------------------------------------------------- | +| GET | `/v1/quotas/check` | Pre-validate quota for a `provider` + `accountId` before issuing a registered key | +| POST | `/v1/issues/report` | Report a quota/key issuance failure to GitHub (requires `GITHUB_ISSUES_REPO` + token) | + +**Auth:** Bearer API key (`isAuthenticated`). + +--- + +## Semantic Cache + +```bash +# Get cache stats +GET /api/cache/stats + +# Clear all caches +DELETE /api/cache/stats +``` + +Response example: + +```json +{ + "semanticCache": { + "memorySize": 42, + "memoryMaxSize": 500, + "dbSize": 128, + "hitRate": 0.65 + }, + "idempotency": { + "activeKeys": 3, + "windowMs": 5000 + } +} +``` + +--- + +## Dashboard & Management + +### Authentication + +| Endpoint | Method | Description | +| ----------------------------- | ------- | --------------------- | +| `/api/auth/login` | POST | Login | +| `/api/auth/logout` | POST | Logout | +| `/api/settings/require-login` | GET/PUT | Toggle login required | + +### Provider Management + +| Endpoint | Method | Description | +| ---------------------------- | --------------------- | ---------------------------------------------- | +| `/api/providers` | GET/POST | List / create providers | +| `/api/providers/[id]` | GET/PUT/DELETE | Manage a provider | +| `/api/providers/[id]/test` | POST | Test provider connection | +| `/api/providers/[id]/models` | GET | List provider models | +| `/api/providers/validate` | POST | Validate provider config | +| `/api/provider-nodes*` | Various | Provider node management | +| `/api/provider-models` | GET/POST/PATCH/DELETE | Custom models (add, update, hide/show, delete) | + +### OAuth Flows + +| Endpoint | Method | Description | +| -------------------------------- | ------- | ----------------------- | +| `/api/oauth/[provider]/[action]` | Various | Provider-specific OAuth | + +### Routing & Config + +| Endpoint | Method | Description | +| --------------------- | -------- | ----------------------------- | +| `/api/models/alias` | GET/POST | Model aliases | +| `/api/models/catalog` | GET | All models by provider + type | +| `/api/combos*` | Various | Combo management | +| `/api/keys*` | Various | API key management | +| `/api/pricing` | GET | Model pricing | + +### Usage & Analytics + +| Endpoint | Method | Description | +| --------------------------- | ------ | -------------------- | +| `/api/usage/history` | GET | Usage history | +| `/api/usage/logs` | GET | Usage logs | +| `/api/usage/request-logs` | GET | Request-level logs | +| `/api/usage/[connectionId]` | GET | Per-connection usage | + +### Settings + +| Endpoint | Method | Description | +| ------------------------------- | ------------- | ------------------------- | +| `/api/settings` | GET/PUT/PATCH | General settings | +| `/api/settings/proxy` | GET/PUT | Network proxy config | +| `/api/settings/proxy/test` | POST | Test proxy connection | +| `/api/settings/ip-filter` | GET/PUT | IP allowlist/blocklist | +| `/api/settings/thinking-budget` | GET/PUT | Reasoning token budget | +| `/api/settings/system-prompt` | GET/PUT | Global system prompt | +| `/api/settings/compression` | GET/PUT | Global compression config | + +### Context & Compression + +| Endpoint | Method | Description | +| -------------------------------------- | -------------- | ------------------------------------------------------------------------ | +| `/api/compression/preview` | POST | Preview off/lite/standard/aggressive/ultra/RTK/stacked compression | +| `/api/compression/language-packs` | GET | List available Caveman language packs | +| `/api/compression/rules` | GET | List Caveman rule metadata | +| `/api/context/caveman/config` | GET/PUT | Caveman-specific settings alias | +| `/api/context/rtk/config` | GET/PUT | RTK-specific settings, including custom filters and raw-output retention | +| `/api/context/rtk/filters` | GET | RTK filter catalog and custom-filter diagnostics | +| `/api/context/rtk/test` | POST | Run RTK preview/test against a text payload | +| `/api/context/rtk/raw-output/[id]` | GET | Read retained redacted raw output by pointer id | +| `/api/context/combos` | GET/POST | Compression combo list/create | +| `/api/context/combos/[id]` | GET/PUT/DELETE | Compression combo detail/update/delete | +| `/api/context/combos/[id]/assignments` | GET/PUT | Assign compression combos to routing combos | +| `/api/context/analytics` | GET | Compression analytics alias | + +### Monitoring + +| Endpoint | Method | Description | +| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------- | +| `/api/sessions` | GET | Active session tracking | +| `/api/rate-limits` | GET | Per-account rate limits | +| `/api/monitoring/health` | GET | Health check + provider summary (`catalogCount`, `configuredCount`, `activeCount`, `monitoredCount`) | +| `/api/cache/stats` | 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 | +| ---------------------- | ------- | --------------------- | +| `/api/sync/cloud` | Various | Cloud sync operations | +| `/api/sync/initialize` | POST | Initialize sync | +| `/api/cloud/*` | Various | Cloud management | + +### Tunnels + +| Endpoint | Method | Description | +| -------------------------- | ------ | ----------------------------------------------------------------------- | +| `/api/tunnels/cloudflared` | GET | Read Cloudflare Quick Tunnel install/runtime status for the dashboard | +| `/api/tunnels/cloudflared` | POST | Enable or disable the Cloudflare Quick Tunnel (`action=enable/disable`) | +| `/api/tunnels/ngrok` | GET | Read ngrok Tunnel runtime status for the dashboard | +| `/api/tunnels/ngrok` | POST | Enable or disable the ngrok Tunnel (`action=enable/disable`) | + +### CLI Tools + +| Endpoint | Method | Description | +| ---------------------------------- | ------ | ------------------- | +| `/api/cli-tools/claude-settings` | GET | Claude CLI status | +| `/api/cli-tools/codex-settings` | GET | Codex CLI status | +| `/api/cli-tools/droid-settings` | GET | Droid CLI status | +| `/api/cli-tools/openclaw-settings` | GET | OpenClaw CLI status | +| `/api/cli-tools/runtime/[toolId]` | GET | Generic CLI runtime | + +CLI responses include: `installed`, `runnable`, `command`, `commandPath`, `runtimeMode`, `reason`. + +### ACP Agents + +| Endpoint | Method | Description | +| ----------------- | ------ | -------------------------------------------------------- | +| `/api/acp/agents` | GET | List all detected agents (built-in + custom) with status | +| `/api/acp/agents` | POST | Add custom agent or refresh detection cache | +| `/api/acp/agents` | DELETE | Remove a custom agent by `id` query param | + +GET response includes `agents[]` (id, name, binary, version, installed, protocol, isCustom) and `summary` (total, installed, notFound, builtIn, custom). + +### Resilience & Rate Limits + +| Endpoint | Method | Description | +| --------------------------------- | --------- | ------------------------------------------------------------------------------------ | +| `/api/resilience` | GET/PATCH | Get/update request queue, connection cooldown, provider breaker, and wait settings | +| `/api/resilience/reset` | POST | Reset provider circuit breakers | +| `/api/resilience/model-cooldowns` | GET | List active per-(provider, connection, model) lockouts, sorted by remaining time | +| `/api/resilience/model-cooldowns` | DELETE | Clear a model lockout — body `{provider, model}` or `{all: true}` to wipe everything | +| `/api/rate-limits` | GET | Per-account rate limit status | +| `/api/rate-limit` | GET | Global rate limit configuration | + +> All four `/api/resilience/*` routes require **management auth** (`requireManagementAuth`). See [Resilience (extended)](#resilience-extended) for a full breakdown of provider breaker vs connection cooldown vs model lockout. + +### Evals + +| Endpoint | Method | Description | +| ------------ | -------- | --------------------------------- | +| `/api/evals` | GET/POST | List eval suites / run evaluation | + +### Policies + +| Endpoint | Method | Description | +| --------------- | --------------- | ----------------------- | +| `/api/policies` | GET/POST/DELETE | Manage routing policies | + +### Compliance + +| Endpoint | Method | Description | +| --------------------------- | ------ | ----------------------------- | +| `/api/compliance/audit-log` | GET | Compliance audit log (last N) | + +### v1beta (Gemini-Compatible) + +| Endpoint | Method | Description | +| -------------------------- | ------ | --------------------------------- | +| `/v1beta/models` | GET | List models in Gemini format | +| `/v1beta/models/{...path}` | POST | Gemini `generateContent` endpoint | + +These endpoints mirror Gemini's API format for clients that expect native Gemini SDK compatibility. + +### Internal / System APIs + +| Endpoint | Method | Description | +| ------------------------ | ------ | ---------------------------------------------------- | +| `/api/init` | GET | Application initialization check (used on first run) | +| `/api/tags` | GET | Ollama-compatible model tags (for Ollama clients) | +| `/api/restart` | POST | Trigger graceful server restart | +| `/api/shutdown` | POST | Trigger graceful server shutdown | +| `/api/system/env/repair` | POST | Repair OAuth provider environment variables | +| `/api/system-info` | GET | Generate system diagnostics report | + +> **Note:** These endpoints are used internally by the system or for Ollama client compatibility. They are not typically called by end users. + +### OAuth Environment Repair _(v3.6.1+)_ + +```bash +POST /api/system/env/repair +Content-Type: application/json + +{ + "provider": "claude-code" +} +``` + +Repairs missing or corrupted OAuth environment variables for a specific provider. Returns: + +```json +{ + "success": true, + "repaired": ["CLAUDE_CODE_OAUTH_CLIENT_ID", "CLAUDE_CODE_OAUTH_CLIENT_SECRET"], + "backupPath": "/home/user/.omniroute/backups/env-repair-2026-04-11.bak" +} +``` + +--- + +## Audio Transcription + +```bash +POST /v1/audio/transcriptions +Authorization: Bearer your-api-key +Content-Type: multipart/form-data +``` + +Transcribe audio files using Deepgram or AssemblyAI. + +**Request:** + +```bash +curl -X POST http://localhost:20128/v1/audio/transcriptions \ + -H "Authorization: Bearer your-api-key" \ + -F "file=@recording.mp3" \ + -F "model=deepgram/nova-3" +``` + +**Response:** + +```json +{ + "text": "Hello, this is the transcribed audio content.", + "task": "transcribe", + "language": "en", + "duration": 12.5 +} +``` + +**Supported providers:** `deepgram/nova-3`, `assemblyai/best`. + +**Supported formats:** `mp3`, `wav`, `m4a`, `flac`, `ogg`, `webm`. + +--- + +## Ollama Compatibility + +For clients that use Ollama's API format: + +```bash +# Chat endpoint (Ollama format) +POST /v1/api/chat + +# Model listing (Ollama format) +GET /api/tags +``` + +Requests are automatically translated between Ollama and internal formats. + +--- + +## Telemetry + +```bash +# Get latency telemetry summary (p50/p95/p99 per provider) +GET /api/telemetry/summary +``` + +**Response:** + +```json +{ + "providers": { + "claudeCode": { "p50": 245, "p95": 890, "p99": 1200, "count": 150 }, + "github": { "p50": 180, "p95": 620, "p99": 950, "count": 320 } + } +} +``` + +--- + +## Budget + +```bash +# Get budget status for all API keys +GET /api/usage/budget + +# Set or update a budget +POST /api/usage/budget +Content-Type: application/json + +{ + "apiKeyId": "key-123", + "dailyLimitUsd": 5.00, + "weeklyLimitUsd": 30.00, + "monthlyLimitUsd": 100.00, + "warningThreshold": 0.8, + "resetInterval": "monthly" +} +``` + +> **Schema notes** (`setBudgetSchema`): `apiKeyId` is required; at least one of `dailyLimitUsd`, `weeklyLimitUsd`, or `monthlyLimitUsd` must be greater than zero. Optional fields: `warningThreshold` (0–1), `resetInterval` (`daily` | `weekly` | `monthly`), `resetTime` (`HH:MM`). The legacy `{keyId, limit, period}` shape returns `400 Bad Request`. + +## Request Processing + +1. Client sends request to `/v1/*` +2. Route handler calls `handleChat`, `handleEmbedding`, `handleAudioTranscription`, or `handleImageGeneration` +3. Model is resolved (direct provider/model or alias/combo) +4. Credentials selected from local DB with account availability filtering +5. For chat: `handleChatCore` checks semantic/signature cache and resolves combo compression settings +6. Proactive compression runs before provider translation when enabled (`lite`, Caveman, RTK, or stacked) +7. Provider executor sends upstream request +8. Response translated back to client format (chat) or returned as-is (embeddings/images/audio) +9. Usage, compression analytics, and request logs are recorded +10. Fallback applies on errors according to combo rules + +Full architecture reference: [`ARCHITECTURE.md`](../architecture/ARCHITECTURE.md) + +--- + +## Combo Management + +Higher-level routing combos (already summarized under `/api/combos*`) can also be mapped 1:1 from a model id pattern, allowing transparent redirection of an OpenAI-style model id to a combo. + +| Method | Path | Description | +| ------ | -------------------------------- | ------------------------------------------------------------------------------ | +| GET | `/api/model-combo-mappings` | List all model→combo mappings | +| POST | `/api/model-combo-mappings` | Create mapping — body: `{pattern, comboId, priority?, enabled?, description?}` | +| GET | `/api/model-combo-mappings/[id]` | Retrieve a single mapping | +| PUT | `/api/model-combo-mappings/[id]` | Update fields of an existing mapping | +| DELETE | `/api/model-combo-mappings/[id]` | Remove a mapping | + +**Auth:** management session/API key (`requireManagementAuth`). + +--- + +## Webhooks + +Outbound webhook subscriptions for OmniRoute events (request completion, quota exhaustion, key rotation, etc.). + +| Method | Path | Description | +| ------ | ------------------------- | --------------------------------------------------------------------- | +| GET | `/api/webhooks` | List webhooks (secrets are masked to `<prefix>...`) | +| POST | `/api/webhooks` | Create webhook — body: `{url, events?: ["*"], secret?, description?}` | +| GET | `/api/webhooks/[id]` | Retrieve a webhook | +| PUT | `/api/webhooks/[id]` | Update url/events/secret/description | +| DELETE | `/api/webhooks/[id]` | Remove a webhook | +| POST | `/api/webhooks/[id]/test` | Send a test payload to the webhook URL and return delivery status | + +**Auth:** management session/API key (`requireManagementAuth`). + +--- + +## Registered Keys (Auto-Management) + +Used by the auto-key management subsystem to issue and rotate API keys against a backing provider/account, with daily/hourly quotas. + +| Method | Path | Description | +| ------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| GET | `/api/v1/registered-keys` | List registered keys (masked prefix only) | +| POST | `/api/v1/registered-keys` | Issue a new registered key — body: `{name, provider?, accountId?, idempotencyKey?, expiresAt?, dailyBudget?, hourlyBudget?}`. Returns the raw key **once**. Returns `429` on quota refusal. | +| GET | `/api/v1/registered-keys/[id]` | Retrieve a registered key's metadata (no raw material) | +| DELETE | `/api/v1/registered-keys/[id]` | Revoke a registered key | +| POST | `/api/v1/registered-keys/[id]/revoke` | Explicit revoke endpoint (same effect as DELETE) | + +**Auth:** Bearer API key (`isAuthenticated`). See also `/v1/quotas/check` and `/v1/issues/report`. + +--- + +## Agents Protocol + +Cloud agent tasks (Claude Code, Codex Cloud, OpenHands, etc.) executed remotely on behalf of OmniRoute users. + +| Method | Path | Description | +| ------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | +| GET | `/api/v1/agents/tasks` | List tasks — optional `?provider=`, `?status=`, `?limit=` (1–500, default 50) | +| POST | `/api/v1/agents/tasks` | Create task — body validated by `CreateCloudAgentTaskSchema` (`providerId`, `prompt`, `source`, `options?`). Returns `201` with task envelope | +| DELETE | `/api/v1/agents/tasks?id=...` | Delete a task | +| GET | `/api/v1/agents/tasks/[id]` | Read task — synchronously refreshes status from the upstream cloud agent when an `external_id` is set | +| POST | `/api/v1/agents/tasks/[id]` | Discriminated action: `{action: "approve"}`, `{action: "message", message}`, or `{action: "cancel"}` | +| DELETE | `/api/v1/agents/tasks/[id]` | Delete a specific task by id | + +> **Auth:** management auth required on every method (`requireCloudAgentManagementAuth`). Prior to v3.8.0 these were unauthenticated — see commit `588a0333` for the breaking change. + +```bash +# Create a Claude Code cloud task +curl -X POST http://localhost:20128/api/v1/agents/tasks \ + -H "Authorization: Bearer your-management-key" \ + -H "Content-Type: application/json" \ + -d '{"providerId":"claude-code-cloud","prompt":"Fix the failing test","source":{"repo":"...","branch":"..."}}' +``` + +--- + +## Management Proxies + +Outbound HTTP(S)/SOCKS proxies that can be assigned to providers, accounts, or globally. + +| Method | Path | Description | +| ------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| GET | `/api/v1/management/proxies` | List proxies (with `?id=` returns one; with `?id=&where_used=1` returns the assignment graph) | +| POST | `/api/v1/management/proxies` | Create proxy — body validated by `createProxyRegistrySchema` | +| PATCH | `/api/v1/management/proxies` | Update proxy — body validated by `updateProxyRegistrySchema` (requires `id`) | +| DELETE | `/api/v1/management/proxies?id=...&force=1` | Delete proxy (use `force=1` to detach assignments) | +| GET | `/api/v1/management/proxies/assignments` | List assignments — filterable by `proxy_id`, `scope`, `scope_id`; pass `resolve_connection_id=<id>` to resolve the active proxy for a connection | +| PUT | `/api/v1/management/proxies/assignments` | Assign — body validated by `proxyAssignmentSchema` (`{scope, scopeId?, proxyId?}`). Clears dispatcher cache | +| PUT | `/api/v1/management/proxies/bulk-assign` | Bulk-assign — body validated by `bulkProxyAssignmentSchema` (`{scope, scopeIds[], proxyId?}`) | +| GET | `/api/v1/management/proxies/health?hours=24` | Aggregate proxy health (success/fail counts, latency) over a window | + +**Auth:** management session/API key on every route (`requireManagementAuth`). + +> The task description's `POST /api/v1/management/proxies/[id]/assignments` and `POST /api/v1/management/proxies/[id]/health` are served by the flat `/assignments` and `/health` routes shown above — there are no per-id subroutes in the codebase. + +--- + +## Resilience (extended) + +OmniRoute exposes three independent temporary-failure mechanisms; the management endpoints below let operators read and override them: + +| Scope | State storage | Read | Reset / clear | +| ------------------- | ------------------------------------------ | ----------------------------------------- | ------------------------------------------- | +| Provider breaker | `domain_circuit_breakers` + in-memory | `/api/monitoring/health` | `POST /api/resilience/reset` | +| Connection cooldown | `rateLimitedUntil` on provider connections | `/api/rate-limits`, `/api/providers/[id]` | (re-enables lazily; clear via provider PUT) | +| Model lockout | In-memory model-availability registry | `GET /api/resilience/model-cooldowns` | `DELETE /api/resilience/model-cooldowns` | + +```bash +# Clear a single model lockout +curl -X DELETE http://localhost:20128/api/resilience/model-cooldowns \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{"provider":"openai","model":"gpt-4o-mini"}' + +# Wipe every lockout +curl -X DELETE http://localhost:20128/api/resilience/model-cooldowns \ + -H "Cookie: auth_token=..." \ + -d '{"all":true}' +``` + +Full conceptual reference and breaker defaults: see [`CLAUDE.md`](../../CLAUDE.md) → "Resilience Runtime State". + +--- + +## Skills + +Skill framework for extending OmniRoute with custom executable handlers, plus marketplace integrations. + +| Method | Path | Description | +| ------ | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| GET | `/api/skills` | List installed skills — filterable by `?q=`, `?mode=on\|off\|auto`, `?source=skillsmp\|skillssh\|local`, paginated | +| GET | `/api/skills/[id]` | Retrieve one skill | +| PUT | `/api/skills/[id]` | Update skill (name, description, mode, schema, handler, tags) | +| DELETE | `/api/skills/[id]` | Uninstall a skill | +| POST | `/api/skills/install` | Install a skill from a raw manifest — body: `{name, version, description, schema:{input, output}, handlerCode, apiKeyId?}` | +| GET | `/api/skills/executions` | List recent skill executions (audit trail with inputs/outputs/duration) | +| GET | `/api/skills/marketplace?q=...` | Search/popular list from the SkillsMP marketplace (requires `skillsmpApiKey` setting) | +| POST | `/api/skills/marketplace/install` | Install a skill by id from SkillsMP | +| GET | `/api/skills/skillssh?q=&limit=` | Search the skills.sh registry | +| POST | `/api/skills/skillssh/install` | Install a skill by id from skills.sh | + +**Auth:** management session/API key. Marketplace search routes accept either management auth or a Bearer API key (`isAuthenticated`). + +--- + +## Memory + +Persistent conversational/factual memory store, scoped per API key / session. + +| Method | Path | Description | +| ------ | -------------------- | ------------------------------------------------------------------------------------------------------------ | +| GET | `/api/memory` | List memories — `?apiKeyId=`, `?type=`, `?sessionId=`, `?q=`, with `offset/limit` or `page/limit` pagination | +| POST | `/api/memory` | Create memory — body validated by Zod: `{content, key, type?, sessionId?, apiKeyId?, metadata?, expiresAt?}` | +| GET | `/api/memory/[id]` | Retrieve one memory | +| DELETE | `/api/memory/[id]` | Delete a memory | +| GET | `/api/memory/health` | Memory subsystem health (DB connectivity, embeddings backend, vector index status) | + +**Auth:** management session/API key (`requireManagementAuth`). `type` enum: `FACTUAL`, `EPISODIC`, `SEMANTIC`, `PROCEDURAL` (see `MemoryType` in `src/lib/memory/types.ts`). + +--- + +## MCP Server + +OmniRoute ships an embedded Model Context Protocol server with 3 transports (stdio, SSE, streamable-http) and scoped tools. The dashboard endpoints below read status/audit data and proxy the HTTP transports. + +| Method | Path | Description | +| ------ | ---------------------- | ------------------------------------------------------------------------------------------------ | -------------------- | +| GET | `/api/mcp/status` | Heartbeat, transport, online state, last call, top tools, 24h success rate | +| GET | `/api/mcp/tools` | List of MCP tools with `name`, `description`, `scopes`, `phase`, `auditLevel`, `sourceEndpoints` | +| GET | `/api/mcp/sse` | Open SSE stream for the SSE transport (returns `503` if MCP disabled or transport mismatch) | +| POST | `/api/mcp/sse` | Send JSON-RPC frame on the SSE transport | +| GET | `/api/mcp/stream` | Open SSE side of the Streamable HTTP transport (server-initiated messages) | +| POST | `/api/mcp/stream` | Send JSON-RPC frame on the Streamable HTTP transport | +| DELETE | `/api/mcp/stream` | End a Streamable HTTP session | +| GET | `/api/mcp/audit` | Query audit log — `?limit=`, `?offset=`, `?tool=`, `?success=true | false`, `?apiKeyId=` | +| GET | `/api/mcp/audit/stats` | Aggregate audit stats (totals, success rate, avg duration, top tools) | + +**Auth:** the `sse`/`stream` transports honor the MCP-specific auth surface (Bearer API key with `mcp` scope); the `status`/`tools`/`audit*` routes are readable from the dashboard (no extra auth required beyond reaching the dashboard host). + +> Both HTTP transports are gated by `settings.mcpEnabled` and `settings.mcpTransport` — a transport mismatch returns `400`, an MCP disabled state returns `503`. + +--- + +## A2A Server + +OmniRoute exposes an A2A (Agent-to-Agent) JSON-RPC 2.0 endpoint plus a REST wrapper for inspection/dashboard use. + +### JSON-RPC + +```bash +POST /a2a +Authorization: Bearer your-api-key # optional unless OMNIROUTE_API_KEY is set +Content-Type: application/json + +{ + "jsonrpc": "2.0", + "id": 1, + "method": "message/send", + "params": { + "skill": "smart-routing", + "messages": [{"role": "user", "content": "Route this coding task"}] + } +} +``` + +Supported methods (all gated on `settings.a2aEnabled`): + +| Method | Description | +| ---------------- | ------------------------------------------------------------------ | +| `message/send` | Synchronous skill execution; returns `{task, artifacts, metadata}` | +| `message/stream` | Streaming SSE execution of the same skill set | +| `tasks/get` | Fetch a task by `taskId` | +| `tasks/cancel` | Cancel a task by `taskId` | + +Built-in skills: `smart-routing`, `quota-management`, `provider-discovery`, `cost-analysis`, `health-report`. + +### Agent Card + +```bash +GET /.well-known/agent.json +``` + +Returns the public A2A agent card (name, description, capabilities, skill catalog, auth scheme) — cached publicly for 1h. No auth required. + +### REST helpers + +| Method | Path | Description | +| ------ | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | +| GET | `/api/a2a/status` | A2A enabled + task stats + cached agent card summary | +| GET | `/api/a2a/tasks` | List tasks — `?state=submitted\|working\|completed\|failed\|cancelled`, `?skill=`, `?limit=` (≤200), `?offset=` | +| POST | `/api/a2a/tasks` | (Not implemented as a REST helper — create via JSON-RPC `message/send`) | +| GET | `/api/a2a/tasks/[id]` | Retrieve one task | +| POST | `/api/a2a/tasks/[id]/cancel` | Cancel a task | + +**Auth:** the REST helpers run without management auth (dashboard-readable); the JSON-RPC `/a2a` route uses Bearer `OMNIROUTE_API_KEY` if configured. + +--- + +## Cloud, Evals & Assess + +| Method | Path | Description | +| ------ | ------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------- | ----------------------------------- | +| POST | `/api/cloud/auth` | Verify a Bearer key and return masked provider connections + model aliases for cloud sync clients | +| POST | `/api/cloud/credentials/update` | Update encrypted credentials for a cloud-synced provider | +| POST | `/api/cloud/model/resolve` | Resolve a logical model id to a concrete provider/model using the local routing table | +| GET | `/api/cloud/models/alias` | List model aliases as exposed to cloud sync | +| GET | `/api/assess` | Read latest assessment categorizations (per-provider/model) | +| POST | `/api/assess` | Run an assessment — body: `{scope: {type:"all"} | {type:"provider", providerId} | {type:"model", modelId}, trigger?}` | +| GET | `/api/evals` | List built-in eval suites + most recent runs | +| POST | `/api/evals` | Trigger an eval run | +| POST | `/api/evals/suites` | Create a custom eval suite — body validated by `evalSuiteSaveSchema` | +| GET | `/api/evals/suites/[id]` | Retrieve a custom eval suite | + +**Auth:** `/api/cloud/auth` validates a Bearer key directly; the other `/api/cloud/*`, `/api/evals/*`, and `/api/assess` routes require management session/API key. `/api/assess` POST uses `validateBody` with a discriminated-union scope schema. + +--- + +## Authentication + +- Dashboard routes (`/dashboard/*`) use `auth_token` cookie +- Login uses saved password hash; fallback to `INITIAL_PASSWORD` +- `requireLogin` toggleable via `/api/settings/require-login` +- `/v1/*` routes optionally require Bearer API key when `REQUIRE_API_KEY=true` + +> **Breaking change (v3.8.0)** — `/api/v1/agents/tasks/*` and the cooldown management endpoints now require **management auth** (dashboard `auth_token` cookie or a management-scoped API key). Clients that previously called these routes unauthenticated will receive `401 Unauthorized`. See commit `588a0333` (`fix(auth): require management auth for agent and cooldown APIs`). diff --git a/docs/reference/CLI-TOOLS.md b/docs/reference/CLI-TOOLS.md new file mode 100644 index 0000000000..ff7e73ae28 --- /dev/null +++ b/docs/reference/CLI-TOOLS.md @@ -0,0 +1,694 @@ +--- +title: "CLI Tools — OmniRoute v3.8.0" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# CLI Tools — OmniRoute v3.8.0 + +Last updated: 2026-05-13 + +OmniRoute integrates with two categories of CLI tools: + +1. **External CLI integrations** — third-party CLIs (Cursor, Cline, Codex, Claude Code, Qwen Code, Windsurf, Hermes, Amp, etc.) that you point at OmniRoute's local OpenAI-compatible endpoint. +2. **Internal OmniRoute CLI** — commands bundled with the `omniroute` binary for server lifecycle, setup, diagnostics, and provider management. + +--- + +## How It Works + +``` +Claude / Codex / OpenCode / Cline / KiloCode / Continue / Cursor / Windsurf / Hermes / Amp / Qwen + │ + ▼ (all point to OmniRoute) + http://YOUR_SERVER:20128/v1 + │ + ▼ (OmniRoute routes to the right provider) + Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ... +``` + +**Benefits:** + +- One API key to manage all tools +- Cost tracking across all CLIs in the dashboard +- Model switching without reconfiguring every tool +- Works locally and on remote servers (VPS, Docker, Akamai, Cloudflare Tunnel) + +--- + +## 1. External CLI Integrations + +### Source of Truth + +The dashboard cards in `/dashboard/cli-tools` are generated from +`src/shared/constants/cliTools.ts`. The internal helper `bin/cli-commands.mjs` +keeps the small set of "fully scriptable" tools that `omniroute setup` can write +config files for automatically. + +### Current Catalog (v3.8.0) + +| Tool | ID | Type / Config | Install / Access | Auth | +| ------------------ | ------------- | ------------------- | ------------------------------------ | ----------------------------------- | +| **Claude Code** | `claude` | env / settings.json | `npm i -g @anthropic-ai/claude-code` | API key (Anthropic gateway) | +| **OpenAI Codex** | `codex` | custom (toml) | `npm i -g @openai/codex` | API key (OpenAI) | +| **Factory Droid** | `droid` | custom | bundled / CLI | API key | +| **Open Claw** | `openclaw` | custom | bundled / CLI | API key | +| **Cursor** | `cursor` | guide (Cloud) | Cursor desktop app | API key (Cloud Endpoint) | +| **Windsurf** | `windsurf` | guide | Windsurf desktop IDE | API key (BYOK) | +| **Cline** | `cline` | custom / VS Code | `npm i -g cline` + VS Code ext | API key | +| **Kilo Code** | `kilo` | custom / VS Code | `npm i -g kilocode` + VS Code ext | API key | +| **Continue** | `continue` | guide (config.yaml) | VS Code extension | API key | +| **Antigravity** | `antigravity` | MITM | OmniRoute built-in | API key (MITM proxy) | +| **GitHub Copilot** | `copilot` | custom / VS Code | VS Code extension | API key (CLI fingerprint: `github`) | +| **OpenCode** | `opencode` | guide (json) | `npm i -g opencode-ai` | API key (OpenAI-compatible) | +| **Hermes** | `hermes` | guide (json) | install per docs | API key (OpenAI-compatible) | +| **Amp CLI** | `amp` | guide (env) | install per Sourcegraph docs | API key (OpenAI-compatible) | +| **Kiro AI** | `kiro` | MITM | Amazon Kiro IDE / CLI | API key (MITM proxy) | +| **Qwen Code** | `qwen` | guide (json/env) | `npm i -g @qwen-code/qwen-code` | API key (OpenAI-compatible) | +| **Custom CLI** | `custom` | custom-builder | any OpenAI-compatible client | API key | + +> Notes: +> +> - "Web wrappers" like ChatGPT/Claude/Grok/Perplexity browser sessions are not +> listed here. OmniRoute can proxy them through the `chatgpt-web`, +> `claude-web`, `grok-web`, `perplexity-web`, `blackbox-web`, +> `muse-spark-web` provider connections, but those are **provider connections** +> (configured under `/dashboard/providers`), not CLI tools. They do not surface +> as cards under `/dashboard/cli-tools`. +> - Tools marked **MITM** (Antigravity, Kiro) intercept the desktop app traffic +> locally and require enabling the corresponding mitm endpoint in +> `/dashboard/settings`. + +### CLI fingerprint sync (Agents + Settings) + +`/dashboard/agents` and `Settings > CLI Fingerprint` use +`src/shared/constants/cliCompatProviders.ts`. This keeps provider IDs aligned +with the CLI cards and legacy IDs. + +| CLI ID | Fingerprint Provider ID | +| --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | +| `kilo` | `kilocode` | +| `copilot` | `github` | +| `claude` / `codex` / `antigravity` / `kiro` / `cursor` / `windsurf` / `cline` / `opencode` / `hermes` / `amp` / `qwen` / `droid` / `openclaw` | same ID | + +Legacy IDs still accepted for compatibility: `copilot`, `kimi-coding`, `qwen`. + +--- + +### Step 1 — Get an OmniRoute API Key + +1. Open the OmniRoute dashboard → **API Manager** (`/dashboard/api-manager`) +2. Click **Create API Key** +3. Give it a name (e.g. `cli-tools`) and select all permissions +4. Copy the key — you'll need it for every CLI below + +> Your key looks like: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx` + +--- + +### Step 2 — Install CLI Tools + +All npm-based tools require Node.js 20.20.2+, 22.22.2+ or 24.x: + +```bash +# Claude Code (Anthropic) +npm install -g @anthropic-ai/claude-code + +# OpenAI Codex +npm install -g @openai/codex + +# OpenCode +npm install -g opencode-ai + +# Cline +npm install -g cline + +# KiloCode +npm install -g kilocode + +# Qwen Code (Alibaba) +npm install -g @qwen-code/qwen-code + +# Kiro CLI (Amazon — requires curl + unzip) +apt-get install -y unzip # on Debian/Ubuntu +curl -fsSL https://cli.kiro.dev/install | bash +export PATH="$HOME/.local/bin:$PATH" # add to ~/.bashrc +``` + +**Verify:** + +```bash +claude --version # 2.x.x +codex --version # 0.x.x +opencode --version # x.x.x +cline --version # 2.x.x +kilocode --version # x.x.x (or: kilo --version) +qwen --version # x.x.x +kiro-cli --version # 1.x.x +``` + +--- + +### Step 3 — Set Global Environment Variables + +Add to `~/.bashrc` (or `~/.zshrc`), then run `source ~/.bashrc`: + +```bash +# OmniRoute Universal Endpoint +export OPENAI_BASE_URL="http://localhost:20128/v1" +export OPENAI_API_KEY="sk-your-omniroute-key" +export ANTHROPIC_BASE_URL="http://localhost:20128" +export ANTHROPIC_AUTH_TOKEN="sk-your-omniroute-key" +export GEMINI_BASE_URL="http://localhost:20128/v1" +export GEMINI_API_KEY="sk-your-omniroute-key" +``` + +> For a **remote server** replace `localhost:20128` with the server IP or domain, +> e.g. `http://192.168.0.15:20128`. + +--- + +### Step 4 — Configure Each Tool + +#### Claude Code + +```bash +# Create ~/.claude/settings.json: +mkdir -p ~/.claude && cat > ~/.claude/settings.json << EOF +{ + "env": { + "ANTHROPIC_BASE_URL": "http://localhost:20128", + "ANTHROPIC_AUTH_TOKEN": "sk-your-omniroute-key" + } +} +EOF +``` + +Use the unified Anthropic gateway root for Claude Code. Do not append `/v1` here. + +**Test:** `claude "say hello"` + +--- + +#### OpenAI Codex + +```bash +mkdir -p ~/.codex && cat > ~/.codex/config.yaml << EOF +model: auto +apiKey: sk-your-omniroute-key +apiBaseUrl: http://localhost:20128/v1 +EOF +``` + +**Test:** `codex "what is 2+2?"` + +--- + +#### OpenCode + +```bash +mkdir -p ~/.config/opencode && cat > ~/.config/opencode/opencode.json << EOF +{ + "\$schema": "https://opencode.ai/config.json", + "provider": { + "omniroute": { + "npm": "@ai-sdk/openai-compatible", + "name": "OmniRoute", + "options": { + "baseURL": "http://localhost:20128/v1", + "apiKey": "sk-your-omniroute-key" + }, + "models": { + "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }, + "claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" }, + "gemini-3-flash": { "name": "gemini-3-flash" } + } + } + } +} +EOF +``` + +**Test:** `opencode` + +> Use `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high` +> to send thinking variants. + +--- + +#### Cline (CLI or VS Code) + +**CLI mode:** + +```bash +mkdir -p ~/.cline/data && cat > ~/.cline/data/globalState.json << EOF +{ + "apiProvider": "openai", + "openAiBaseUrl": "http://localhost:20128/v1", + "openAiApiKey": "sk-your-omniroute-key" +} +EOF +``` + +**VS Code mode:** +Cline extension settings → API Provider: `OpenAI Compatible` → Base URL: `http://localhost:20128/v1` + +Or use the OmniRoute dashboard → **CLI Tools → Cline → Apply Config**. + +--- + +#### KiloCode (CLI or VS Code) + +**CLI mode:** + +```bash +kilocode --api-base http://localhost:20128/v1 --api-key sk-your-omniroute-key +``` + +**VS Code settings:** + +```json +{ + "kilo-code.openAiBaseUrl": "http://localhost:20128/v1", + "kilo-code.apiKey": "sk-your-omniroute-key" +} +``` + +Or use the OmniRoute dashboard → **CLI Tools → KiloCode → Apply Config**. + +--- + +#### Continue (VS Code Extension) + +Edit `~/.continue/config.yaml`: + +```yaml +models: + - name: OmniRoute + provider: openai + model: auto + apiBase: http://localhost:20128/v1 + apiKey: sk-your-omniroute-key + default: true +``` + +Restart VS Code after editing. + +--- + +#### Kiro CLI (Amazon) + +```bash +# Login to your AWS/Kiro account: +kiro-cli login + +# The CLI uses its own auth — OmniRoute is not needed as backend for Kiro CLI itself. +# Use kiro-cli alongside OmniRoute for other tools. +kiro-cli status +``` + +For the **Kiro IDE** desktop app, use the MITM endpoint exposed by OmniRoute +under `/dashboard/cli-tools → Kiro`. + +--- + +#### Qwen Code (Alibaba) + +Qwen Code supports OpenAI-compatible API endpoints via environment variables or `settings.json`. + +> Qwen OAuth free tier was discontinued on 2026-04-15. Use OmniRoute with +> `alicode` / `openrouter` / `anthropic` / `gemini` providers instead. + +**Option 1: Environment variables (`~/.qwen/.env`)** + +```bash +mkdir -p ~/.qwen && cat > ~/.qwen/.env << EOF +OPENAI_API_KEY="sk-your-omniroute-key" +OPENAI_BASE_URL="http://localhost:20128/v1" +OPENAI_MODEL="auto" +EOF +``` + +**Option 2: `settings.json` with `security.auth`** + +```json +// ~/.qwen/settings.json +{ + "security": { + "auth": { + "selectedType": "openai", + "apiKey": "sk-your-omniroute-key", + "baseUrl": "http://localhost:20128/v1" + } + }, + "model": { + "name": "claude-sonnet-4-6" + } +} +``` + +**Option 3: Inline CLI flags** + +```bash +OPENAI_BASE_URL="http://localhost:20128/v1" \ +OPENAI_API_KEY="sk-your-omniroute-key" \ +OPENAI_MODEL="auto" \ +qwen +``` + +> For a **remote server** replace `localhost:20128` with the server IP or domain. + +**Test:** `qwen "say hello"` + +--- + +#### Cursor (Desktop App) + +> **Note:** Cursor routes requests through its cloud. For OmniRoute integration, +> enable **Cloud Endpoint** in OmniRoute Settings and use your public domain URL. + +Via GUI: **Settings → Models → OpenAI API Key** + +- Base URL: `https://your-domain.com/v1` +- API Key: your OmniRoute key + +--- + +#### Windsurf (Desktop IDE) + +> Official Windsurf docs currently describe BYOK for select Claude models plus +> enterprise URL/token settings, not a generic custom OpenAI-compatible provider. +> Test BYOK behavior in your environment before relying on this integration. + +1. Open AI Settings inside Windsurf. +2. Select **Add custom provider** (OpenAI-compatible). +3. Base URL: `http://localhost:20128/v1` +4. API Key: your OmniRoute key +5. Pick a model from the OmniRoute catalog. + +--- + +#### Hermes + +```json +// Hermes config file +{ + "provider": { + "type": "openai", + "baseURL": "http://localhost:20128/v1", + "apiKey": "sk-your-omniroute-key", + "model": "claude-sonnet-4-6" + } +} +``` + +--- + +#### Amp CLI (Sourcegraph) + +```bash +export OPENAI_API_KEY="sk-your-omniroute-key" +export OPENAI_BASE_URL="http://localhost:20128/v1" +amp --model "claude-sonnet-4-6" + +# Suggested shorthand aliases you can map locally: +# g25p -> gemini/gemini-2.5-pro +# g25f -> gemini/gemini-2.5-flash +# cs45 -> cc/claude-sonnet-4-5-20250929 +# g54 -> gemini/gemini-3.1-pro-high +``` + +--- + +### Dashboard Auto-Configuration + +The OmniRoute dashboard automates configuration for most tools: + +1. Go to `http://localhost:20128/dashboard/cli-tools` +2. Expand any tool card +3. Select your API key from the dropdown +4. Click **Apply Config** (if the tool is detected as installed) +5. Or copy the generated config snippet manually + +--- + +### Built-in Agents: Droid & Open Claw + +**Droid** and **Open Claw** are AI agents built directly into OmniRoute — no +installation needed. They run as internal routes and use OmniRoute's model +routing automatically. + +- Access: `http://localhost:20128/dashboard/agents` +- Configure: same combos and providers as all other tools +- No API key or CLI install required + +--- + +## 2. Internal OmniRoute CLI + +The `omniroute` binary (installed via `npm install -g omniroute` or bundled +with the desktop app) provides commands beyond running the server. The full +matrix is implemented in: + +- `bin/omniroute.mjs` — entry point and `--help` text +- `bin/cli/index.mjs` — dispatcher for the supported subcommands +- `bin/cli/commands/setup.mjs`, `bin/cli/commands/doctor.mjs`, + `bin/cli/commands/providers.mjs` — the three core subcommands + +Other subcommands listed in `--help` (status, logs, combo, keys, mcp, a2a, +tunnel, backup, restore, quota, health, cache, env, completion, dashboard, +serve, stop, restart, open, update, test) are wired through +`bin/cli-commands.mjs` and require a running server for most of them. + +### Server Lifecycle + +```bash +omniroute # Start server (default port 20128) +omniroute --port 3000 # Override port +omniroute --no-open # Don't auto-open browser +omniroute --mcp # Start as MCP server (stdio transport) +omniroute serve # Same as `omniroute` +omniroute stop # Stop the running server +omniroute restart # Restart the server +omniroute dashboard # Open dashboard in default browser +omniroute open # Alias for `dashboard` +omniroute --version # Print version +omniroute --help # Show all commands +``` + +### Setup & Initialization + +```bash +omniroute setup # Interactive setup wizard +omniroute setup --non-interactive # CI/automation mode (reads env vars + flags) +omniroute setup --password '<value>' # Set admin password directly +omniroute setup --add-provider \ + --provider openai \ + --api-key '<value>' \ + --test-provider # Add and test a provider in one shot +``` + +Recognized environment variables for non-interactive setup: + +| Var | Purpose | +| ----------------------------- | -------------------------------------------- | +| `OMNIROUTE_SETUP_PASSWORD` | Admin password (>=8 chars) | +| `OMNIROUTE_PROVIDER` | Provider id (e.g. `openai`, `anthropic`) | +| `OMNIROUTE_PROVIDER_NAME` | Display name for the connection | +| `OMNIROUTE_PROVIDER_BASE_URL` | Optional OpenAI-compatible base URL override | +| `OMNIROUTE_API_KEY` | Provider API key | +| `OMNIROUTE_DEFAULT_MODEL` | Optional default model | +| `DATA_DIR` | Override the OmniRoute data directory | + +### Diagnostics + +```bash +omniroute doctor # Check config, DB, ports, runtime, memory, liveness +omniroute doctor --json # Machine-readable JSON +omniroute doctor --no-liveness # Skip the HTTP health probe +omniroute doctor --host 0.0.0.0 # Override liveness host +omniroute doctor --liveness-url <url> # Full health endpoint URL override +``` + +The doctor runs these checks: `Config`, `Database`, `Storage/encryption`, +`Port availability`, `Node runtime`, `Native binary` (better-sqlite3), +`Memory`, and `Server liveness`. It exits non-zero if any check is `fail`. + +### Provider Management + +```bash +omniroute providers available # OmniRoute provider catalog +omniroute providers available --search openai # Filter catalog by id/name/alias/category +omniroute providers available --category api-key # Filter by category (api-key, oauth, free, ...) +omniroute providers available --json # Machine-readable JSON + +omniroute providers list # Configured provider connections +omniroute providers list --json + +omniroute providers test <id|name> # Test one configured connection +omniroute providers test-all # Test every active connection +omniroute providers validate # Local-only structural validation +``` + +> `providers available` reads the OmniRoute catalog; `providers list/test/test-all/validate` +> read the local SQLite database directly and do not require the server to be running. + +### Recovery & Reset + +```bash +omniroute reset-password # Reset the admin password (legacy alias still works) +omniroute reset-encrypted-columns # Show warning + dry-run for encrypted credential reset +omniroute reset-encrypted-columns --force # Actually null out encrypted credentials in SQLite +``` + +### Other subcommands (via `cli-commands.mjs`) + +These are dispatched in `bin/cli-commands.mjs` and assume a running OmniRoute +server, unless noted otherwise: + +```bash +omniroute status # Comprehensive runtime status +omniroute logs # Stream request logs (--json, --search, --follow) +omniroute config show # Display current configuration + +omniroute provider list # List available providers (alias of providers list) +omniroute provider add # Register OmniRoute as a provider on a tool +omniroute keys add | list | remove # Manage API keys +omniroute models [provider] # List models (--json, --search) +omniroute combo list | switch | create | delete + +omniroute backup # Snapshot config + DB +omniroute restore # Restore from a previous snapshot + +omniroute health # Detailed health (breakers, cache, memory) +omniroute quota # Provider quota usage +omniroute cache # Cache status +omniroute cache clear # Clear semantic + signature caches + +omniroute mcp status | restart # MCP server status / restart +omniroute a2a status | card # A2A server status / agent card + +omniroute tunnel list | create | stop # Manage tunnels (cloudflare/tailscale/ngrok) +omniroute env show | get <k> | set <k> <v> # Inspect / set env vars (temporary) + +omniroute test # Provider connectivity smoke test +omniroute update # Check for updates +omniroute completion # Generate shell completion +``` + +### Common flags + +| Flag | Description | +| ------------------- | ------------------------------------------------------ | +| `--no-open` | Don't auto-open the browser on start | +| `--port <n>` | Override the API port (default 20128) | +| `--mcp` | Run as MCP server over stdio (for IDEs) | +| `--non-interactive` | CI mode (no prompts; reads from env/flags) | +| `--json` | Machine-readable JSON output (doctor, providers, etc.) | +| `--help`, `-h` | Show command-specific help | +| `--version`, `-v` | Print the installed version | + +--- + +## Available API Endpoints + +| Endpoint | Description | Use For | +| -------------------------- | ----------------------------- | --------------------------- | +| `/v1/chat/completions` | Standard chat (all providers) | All modern tools | +| `/v1/responses` | Responses API (OpenAI format) | Codex, agentic workflows | +| `/v1/completions` | Legacy text completions | Older tools using `prompt:` | +| `/v1/embeddings` | Text embeddings | RAG, search | +| `/v1/images/generations` | Image generation | GPT-Image, Flux, etc. | +| `/v1/audio/speech` | Text-to-speech | ElevenLabs, OpenAI TTS | +| `/v1/audio/transcriptions` | Speech-to-text | Deepgram, AssemblyAI | + +--- + +## Troubleshooting + +| Error | Cause | Fix | +| ------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------- | +| `Connection refused` | OmniRoute not running | `omniroute serve` or `pm2 start omniroute` | +| `401 Unauthorized` | Wrong API key | Check in `/dashboard/api-manager` | +| `No combo configured` | No active routing combo | Set up in `/dashboard/combos` | +| `invalid model` | Model not in catalog | Use `auto` or check `/dashboard/providers` | +| CLI shows "not installed" | Binary not in PATH | Check `which <command>` | +| `kiro-cli: not found` | Not in PATH | `export PATH="$HOME/.local/bin:$PATH"` | +| `doctor` reports SQLite incompatible | Wrong native binary | `cd app && npm rebuild better-sqlite3` | +| `doctor` reports `STORAGE_ENCRYPTION_KEY` missing | Encrypted creds without key | Set `STORAGE_ENCRYPTION_KEY` or `omniroute reset-encrypted-columns --force` | + +--- + +## Quick Setup Script (One Command) + +```bash +cat > my-setup.sh <<'EOF' +#!/usr/bin/env bash +set -euo pipefail + +# === Edit these === +OMNIROUTE_URL="http://localhost:20128/v1" +OMNIROUTE_ANTHROPIC_URL="http://localhost:20128" +OMNIROUTE_KEY="sk-your-omniroute-key" +# ================== + +# 1. Install the external CLIs +npm install -g \ + @anthropic-ai/claude-code \ + @openai/codex \ + opencode-ai \ + cline \ + kilocode \ + @qwen-code/qwen-code + +# 2. Optional: Kiro CLI (needs unzip) +if ! command -v unzip >/dev/null 2>&1; then + sudo apt-get install -y unzip +fi +curl -fsSL https://cli.kiro.dev/install | bash + +# 3. Write the per-tool config files +mkdir -p ~/.claude ~/.codex ~/.config/opencode ~/.continue ~/.qwen + +cat > ~/.claude/settings.json <<JSON +{ + "env": { + "ANTHROPIC_BASE_URL": "${OMNIROUTE_ANTHROPIC_URL}", + "ANTHROPIC_AUTH_TOKEN": "${OMNIROUTE_KEY}" + } +} +JSON + +cat > ~/.codex/config.yaml <<YAML +model: auto +apiKey: ${OMNIROUTE_KEY} +apiBaseUrl: ${OMNIROUTE_URL} +YAML + +cat > ~/.qwen/.env <<ENV +OPENAI_API_KEY="${OMNIROUTE_KEY}" +OPENAI_BASE_URL="${OMNIROUTE_URL}" +OPENAI_MODEL="auto" +ENV + +# 4. Append global env vars (idempotent guard) +if ! grep -q "OmniRoute Universal Endpoint" ~/.bashrc 2>/dev/null; then + cat >> ~/.bashrc <<ENV + +# OmniRoute Universal Endpoint +export OPENAI_BASE_URL="${OMNIROUTE_URL}" +export OPENAI_API_KEY="${OMNIROUTE_KEY}" +export ANTHROPIC_BASE_URL="${OMNIROUTE_ANTHROPIC_URL}" +export ANTHROPIC_AUTH_TOKEN="${OMNIROUTE_KEY}" +ENV +fi + +# 5. Validate via the internal CLI +omniroute doctor || true +omniroute providers list || true + +echo "All CLIs installed and configured for OmniRoute" +EOF +chmod +x my-setup.sh +./my-setup.sh +``` diff --git a/docs/reference/ENVIRONMENT.md b/docs/reference/ENVIRONMENT.md new file mode 100644 index 0000000000..13933a3ff0 --- /dev/null +++ b/docs/reference/ENVIRONMENT.md @@ -0,0 +1,857 @@ +--- +title: "Environment Variables Reference" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Environment Variables Reference + +> Complete reference for every environment variable recognized by OmniRoute. +> For a quick-start template, see [`.env.example`](../../.env.example). + +> [!IMPORTANT] +> Every variable documented here must also appear in `.env.example`, and +> every variable in `.env.example` must appear here. `npm run check:env-doc-sync` +> enforces this on commit and in CI. To omit a variable on purpose, add it to +> the allowlist inside `scripts/check-env-doc-sync.mjs`. + +--- + +## Table of Contents + +- [1. Required Secrets](#1-required-secrets) +- [2. Storage & Database](#2-storage--database) +- [3. Network & Ports](#3-network--ports) +- [4. Security & Authentication](#4-security--authentication) +- [5. Input Sanitization & PII Protection](#5-input-sanitization--pii-protection) +- [6. Tool & Routing Policies](#6-tool--routing-policies) +- [7. URLs & Cloud Sync](#7-urls--cloud-sync) +- [8. Outbound Proxy](#8-outbound-proxy) +- [9. CLI Tool Integration](#9-cli-tool-integration) +- [10. Internal Agent & MCP Integrations](#10-internal-agent--mcp-integrations) +- [11. OAuth Provider Credentials](#11-oauth-provider-credentials) +- [12. Provider User-Agent Overrides](#12-provider-user-agent-overrides) +- [13. CLI Fingerprint Compatibility](#13-cli-fingerprint-compatibility) +- [14. API Key Providers](#14-api-key-providers) +- [15. Timeout Settings](#15-timeout-settings) +- [16. Logging](#16-logging) +- [17. Memory Optimization](#17-memory-optimization) +- [18. Pricing Sync](#18-pricing-sync) +- [19. Model Sync (Dev)](#19-model-sync-dev) +- [20. Provider-Specific Settings](#20-provider-specific-settings) +- [21. Proxy Health](#21-proxy-health) +- [22. Debugging](#22-debugging) +- [23. GitHub Integration](#23-github-integration) +- [24. Skills Sandbox (v3.8.0+)](#24-skills-sandbox-v380) +- [Deployment Scenarios](#deployment-scenarios) +- [Audit: Removed / Dead Variables](#audit-removed--dead-variables) + +--- + +## 1. Required Secrets + +These **must** be set before the first run. Without them, the application will either refuse to start or operate with insecure defaults. + +| Variable | Required | Default | Source File | Description | +| ---------------------------- | -------------------- | ---------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `JWT_SECRET` | **Yes** | _(none)_ | `src/lib/auth` | Signs/verifies all dashboard session cookies (JWT). Generate with `openssl rand -base64 48`. | +| `API_KEY_SECRET` | **Yes** | _(none)_ | `src/lib/db/apiKeys.ts` | AES encryption key for API key values at rest in SQLite. Generate with `openssl rand -hex 32`. | +| `INITIAL_PASSWORD` | **Yes** | `CHANGEME` | Bootstrap script | Sets the initial admin dashboard password (matches `.env.example` default — kept obviously insecure to force a change). **Change before first use.** After login, change via Dashboard → Settings → Security. | +| `OMNIROUTE_WS_BRIDGE_SECRET` | **Yes** (production) | _(unset)_ | `src/app/api/internal/codex-responses-ws/route.ts` | Shared secret for the internal Codex Responses WebSocket bridge. Authenticates bridge requests between the Electron/browser WS relay and OmniRoute. ⚠️ **REQUIRED in production — when unset, all WS bridge requests are rejected.** Generate with `openssl rand -base64 32`. | + +### Generation Commands + +```bash +# Generate all four secrets at once: +echo "JWT_SECRET=$(openssl rand -base64 48)" +echo "API_KEY_SECRET=$(openssl rand -hex 32)" +echo "INITIAL_PASSWORD=$(openssl rand -base64 16)" +echo "OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -base64 32)" +``` + +> [!CAUTION] +> Never commit `.env` files with real secrets to version control. The `.gitignore` already excludes `.env`, but verify before pushing. + +--- + +## 2. Storage & Database + +OmniRoute uses **SQLite** (via `better-sqlite3`) for all persistence. These variables control data location, encryption, and lifecycle. + +| Variable | Default | Source File | Description | +| -------------------------------------- | -------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | +| `DATA_DIR` | `~/.omniroute/` | `src/lib/db/core.ts` | Root directory for SQLite DB, backups, and data files. Override for Docker volumes or custom paths. | +| `STORAGE_ENCRYPTION_KEY` | _(empty = disabled)_ | `src/lib/db/encryption.ts` | AES key for full SQLite database encryption at rest. Generate with `openssl rand -hex 32`. | +| `STORAGE_ENCRYPTION_KEY_VERSION` | `v1` | `scripts/build/bootstrap-env.mjs`, `electron/main.js` | Version label for the encryption key. Increment when performing key rotation to support decryption of old backups. | +| `DISABLE_SQLITE_AUTO_BACKUP` | `false` | `src/lib/db/backup.ts` | When `true`, skips the automatic database backup that runs before migrations on every startup. | +| `OMNIROUTE_CRYPT_KEY` | _(unset)_ | `src/lib/db/encryption.ts` | **Legacy alias** for `STORAGE_ENCRYPTION_KEY`. Accepted as a fallback when the primary variable is absent. | +| `OMNIROUTE_API_KEY_BASE64` | _(unset)_ | `src/lib/db/encryption.ts` | **Legacy alias** (Base64-encoded form) accepted as a fallback. Decoded automatically before use. | +| `OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS` | _(unset)_ | `src/lib/db/core.ts` | Override the periodic SQLite healthcheck interval (ms). When unset, defaults are derived from `NODE_ENV`. | +| `OMNIROUTE_FORCE_DB_HEALTHCHECK` | `0` | `src/lib/db/core.ts` | Set to `1` to force the DB healthcheck loop on, even when it would normally be skipped (e.g., short-lived tasks). | +| `OMNIROUTE_MIGRATIONS_DIR` | _(auto-detect)_ | `src/lib/db/migrationRunner.ts` | Override the directory that the migration runner scans. Useful when shipping bundled migrations in custom builds. | +| `OMNIROUTE_SPEND_FLUSH_INTERVAL_MS` | _(default in code)_ | `src/lib/spend/batchWriter.ts` | Flush interval (ms) for the batched spend/cost writer. Lower values reduce write coalescing; higher values reduce DB contention. | +| `OMNIROUTE_SPEND_MAX_BUFFER_SIZE` | _(default in code)_ | `src/lib/spend/batchWriter.ts` | Max buffered spend entries before a forced flush. Raise on high-QPS deployments; lower when bounded memory matters more. | + +### Scenarios + +| Scenario | Configuration | +| --------------------- | -------------------------------------------------------------------------------- | +| **Local development** | Leave all defaults. DB lives at `~/.omniroute/omniroute.db`. | +| **Docker** | `DATA_DIR=/data` + mount a volume at `/data`. | +| **Encrypted at rest** | Set `STORAGE_ENCRYPTION_KEY` + keep backups of the key! Losing it = losing data. | +| **CI/Testing** | `DATA_DIR=/tmp/omniroute-test` — ephemeral, no encryption needed. | + +--- + +## 3. Network & Ports + +| Variable | Default | Source File | Description | +| ------------------------- | ------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `PORT` | `20128` | `src/lib/runtime/ports.ts` | Primary port for both Dashboard UI and API endpoints (single-port mode). | +| `API_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | When set, serves the `/v1/*` proxy API on this separate port. | +| `API_HOST` | `0.0.0.0` | `src/lib/runtime/ports.ts` | Bind address for the API port. | +| `DASHBOARD_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | When set, serves the Dashboard UI on this separate port. | +| `PROD_DASHBOARD_PORT` | `20130` | `docker-compose.prod.yml` | Host-side published port for the Dashboard in Docker production mode. | +| `PROD_API_PORT` | `20131` | `docker-compose.prod.yml` | Host-side published port for the API in Docker production mode. | +| `OMNIROUTE_PORT` | _(unset)_ | `src/lib/runtime/ports.ts` | Takes precedence over `PORT` when running inside Electron or other wrappers. | +| `NODE_ENV` | `production` | Next.js core | Controls logging verbosity, caching, error detail exposure, and Next.js optimizations. | +| `OMNIROUTE_USE_TURBOPACK` | `1` (default in `.env.example`) | `package.json` / Next.js 16 | Toggles the Next.js 16 Turbopack bundler in `npm run dev` and `npm run build`. Set to `0` on Windows or when running into native binding incompatibilities. | +| `HOST` | `0.0.0.0` | `scripts/run-next.mjs` | Bind address for the Next.js dev/start server. Overrides the default `0.0.0.0` when set. | +| `HOSTNAME` | `127.0.0.1` | `scripts/run-next-playwright.mjs` | Bind address used by the Playwright runner when launching Next.js. Defaults to `127.0.0.1` for hermetic tests. | + +### Port Modes + +``` +┌─────────────────────────── Single Port (default) ──────────────────────────┐ +│ PORT=20128 │ +│ → Dashboard: http://localhost:20128 │ +│ → API: http://localhost:20128/v1/chat/completions │ +└─────────────────────────────────────────────────────────────────────────────┘ + +┌─────────────────────────── Split Ports ─────────────────────────────────────┐ +│ DASHBOARD_PORT=20128 │ +│ API_PORT=20129 │ +│ API_HOST=0.0.0.0 │ +│ → Dashboard: http://localhost:20128 │ +│ → API: http://0.0.0.0:20129/v1/chat/completions │ +│ Use case: Expose API to LAN while restricting Dashboard to localhost. │ +└─────────────────────────────────────────────────────────────────────────────┘ + +┌─────────────────────────── Docker Production ──────────────────────────────┐ +│ PROD_DASHBOARD_PORT=443 PROD_API_PORT=8443 │ +│ → Maps container ports to host ports in docker-compose.prod.yml. │ +└─────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 4. Security & Authentication + +| Variable | Default | Source File | Description | +| --------------------------------------- | --------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `MACHINE_ID_SALT` | `endpoint-proxy-salt` | `src/lib/auth` | Salt combined with hardware identifiers for machine fingerprinting. Change per-deployment for isolation. | +| `AUTH_COOKIE_SECURE` | `false` | `src/lib/auth` | Sets the `Secure` flag on session cookies. **Must be `true`** when running behind HTTPS. | +| `REQUIRE_API_KEY` | `false` | API middleware | When `true`, all `/v1/*` proxy requests must include a valid API key. | +| `ALLOW_API_KEY_REVEAL` | `false` | Dashboard providers page | Allows revealing full API key values in the Dashboard UI. Security risk on shared instances. | +| `NO_LOG_API_KEY_IDS` | _(empty)_ | `src/lib/compliance/index.ts` | Comma-separated API key IDs that bypass request logging (GDPR compliance). | +| `MAX_BODY_SIZE_BYTES` | `10485760` (10 MB) | `src/shared/middleware/bodySizeGuard.ts` | Maximum allowed request body size. Rejects payloads exceeding this limit. | +| `CORS_ORIGIN` | `*` | Next.js middleware | CORS `Access-Control-Allow-Origin` value. Restrict for production. | +| `OUTBOUND_SSRF_GUARD_ENABLED` | `true` | `src/shared/network/outboundUrlGuard.ts` | Block provider calls targeting private/loopback/link-local IP ranges. Disable only in isolated test envs. | +| `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` | `false` | `src/shared/network/outboundUrlGuard.ts` | Allow provider URLs pointing to private/local networks (localhost, 192.168.x.x, 10.x.x.x, etc.). **REQUIRED for self-hosted providers** (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). When `false`, the dashboard rejects validation of local URLs. | + +### Hardening Checklist + +```bash +# Production security minimum: +AUTH_COOKIE_SECURE=true # Requires HTTPS +REQUIRE_API_KEY=true # Authenticate all proxy calls +ALLOW_API_KEY_REVEAL=false # Never expose keys in UI +CORS_ORIGIN=https://your.domain.com +MAX_BODY_SIZE_BYTES=5242880 # 5 MB limit +``` + +--- + +## 5. Input Sanitization & PII Protection + +OmniRoute provides a two-layer defense: request-side injection scanning and response-side PII stripping. + +### Request-Side: Prompt Injection Guard + +| Variable | Default | Source File | Description | +| ------------------------- | --------- | ---------------------------------------- | ------------------------------------------------------------------------------------------- | +| `INPUT_SANITIZER_ENABLED` | `false` | `src/middleware/promptInjectionGuard.ts` | Enable scanning of incoming messages for prompt injection patterns. | +| `INPUT_SANITIZER_MODE` | `warn` | `src/middleware/promptInjectionGuard.ts` | `warn` = log only, `block` = reject request with 400, `redact` = strip suspicious patterns. | +| `INJECTION_GUARD_MODE` | _(unset)_ | `src/middleware/promptInjectionGuard.ts` | Legacy alias for `INPUT_SANITIZER_MODE` — same behavior. | +| `PII_REDACTION_ENABLED` | `false` | `src/middleware/promptInjectionGuard.ts` | Detect PII (emails, phones, SSNs) in incoming requests. | + +### Response-Side: PII Sanitizer + +| Variable | Default | Source File | Description | +| -------------------------------- | -------- | ------------------------- | ----------------------------------------------------------------------- | +| `PII_RESPONSE_SANITIZATION` | `false` | `src/lib/piiSanitizer.ts` | Scan LLM responses for leaked PII before returning to client. | +| `PII_RESPONSE_SANITIZATION_MODE` | `redact` | `src/lib/piiSanitizer.ts` | `redact` = mask PII, `warn` = log only, `block` = drop entire response. | + +### Scenarios + +| Scenario | Configuration | +| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| **Enterprise compliance** | `INPUT_SANITIZER_ENABLED=true`, `INPUT_SANITIZER_MODE=block`, `PII_REDACTION_ENABLED=true`, `PII_RESPONSE_SANITIZATION=true` | +| **Monitoring only** | `INPUT_SANITIZER_ENABLED=true`, `INPUT_SANITIZER_MODE=warn` — logs but never blocks | +| **Personal use** | Leave all disabled — zero overhead | + +--- + +## 6. Tool & Routing Policies + +| Variable | Default | Source File | Description | +| ----------------------------------- | ---------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | +| `TOOL_POLICY_MODE` | `disabled` | `src/lib/toolPolicy.ts` | Controls LLM tool/function-calling access. `allowlist` = only listed tools, `denylist` = all except listed, `disabled` = no restrictions. | +| `OMNIROUTE_PAYLOAD_RULES_PATH` | `./config/payloadRules.json` | `open-sse/services/payloadRules.ts` | Path to payload manipulation rules JSON file (per-model/protocol upstream tweaks). | +| `OMNIROUTE_PAYLOAD_RULES_RELOAD_MS` | `5000` | `open-sse/services/payloadRules.ts` | Reload interval (ms) for hot-reloading the payload rules file. Minimum `1000`. | + +--- + +## 7. URLs & Cloud Sync + +| Variable | Default | Source File | Description | +| --------------------------------------- | --------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `BASE_URL` | `http://localhost:20128` | `src/lib/cloudSync.ts` | Server-side URL for internal sync jobs to call `/api/sync/cloud`. | +| `CLOUD_URL` | _(empty)_ | `src/lib/cloudSync.ts` | Cloud relay endpoint URL (premium feature). | +| `CLOUD_SYNC_TIMEOUT_MS` | `12000` | `src/lib/cloudSync.ts` | HTTP timeout for cloud sync requests. | +| `NEXT_PUBLIC_BASE_URL` | `http://localhost:20128` | OAuth, Dashboard, sync | Public-facing URL for OAuth redirect_uri, Dashboard links. **Must match your public URL behind reverse proxy.** | +| `NEXT_PUBLIC_CLOUD_URL` | _(empty)_ | Client-side | Client-side mirror of `CLOUD_URL`. | +| `NEXT_PUBLIC_APP_URL` | _(unset)_ | `src/shared/services/cloudSyncScheduler.ts` | Legacy fallback for `NEXT_PUBLIC_BASE_URL`. | +| `OMNIROUTE_PUBLIC_BASE_URL` | _(unset)_ | `open-sse/executors/chatgpt-web.ts` | Browser-facing OmniRoute origin used for image URLs in API responses (e.g., `/v1/chatgpt-web/image/<id>`). Set this when OpenWebUI or another relay reaches OmniRoute by an internal URL but the user's browser must fetch images from a LAN, tunnel, or public origin. Do **not** include `/v1`. | +| `OMNIROUTE_CGPT_WEB_IMAGE_TIMEOUT_MS` | `180000` (3 min) | `open-sse/executors/chatgpt-web.ts` | Max wait time for an async chatgpt-web image to land via the celsius WebSocket. Increase during upstream queue-deep windows. | +| `OMNIROUTE_CGPT_WEB_IMAGE_CACHE_MAX_MB` | `256` | `open-sse/services/chatgptImageCache.ts` | Total in-memory byte budget (MB) for the chatgpt-web image cache serving `/v1/chatgpt-web/image/<id>`. Lower on memory-constrained hosts; raise if image generation is heavy and clients race the 30-minute TTL. | +| `KIE_CALLBACK_URL` | _(unset)_ | `open-sse/utils/kieTask.ts` | Public callback URL for asynchronous kie.ai jobs. Highest-priority override before `OMNIROUTE_KIE_CALLBACK_URL` and `OMNIROUTE_PUBLIC_URL`. | +| `OMNIROUTE_KIE_CALLBACK_URL` | _(unset)_ | `open-sse/utils/kieTask.ts` | Alternate spelling of `KIE_CALLBACK_URL`. Falls back when the primary variable is unset. | +| `OMNIROUTE_PUBLIC_URL` | _(unset)_ | `open-sse/utils/kieTask.ts` | Public origin used to compose async callback URLs. Lowest-priority fallback for kie.ai callbacks; also used as a generic public URL for other relays. | +| `OMNIROUTE_CROF_USAGE_URL` | `https://crof.ai/usage_api/` | `open-sse/services/usage.ts` | CrofAI quota lookup endpoint used by the Usage page. Override for relays / test fixtures. | +| `OMNIROUTE_GEMINI_CLI_USAGE_URL` | `https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist` | `open-sse/services/usage.ts` | Gemini CLI quota lookup endpoint. Override for relays / test fixtures. | +| `OMNIROUTE_CODEWHISPERER_BASE_URL` | `https://codewhisperer.us-east-1.amazonaws.com` | `open-sse/services/usage.ts` | CodeWhisperer (AWS Kiro) usage limits endpoint. Override for relays / test fixtures. | + +> [!IMPORTANT] +> When deploying behind a reverse proxy (nginx, Caddy), `NEXT_PUBLIC_BASE_URL` **must** be set to your public URL (e.g., `https://omniroute.example.com`). Without this, OAuth callbacks will fail because the redirect_uri won't match. + +--- + +## 8. Outbound Proxy + +Route upstream LLM provider calls through an HTTP or SOCKS5 proxy for egress control, geo-routing, or IP masking. + +| Variable | Default | Source File | Description | +| --------------------------------- | --------- | -------------------- | ----------------------------------------------------------------------------------- | +| `ENABLE_SOCKS5_PROXY` | `true` | `open-sse/executors` | Enable SOCKS5 proxy agent for upstream calls. | +| `NEXT_PUBLIC_ENABLE_SOCKS5_PROXY` | `true` | Client-side | Client-side awareness of SOCKS5 availability. | +| `HTTP_PROXY` | _(unset)_ | Node.js standard | HTTP proxy for upstream calls. | +| `HTTPS_PROXY` | _(unset)_ | Node.js standard | HTTPS proxy for upstream calls. | +| `ALL_PROXY` | _(unset)_ | Node.js standard | Universal proxy (supports `socks5://`). | +| `NO_PROXY` | _(unset)_ | Node.js standard | Comma-separated hostnames/IPs to bypass the proxy. | +| `ENABLE_TLS_FINGERPRINT` | `false` | `open-sse/executors` | Spoof TLS fingerprint using wreq-js (mimics Chrome 124). Counters JA3/JA4 blocking. | + +### Scenarios + +| Scenario | Configuration | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- | +| **SOCKS5 through SSH tunnel** | `ALL_PROXY=socks5://127.0.0.1:7890`, `ENABLE_SOCKS5_PROXY=true` | +| **Corporate HTTP proxy** | `HTTP_PROXY=http://proxy.corp.com:3128`, `HTTPS_PROXY=http://proxy.corp.com:3128`, `NO_PROXY=localhost,internal.corp.com` | +| **Anti-fingerprint** | `ENABLE_TLS_FINGERPRINT=true` — requires `wreq-js` (included) | + +--- + +## 9. CLI Tool Integration + +Controls how OmniRoute discovers and launches CLI sidecars (Claude Code, Codex, etc.). + +| Variable | Default | Source File | Description | +| ------------------------- | ---------- | ----------------------------------- | ---------------------------------------------------------------------------------- | +| `CLI_MODE` | `auto` | `src/shared/services/cliRuntime.ts` | `auto` = search system PATH; `manual` = use explicit paths only. | +| `CLI_EXTRA_PATHS` | _(unset)_ | `src/shared/services/cliRuntime.ts` | Additional PATH entries for CLI binary discovery (colon-separated). | +| `CLI_CONFIG_HOME` | _(unset)_ | `src/shared/services/cliRuntime.ts` | Override home directory for reading CLI configs (`~/.claude`, `~/.codex`). | +| `CLI_ALLOW_CONFIG_WRITES` | `false` | `src/shared/services/cliRuntime.ts` | Allow OmniRoute to write CLI config files (token refresh, session data). | +| `CLI_CLAUDE_BIN` | `claude` | `src/shared/services/cliRuntime.ts` | Custom path to Claude CLI binary. | +| `CLI_CODEX_BIN` | `codex` | `src/shared/services/cliRuntime.ts` | Custom path to Codex CLI binary. | +| `CLI_DROID_BIN` | `droid` | `src/shared/services/cliRuntime.ts` | Custom path to Droid CLI binary. | +| `CLI_OPENCLAW_BIN` | `openclaw` | `src/shared/services/cliRuntime.ts` | Custom path to OpenClaw CLI binary. | +| `CLI_CURSOR_BIN` | `agent` | `src/shared/services/cliRuntime.ts` | Custom path to Cursor agent binary. | +| `CLI_CLINE_BIN` | `cline` | `src/shared/services/cliRuntime.ts` | Custom path to Cline CLI binary. | +| `CLI_CONTINUE_BIN` | `cn` | `src/shared/services/cliRuntime.ts` | Custom path to Continue CLI binary. | +| `CLI_QODER_BIN` | `qoder` | `src/shared/services/cliRuntime.ts` | Custom path to Qoder CLI binary. | +| `CLI_QWEN_BIN` | `qwen` | `src/shared/services/cliRuntime.ts` | Custom path to the Qwen Code CLI binary. | +| `CLI_DEVIN_BIN` | `devin` | `open-sse/executors/devin-cli.ts` | Custom path to the Devin CLI binary (v3.8.0). Used by the Windsurf/Devin executor. | + +### Docker Example + +```bash +# Mount host binaries into the container and tell OmniRoute where they are: +CLI_EXTRA_PATHS=/host-cli/bin +CLI_CONFIG_HOME=/root +CLI_ALLOW_CONFIG_WRITES=true +CLI_CLAUDE_BIN=/host-cli/bin/claude +``` + +--- + +## 10. Internal Agent & MCP Integrations + +| Variable | Default | Source File | Description | +| ----------------------------------------------- | ----------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | +| `OMNIROUTE_BASE_URL` | auto-detect | `open-sse/mcp-server/server.ts` | Explicit URL for MCP/A2A tools to reach OmniRoute. Overrides localhost auto-detection. | +| `OMNIROUTE_API_KEY` | _(unset)_ | MCP/A2A modules | API key for internal MCP tool and A2A skill calls. | +| `OMNIROUTE_API_KEY_ID` | _(unset)_ | `open-sse/mcp-server/audit.ts` | Key ID for MCP audit log attribution. | +| `ROUTER_API_KEY` | _(unset)_ | Legacy | Legacy alias for `OMNIROUTE_API_KEY`. | +| `OMNIROUTE_MCP_ENFORCE_SCOPES` | `false` | `open-sse/mcp-server/server.ts` | Enforce scope-based access control on MCP tool calls. | +| `OMNIROUTE_MCP_SCOPES` | _(all)_ | `open-sse/mcp-server/server.ts` | Comma-separated scopes: `admin`, `combos`, `health`, `models`, `routing`, `budget`, `metrics`, `pricing`, `memory`, `skills`. | +| `OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS` | enabled | `open-sse/mcp-server/descriptionCompressor.ts` | Compress MCP tool descriptions before serializing the manifest. Disable values: `0`, `false`, `off`. | +| `OMNIROUTE_MCP_DESCRIPTION_COMPRESSION` | `rtk` | `open-sse/mcp-server/descriptionCompressor.ts` | Compression algorithm/profile. Disable values: `0`, `false`, `off`. | +| `MODEL_SYNC_INTERVAL_HOURS` | `24` | `src/shared/services/modelSyncScheduler.ts` | Model catalog sync interval in hours. | +| `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES` | `70` | `src/server-init.ts` | Provider rate-limit and quota polling interval. | +| `OMNIROUTE_DISABLE_BACKGROUND_SERVICES` | `false` | `src/instrumentation-node.ts` | Disable all background services (sync, pricing, model refresh). Useful for CI/test. | +| `OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS` | _(unset)_ | `src/lib/config/runtimeSettings.ts` | Force background tasks on under automated test detection. Set `1` to override the test heuristic. | +| `OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS` | `600000` | `src/lib/jobs/budgetResetJob.ts` | Budget reset check cadence (ms). Floor `10000`. | +| `OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS` | `1800000` | `src/lib/jobs/reasoningCacheCleanupJob.ts` | Reasoning cache cleanup cadence (ms). Floor `60000`. | +| `OMNIROUTE_CONFIG_HOT_RELOAD_MS` | `5000` | `src/lib/config/hotReload.ts` | Polling interval (ms) for config hot-reload. Lower than `1000` is rejected. | +| `OMNIROUTE_DISABLE_REDIS_AUTH_CACHE` | _(enabled)_ | `src/lib/db/apiKeys.ts` | Set `1` to bypass the Redis-backed API-key auth cache (forces DB reads). | +| `OMNIROUTE_RTK_TRUST_PROJECT_FILTERS` | `0` | `open-sse/services/compression/engines/rtk/filterLoader.ts` | Trust user-managed RTK project filter rules without strict signature checks. | +| `OMNIROUTE_BOOTSTRAPPED` | `false` | `src/app/(dashboard)/dashboard/page.tsx` | Set `true` by bootstrap script after initial setup. Controls setup wizard visibility. | +| `OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE` | `0` | `open-sse/executors/antigravity.ts` | Escape hatch: allow request body to override the Antigravity project field. | +| `ANTIGRAVITY_CREDITS` | _(unset)_ | `open-sse/services/antigravityCredits.ts` | Override Antigravity's advertised remaining credits (testing / forced values). | + +### OAuth CLI Bridge (Internal) + +| Variable | Default | Source File | Description | +| ------------------- | ----------- | ------------------------------- | ----------------------------------------- | +| `OMNIROUTE_SERVER` | auto-detect | `src/lib/oauth/config/index.ts` | Server URL for CLI↔OmniRoute auth bridge. | +| `OMNIROUTE_TOKEN` | _(unset)_ | `src/lib/oauth/config/index.ts` | Auth token for CLI bridge. | +| `OMNIROUTE_USER_ID` | `cli` | `src/lib/oauth/config/index.ts` | User ID for CLI bridge sessions. | +| `SERVER_URL` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_SERVER`. | +| `CLI_TOKEN` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_TOKEN`. | +| `CLI_USER_ID` | _(unset)_ | `src/lib/oauth/config/index.ts` | Legacy alias for `OMNIROUTE_USER_ID`. | + +--- + +## 11. OAuth Provider Credentials + +Built-in credentials for **localhost development**. For remote deployments, register your own at each provider's developer console. + +| Variable | Provider | Notes | +| --------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CLAUDE_OAUTH_CLIENT_ID` | Claude Code (Anthropic) | Public client — no secret needed. | +| `CLAUDE_CODE_REDIRECT_URI` | Claude Code | Override redirect URI. Default: `https://platform.claude.com/oauth/code/callback` | +| `CODEX_OAUTH_CLIENT_ID` | Codex / OpenAI | Public client. | +| `GEMINI_OAUTH_CLIENT_ID` | Gemini (Google) | Requires matching `_SECRET`. | +| `GEMINI_OAUTH_CLIENT_SECRET` | Gemini (Google) | — | +| `GEMINI_CLI_OAUTH_CLIENT_ID` | Gemini CLI | Usually same as Gemini. | +| `GEMINI_CLI_OAUTH_CLIENT_SECRET` | Gemini CLI | — | +| `QWEN_OAUTH_CLIENT_ID` | Qwen (Alibaba) | Public client. | +| `KIMI_CODING_OAUTH_CLIENT_ID` | Kimi Coding (Moonshot) | Public client. | +| `ANTIGRAVITY_OAUTH_CLIENT_ID` | Antigravity (Google) | Requires matching `_SECRET`. | +| `ANTIGRAVITY_OAUTH_CLIENT_SECRET` | Antigravity (Google) | — | +| `GITHUB_OAUTH_CLIENT_ID` | GitHub Copilot | Public client. | +| `WINDSURF_FIREBASE_API_KEY` | Windsurf / Devin (v3.8) | Public Firebase Web API key used by Windsurf's Secure Token Service to refresh short-lived browser-flow tokens. Client-side credential (not a secret). Long-lived import tokens skip this entirely. Source: extracted from Devin CLI binary. | +| `WINDSURF_API_KEY` | Windsurf / Devin (v3.8) | API key fallback used by `open-sse/executors/devin-cli.ts` when no per-connection credential is available. Optional. | +| `CLI_DEVIN_BIN` | Devin CLI (v3.8) | Custom path to the Devin CLI binary (`devin`). Resolved by `open-sse/executors/devin-cli.ts`. | +| `GITLAB_DUO_OAUTH_CLIENT_ID` | GitLab Duo (v3.8) | OAuth client ID for GitLab Duo. Register an app at `https://gitlab.com/-/profile/applications` with redirect URI `<NEXT_PUBLIC_BASE_URL>/callback` and scopes `api, read_user, openid, profile, email`. Falls back to `GITLAB_OAUTH_CLIENT_ID`. | +| `GITLAB_DUO_OAUTH_CLIENT_SECRET` | GitLab Duo (v3.8) | OAuth client secret for GitLab Duo. Optional — PKCE flow does not require a secret. Falls back to `GITLAB_OAUTH_CLIENT_SECRET`. | +| `GITLAB_DUO_BASE_URL` | GitLab Duo (v3.8) | Override GitLab base URL (self-hosted GitLab). Defaults to `https://gitlab.com`. Falls back to `GITLAB_BASE_URL`. | +| `GITLAB_BASE_URL` | GitLab Duo (v3.8) | Legacy fallback for `GITLAB_DUO_BASE_URL`. Used when the `_DUO_` variant is unset. | +| `GITLAB_OAUTH_CLIENT_ID` | GitLab Duo (v3.8) | Legacy fallback for `GITLAB_DUO_OAUTH_CLIENT_ID` consumed by `src/lib/oauth/constants/oauth.ts`. | +| `GITLAB_OAUTH_CLIENT_SECRET` | GitLab Duo (v3.8) | Legacy fallback for `GITLAB_DUO_OAUTH_CLIENT_SECRET` consumed by `src/lib/oauth/constants/oauth.ts`. | +| `QODER_OAUTH_CLIENT_SECRET` | Qoder | — | +| `QODER_OAUTH_AUTHORIZE_URL` | Qoder | Set to enable Qoder OAuth. | +| `QODER_OAUTH_TOKEN_URL` | Qoder | — | +| `QODER_OAUTH_USERINFO_URL` | Qoder | — | +| `QODER_OAUTH_CLIENT_ID` | Qoder | — | +| `QODER_PERSONAL_ACCESS_TOKEN` | Qoder | Direct API key fallback (bypasses OAuth). | +| `QODER_CLI_WORKSPACE` | Qoder | Workspace ID for Qoder CLI. | +| `OMNIROUTE_QODER_WORKSPACE` | Qoder | Alias for `QODER_CLI_WORKSPACE`. | + +> [!WARNING] +> **Google OAuth** (Antigravity, Gemini CLI) credentials **only work on localhost**. For remote servers: +> +> 1. Go to [Google Cloud Console → Credentials](https://console.cloud.google.com/apis/credentials) +> 2. Create an OAuth 2.0 Client ID (type: "Web application") +> 3. Add your server URL as Authorized redirect URI +> 4. Replace the credential values in `.env`. + +--- + +## 12. Provider User-Agent Overrides + +Override the `User-Agent` header sent to each upstream provider. This is dynamically resolved at runtime by the executor base class: + +``` +process.env[`${PROVIDER_ID}_USER_AGENT`] +``` + +> **Source:** `open-sse/executors/base.ts` → `buildHeaders()` + +| Variable | Default Value | When to Update | +| ------------------------ | --------------------------------------------- | ------------------------------------------------------------- | +| `CLAUDE_USER_AGENT` | `claude-cli/2.1.137 (external, cli)` | When Anthropic releases a new CLI version | +| `CODEX_USER_AGENT` | `codex-cli/0.130.0 (Windows 10.0.26200; x64)` | When OpenAI updates the Codex CLI | +| `CODEX_CLIENT_VERSION` | `0.130.0` | Override Codex client version independently of full UA string | +| `GITHUB_USER_AGENT` | `GitHubCopilotChat/0.45.1` | When GitHub Copilot Chat updates | +| `ANTIGRAVITY_USER_AGENT` | `antigravity/1.23.2 darwin/arm64` | When Antigravity IDE updates | +| `KIRO_USER_AGENT` | `AWS-SDK-JS/3.0.0 kiro-ide/1.0.0` | When Kiro IDE updates | +| `QODER_USER_AGENT` | `Qoder-Cli` | When Qoder CLI updates | +| `QWEN_USER_AGENT` | `QwenCode/0.15.9 (linux; x64)` | When Qwen Code updates | +| `CURSOR_USER_AGENT` | `Cursor/3.3` | When Cursor updates | +| `GEMINI_CLI_USER_AGENT` | `google-api-nodejs-client/10.3.0` | When Google API client updates | + +> [!TIP] +> You can add User-Agent overrides for **any** provider using the pattern `{PROVIDER_ID}_USER_AGENT`. The executor dynamically constructs the env var name. + +--- + +## 13. CLI Fingerprint Compatibility + +When enabled, OmniRoute reorders HTTP headers and JSON body fields to match the exact signature of official CLI tools. This reduces the risk of account flagging while preserving your proxy IP. + +**Source:** `open-sse/config/cliFingerprints.ts`, `open-sse/executors/base.ts` + +### Per-Provider + +| Variable | Activation | Effect | +| ------------------------ | ---------- | --------------------------------------- | +| `CLI_COMPAT_CODEX` | `=1` | Mimics Codex CLI request signature | +| `CLI_COMPAT_CLAUDE` | `=1` | Mimics Claude Code request signature | +| `CLI_COMPAT_GITHUB` | `=1` | Mimics GitHub Copilot request signature | +| `CLI_COMPAT_ANTIGRAVITY` | `=1` | Mimics Antigravity request signature | +| `CLI_COMPAT_CURSOR` | `=1` | Mimics Cursor request signature | +| `CLI_COMPAT_KIMI_CODING` | `=1` | Mimics Kimi Coding request signature | +| `CLI_COMPAT_KILOCODE` | `=1` | Mimics Kilo Code request signature | +| `CLI_COMPAT_CLINE` | `=1` | Mimics Cline request signature | +| `CLI_COMPAT_QWEN` | `=1` | Mimics Qwen Code request signature | + +### Global + +| Variable | Activation | Effect | +| ---------------- | ---------- | --------------------------------------------------------------- | +| `CLI_COMPAT_ALL` | `=1` | Enable fingerprint compatibility for **all** providers at once. | + +### Kimi Coding CLI identity overrides + +| Variable | Default | Source File | Description | +| ----------------------- | -------------------- | ---------------------------------------- | ------------------------------------------------------------ | +| `KIMI_CLI_VERSION` | `1.36.0` | `src/lib/oauth/providers/kimi-coding.ts` | Override the Kimi CLI version sent during OAuth/API calls. | +| `KIMI_CODING_DEVICE_ID` | _(captured default)_ | `src/lib/oauth/providers/kimi-coding.ts` | Override the captured Kimi device ID used in client headers. | + +> [!NOTE] +> This feature works alongside the User-Agent overrides (§12). The fingerprint system handles header ordering and body field ordering, while User-Agent overrides handle the specific UA string. Both can be enabled independently. + +--- + +## 14. API Key Providers + +API keys for providers that use direct authentication. **Preferred setup:** Dashboard → Providers → Add API Key. + +Setting via environment variables is an alternative for Docker or headless deployments. + +Recognized pattern: `{PROVIDER_ID}_API_KEY` + +| Variable | Provider | +| ------------------ | ---------- | +| `DEEPSEEK_API_KEY` | DeepSeek | +| `NVIDIA_API_KEY` | NVIDIA NIM | + +> [!NOTE] +> Static `${PROVIDER}_API_KEY` entries for Groq, xAI, Mistral, Perplexity, Together AI, Fireworks, Cerebras, Cohere, Nebius, and Qianfan were removed in v3.8.0 because the runtime no longer reads them — those providers rely exclusively on Dashboard / `data/provider-credentials.json` / the encrypted DB. See the _Audit: Removed / Dead Variables_ section at the bottom of this document for the migration path. + +> [!TIP] +> Keys set via the Dashboard are stored encrypted in SQLite and take precedence over environment variables. + +--- + +## 15. Timeout Settings + +All values are in **milliseconds**. Centralized resolution in `src/shared/utils/runtimeTimeouts.ts`. + +### Timeout Hierarchy + +``` +REQUEST_TIMEOUT_MS (global override) +├─→ FETCH_TIMEOUT_MS (upstream provider calls, default: 600000) +│ ├─→ FETCH_HEADERS_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) +│ ├─→ FETCH_BODY_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) +│ ├─→ TLS_CLIENT_TIMEOUT_MS (inherits from FETCH_TIMEOUT_MS) +│ ├── FETCH_CONNECT_TIMEOUT_MS (independent, default: 30000) +│ └── FETCH_KEEPALIVE_TIMEOUT_MS (independent, default: 4000) +├─→ STREAM_IDLE_TIMEOUT_MS (inherits from REQUEST_TIMEOUT_MS, default: 600000) +└─→ API_BRIDGE_PROXY_TIMEOUT_MS (inherits from REQUEST_TIMEOUT_MS, default: 30000) + ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (derived, default: 300000) + ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (default: 60000) + ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (default: 5000) + └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (default: 0 = disabled) +``` + +| Variable | Default | Description | +| ---------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------- | +| `REQUEST_TIMEOUT_MS` | _(unset)_ | Global shortcut — overrides both `FETCH_TIMEOUT_MS` and `STREAM_IDLE_TIMEOUT_MS` defaults. | +| `FETCH_TIMEOUT_MS` | `600000` | Total HTTP request timeout for upstream provider calls. | +| `STREAM_IDLE_TIMEOUT_MS` | `600000` | Max silence between SSE chunks before aborting. Extended-thinking models rarely pause >90s. | +| `FETCH_HEADERS_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | Time to receive response headers. | +| `FETCH_BODY_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | Time to receive the full response body. | +| `FETCH_CONNECT_TIMEOUT_MS` | `30000` | TCP connection establishment timeout. | +| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Keep-alive socket idle timeout. | +| `TLS_CLIENT_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | TLS fingerprint proxy (wreq-js) timeout. | +| `API_BRIDGE_PROXY_TIMEOUT_MS` | `30000` | Proxy hop timeout for `/v1` bridge requests. | +| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `300000` | Overall server request timeout for the bridge. | +| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | Time to send response headers via the bridge. | +| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | Bridge keep-alive idle timeout. | +| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | Raw socket timeout (0 = disabled). | +| `SHUTDOWN_TIMEOUT_MS` | `30000` | Grace period on SIGTERM/SIGINT before force-exit. | +| `OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS` | `120000` | Fallback used by `src/shared/utils/fetchTimeout.ts` when `FETCH_TIMEOUT_MS` is unset. | +| `OMNIROUTE_CHATGPT_TLS_TIMEOUT_MS` | `60000` | Wire-level timeout for the bogdanfinn/tls-client koffi binding (`chatgptTlsClient.ts`). | +| `OMNIROUTE_CHATGPT_TLS_GRACE_MS` | `10000` | JS-side grace added on top of the wire timeout when the native binding is wedged. | + +### Circuit Breaker Thresholds + +Provider-level circuit breaker tuning. Defaults reflect the scaled values used since v3.6 for 500+ connections. + +| Variable | Default | Source File | Description | +| --------------------------------------------- | ------- | ------------------------------ | --------------------------------------------------------------------------- | +| `OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD` | `8` | `open-sse/config/constants.ts` | Consecutive failure threshold for OAuth providers before the breaker trips. | +| `OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS` | `60000` | `open-sse/config/constants.ts` | Reset window (ms) for OAuth provider breaker. | +| `OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD` | `12` | `open-sse/config/constants.ts` | Consecutive failure threshold for API-key providers. | +| `OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS` | `30000` | `open-sse/config/constants.ts` | Reset window (ms) for API-key provider breaker. | +| `OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD` | `2` | `open-sse/config/constants.ts` | Consecutive failure threshold for local providers (Ollama, LM Studio, ...). | +| `OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS` | `15000` | `open-sse/config/constants.ts` | Reset window (ms) for local provider breaker. | + +### Scenarios + +| Scenario | Configuration | +| -------------------------------- | ------------------------------------------------------ | +| **Long-running code generation** | `REQUEST_TIMEOUT_MS=900000` (15 min) | +| **Fast-fail for production API** | `API_BRIDGE_PROXY_TIMEOUT_MS=10000` | +| **Extended thinking models** | `STREAM_IDLE_TIMEOUT_MS=300000` (5 min between chunks) | + +--- + +## 16. Logging + +The logging system writes to both stdout and rotated log files. All configuration is read by `src/lib/logEnv.ts`. + +| Variable | Default | Description | +| ----------------------------------------- | -------------------------- | --------------------------------------------------------------------------------- | +| `APP_LOG_LEVEL` | `info` | Minimum log level: `debug`, `info`, `warn`, `error`. | +| `APP_LOG_FORMAT` | `text` | Output format: `text` (human-readable) or `json` (structured). | +| `APP_LOG_TO_FILE` | `true` | Write logs to file alongside stdout. | +| `APP_LOG_FILE_PATH` | `logs/application/app.log` | Log file path (relative to project root or `DATA_DIR`). | +| `APP_LOG_MAX_FILE_SIZE` | `50M` | Max file size before rotation. Accepts: `50M`, `1G`, `512K`, or plain bytes. | +| `APP_LOG_RETENTION_DAYS` | `7` | Days to keep rotated application log files. | +| `APP_LOG_MAX_FILES` | `20` | Maximum rotated log file backups. | +| `CALL_LOG_RETENTION_DAYS` | `7` | Days to keep request/call log entries in the database. | +| `CALL_LOG_MAX_ENTRIES` | `10000` | Max call log entries in the in-memory buffer. | +| `CALL_LOGS_TABLE_MAX_ROWS` | `100000` | Max rows in the `call_logs` SQLite table before pruning. | +| `CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS` | `true` | Store stream chunks in pipeline artifacts when `call_log_pipeline_enabled=true`. | +| `CALL_LOG_PIPELINE_MAX_SIZE_KB` | `512` | Max pipeline call log artifact size in KB when `call_log_pipeline_enabled=true`. | +| `PROXY_LOGS_TABLE_MAX_ROWS` | `100000` | Max rows in the `proxy_logs` SQLite table before pruning. | +| `APP_LOG_ROTATION_CHECK_INTERVAL_MS` | `60000` (1 min) | How often `src/lib/logRotation.ts` re-checks the active log file size. | +| `CHAT_LOG_TEXT_LIMIT` | `65536` | Max string length retained in chat log artifacts (default 64 KB). | +| `CHAT_LOG_ARRAY_TAIL_ITEMS` | `24` | Number of array items retained from the tail when truncating chat log payloads. | +| `CHAT_LOG_MAX_DEPTH` | `6` | Max nesting depth before chat log payloads are truncated. | +| `CHAT_LOG_MAX_OBJECT_KEYS` | `80` | Max object keys retained in chat log payloads (0 = unlimited). | +| `CHAT_DEBUG_FILE` | `false` | When true, `serializeArtifactForStorage` skips size-based truncation. Debug only. | + +--- + +## 17. Memory Optimization + +| Variable | Default | Description | +| -------------------------- | ------------------------------- | ---------------------------------------------------------------------- | +| `OMNIROUTE_MEMORY_MB` | `256` (Docker) / system default | V8 heap limit. Sets `--max-old-space-size`. | +| `PROMPT_CACHE_MAX_SIZE` | `50` | Max cached system prompt entries. | +| `PROMPT_CACHE_MAX_BYTES` | `2097152` (2 MB) | Max total prompt cache size. | +| `PROMPT_CACHE_TTL_MS` | `300000` (5 min) | Prompt cache entry TTL. | +| `SEMANTIC_CACHE_MAX_SIZE` | `100` | Max cached temperature=0 responses. | +| `SEMANTIC_CACHE_MAX_BYTES` | `4194304` (4 MB) | Max total semantic cache size. | +| `SEMANTIC_CACHE_TTL_MS` | `1800000` (30 min) | Semantic cache entry TTL. | +| `STREAM_HISTORY_MAX` | `50` | Max recent stream events in the Dashboard live view buffer. | +| `CONTEXT_LENGTH_DEFAULT` | `128000` | Global fallback max context length for models without explicit config. | +| `USAGE_TOKEN_BUFFER` | `100` | Extra token headroom reserved when tracking usage quotas. | + +### Compression + +| Variable | Default | Description | +| ------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- | +| `OMNIROUTE_RTK_TRUST_PROJECT_FILTERS` | unset | Trust project `.rtk/filters.json` without a `.rtk/trust.json` hash. Use only in controlled local development. | + +### Low-RAM Docker Example + +```bash +OMNIROUTE_MEMORY_MB=128 +PROMPT_CACHE_MAX_SIZE=20 +PROMPT_CACHE_MAX_BYTES=524288 # 512 KB +SEMANTIC_CACHE_MAX_SIZE=25 +SEMANTIC_CACHE_MAX_BYTES=1048576 # 1 MB +STREAM_HISTORY_MAX=10 +``` + +--- + +## 18. Pricing Sync + +Automatic model pricing data synchronization from external sources. + +| Variable | Default | Source File | Description | +| ----------------------- | ------------- | ------------------------ | ----------------------------- | +| `PRICING_SYNC_ENABLED` | `false` | `src/lib/pricingSync.ts` | Opt-in periodic pricing sync. | +| `PRICING_SYNC_INTERVAL` | `86400` (24h) | `src/lib/pricingSync.ts` | Sync interval in seconds. | +| `PRICING_SYNC_SOURCES` | `litellm` | `src/lib/pricingSync.ts` | Comma-separated data sources. | + +--- + +## 19. Model Sync (Dev) + +| Variable | Default | Source File | Description | +| -------------------------- | ------------- | -------------------------- | -------------------------------------------------------- | +| `MODELS_DEV_SYNC_INTERVAL` | `86400` (24h) | `src/lib/modelsDevSync.ts` | Development-time model catalog sync interval in seconds. | + +--- + +## 20. Provider-Specific Settings + +| Variable | Default | Source File | Description | +| ----------------------------------------- | ------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | +| `OPENROUTER_CATALOG_TTL_MS` | `86400000` (24h) | `src/lib/catalog/openrouterCatalog.ts` | OpenRouter model catalog cache TTL. | +| `NANOBANANA_POLL_TIMEOUT_MS` | `120000` | `open-sse/handlers/imageGeneration.ts` | Max wait for NanoBanana image generation jobs. | +| `NANOBANANA_POLL_INTERVAL_MS` | `2500` | `open-sse/handlers/imageGeneration.ts` | NanoBanana job polling frequency. | +| `AWS_REGION` | _(unset)_ | `src/lib/providers/validation.ts`, `open-sse/handlers/audioSpeech.ts` | Region used to construct AWS Bedrock endpoints (Kiro, audio). | +| `AWS_DEFAULT_REGION` | _(unset)_ | `src/lib/providers/validation.ts`, `open-sse/handlers/audioSpeech.ts` | Fallback when `AWS_REGION` is not set. | +| `CLOUDFLARE_ACCOUNT_ID` | _(unset)_ | `open-sse/executors/cloudflare-ai.ts` | Account ID for Cloudflare Workers AI. | +| `CLOUDFLARED_BIN` | auto-detect | `src/lib/cloudflaredTunnel.ts` | Custom path to `cloudflared` binary. | +| `SEARCH_CACHE_TTL_MS` | `300000` (5 min) | `open-sse/services/searchCache.ts` | TTL for search API (Perplexity, Brave, etc.) response caching. | +| `ALLOW_MULTI_CONNECTIONS_PER_COMPAT_NODE` | `false` | `src/app/api/providers/route.ts` | Allow multiple simultaneous connections per OpenAI-compatible provider. | +| `ENABLE_CC_COMPATIBLE_PROVIDER` | `false` | `src/shared/utils/featureFlags.ts` | Reveal the experimental CC-compatible provider UI for Claude Code-only relays. | +| `CLIPROXYAPI_HOST` | `127.0.0.1` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI bridge host (legacy integration). | +| `CLIPROXYAPI_PORT` | `5544` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI bridge port. | +| `CLIPROXYAPI_CONFIG_DIR` | `~/.cli-proxy-api` | `src/lib/versionManager/processManager.ts` | CLIProxyAPI config directory. | +| `LOCAL_HOSTNAMES` | _(empty)_ | `open-sse/config/providerRegistry.ts` | Comma-separated additional hostnames treated as "local" (Docker service names, etc.). | + +`ENABLE_CC_COMPATIBLE_PROVIDER` is only for third-party relays that accept Claude Code clients +exclusively. OmniRoute rewrites requests so those relays accept them. If you only want to use +Claude Code CLI, or you are not sure what these relays are, keep this disabled and add a regular +Anthropic-compatible provider instead. + +--- + +## 21. Proxy Health + +| Variable | Default | Source File | Description | +| ---------------------------- | ---------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `PROXY_FAST_FAIL_TIMEOUT_MS` | `2000` | `src/lib/proxyHealth.ts` | Fast-fail health check timeout. | +| `PROXY_HEALTH_CACHE_TTL_MS` | `30000` | `src/lib/proxyHealth.ts` | Health check result cache TTL. | +| `RATE_LIMIT_MAX_WAIT_MS` | `120000` (2 min) | `open-sse/services/rateLimitManager.ts` | Max time to wait on a 429 before failing the request. | +| `RATE_LIMIT_AUTO_ENABLE` | _(unset)_ | `open-sse/services/rateLimitManager.ts` | Force the auto-enable rate limit safety net on/off regardless of the persisted Dashboard setting. Accepts `true`/`1`/`on` to force on, `false`/`0`/`off` to force off. | +| `HEALTHCHECK_STAGGER_MS` | `3000` | `src/lib/tokenHealthCheck.ts` | Stagger interval (ms) between provider token healthchecks at startup. | +| `REQUEST_RETRY` | `2` | `src/sse/services/cooldownAwareRetry.ts` | Number of automatic retries on model-scoped cooldown responses before returning error to client. | +| `MAX_RETRY_INTERVAL_SEC` | `30` | `src/sse/services/cooldownAwareRetry.ts` | Max backoff interval (seconds) between cooldown retries. Capped by this value regardless of upstream `Retry-After`. | + +--- + +## 22. Debugging + +> [!CAUTION] +> These variables produce **verbose output** and may leak sensitive data. **Never enable in production.** + +| Variable | Default | Source File | Description | +| -------------------------------- | ------------------- | ------------------------------------------ | --------------------------------------------------------------------------------- | +| `CURSOR_DEBUG` | _(unset)_ | `open-sse/executors/cursor.ts` | Set `1` to enable verbose Cursor executor logs (decoded SSE chunks, etc.). | +| `CURSOR_STREAM_DEBUG` | _(unset)_ | `open-sse/executors/cursor.ts` | Backward-compatible alias of `CURSOR_DEBUG`. | +| `CURSOR_DUMP_FILE` | _(unset)_ | `open-sse/executors/cursor.ts` | Optional file path that receives raw decoded Cursor chunks when `CURSOR_DEBUG=1`. | +| `CURSOR_STREAM_TIMEOUT_MS` | `300000` | `open-sse/executors/cursor.ts` | Stream idle timeout (ms) for the Cursor executor. | +| `CURSOR_STATE_DB_PATH` | _(probed)_ | `open-sse/utils/cursorVersionDetector.ts` | Override the Cursor state DB lookup used for version detection. | +| `CURSOR_TOKEN` | _(unset)_ | `scripts/cursor-tap.cjs` | Direct Cursor bearer token used by developer tooling. | +| `OMNIROUTE_LOG_REQUEST_SHAPE` | enabled (`!== "0"`) | `src/app/api/v1/chat/completions/route.ts` | Log content-type/length markers for large chat payloads. Set `"0"` to silence. | +| `DEBUG_RESPONSES_SSE_TO_JSON` | _(unset)_ | `open-sse/handlers/responseTranslator.ts` | Set `true` to log Responses API SSE→JSON translation details. | +| `NEXT_PUBLIC_OMNIROUTE_E2E_MODE` | _(unset)_ | E2E test harness | Set `true` to enable E2E test mode (relaxed auth, test hooks). | + +--- + +## 23. GitHub Integration + +Allow users to report issues directly from the Dashboard. + +| Variable | Default | Source File | Description | +| --------------------- | --------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | +| `GITHUB_ISSUES_REPO` | _(unset)_ | `src/app/api/v1/issues/report/route.ts` | Repository in `owner/repo` format. | +| `GITHUB_ISSUES_TOKEN` | _(unset)_ | `src/app/api/v1/issues/report/route.ts` | GitHub Personal Access Token with `issues:write` scope. | +| `GITHUB_TOKEN` | _(unset)_ | issue triage / cloud agent helpers | Generic GitHub access token used as fallback for `GITHUB_ISSUES_TOKEN` and consumed by cloud agent helpers in `src/lib/cloudAgent/*`. | + +--- + +## Deployment Scenarios + +### Minimal Local Development + +```bash +JWT_SECRET=$(openssl rand -base64 48) +API_KEY_SECRET=$(openssl rand -hex 32) +INITIAL_PASSWORD=dev123 +PORT=20128 +NODE_ENV=development +``` + +### Docker Production + +```bash +JWT_SECRET=<generated> +API_KEY_SECRET=<generated> +INITIAL_PASSWORD=<generated> +STORAGE_ENCRYPTION_KEY=<generated> +DATA_DIR=/data +PORT=20128 +API_PORT=20129 +NODE_ENV=production +AUTH_COOKIE_SECURE=true +REQUIRE_API_KEY=true +NEXT_PUBLIC_BASE_URL=https://omniroute.example.com +BASE_URL=http://localhost:20128 +OMNIROUTE_MEMORY_MB=512 +CORS_ORIGIN=https://your-frontend.example.com +``` + +### Air-Gapped / CI + +```bash +JWT_SECRET=test-jwt-secret-for-ci +API_KEY_SECRET=test-api-key-secret-for-ci +INITIAL_PASSWORD=testpass +NODE_ENV=production +OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true +APP_LOG_TO_FILE=false +``` + +### VPS with Reverse Proxy (nginx + Cloudflare) + +```bash +JWT_SECRET=<generated> +API_KEY_SECRET=<generated> +STORAGE_ENCRYPTION_KEY=<generated> +PORT=20128 +AUTH_COOKIE_SECURE=true +REQUIRE_API_KEY=true +NEXT_PUBLIC_BASE_URL=https://omniroute.example.com +BASE_URL=http://127.0.0.1:20128 +CORS_ORIGIN=https://omniroute.example.com +ENABLE_TLS_FINGERPRINT=true +CLI_COMPAT_ALL=1 +``` + +--- + +## 24. Skills Sandbox (v3.8.0+) + +Limits and safety knobs applied when the Skills framework (`src/lib/skills/`) executes user-defined automations in a sandboxed environment. + +| Variable | Default | Source File | Description | +| --------------------------------- | --------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------ | +| `SKILLS_SANDBOX_TIMEOUT_MS` | `10000` (10 s) | `src/lib/skills/builtins.ts` | Per-execution wall-clock timeout for sandboxed skill code. Hard cap; anything longer is killed. | +| `SKILLS_EXECUTION_TIMEOUT_MS` | _(falls back to `SKILLS_SANDBOX_TIMEOUT_MS`)_ | `src/lib/skills/` | High-level skill orchestration timeout. Set higher than `SKILLS_SANDBOX_TIMEOUT_MS` to allow multi-step workflows. | +| `SKILLS_MAX_FILE_BYTES` | `1048576` (1 MB) | `src/lib/skills/builtins.ts` | Max bytes a skill may read from any single sandboxed file. | +| `SKILLS_MAX_HTTP_RESPONSE_BYTES` | `256000` (250 KB) | `src/lib/skills/builtins.ts` | Max bytes captured from any single HTTP response inside a skill. | +| `SKILLS_MAX_SANDBOX_OUTPUT_CHARS` | `100000` | `src/lib/skills/builtins.ts` | Hard cap on stdout/stderr characters returned from a sandbox invocation. | +| `SKILLS_SANDBOX_NETWORK_ENABLED` | `false` | `src/lib/skills/builtins.ts` | Set `1`/`true` to allow outbound network from inside the sandbox. Defaults to **isolated** for safety. | +| `SKILLS_ALLOWED_SANDBOX_IMAGES` | _(empty)_ | `src/lib/skills/builtins.ts` | Comma-separated allowlist of container images permitted for sandbox execution. Empty means built-in default only. | +| `SKILLS_SANDBOX_DOCKER_IMAGE` | _(built-in default)_ | `src/lib/skills/` | Container image used when spawning a Docker-backed sandbox. Override to pin a custom hardened base image. | + +> [!CAUTION] +> Enabling `SKILLS_SANDBOX_NETWORK_ENABLED=true` opens an egress path from arbitrary skill code. Pair with `OUTBOUND_SSRF_GUARD_ENABLED=true` and a strict `CORS_ORIGIN`/proxy policy in shared deployments. + +--- + +## 25. Provider Quotas, Tunnels, Backups & Misc Runtime + +Provider quota endpoints, network tunnels (Tailscale, Ngrok, MITM debug proxy), the 1Proxy egress pool, database backups and small per-feature overrides referenced by the executor layer or scripts. + +| Variable | Default | Source File | Description | +| -------------------------------- | ------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------- | +| `REDIS_URL` | `redis://localhost:6379` | `src/shared/utils/rateLimiter.ts` | Redis connection string for the rate limiter backend. | +| `ALIBABA_CODING_PLAN_HOST` | _(production host)_ | `open-sse/services/bailianQuotaFetcher.ts` | Override the host used to fetch Alibaba Bailian coding-plan quotas. | +| `ALIBABA_CODING_PLAN_QUOTA_URL` | derived from host | `open-sse/services/bailianQuotaFetcher.ts` | Full quota URL override for Alibaba Bailian. | +| `CONTEXT_RESERVE_TOKENS` | `1024` | `open-sse/services/contextManager.ts` | Tokens reserved for completion output when computing prompt budgets. | +| `MODEL_ALIAS_COMPAT_ENABLED` | enabled | `open-sse/services/model.ts` | Toggle the legacy model-alias compatibility layer used by older clients. | +| `COMMAND_CODE_CALLBACK_PORT` | _(unset)_ | `src/app/api/providers/command-code/auth/shared.ts` | Local port used for OAuth-style callbacks from the Command Code CLI helper. | +| `MITM_LOCAL_PORT` | `443` | `src/mitm/server.cjs` | Local bind port for the MITM debug proxy. | +| `MITM_DISABLE_TLS_VERIFY` | `0` | `src/mitm/server.cjs` | Set `1` to disable upstream TLS verification (development only). | +| `ONEPROXY_ENABLED` | `true` | `src/lib/oneproxySync.ts` | Enable the 1Proxy egress pool sync. | +| `ONEPROXY_API_URL` | `https://1proxy-api.aitradepulse.com` | `src/lib/oneproxySync.ts` | 1Proxy service API URL override. | +| `ONEPROXY_MAX_PROXIES` | `500` | `src/lib/oneproxySync.ts` | Maximum proxies imported per sync. | +| `ONEPROXY_MIN_QUALITY_THRESHOLD` | `50` | `src/lib/oneproxySync.ts` | Minimum quality score for imported proxies. | +| `TAILSCALE_BIN` | _(auto-detect)_ | `src/lib/tailscaleTunnel.ts` | Explicit path to the `tailscale` binary. | +| `TAILSCALED_BIN` | _(auto-detect)_ | `src/lib/tailscaleTunnel.ts` | Explicit path to the `tailscaled` daemon binary. | +| `NGROK_AUTHTOKEN` | _(unset)_ | `src/lib/ngrokTunnel.ts` | Authenticates outbound ngrok tunnels. | +| `DB_BACKUP_MAX_FILES` | `20` | `src/lib/db/backup.ts` | Maximum SQLite backup files retained on disk. | +| `DB_BACKUP_RETENTION_DAYS` | `0` | `src/lib/db/backup.ts` | Maximum age (days) of retained backups. `0` disables age-based pruning. | +| `OMNIROUTE_TLS_PROXY_URL` | _(unset)_ | `open-sse/services/chatgptTlsClient.ts` | Override the TLS sidecar URL for tests. Production should leave unset. | + +--- + +## 26. Test & E2E Harness + +Used by `scripts/run-next-playwright.mjs`, `scripts/smoke-electron-packaged.mjs`, +`scripts/run-ecosystem-tests.mjs`, and `scripts/uninstall.mjs`. Leave every +value below unset in production deployments. + +| Variable | Default | Source File | Description | +| ------------------------------------- | -------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------- | +| `OMNIROUTE_E2E_BOOTSTRAP_MODE` | `auth` | `scripts/run-next-playwright.mjs` | E2E bootstrap mode (`auth`, `fresh`, `reuse`) for the Playwright runner. | +| `OMNIROUTE_E2E_PASSWORD` | falls back to `INITIAL_PASSWORD` | `scripts/run-next-playwright.mjs` | Admin password injected into the Playwright environment. | +| `OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK` | `true` | `scripts/run-next-playwright.mjs` | Disable the local healthcheck poll during Playwright runs. | +| `OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK` | `true` | `scripts/run-next-playwright.mjs` | Disable the OAuth token healthcheck loop during tests. | +| `OMNIROUTE_HIDE_HEALTHCHECK_LOGS` | `true` | `scripts/run-next-playwright.mjs` | Silence healthcheck noise in Playwright stdout. | +| `OMNIROUTE_PLAYWRIGHT_SKIP_BUILD` | `0` | `scripts/run-next-playwright.mjs` | Skip the Next.js production build before Playwright starts (CI optimization). | +| `OMNIROUTE_SKIP_UNINSTALL_HOOK` | `0` | `scripts/uninstall.mjs` | Skip the OmniRoute uninstall hook (used by CI to keep `node_modules` intact). | +| `ECOSYSTEM_SERVER_WAIT_MS` | `180000` | `scripts/run-ecosystem-tests.mjs` | Wait time (ms) for the server to become healthy before running ecosystem/protocol tests. | +| `ELECTRON_SMOKE_URL` | `http://127.0.0.1:20128/login` | `scripts/smoke-electron-packaged.mjs` | URL the Electron smoke harness expects the packaged app to serve. | +| `ELECTRON_SMOKE_TIMEOUT_MS` | `45000` | `scripts/smoke-electron-packaged.mjs` | Total timeout (ms) before the smoke harness gives up. | +| `ELECTRON_SMOKE_SETTLE_MS` | `2000` | `scripts/smoke-electron-packaged.mjs` | Settle window (ms) after the page loads. | +| `ELECTRON_SMOKE_APP_EXECUTABLE` | _(auto)_ | `scripts/smoke-electron-packaged.mjs` | Explicit path to the packaged Electron executable. | +| `ELECTRON_SMOKE_DATA_DIR` | _(tmpdir)_ | `scripts/smoke-electron-packaged.mjs` | Data directory for the Electron smoke run. | +| `ELECTRON_SMOKE_KEEP_DATA` | `0` | `scripts/smoke-electron-packaged.mjs` | Set `1` to preserve the smoke data directory after the run. | +| `ELECTRON_SMOKE_STREAM_LOGS` | `0` | `scripts/smoke-electron-packaged.mjs` | Set `1` to stream Electron logs to stdout during the run. | +| `CLI_DEVIN_BIN` | _(PATH lookup)_ | `open-sse/executors/devin-cli.ts` | Override the Devin CLI binary path. | + +### Docs translation pipeline + +Used by `scripts/i18n/run-translation.mjs` (the `npm run i18n:run` command). +All five variables are unset by default — set them in `.env` only on machines +that should be able to run the docs translator. + +| Variable | Default | Source File | Description | +| ----------------------------------- | --------- | ---------------------------------- | ------------------------------------------------------------------------- | +| `OMNIROUTE_TRANSLATION_API_URL` | _(unset)_ | `scripts/i18n/run-translation.mjs` | OpenAI-compatible base URL for the translation backend. | +| `OMNIROUTE_TRANSLATION_API_KEY` | _(unset)_ | `scripts/i18n/run-translation.mjs` | Bearer token for the translation backend (never logged). | +| `OMNIROUTE_TRANSLATION_MODEL` | _(unset)_ | `scripts/i18n/run-translation.mjs` | Model id, e.g. `gpt-4o-mini` or `cx/gpt-5.4-mini`. | +| `OMNIROUTE_TRANSLATION_TIMEOUT_MS` | `60000` | `scripts/i18n/run-translation.mjs` | Per-request timeout in milliseconds. | +| `OMNIROUTE_TRANSLATION_CONCURRENCY` | `4` | `scripts/i18n/run-translation.mjs` | Parallel translation requests when running over multiple files / locales. | + +--- + +## Audit: Removed / Dead Variables + +The following variables appeared in previous versions of `.env.example` but have **no runtime references** in the current codebase. They have been removed: + +| Variable | Reason | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| `STORAGE_DRIVER=sqlite` | Never read by any source file. SQLite is the only supported driver — no selection needed. | +| `INSTANCE_NAME=omniroute` | Present in old docs/env templates but unused at runtime. May return in a future multi-instance feature. | +| `SQLITE_MAX_SIZE_MB=2048` | Not referenced in source code. Database size is not artificially limited. | +| `SQLITE_CLEAN_LEGACY_FILES=true` | Not referenced in source code. Legacy cleanup was likely removed. | +| `CLI_ROO_BIN` | Not registered in `src/shared/services/cliRuntime.ts`. | +| `CLI_KIMI_CODING_BIN` | Not registered in `src/shared/services/cliRuntime.ts` (Kimi Coding uses OAuth, not a CLI binary). | +| `IFLOW_OAUTH_CLIENT_ID` / `IFLOW_OAUTH_CLIENT_SECRET` | Not referenced anywhere in source code. | +| `CEREBRAS_API_KEY` / `COHERE_API_KEY` / `FIREWORKS_API_KEY` / `GROQ_API_KEY` / `MISTRAL_API_KEY` / `NEBIUS_API_KEY` / `PERPLEXITY_API_KEY` / `TOGETHER_API_KEY` / `XAI_API_KEY` | Removed in v3.8.0. The runtime no longer reads these env vars — credentials come from Dashboard / `data/provider-credentials.json` / encrypted DB. | +| `CURSOR_PROTOBUF_DEBUG` | Removed in v3.8.0. Cursor executor uses `CURSOR_DEBUG` / `CURSOR_STREAM_DEBUG` (see §22). | +| `CLI_COMPAT_KIRO` | Removed in v3.8.0. Kiro is in `CLI_COMPAT_OMITTED_PROVIDER_IDS` — its toggle has no effect. | +| `QIANFAN_API_KEY` | Removed alongside other unused provider API key stubs in v3.8.0. | + +### Default Value Corrections + +| Variable | Old `.env.example` Value | Actual Code Default | Fixed | +| ------------------------- | ------------------------ | ------------------- | ------------------------------------------------------ | +| `APP_LOG_RETENTION_DAYS` | `90` | `7` | ✅ Removed misleading value; documented `7` as default | +| `CALL_LOG_RETENTION_DAYS` | `90` | `7` | ✅ Removed misleading value; documented `7` as default | diff --git a/docs/reference/FREE_TIERS.md b/docs/reference/FREE_TIERS.md new file mode 100644 index 0000000000..1853cf78e6 --- /dev/null +++ b/docs/reference/FREE_TIERS.md @@ -0,0 +1,238 @@ +--- +title: "Free Tiers" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Free Tiers + +> **Last consolidated:** 2026-05-13 — OmniRoute v3.8.0 +> **Source of truth:** `src/shared/constants/providers.ts` (`FREE_PROVIDERS`, `OAUTH_PROVIDERS`, and `APIKEY_PROVIDERS` entries flagged with `hasFree: true` + `freeNote`) + +This page lists providers with usable free tiers shipped in OmniRoute v3.8.0. The data is derived from the provider catalog. If a provider does not appear here, it either has no free tier in the catalog or its `hasFree` flag is `false`. + +Add credentials from the dashboard (`/dashboard/providers/new`) — OmniRoute reads keys from the database, not from per-provider environment variables. The only env vars that influence provider behavior are listed in the [Environment Variables](#environment-variables) section. + +--- + +## How free providers are wired + +OmniRoute classifies providers into the following groups in `src/shared/constants/providers.ts`: + +| Group | Auth | Example IDs | +| ------------------ | ------------------------------ | ------------------------------------------- | +| `FREE_PROVIDERS` | OAuth or vendor account | `qoder`, `gemini-cli`, `kiro`, `amazon-q` | +| `OAUTH_PROVIDERS` | OAuth | `claude`, `cursor`, `windsurf`, `devin-cli` | +| `APIKEY_PROVIDERS` | API key (with `hasFree: true`) | `groq`, `cerebras`, `mistral`, `gemini` | + +A provider appears in the **free pool** when either: + +- It is listed in the `FREE_PROVIDERS` map (and not flagged `deprecated: true`), or +- It is listed in `APIKEY_PROVIDERS` with `hasFree: true` and a `freeNote` string, or +- It is an OAuth provider whose vendor offers a free tier on top of OAuth sign-in. + +--- + +## Quick reference (API key providers with `hasFree: true`) + +| Provider | ID | Free tier note | +| ------------------ | --------------- | ---------------------------------------------------------------------------------------------------- | +| AgentRouter | `agentrouter` | $200 free credits on signup — multi-model routing gateway | +| AI21 Labs | `ai21` | $10 trial credits on signup (valid 3 months), no credit card required | +| AI/ML API | `aimlapi` | $0.025/day free credits — 200+ models via single endpoint | +| BazaarLink | `bazaarlink` | Free tier with `auto:free` routing — zero-cost inference, no credit card required | +| Baseten | `baseten` | $30 free trial credits for GPU inference | +| Blackbox AI | `blackbox` | Free tier: unlimited basic chat plus Minimax-M2.5, no credit card required | +| Bytez | `bytez` | $1 free credits, refreshes every 4 weeks | +| Cerebras | `cerebras` | Free: 1M tokens/day, 60K TPM — world's fastest inference | +| Cloudflare AI | `cloudflare-ai` | Free 10K Neurons/day: ~150 LLM responses or 500s Whisper audio | +| Cohere | `cohere` | Free Trial: 1,000 API calls/month for testing, no credit card required | +| Completions.me | `completions` | Free unlimited access to Claude, GPT, Gemini — no credit card, no rate limits | +| DeepInfra | `deepinfra` | Free signup credits for API testing and model exploration | +| DeepSeek | `deepseek` | 5M free tokens on signup — no credit card required | +| Enally AI | `enally` | Free for students and developers — no credit card, OTP verification | +| Fireworks AI | `fireworks` | $1 free starter credits on signup for API testing | +| FreeTheAi | `freetheai` | Community-run — free forever, no paid tiers, no credit card | +| Gemini (AI Studio) | `gemini` | Free forever: 1,500 req/day for Gemini 2.5 Flash — no credit card | +| GLHF Chat | `glhf` | Free tier for open-source model inference | +| Groq | `groq` | Free tier: 30 RPM / 14.4K RPD — no credit card | +| HuggingFace | `huggingface` | Free Inference API for thousands of models (Whisper, VITS, SDXL…) | +| Hyperbolic | `hyperbolic` | $1–5 trial credits on signup for serverless inference | +| Inference.net | `inference-net` | $25 free credits on signup plus research grants available | +| Jina AI | `jina-ai` | 10M free tokens on signup (non-commercial), no credit card required | +| Kluster AI | `kluster` | $5 free credits on signup — DeepSeek R1, Llama 4 Maverick/Scout, Qwen3 235B | +| Lepton AI | `lepton` | Free tier available — fast inference on custom hardware | +| LLM7.io | `llm7` | No signup required — 2 req/s, 20 RPM, 100 req/hr free tier | +| LongCat AI | `longcat` | 50M tokens/day (Flash-Lite) + 500K/day (Chat/Thinking) — 100% free while public beta | +| Mistral | `mistral` | Free Experiment tier: rate-limited access to all models, no credit card required | +| Modal | `modal` | $30/month free credits for new accounts | +| Morph | `morph` | Free tier: 250K credits/month, $0 | +| Nebius | `nebius` | ~$1 trial credits on signup for API testing | +| NLP Cloud | `nlpcloud` | Trial credits for new accounts | +| Nous Research | `nous-research` | Free tier: 50 RPM, 500,000 TPM — no credit card | +| Novita AI | `novita` | $0.50 trial credits on signup (valid about 1 year) | +| nScale | `nscale` | $5 free credits on signup for inference testing | +| NVIDIA NIM | `nvidia` | Free dev access: ~40 RPM, 70+ models (Kimi K2.5, GLM 4.7, DeepSeek V3.2…) | +| OpenRouter | `openrouter` | Free models at $0/token with `:free` suffix — 20 RPM / 200 RPD | +| Pollinations AI | `pollinations` | No API key required for free public endpoint. Optional Spore tier: ~0.01 pollen/hour | +| Predibase | `predibase` | $25 free trial credits (30-day validity) | +| PublicAI | `publicai` | Free community inference tier for testing | +| Puter AI | `puter` | 500+ models (GPT-5, Claude Opus 4, Gemini 3 Pro, Grok 4, DeepSeek V3…) — users pay via Puter account | +| Reka | `reka` | $10/month recurring free API credits | +| SambaNova | `sambanova` | $5 free credits on signup (30-day validity), no credit card required | +| Scaleway AI | `scaleway` | 1M free tokens for new accounts — EU/GDPR compliant (Paris), Qwen3 235B & Llama 70B | +| SiliconFlow | `siliconflow` | $1 free credits plus permanently free models after identity verification | +| Together AI | `together` | $25 signup credits + 3 permanently free models: Llama 3.3 70B, Vision, DeepSeek-R1 distill | +| UncloseAI | `uncloseai` | Free forever — no signup, no credit card. OpenAI-compatible endpoints | +| Voyage AI | `voyage-ai` | 200M free tokens for embeddings and reranking | + +**Total: 48 API-key providers with `hasFree: true`.** + +> All entries above are copied verbatim from the `freeNote` field in the provider catalog so they stay in sync with the code. + +--- + +## OAuth-based free tiers + +### Always-free OAuth providers (in `FREE_PROVIDERS`) + +These providers are designed around a vendor OAuth flow and ship a free tier by default: + +| Provider | ID | Notes | +| ---------- | ------------ | ----------------------------------------------------------------------------------------------------------- | +| Qoder AI | `qoder` | OAuth or Personal Access Token. Free tier on signup. | +| Gemini CLI | `gemini-cli` | Uses Gemini CLI OAuth / Cloud Code credentials. Pro models require an eligible Google account or paid plan. | +| Kiro AI | `kiro` | AWS Builder ID (Kiro Free tier). | +| Amazon Q | `amazon-q` | Same AWS Builder ID / refresh-token flow as Kiro, but kept as separate connections. | + +### OAuth providers with vendor-controlled free tiers (in `OAUTH_PROVIDERS`) + +The free-tier surface here depends entirely on each vendor's account plan, not on OmniRoute: + +| Provider | ID | Auth hint | +| -------------------- | ------------- | --------------------------------------------------------------------------------------- | +| Claude Code | `claude` | OAuth via `platform.claude.com`. Free quota depends on your Anthropic account. | +| Antigravity | `antigravity` | Google OAuth (Antigravity). | +| OpenAI Codex | `codex` | OAuth via OpenAI (Codex CLI). Subject to ChatGPT plan free credits. | +| GitHub Copilot | `github` | OAuth via GitHub. Free for verified students; free trial otherwise. | +| GitLab Duo | `gitlab-duo` | OAuth (`ai_features + read_user`). Requires GitLab Duo entitlement. | +| Cursor IDE | `cursor` | Cursor OAuth. Free tier limits depend on Cursor plan. | +| Kimi Coding | `kimi-coding` | Moonshot OAuth. Free quota on Kimi Coding accounts. | +| Kilo Code | `kilocode` | Kilo OAuth — free auto-router available. | +| Cline | `cline` | Cline OAuth. | +| Windsurf (Devin CLI) | `windsurf` | Sign in at `windsurf.com`, paste your token. Free tier limits set by Windsurf. | +| Devin CLI (Official) | `devin-cli` | Uses the official Devin CLI binary or `WINDSURF_API_KEY`. Subject to Devin's free tier. | + +--- + +## Deprecated / discontinued + +### Qwen Code (`qwen`) + +Marked `deprecated: true` in `FREE_PROVIDERS`. Discontinued **2026-04-15**. + +> Qwen OAuth free tier was discontinued on 2026-04-15. Use `alicode`, `alicode-intl`, or `openrouter` providers with an API key instead. + +Connections of type `qwen` will keep working until their tokens expire, but no new OAuth sign-ins are accepted upstream. Migrate to: + +- `alicode` (Alibaba Cloud Bailian — DashScope) +- `alicode-intl` (Alibaba Cloud International) +- `openrouter` (Qwen models exposed via OpenRouter) + +--- + +## Command Code + +`command-code` is a separate API-key provider for the Command Code agent (see `commandcode.ai`). It is not flagged with `hasFree: true` in the catalog, so it does not appear in the free table above, but it is included here because it ships in v3.8.0 alongside the free-tier providers: + +- ID: `command-code` +- Endpoint: Command Code `/alpha/generate` +- Auth: Bearer API key, configured from the dashboard. + +Check Command Code's website for the current free-tier policy. + +--- + +## Environment variables + +OmniRoute v3.8.0 does **not** read provider API keys from environment variables (with one exception below). Keys are stored in the encrypted SQLite database and configured from the dashboard. The env vars listed here are the only ones that affect free-tier behavior: + +```bash +# Windsurf / Devin CLI — Firebase Web API key used by the Secure Token +# Service to refresh the Windsurf app. The default value ships in +# .env.example (it is a public Firebase Web API key extracted from the +# Devin CLI binary, not a real secret); override only if you mirror your +# own Windsurf token-refresh service. +WINDSURF_FIREBASE_API_KEY=<see .env.example> + +# Optional fallback for the devin-cli executor when no connection key is set. +WINDSURF_API_KEY= + +# Optional path to the official Devin CLI binary. +CLI_DEVIN_BIN=/usr/local/bin/devin + +# OAuth client overrides (rarely needed — defaults shipped in code) +CODEX_OAUTH_CLIENT_ID= +GEMINI_OAUTH_CLIENT_ID= +GEMINI_OAUTH_CLIENT_SECRET= +GEMINI_CLI_OAUTH_CLIENT_ID= +GEMINI_CLI_OAUTH_CLIENT_SECRET= +QWEN_OAUTH_CLIENT_ID= +KIMI_CODING_OAUTH_CLIENT_ID= +GITHUB_OAUTH_CLIENT_ID= +GITLAB_DUO_OAUTH_CLIENT_ID= +GITLAB_DUO_OAUTH_CLIENT_SECRET= +QODER_OAUTH_CLIENT_SECRET= +QODER_PERSONAL_ACCESS_TOKEN= + +# CLI sidecar binaries +CLI_CODEX_BIN=codex +CLI_CURSOR_BIN=agent +CLI_CLINE_BIN=cline +CLI_QODER_BIN=qoder +CLI_QWEN_BIN=qwen +``` + +For all other providers (Groq, Cerebras, Mistral, Gemini, Cohere, NVIDIA, OpenRouter, Together, Fireworks, Cloudflare AI, SambaNova, HuggingFace, SiliconFlow, Hyperbolic, Morph, LLM7, Lepton, Kluster, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi, AgentRouter, Command Code, etc.), add the key from `/dashboard/providers/new`. + +--- + +## How to use + +1. Open `/dashboard/providers/new` and pick the provider you want. +2. Paste the API key (or complete the OAuth flow). For OAuth providers, follow the dashboard wizard. +3. The provider appears in your routing pool automatically and is eligible for combos and auto-routing. +4. Track usage at `/dashboard/usage` to see how close you are to free-tier limits. + +### Suggested combos + +| Goal | Strategy | Notes | +| ---------------------------- | -------------------- | --------------------------------------------------------------------- | +| Cheapest possible chat | `auto/cheap` | Prefers free / lowest-cost providers; falls back automatically. | +| Local-only routing | `auto/offline` | Routes only to local providers (Ollama, LM Studio, vLLM, …). | +| Redundancy across free tiers | combo `priority` | List Groq → Cerebras → Mistral → Gemini → NVIDIA → OpenRouter. | +| High RPM throughput | combo `round-robin` | Spreads requests across all configured free providers. | +| Best success rate | combo `lkgp` / `p2c` | Picks last-known-good provider or "power of two choices" rebalancing. | + +### Tips + +- Combine multiple free providers in a combo (`/dashboard/combos`) to maximize daily quota and route around outages. +- Use `omniroute doctor` to verify all configured free providers are reachable. +- Check provider health in `/dashboard/monitoring/health` — a provider with an open circuit breaker is skipped automatically. +- Free-tier limits change frequently; the `freeNote` strings reflect the limits as known at v3.8.0 ship date. Verify with each provider's official docs before relying on a specific number. + +--- + +## Glossary + +| Term | Meaning | +| ---------- | -------------------------------------------------------- | +| **RPM** | Requests per minute | +| **RPD** | Requests per day | +| **RPH** | Requests per hour | +| **RPS** | Requests per second | +| **TPM** | Tokens per minute | +| **TPD** | Tokens per day | +| **Neuron** | Cloudflare's compute unit (~1 output token) | +| **LKGP** | Last-known-good provider — auto-combo strategy | +| **P2C** | Power-of-two choices — auto-combo load balancer strategy | diff --git a/docs/reference/PROVIDER_REFERENCE.md b/docs/reference/PROVIDER_REFERENCE.md new file mode 100644 index 0000000000..4e2df77833 --- /dev/null +++ b/docs/reference/PROVIDER_REFERENCE.md @@ -0,0 +1,272 @@ +--- +title: "Provider Reference" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Provider Reference + +> **Auto-generated** from `src/shared/constants/providers.ts` — do not edit by hand. +> Regenerate with: `npm run gen:provider-reference` +> **Last generated:** 2026-05-13 + +Total providers: **177**. See category breakdown below. + +## Categories + +- **Free** — free tier with API key (configured via dashboard) +- **OAuth** — sign-in flow handled by OmniRoute, no API key needed +- **Web cookie** — wraps the provider's web app via cookie auth +- **API key** — paid provider configured via API key (free credits may apply) +- **Local** — runs on the user's machine (Ollama, LM Studio, vLLM, etc.) +- **Search** — web search providers +- **Audio** — audio-only providers (TTS/STT) +- **Upstream proxy** — providers that proxy to other providers +- **Cloud agent** — long-running coding agents (Codex Cloud, Devin, Jules) +- **System** — OmniRoute-internal providers (loopback, etc.) + +Additional tags: `image`, `video`, `aggregator`, `enterprise`, `embed/rerank`, `self-hosted`. + +Use the dashboard at `/dashboard/providers` to enable, configure, and test each provider. + +--- + +## Free Tier (OAuth-first or no-key) (5) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------ | ------------ | ---------- | ---- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | +| `amazon-q` | `aq` | Amazon Q | Free | [link](https://aws.amazon.com/q/developer/) | Uses the same AWS Builder ID or imported refresh-token flow as Kiro, but keeps Amazon Q connections separate. | +| `gemini-cli` | `gemini-cli` | Gemini CLI | Free | — | Uses Gemini CLI OAuth / Cloud Code credentials. Pro models require an eligible Google account or paid plan. | +| `kiro` | `kr` | Kiro AI | Free | — | — | +| `qoder` | `if` | Qoder AI | Free | — | — | +| `qwen` | `qw` | Qwen Code | Free | — | ⚠️ **DEPRECATED.** Qwen OAuth free tier was discontinued on 2026-04-15. Use 'alicode', 'alicode-intl', or 'openrouter' provider with API key instead. | + +## OAuth Providers (11) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------- | ------------ | -------------------- | ----- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `antigravity` | — | Antigravity | OAuth | — | — | +| `claude` | `cc` | Claude Code | OAuth | — | — | +| `cline` | `cl` | Cline | OAuth | — | — | +| `codex` | `cx` | OpenAI Codex | OAuth | — | — | +| `cursor` | `cu` | Cursor IDE | OAuth | — | — | +| `devin-cli` | `dv` | Devin CLI (Official) | OAuth | [link](https://cli.devin.ai) | Requires the Devin CLI binary. Run `devin auth login` to authenticate, or provide your WINDSURF_API_KEY. Install: https://cli.devin.ai | +| `github` | `gh` | GitHub Copilot | OAuth | — | — | +| `gitlab-duo` | `gitlab-duo` | GitLab Duo | OAuth | [link](https://docs.gitlab.com/user/duo_agent_platform/code_suggestions/) | OAuth application with ai_features + read_user scopes. Configure GITLAB_DUO_OAUTH_CLIENT_ID and optionally GITLAB_DUO_OAUTH_CLIENT_SECRET on this OmniRoute instance. | +| `kilocode` | `kc` | Kilo Code | OAuth | — | — | +| `kimi-coding` | `kmc` | Kimi Coding | OAuth | — | — | +| `windsurf` | `ws` | Windsurf (Devin CLI) | OAuth | [link](https://windsurf.com) | Sign in at windsurf.com to get your token. Visit windsurf.com/show-auth-token after logging in and paste it here, or use the device-code login flow. | + +## Web Cookie Providers (5) + +| ID | Alias | Name | Tags | Website | Notes | +| ---------------- | ---------- | --------------------------- | ---------- | --------------------------------- | ------------------------------------------------------------------------------------------- | +| `blackbox-web` | `bb-web` | Blackbox Web (Subscription) | Web cookie | [link](https://app.blackbox.ai) | Paste your \_\_Secure-authjs.session-token value or full cookie header from app.blackbox.ai | +| `chatgpt-web` | `cgpt-web` | ChatGPT Web (Plus/Pro) | Web cookie | [link](https://chatgpt.com) | Paste your \_\_Secure-next-auth.session-token cookie value from chatgpt.com | +| `grok-web` | `gw` | Grok Web (Subscription) | Web cookie | [link](https://grok.com) | Paste your sso= cookie value from grok.com | +| `muse-spark-web` | `ms-web` | Muse Spark Web (Meta AI) | Web cookie | [link](https://www.meta.ai) | Paste your abra_sess value or full cookie header from meta.ai | +| `perplexity-web` | `pplx-web` | Perplexity Web (Pro/Max) | Web cookie | [link](https://www.perplexity.ai) | Paste your \_\_Secure-next-auth.session-token cookie value from perplexity.ai | + +## API Key Providers (paid / paid-with-free-credits) (123) + +| ID | Alias | Name | Tags | Website | Notes | +| --------------------- | -------------- | -------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `agentrouter` | `agentrouter` | AgentRouter | API key, aggregator | [link](https://agentrouter.org) | $200 free credits on signup - multi-model routing gateway | +| `ai21` | `ai21` | AI21 Labs | API key | [link](https://www.ai21.com) | $10 trial credits on signup (valid 3 months), no credit card required | +| `aimlapi` | `aiml` | AI/ML API | API key, aggregator | [link](https://aimlapi.com) | $0.025/day free credits — 200+ models (GPT-4o, Claude, Gemini, Llama) via single endpoint | +| `alibaba` | `ali` | Alibaba Cloud (DashScope) | API key | [link](https://dashscope-intl.aliyuncs.com) | — | +| `alicode` | `alicode` | Alibaba | API key | [link](https://bailian.console.aliyun.com) | — | +| `alicode-intl` | `alicode-intl` | Alibaba Intl | API key | [link](https://modelstudio.console.alibabacloud.com) | — | +| `anthropic` | `anthropic` | Anthropic | API key | [link](https://platform.claude.com) | — | +| `azure-ai` | `azure-ai` | Azure AI Foundry | API key, enterprise | [link](https://learn.microsoft.com/azure/ai-foundry) | Use your Azure AI Foundry key. Base URL can be https://<resource>.services.ai.azure.com/openai/v1/ or https://<resource>.openai.azure.com/openai/v1/. | +| `azure-openai` | `azure` | Azure OpenAI | API key, enterprise | [link](https://azure.microsoft.com/products/ai-services/openai-service) | Use your Azure OpenAI API key. Base URL should be your resource endpoint, for example https://my-resource.openai.azure.com. | +| `bailian-coding-plan` | `bcp` | Alibaba Coding Plan | API key | [link](https://www.alibabacloud.com/help/en/model-studio/coding-plan) | — | +| `baseten` | `baseten` | Baseten | API key | [link](https://baseten.co) | $30 free trial credits for GPU inference | +| `bazaarlink` | `bzl` | BazaarLink | API key | [link](https://bazaarlink.ai) | Free tier with auto:free routing — zero-cost inference, no credit card required | +| `bedrock` | `bedrock` | Amazon Bedrock | API key, enterprise | [link](https://aws.amazon.com/bedrock) | Use your Amazon Bedrock API key in Authorization: Bearer <key>. OmniRoute defaults to the OpenAI-compatible bedrock-mantle endpoint in us-east-1; set a regional base URL if your account uses another region or the bedrock-runtime /openai/v1 path. | +| `black-forest-labs` | `bfl` | Black Forest Labs | API key, image | [link](https://blackforestlabs.ai) | — | +| `blackbox` | `bb` | Blackbox AI | API key | [link](https://blackbox.ai) | Free tier: unlimited basic chat plus Minimax-M2.5, no credit card required | +| `bytez` | `bytez` | Bytez | API key | [link](https://bytez.com) | $1 free credits, refreshes every 4 weeks | +| `cablyai` | `cablyai` | CablyAI | API key, aggregator | [link](https://cablyai.com) | Bearer API key for the CablyAI OpenAI-compatible gateway. | +| `cerebras` | `cerebras` | Cerebras | API key | [link](https://inference.cerebras.ai) | Free: 1M tokens/day, 60K TPM — world's fastest inference | +| `chutes` | `chutes` | Chutes.ai | API key, aggregator | [link](https://chutes.ai) | Bearer API key for the Chutes OpenAI-compatible gateway. | +| `clarifai` | `clarifai` | Clarifai | API key, enterprise | [link](https://docs.clarifai.com) | Use your Clarifai PAT or app-specific API key. OmniRoute targets the OpenAI-compatible endpoint at https://api.clarifai.com/v2/ext/openai/v1 and authenticates with Authorization: Key <token>. | +| `cloudflare-ai` | `cf` | Cloudflare Workers AI | API key | [link](https://developers.cloudflare.com/workers-ai) | Requires API Token AND Account ID (found at dash.cloudflare.com) | +| `codestral` | `codestral` | Codestral | API key | [link](https://mistral.ai) | — | +| `cohere` | `cohere` | Cohere | API key | [link](https://cohere.com) | Free Trial: 1,000 API calls/month for testing, no credit card required | +| `command-code` | `cmd` | Command Code | API key | [link](https://commandcode.ai/) | Use a Command Code API key. Requests are sent to Command Code's /alpha/generate endpoint. | +| `completions` | `cpl` | Completions.me | API key | [link](https://completions.me) | Free unlimited access to Claude, GPT, Gemini — no credit card, no rate limits | +| `crof` | `crof` | CrofAI | API key | [link](https://crof.ai) | — | +| `databricks` | `databricks` | Databricks | API key, enterprise | [link](https://www.databricks.com) | — | +| `datarobot` | `datarobot` | DataRobot | API key, enterprise | [link](https://docs.datarobot.com) | Use your DataRobot API token. Optional Base URL can be the account root (for LLM Gateway) or a deployment URL under /api/v2/deployments/<id>. | +| `deepinfra` | `deepinfra` | DeepInfra | API key | [link](https://deepinfra.com) | Free signup credits for API testing and model exploration | +| `deepseek` | `ds` | DeepSeek | API key | [link](https://platform.deepseek.com) | 5M free tokens on signup - no credit card required | +| `empower` | `empower` | Empower | API key, aggregator | [link](https://docs.empower.dev) | Bearer API key for the Empower OpenAI-compatible endpoint. | +| `enally` | `enly` | Enally AI | API key | [link](https://ai.enally.in) | Free for students and developers — no credit card, OTP verification | +| `fal-ai` | `fal` | Fal.ai | API key, image | [link](https://fal.ai) | — | +| `featherless-ai` | `featherless` | Featherless AI | API key | [link](https://featherless.ai) | — | +| `fenayai` | `fenayai` | FenayAI | API key, aggregator | [link](https://fenayai.com) | Bearer API key for the FenayAI OpenAI-compatible gateway. | +| `fireworks` | `fireworks` | Fireworks AI | API key | [link](https://fireworks.ai) | $1 free starter credits on signup for API testing | +| `freetheai` | `fta` | FreeTheAi | API key | [link](https://freetheai.xyz) | Community-run — free forever, no paid tiers, no credit card | +| `friendliai` | `friendli` | FriendliAI | API key | [link](https://friendli.ai) | — | +| `galadriel` | `galadriel` | Galadriel | API key | [link](https://galadriel.com) | — | +| `gemini` | `gemini` | Gemini (Google AI Studio) | API key | [link](https://aistudio.google.com) | Free forever: 1,500 req/day for Gemini 2.5 Flash — no credit card, get key at aistudio.google.com | +| `getgoapi` | `ggo` | GoAPI | API key, aggregator | [link](https://api.getgoapi.com) | — | +| `gigachat` | `gigachat` | GigaChat (Sber) | API key | [link](https://developers.sber.ru) | — | +| `gitlab` | `gitlab` | GitLab Duo PAT | API key | [link](https://docs.gitlab.com/user/duo_agent_platform/code_suggestions/) | GitLab personal access token for the public Code Suggestions API. Configure a self-hosted base URL when not using gitlab.com. | +| `glhf` | `glhf` | GLHF Chat | API key, aggregator | [link](https://glhf.chat) | Bearer API key for the GLHF OpenAI-compatible gateway. | +| `glm` | `glm` | GLM Coding | API key | [link](https://z.ai/subscribe) | — | +| `glm-cn` | `glmcn` | GLM Coding (China) | API key | [link](https://open.bigmodel.cn) | — | +| `glmt` | `glmt` | GLM Thinking | API key | [link](https://open.bigmodel.cn) | — | +| `groq` | `groq` | Groq | API key | [link](https://groq.com) | Free tier: 30 RPM / 14.4K RPD — no credit card | +| `heroku` | `heroku` | Heroku AI | API key, enterprise | [link](https://www.heroku.com) | — | +| `huggingface` | `hf` | HuggingFace | API key | [link](https://huggingface.co) | Free Inference API for thousands of models (Whisper, VITS, SDXL…) | +| `hyperbolic` | `hyp` | Hyperbolic | API key | [link](https://hyperbolic.xyz) | $1-5 trial credits on signup for serverless inference | +| `inference-net` | `inet` | Inference.net | API key | [link](https://inference.net) | $25 free credits on signup plus research grants available | +| `jina-ai` | `jina` | Jina AI | API key, embed/rerank | [link](https://jina.ai) | Bearer API key for the Jina AI rerank API. | +| `kie` | `kie` | KIE.AI | API key | [link](https://kie.ai) | — | +| `kilo-gateway` | `kg` | Kilo Gateway | API key, aggregator | [link](https://kilo.ai) | — | +| `kimi` | `kimi` | Kimi | API key | [link](https://platform.moonshot.ai) | — | +| `kimi-coding-apikey` | `kmca` | Kimi Coding (API Key) | API key | [link](https://www.kimi.com/code) | — | +| `kluster` | `kluster` | Kluster AI | API key | [link](https://kluster.ai) | $5 free credits on signup - DeepSeek R1, Llama 4 Maverick/Scout, Qwen3 235B | +| `lambda-ai` | `lambda` | Lambda AI | API key | [link](https://lambda.ai) | — | +| `laozhang` | `lz` | LaoZhang AI | API key, aggregator | [link](https://api.laozhang.ai) | — | +| `lepton` | `lepton` | Lepton AI | API key | [link](https://lepton.ai) | Free tier available - fast inference on custom hardware | +| `llamagate` | `llamagate` | LlamaGate | API key | [link](https://llamagate.ai) | — | +| `llm7` | `llm7` | LLM7.io | API key | [link](https://llm7.io) | No signup required - 2 req/s, 20 RPM, 100 req/hr free tier | +| `longcat` | `lc` | LongCat AI | API key | [link](https://longcat.chat/platform/docs) | 50M tokens/day (Flash-Lite) + 500K/day (Chat/Thinking) — 100% free while public beta | +| `maritalk` | `maritalk` | Maritalk | API key | [link](https://www.maritaca.ai) | — | +| `meta-llama` | `meta` | Meta Llama API | API key | [link](https://llama.developer.meta.com) | — | +| `minimax` | `minimax` | Minimax Coding | API key | [link](https://www.minimax.io) | — | +| `minimax-cn` | `minimax-cn` | Minimax (China) | API key | [link](https://www.minimaxi.com) | — | +| `mistral` | `mistral` | Mistral | API key | [link](https://mistral.ai) | Free Experiment tier: rate-limited access to all models, no credit card required | +| `modal` | `mdl` | Modal | API key, enterprise | [link](https://modal.com/docs) | Use the bearer token that protects your Modal deployment, if enabled. Base URL should point to your OpenAI-compatible Modal app, for example https://<workspace>--<app>.modal.run/v1. | +| `moonshot` | `moonshot` | Moonshot AI | API key | [link](https://platform.moonshot.ai) | — | +| `morph` | `morph` | Morph | API key | [link](https://morphllm.com) | Free tier: 250K credits/month, $0 | +| `nanobanana` | `nb` | NanoBanana | API key, image | [link](https://nanobananaapi.ai) | — | +| `nanogpt` | `nanogpt` | NanoGPT | API key | [link](https://nano-gpt.com) | — | +| `nebius` | `nebius` | Nebius AI | API key | [link](https://nebius.com) | ~$1 trial credits on signup for API testing | +| `nlpcloud` | `nlpc` | NLP Cloud | API key | [link](https://docs.nlpcloud.com) | Use your NLP Cloud API key in Authorization: Token <key>. OmniRoute targets the chatbot endpoint on https://api.nlpcloud.io/v1/gpu/<model>/chatbot by default. | +| `nous-research` | `nous` | Nous Research | API key | [link](https://portal.nousresearch.com/help) | Use your Nous Portal API key. OmniRoute targets the official OpenAI-compatible inference endpoint at https://inference-api.nousresearch.com/v1. | +| `novita` | `novita` | Novita AI | API key, aggregator | [link](https://novita.ai) | $0.50 trial credits on signup (valid about 1 year) | +| `nscale` | `nscale` | nScale | API key | [link](https://nscale.com) | $5 free credits on signup for inference testing | +| `nvidia` | `nvidia` | NVIDIA NIM | API key | [link](https://build.nvidia.com) | Free dev access: ~40 RPM, 70+ models (Kimi K2.5, GLM 4.7, DeepSeek V3.2...) | +| `oci` | `oci` | OCI Generative AI | API key, enterprise | [link](https://www.oracle.com/artificial-intelligence/generative-ai) | Use your OCI Generative AI API key or IAM bearer token. Base URL can be https://inference.generativeai.<region>.oci.oraclecloud.com/openai/v1/. | +| `ollama-cloud` | `ollamacloud` | Ollama Cloud | API key | [link](https://ollama.com/settings/api-keys) | — | +| `openai` | `openai` | OpenAI | API key | [link](https://platform.openai.com) | — | +| `opencode-go` | `opencode-go` | OpenCode Go | API key | [link](https://opencode.ai/go) | — | +| `opencode-zen` | `opencode-zen` | OpenCode Zen | API key | [link](https://opencode.ai/zen) | — | +| `openrouter` | `openrouter` | OpenRouter | API key, aggregator | [link](https://openrouter.ai) | Free models at $0/token with :free suffix - 20 RPM / 200 RPD | +| `ovhcloud` | `ovh` | OVHcloud AI | API key | [link](https://www.ovhcloud.com) | — | +| `perplexity` | `pplx` | Perplexity | API key | [link](https://www.perplexity.ai) | — | +| `petals` | `petals` | Petals | API key | [link](https://chat.petals.dev) | No API key is required for the public research endpoint. Leave the field blank, or provide a bearer token if your self-hosted Petals gateway uses auth. | +| `piapi` | `pi` | PiAPI | API key, aggregator | [link](https://piapi.ai) | — | +| `poe` | `poe` | Poe | API key, aggregator | [link](https://creator.poe.com/api-reference) | Bearer API key for the Poe OpenAI-compatible API. | +| `pollinations` | `pol` | Pollinations AI | API key | [link](https://pollinations.ai) | No API key required for free public endpoint. Optional Spore tier: ~0.01 pollen/hour. | +| `predibase` | `predibase` | Predibase | API key | [link](https://predibase.com) | $25 free trial credits (30-day validity) | +| `publicai` | `publicai` | PublicAI | API key | [link](https://publicai.co) | Free community inference tier for testing | +| `puter` | `pu` | Puter AI | API key | [link](https://puter.com) | Get token at puter.com/dashboard → Copy Auth Token | +| `qianfan` | `qianfan` | Baidu Qianfan | API key | [link](https://cloud.baidu.com/product/wenxinworkshop) | — | +| `recraft` | `recraft` | Recraft | API key, image | [link](https://recraft.ai) | — | +| `reka` | `reka` | Reka | API key | [link](https://docs.reka.ai/chat/overview) | Use your Reka API key. OmniRoute supports the OpenAI-compatible base URL https://api.reka.ai/v1 and sends both Authorization and X-Api-Key headers for compatibility. | +| `runwayml` | `runway` | Runway | API key, video | [link](https://docs.dev.runwayml.com) | Use your Runway API key in Authorization: Bearer <key>. OmniRoute targets the current Runway API at https://api.dev.runwayml.com/v1 and sends the required X-Runway-Version header automatically. | +| `sambanova` | `samba` | SambaNova | API key | [link](https://sambanova.ai) | $5 free credits on signup (30-day validity), no credit card required | +| `sap` | `sap` | SAP Generative AI Hub | API key, enterprise | [link](https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/generative-ai-hub-in-sap-ai-core) | Use your SAP AI Core bearer token. Base URL can be your AI_API_URL root or a deploymentUrl from Generative AI Hub. | +| `scaleway` | `scw` | Scaleway AI | API key | [link](https://www.scaleway.com/en/ai/generative-apis) | 1M free tokens for new accounts — EU/GDPR compliant (Paris), Qwen3 235B & Llama 70B | +| `siliconflow` | `siliconflow` | SiliconFlow | API key | [link](https://cloud.siliconflow.com) | $1 free credits plus permanently free models after identity verification | +| `snowflake` | `snowflake` | Snowflake Cortex | API key, enterprise | [link](https://www.snowflake.com) | — | +| `stability-ai` | `stability` | Stability AI | API key, image | [link](https://stability.ai) | — | +| `synthetic` | `synthetic` | Synthetic | API key, aggregator | [link](https://synthetic.new) | — | +| `thebai` | `thebai` | TheB.AI | API key, aggregator | [link](https://theb.ai) | Bearer API key for the TheB.AI OpenAI-compatible gateway. | +| `together` | `together` | Together AI | API key | [link](https://www.together.ai) | $25 signup credits + 3 permanently free models: Llama 3.3 70B, Vision, DeepSeek-R1 distill | +| `topaz` | `topaz` | Topaz | API key, image | [link](https://topazlabs.com) | — | +| `uncloseai` | `unc` | UncloseAI | API key | [link](https://uncloseai.com) | No auth required. API accepts any non-empty string as key for identification. | +| `upstage` | `upstage` | Upstage | API key | [link](https://www.upstage.ai) | — | +| `v0-vercel` | `v0` | v0 (Vercel) | API key | [link](https://v0.dev) | — | +| `venice` | `venice` | Venice.ai | API key | [link](https://venice.ai) | — | +| `vercel-ai-gateway` | `vag` | Vercel AI Gateway | API key, aggregator | [link](https://vercel.com/docs/ai-gateway) | — | +| `vertex` | `vertex` | Vertex AI | API key, enterprise | [link](https://cloud.google.com/vertex-ai) | Provide Service Account JSON or OAuth access_token | +| `vertex-partner` | `vp` | Vertex AI Partners | API key, enterprise | [link](https://cloud.google.com/vertex-ai) | Provide the same Service Account JSON used for Vertex AI partner models. | +| `volcengine` | `volcengine` | Volcengine | API key | [link](https://www.volcengine.com) | — | +| `voyage-ai` | `voyage` | Voyage AI | API key, embed/rerank | [link](https://www.voyageai.com) | Bearer API key for Voyage AI embeddings and rerank APIs. | +| `wandb` | `wandb` | Weights & Biases Inference | API key | [link](https://wandb.ai) | — | +| `watsonx` | `watsonx` | IBM watsonx.ai Gateway | API key, enterprise | [link](https://www.ibm.com/products/watsonx-ai) | Use your watsonx bearer token. Base URL can be https://<region>.ml.cloud.ibm.com/ml/gateway/v1/ or a self-managed /ml/gateway/v1 endpoint. | +| `xai` | `xai` | xAI (Grok) | API key | [link](https://x.ai) | — | +| `xiaomi-mimo` | `mimo` | Xiaomi MiMo | API key | [link](https://mimo.mi.com) | — | +| `zai` | `zai` | Z.AI | API key | [link](https://open.bigmodel.cn) | — | + +## Local Providers (10) + +| ID | Alias | Name | Tags | Website | Notes | +| --------------------- | ------------ | ------------------- | ------------------ | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `comfyui` | `comfyui` | ComfyUI | Local | [link](https://github.com/comfyanonymous/ComfyUI) | No API key required. Configure the local ComfyUI base URL (default: http://localhost:8188). | +| `docker-model-runner` | `dmr` | Docker Model Runner | Local, self-hosted | [link](https://docs.docker.com/ai/model-runner/) | API key optional. Configure the local Docker Model Runner OpenAI-compatible base URL (default: http://localhost:12434/v1). | +| `lemonade` | `lemonade` | Lemonade Server | Local, self-hosted | [link](https://lemonade-server.ai) | API key optional. Configure the local Lemonade OpenAI-compatible base URL (default: http://localhost:13305/api/v1). | +| `llamafile` | `llamafile` | Llamafile | Local, self-hosted | [link](https://github.com/Mozilla-Ocho/llamafile) | API key optional. Configure the local Llamafile OpenAI-compatible base URL (default: http://127.0.0.1:8080/v1). | +| `lm-studio` | `lmstudio` | LM Studio | Local, self-hosted | [link](https://lmstudio.ai) | API key optional. Configure the local LM Studio OpenAI-compatible base URL (default: http://localhost:1234/v1). | +| `oobabooga` | `ooba` | oobabooga | Local, self-hosted | [link](https://github.com/oobabooga/text-generation-webui) | API key optional. Configure the local oobabooga OpenAI-compatible base URL (default: http://localhost:5000/v1). | +| `sdwebui` | `sdwebui` | SD WebUI | Local | [link](https://github.com/AUTOMATIC1111/stable-diffusion-webui) | No API key required. Configure the local WebUI base URL (default: http://localhost:7860). | +| `triton` | `triton` | NVIDIA Triton | Local, self-hosted | [link](https://developer.nvidia.com/triton-inference-server) | API key optional. Configure the Triton OpenAI-compatible base URL (default: http://localhost:8000/v1). | +| `vllm` | `vllm` | vLLM | Local, self-hosted | [link](https://github.com/vllm-project/vllm) | API key optional. Configure the local vLLM OpenAI-compatible base URL (default: http://localhost:8000/v1). | +| `xinference` | `xinference` | XInference | Local, self-hosted | [link](https://inference.readthedocs.io) | API key optional. Configure the local XInference OpenAI-compatible base URL (default: http://localhost:9997/v1). | + +## Search Providers (11) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------------- | --------------- | -------------------------- | ------ | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `brave-search` | `brave-search` | Brave Search | Search | [link](https://brave.com/search/api) | Subscription token from Brave Search API dashboard | +| `exa-search` | `exa-search` | Exa Search | Search | [link](https://exa.ai) | API key from dashboard.exa.ai | +| `google-pse-search` | `google-pse` | Google Programmable Search | Search | [link](https://developers.google.com/custom-search/v1/overview) | Requires a Google API key and your Programmable Search Engine ID (cx) | +| `linkup-search` | `linkup` | Linkup Search | Search | [link](https://docs.linkup.so) | Bearer API key from the Linkup dashboard | +| `ollama-search` | `ollama-search` | Ollama Search | Search | [link](https://ollama.com/settings/api-keys) | Same API key as Ollama Cloud (from ollama.com/settings/api-keys) | +| `perplexity-search` | `pplx-search` | Perplexity Search | Search | [link](https://docs.perplexity.ai/guides/search-quickstart) | Same API key as Perplexity (pplx-...) | +| `searchapi-search` | `searchapi` | SearchAPI | Search | [link](https://www.searchapi.io/docs) | API key from SearchAPI (query param or Bearer auth) | +| `searxng-search` | `searxng` | SearXNG Search | Search | [link](https://docs.searxng.org) | API key is optional. Set your SearXNG base URL. Some instances may require a bearer token for access. | +| `serper-search` | `serper-search` | Serper Search | Search | [link](https://serper.dev) | API key from serper.dev dashboard | +| `tavily-search` | `tavily-search` | Tavily Search | Search | [link](https://tavily.com) | API key from app.tavily.com (format: tvly-...) | +| `youcom-search` | `youcom-search` | You.com Search | Search | [link](https://you.com/docs/search/overview) | X-API-Key from the You.com platform dashboard | + +## Audio-only Providers (7) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------ | ---------- | ---------- | ----- | ------------------------------------- | ----------------------------------------------------------------------------------------------- | +| `assemblyai` | `aai` | AssemblyAI | Audio | [link](https://assemblyai.com) | — | +| `aws-polly` | `polly` | AWS Polly | Audio | [link](https://aws.amazon.com/polly/) | Use AWS Secret Access Key as API key; set providerSpecificData.accessKeyId and optional region. | +| `cartesia` | `cartesia` | Cartesia | Audio | [link](https://cartesia.ai) | — | +| `deepgram` | `dg` | Deepgram | Audio | [link](https://deepgram.com) | — | +| `elevenlabs` | `el` | ElevenLabs | Audio | [link](https://elevenlabs.io) | — | +| `inworld` | `inworld` | Inworld | Audio | [link](https://inworld.ai) | — | +| `playht` | `playht` | PlayHT | Audio | [link](https://play.ht) | — | + +## Upstream Proxy Providers (1) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------- | ----- | ----------- | -------------- | ---------------------------------------------------- | ----- | +| `cliproxyapi` | `cpa` | CLIProxyAPI | Upstream proxy | [link](https://github.com/router-for-me/CLIProxyAPI) | — | + +## Cloud Agent Providers (3) + +| ID | Alias | Name | Tags | Website | Notes | +| ------------- | ------------- | ------------ | ----------- | -------------------------------- | ----------------------------------------------------------- | +| `codex-cloud` | `codex-cloud` | Codex Cloud | Cloud agent | [link](https://openai.com/codex) | OpenAI API key with Codex Cloud task access. | +| `devin` | `devin` | Devin | Cloud agent | [link](https://devin.ai) | Devin API key for cloud agent sessions. | +| `jules` | `jules` | Google Jules | Cloud agent | [link](https://jules.google) | Jules API key for creating and managing cloud coding tasks. | + +## System Providers (1) + +| ID | Alias | Name | Tags | Website | Notes | +| ------ | ------ | ------------------ | ------ | ------- | ----- | +| `auto` | `auto` | Auto (Zero-Config) | System | — | — | + +## Sources of truth + +- Catalog: [`src/shared/constants/providers.ts`](../../src/shared/constants/providers.ts) +- Registry (per-model details): [`open-sse/config/providerRegistry.ts`](../../open-sse/config/providerRegistry.ts) +- Executors: [`open-sse/executors/`](../../open-sse/executors/) (31 files) +- Translators: [`open-sse/translator/`](../../open-sse/translator/) + +## See Also + +- [FREE_TIERS.md](./FREE_TIERS.md) — curated free-tier guide +- [USER_GUIDE.md](../guides/USER_GUIDE.md) — provider setup walkthrough +- [ARCHITECTURE.md](../architecture/ARCHITECTURE.md) — overall architecture diff --git a/docs/openapi.yaml b/docs/reference/openapi.yaml similarity index 91% rename from docs/openapi.yaml rename to docs/reference/openapi.yaml index 8e16c6a587..4f43468f53 100644 --- a/docs/openapi.yaml +++ b/docs/reference/openapi.yaml @@ -432,6 +432,38 @@ paths: items: $ref: "#/components/schemas/Model" + /api/v1/providers/{provider}/models: + get: + tags: [Models] + summary: List models for a specific provider + description: Returns only models for the selected provider with provider prefix removed from each model id. + security: + - BearerAuth: [] + parameters: + - in: path + name: provider + required: true + schema: + type: string + description: Provider id or alias (for example `openai`, `claude`, `cc`). + responses: + "200": + description: Provider-scoped model list + content: + application/json: + schema: + type: object + properties: + object: + type: string + example: list + data: + type: array + items: + $ref: "#/components/schemas/Model" + "400": + description: Unknown provider + /api/models: get: tags: [Models] @@ -1401,22 +1433,6 @@ paths: "200": description: Translation history entries - /api/translator/load: - get: - tags: [Translator] - summary: Load saved translation template - responses: - "200": - description: Template data - - /api/translator/save: - post: - tags: [Translator] - summary: Save translation template - responses: - "200": - description: Template saved - # ─── CLI Tools ───────────────────────────────────────────────── /api/cli-tools/backups: @@ -2237,6 +2253,73 @@ paths: "200": description: Generated content + # ─── OpenAPI Spec ────────────────────────────────────────────── + + /api/openapi/spec: + get: + tags: [System] + summary: Get OpenAPI specification catalog + description: >- + Returns a structured JSON catalog parsed from this `openapi.yaml`, + including info, servers, tags, schemas, and a flat list of endpoints + (method, path, tags, summary, security, parameters, responses). + Used by the in-app API explorer. + responses: + "200": + description: Parsed OpenAPI catalog + content: + application/json: + schema: + type: object + properties: + info: + type: object + servers: + type: array + items: + type: object + tags: + type: array + items: + type: object + endpoints: + type: array + items: + type: object + properties: + method: + type: string + path: + type: string + tags: + type: array + items: + type: string + summary: + type: string + description: + type: string + security: + type: boolean + parameters: + type: array + items: + type: object + requestBody: + type: boolean + responses: + type: array + items: + type: string + schemas: + type: array + items: + type: string + "404": + description: openapi.yaml file not found on disk + "500": + description: Failed to parse OpenAPI spec + components: securitySchemes: BearerAuth: @@ -2444,13 +2527,35 @@ components: type: array items: type: object - required: [role, content] + required: [role] properties: role: type: string - enum: [system, user, assistant] + description: >- + Message role. The proxy accepts any non-empty string; common values + include system, user, assistant, tool, function, and developer. + example: user content: + description: >- + Message content. May be a plain string, an array of content parts + for multimodal inputs (text, image, audio, etc.), or null when the + message only carries tool/function calls. + oneOf: + - type: string + - type: array + items: + type: object + - type: "null" + name: type: string + tool_call_id: + type: string + tool_calls: + type: array + items: + type: object + function_call: + type: object stream: type: boolean default: false @@ -2460,6 +2565,65 @@ components: maximum: 2 max_tokens: type: integer + top_p: + type: number + minimum: 0 + maximum: 1 + n: + type: integer + minimum: 1 + default: 1 + stop: + description: Up to 4 stop sequences (string or array of strings). + oneOf: + - type: string + - type: array + items: + type: string + maxItems: 4 + frequency_penalty: + type: number + minimum: -2 + maximum: 2 + presence_penalty: + type: number + minimum: -2 + maximum: 2 + seed: + type: integer + logprobs: + type: boolean + top_logprobs: + type: integer + minimum: 0 + maximum: 20 + response_format: + type: object + description: Output format constraint (e.g. JSON mode or JSON Schema). + properties: + type: + type: string + example: json_object + tools: + type: array + description: Tool definitions available to the model. + items: + type: object + tool_choice: + description: Controls which tool (if any) is invoked by the model. + oneOf: + - type: string + example: auto + - type: object + parallel_tool_calls: + type: boolean + default: true + service_tier: + type: string + example: auto + user: + type: string + description: Stable end-user identifier for abuse monitoring. ChatCompletionResponse: type: object @@ -2605,7 +2769,21 @@ components: type: string strategy: type: string - enum: [priority, weighted, round-robin, random, least-used, cost-optimized] + enum: + - priority + - weighted + - round-robin + - context-relay + - fill-first + - p2c + - random + - least-used + - cost-optimized + - reset-aware + - strict-random + - auto + - lkgp + - context-optimized default: priority nodes: type: array diff --git a/docs/routing/AUTO-COMBO.md b/docs/routing/AUTO-COMBO.md new file mode 100644 index 0000000000..eb12811af1 --- /dev/null +++ b/docs/routing/AUTO-COMBO.md @@ -0,0 +1,221 @@ +--- +title: "OmniRoute Auto-Combo Engine" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# OmniRoute Auto-Combo Engine + +> Self-managing model chains with adaptive scoring + zero-config auto-routing + +## Zero-Config Auto-Routing (`auto/` prefix) + +> **NEW:** No combo creation required. Use `auto/` prefix directly in any client. + +### Quick Examples + +| Model ID | Variant | Behavior | +| -------------- | ------- | ------------------------------------------------------------------------ | +| `auto` | default | All connected providers, LKGP strategy, balanced weights | +| `auto/coding` | coding | Quality-first weights, suitable for code generation | +| `auto/fast` | fast | Low-latency weighted selection | +| `auto/cheap` | cheap | Cost-optimized routing (lowest cost first) | +| `auto/offline` | offline | Favors providers with highest quota availability | +| `auto/smart` | smart | Quality-first + higher exploration rate (10%) for better model discovery | +| `auto/lkgp` | lkgp | Explicit LKGP (same as default `auto`) | + +**How to use:** + +```bash +# Any IDE or CLI tool that supports OpenAI format +Base URL: http://localhost:20128/v1 +API Key: <your-endpoint-key> + +# In your code/config, set model to: +model: "auto" # balanced default +model: "auto/coding" # best for coding tasks +model: "auto/fast" # fastest available +model: "auto/cheap" # cheapest per token +``` + +**What happens:** + +1. OmniRoute detects `auto/` prefix in `src/sse/handlers/chat.ts` +2. Queries all **active provider connections** from the database +3. Filters to those with valid credentials (API key or OAuth token) +4. Determines the model per connection (`connection.defaultModel` or provider's first model) +5. Builds a **virtual combo** in-memory (not stored in DB) +6. Routes using the selected variant's weight profile + LKGP strategy + +**Key properties:** + +- ✅ **Always-on:** No toggle, no combo creation, no configuration needed +- ✅ **Dynamic:** Reflects current connected providers automatically +- ✅ **Session stickiness:** LKGP ensures last successful provider is prioritized +- ✅ **Multi-account aware:** Each provider connection becomes a separate candidate +- ✅ **No DB writes:** Virtual combo exists only for the request, zero persistence overhead + +**Behind the scenes:** + +```txt +Request: { model: "auto/coding" } + ↓ +src/sse/handlers/chat.ts detects prefix + ↓ +createVirtualAutoCombo('coding') → candidatePool from active connections + ↓ +handleComboChat (same engine as persisted combos) + ↓ +Auto-scoring selects best provider/model per request +``` + +**Implementation files:** + +| File | Purpose | +| --------------------------------------------------------- | ----------------------------------------- | +| `open-sse/services/autoCombo/autoPrefix.ts` | Prefix parser (`parseAutoPrefix`) | +| `open-sse/services/autoCombo/virtualFactory.ts` | Creates virtual `AutoComboConfig` objects | +| `open-sse/services/autoCombo/providerRegistryAccessor.ts` | Test hook for mocking provider registry | +| `src/sse/handlers/chat.ts` | Integration: auto prefix short-circuit | +| `src/shared/constants/providers.ts` | `SYSTEM_PROVIDERS.auto` system entry | + +## How It Works (Persisted Auto-Combos) + +The Auto-Combo Engine dynamically selects the best provider/model for each request using a **9-factor scoring function** (defined in `open-sse/services/autoCombo/scoring.ts` → `DEFAULT_WEIGHTS`). All weights sum to **1.0**. + +![Auto-Combo 9-factor scoring](../diagrams/exported/auto-combo-9factor.svg) + +> Source: [diagrams/auto-combo-9factor.mmd](../diagrams/auto-combo-9factor.mmd) + +| Factor | Default Weight | Description | +| :----------------- | :------------- | :---------------------------------------------------------------------- | +| `health` | 0.22 | Health score from circuit breaker (CLOSED=1.0, HALF_OPEN=0.5, OPEN=0.0) | +| `quota` | 0.17 | Remaining quota / rate-limit headroom [0..1] | +| `costInv` | 0.17 | Inverse cost normalized to pool — cheaper = higher score | +| `latencyInv` | 0.13 | Inverse p95 latency normalized to pool — faster = higher score | +| `taskFit` | 0.08 | Task-type fitness (coding, review, planning, analysis, debugging, docs) | +| `specificityMatch` | 0.08 | Match between request specificity (manifest hint) and model tier | +| `stability` | 0.05 | Variance-based stability (low latency stdDev / error rate) | +| `tierPriority` | 0.05 | Account-tier priority — Ultra=1.0, Pro=0.67, Standard=0.33, Free=0.0 | +| `tierAffinity` | 0.05 | Affinity between the candidate's tier and the manifest-recommended tier | + +**Sum:** `0.22 + 0.17 + 0.17 + 0.13 + 0.08 + 0.08 + 0.05 + 0.05 + 0.05 = 1.0` (validated by `validateWeights()`). + +## Mode Packs + +Four pre-defined weight profiles in `open-sse/services/autoCombo/modePacks.ts`. Each pack overrides the default weights to bias selection toward a specific goal. Below are the **full weight tables per pack** (each row sums to 1.0). + +| Factor | ship-fast | cost-saver | quality-first | offline-friendly | +| :----------- | :-------- | :--------- | :------------ | :--------------- | +| quota | 0.15 | 0.15 | 0.10 | **0.40** | +| health | 0.30 | 0.20 | 0.20 | 0.30 | +| costInv | 0.05 | **0.40** | 0.05 | 0.10 | +| latencyInv | **0.35** | 0.05 | 0.05 | 0.05 | +| taskFit | 0.10 | 0.10 | **0.40** | 0.00 | +| stability | 0.00 | 0.05 | 0.15 | 0.10 | +| tierPriority | 0.05 | 0.05 | 0.05 | 0.05 | + +Notes: + +- `tierAffinity` and `specificityMatch` are not set in mode packs — `calculateScore()` treats them as `?? 0` when absent. +- Each pack's emphasis at a glance: + - **ship-fast** → latencyInv 0.35 + health 0.30 (low-latency, healthy connections) + - **cost-saver** → costInv 0.40 (cheapest tokens win) + - **quality-first** → taskFit 0.40 + stability 0.15 (best model for the task, consistent) + - **offline-friendly** → quota 0.40 + health 0.30 (max headroom regardless of speed/cost) + +## All Routing Strategies + +OmniRoute's combo engine supports **14 routing strategies** (declared in `src/shared/constants/routingStrategies.ts` → `ROUTING_STRATEGY_VALUES`). The Auto Combo engine itself is exposed under the `auto` strategy; the others are available for persisted combos. + +| Strategy | Description | +| :------------------ | :----------------------------------------------------------------- | +| `priority` | First-target ordered list with explicit priority | +| `weighted` | Weighted random by per-target weight | +| `round-robin` | Cycle through targets in order | +| `context-relay` | Hand off context across targets (long conversations) | +| `fill-first` | Fill each target's quota before moving to next | +| `p2c` | Power-of-2-choices random load balancing | +| `random` | Uniform random selection | +| `least-used` | Pick target with lowest current load | +| `cost-optimized` | Minimize $ per request given catalog pricing | +| `reset-aware` ⭐ | Prioritize by quota reset time — short reset windows ranked higher | +| `strict-random` | Random without deduplication of repeats | +| `auto` | Use Auto Combo scoring (9-factor) — **recommended** | +| `lkgp` | Last-Known-Good Path (sticky route to last successful target) | +| `context-optimized` | Pick target with best fit for current context size | + +⭐ = New in v3.8.0 + +## Virtual Auto-Combo Factory + +The Auto Combo engine doesn't require pre-defined combos. Instead, `open-sse/services/autoCombo/virtualFactory.ts` builds candidates on-the-fly: + +1. Pulls `getProviderConnections({ isActive: true })` (all enabled connections) +2. Filters to those with valid credentials (API key or non-expired OAuth token via `hasUsableOAuthToken()`) +3. Cross-references with `getProviderRegistry()` for model availability + pricing +4. For each tuple `(provider, model, connection)`, builds a `VirtualAutoComboCandidate` +5. Picks `connection.defaultModel` (or the registry's first model) as the dispatch target +6. Scores each candidate using the 9-factor `scorePool()` and the variant's weight pack +7. Returns the resulting in-memory `AutoComboConfig` for `handleComboChat()` — never persisted to DB + +This means **adding a new provider with `auto/*` enabled automatically expands the candidate pool** — no manual combo editing needed. The virtual combo is rebuilt per request, so newly-added or newly-healthy connections are picked up immediately. + +## Self-Healing + +- **Temporary exclusion**: Score < 0.2 → excluded for 5 min (progressive backoff, max 30 min) +- **Circuit breaker awareness**: OPEN → auto-excluded; HALF_OPEN → probe requests +- **Incident mode**: >50% OPEN → disable exploration, maximize stability +- **Cooldown recovery**: After exclusion, first request is a "probe" with reduced timeout + +## Bandit Exploration + +5% of requests (configurable) are routed to random providers for exploration. Disabled in incident mode. + +## API + +There is **no dedicated `POST /api/combos/auto` endpoint** — Auto-Combo is consumed in two ways: + +1. **Zero-config (recommended):** Send any chat completion request with `model: "auto"` or `model: "auto/<variant>"`. The virtual factory builds the combo per request — no persistence, no API calls needed. + +2. **Persisted combo with `strategy: "auto"`:** Create a regular combo via `POST /api/combos` and set `strategy: "auto"` plus `config.auto.weights` / `config.auto.candidatePool`. The same scoring engine is used; the combo is stored in `combos` and reusable by ID. + +```bash +# Zero-config usage (no combo creation) +curl -X POST http://localhost:20128/v1/chat/completions \ + -H "Authorization: Bearer <key>" \ + -H "Content-Type: application/json" \ + -d '{"model":"auto/coding","messages":[{"role":"user","content":"Hello"}]}' + +# Persisted auto combo via the regular combos endpoint +curl -X POST http://localhost:20128/api/combos \ + -H "Content-Type: application/json" \ + -d '{"id":"my-auto","name":"Auto Coder","strategy":"auto","config":{"auto":{"candidatePool":["anthropic","google","openai"],"weights":{"quota":0.15,"health":0.3,"costInv":0.05,"latencyInv":0.35,"taskFit":0.1,"stability":0,"tierPriority":0.05}}}}' +``` + +## Task Fitness + +30+ models scored across 6 task types (`coding`, `review`, `planning`, `analysis`, `debugging`, `documentation`). Supports wildcard patterns (e.g., `*-coder` → high coding score). + +## Auto Variants Recap + +Including the bare `auto` (default) plus the 6 `AutoVariant` values declared in `autoPrefix.ts`, there are **7 invokable model IDs**: + +`auto`, `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp` + +(`AutoVariant` itself enumerates 6 values; the 7th option is "no variant" — bare `auto` — handled by `parseAutoPrefix()` as `variant: undefined`.) + +## Files + +| File | Purpose | +| :-------------------------------------------------------- | :------------------------------------------------------------------------- | +| `open-sse/services/autoCombo/scoring.ts` | 9-factor scoring function, `DEFAULT_WEIGHTS`, pool norm | +| `open-sse/services/autoCombo/taskFitness.ts` | Model × task fitness lookup | +| `open-sse/services/autoCombo/engine.ts` | Selection logic, bandit, budget cap | +| `open-sse/services/autoCombo/selfHealing.ts` | Exclusion, probes, incident mode | +| `open-sse/services/autoCombo/modePacks.ts` | 4 weight profiles (ship-fast, cost-saver, quality-first, offline-friendly) | +| `open-sse/services/autoCombo/autoPrefix.ts` | `auto/` prefix parser + 6 variants | +| `open-sse/services/autoCombo/virtualFactory.ts` | Builds in-memory `AutoComboConfig` from live connections | +| `open-sse/services/autoCombo/providerRegistryAccessor.ts` | Test hook for mocking provider registry | +| `src/shared/constants/routingStrategies.ts` | `ROUTING_STRATEGY_VALUES` (14 strategies) | +| `src/sse/handlers/chat.ts` | Integration: auto-prefix short-circuit | diff --git a/docs/routing/REASONING_REPLAY.md b/docs/routing/REASONING_REPLAY.md new file mode 100644 index 0000000000..adefd7983a --- /dev/null +++ b/docs/routing/REASONING_REPLAY.md @@ -0,0 +1,165 @@ +--- +title: "Reasoning Replay Cache" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Reasoning Replay Cache + +> **Source of truth:** `src/lib/db/reasoningCache.ts`, `open-sse/services/reasoningCache.ts` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute captures assistant `reasoning_content` produced by thinking-mode models and replays it transparently on multi-turn requests when the upstream provider requires it. This eliminates the HTTP 400 errors that strict providers raise when a client's conversation history is missing the prior turn's reasoning. + +## Why This Exists + +Several thinking-mode providers reject a follow-up turn unless the **previous assistant message includes the original `reasoning_content`**. The upstream returns 400 with messages like: + +``` +Param Incorrect: The reasoning_content in the thinking mode must be passed back to the API. +``` + +But typical clients (Cursor, Cline, Roo Code, OpenAI SDK) strip `reasoning_content` from the history they replay. OmniRoute restores it from a server-side cache so the request the upstream sees is consistent. Issue #1628 introduced the hybrid memory/SQLite persistence so the cache survives process restarts. + +## Architecture + +``` +Turn N (assistant generates): + → response contains reasoning_content + tool_calls + → cacheReasoningFromAssistantMessage() writes (memory + DB), keyed by every tool_call.id + → forward response to client (which may or may not retain reasoning) + +Turn N+1 (client sends follow-up): + → translator detects: requiresReasoningReplay(provider, model) === true + → for each assistant message with tool_calls and no reasoning_content: + lookupReasoning(toolCalls[0].id) → memory → DB + hit → msg.reasoning_content = cached; recordReplay() + miss → msg.reasoning_content = "" (legacy fallback for older DeepSeek) + → upstream sees consistent history → no 400 +``` + +Capture happens in `open-sse/handlers/chatCore.ts` (two sites, around lines 4093 and 4380). Replay happens in `open-sse/translator/index.ts` after schema coercion but before dispatch. + +## Storage — Hybrid Memory + SQLite + +The hot path uses an in-memory `Map` (LRU-by-creation) backed by a SQLite table for crash recovery and dashboard visibility. + +| Layer | Implementation | Purpose | +| ------ | ---------------------------------------------- | -------------------------------------- | +| Memory | `Map` in `open-sse/services/reasoningCache.ts` | Fast lookups, evicts oldest at 2000 | +| DB | `reasoning_cache` table (`src/lib/db/`) | Persists across restarts, drives stats | + +Writes go to both. Reads consult memory first, then fall back to DB (DB hits are promoted back into memory). DB failures are non-fatal — the in-memory cache continues to serve the hot path. + +**Defaults:** + +- TTL: `2h` (`TTL_MS = 2 * 60 * 60 * 1000`) +- Max memory entries: `2000` (`MAX_MEMORY_ENTRIES`) +- Eviction: oldest `createdAt` first + +## Database Schema + +Migration: `src/lib/db/migrations/033_create_reasoning_cache.sql` + +```sql +CREATE TABLE IF NOT EXISTS reasoning_cache ( + tool_call_id TEXT PRIMARY KEY, + provider TEXT NOT NULL, + model TEXT NOT NULL, + reasoning TEXT NOT NULL, + char_count INTEGER NOT NULL DEFAULT 0, + created_at TEXT NOT NULL DEFAULT (datetime('now')), + expires_at INTEGER NOT NULL +); +``` + +Indexes: `expires_at`, `provider`, `model`, `created_at`. `expires_at` is stored as Unix epoch seconds; the SELECT layer normalizes legacy text values via `EXPIRES_AT_EPOCH_SQL`. + +## Provider / Model Detection + +Replay is enabled when `requiresReasoningReplay(provider, model)` returns `true`. The function checks two lists in `open-sse/services/reasoningCache.ts`. + +**Provider IDs (exact match, case-insensitive):** + +- `deepseek` +- `opencode-go` +- `siliconflow` +- `nebius` +- `deepinfra` +- `sambanova` +- `fireworks` +- `together` +- `xiaomi-mimo` + +**Model regex patterns (case-insensitive):** + +- `/deepseek-r1/i` +- `/deepseek-reasoner/i` +- `/deepseek-chat/i` +- `/kimi-k2/i` +- `/qwq/i` +- `/qwen.*think/i` +- `/glm.*think/i` +- `/^mimo[-.]?v\d/i` + +Adding a new strict provider/model means appending to one of these lists and writing a unit test asserting replay injection. The PR description should cite the exact upstream 400 string that motivated the change. + +## REST API + +The cache exposes two endpoints under `src/app/api/cache/reasoning/route.ts`. Both require management authentication (`isAuthenticated` from `@/shared/utils/apiAuth`). + +| Method | Endpoint | Description | +| ------ | --------------------------------------------------------- | -------------------------------------------------------- | +| GET | `/api/cache/reasoning` | Stats + paginated entries | +| GET | `/api/cache/reasoning?provider=deepseek&model=...&limit=` | Filtered listing (`limit` clamped to `[1, 200]`) | +| DELETE | `/api/cache/reasoning` | Clear everything (memory + DB) and reset hit/miss counts | +| DELETE | `/api/cache/reasoning?provider=deepseek` | Clear only entries for one provider | +| DELETE | `/api/cache/reasoning?toolCallId=call_abc` | Delete a single entry | + +**GET response shape:** + +```json +{ + "stats": { + "memoryEntries": 12, + "dbEntries": 47, + "totalEntries": 47, + "totalChars": 138291, + "hits": 84, + "misses": 6, + "replays": 81, + "replayRate": "90.0%", + "byProvider": { "deepseek": { "entries": 32, "chars": 98412 } }, + "byModel": { "deepseek-reasoner": { "entries": 32, "chars": 98412 } }, + "oldestEntry": "2026-05-13T10:00:00.000Z", + "newestEntry": "2026-05-13T11:42:11.000Z" + }, + "entries": [ + { + "toolCallId": "call_abc", + "provider": "deepseek", + "model": "deepseek-reasoner", + "reasoning": "...", + "charCount": 3128, + "createdAt": "...", + "expiresAt": "..." + } + ] +} +``` + +## Operational Notes + +- **Cleanup:** `cleanupReasoningCache()` purges expired memory entries and runs `DELETE FROM reasoning_cache WHERE expires_at <= unixepoch('now')`. Health-check workers call this periodically. +- **Crash recovery:** After a restart, memory is empty but the DB still holds unexpired entries. The first lookup for a given `tool_call_id` is a DB hit; subsequent lookups are memory hits. +- **No reasoning, no cache:** `cacheReasoningFromAssistantMessage` returns `0` when the assistant message has no `reasoning_content` / `reasoning` field, so non-thinking responses cost nothing. +- **Non-strict providers:** When `requiresReasoningReplay` is `false` and the target format is OpenAI, the translator **strips** any `reasoning_content` field from outgoing messages — OpenAI Chat Completions does not accept it. + +## See Also + +- [RESILIENCE_GUIDE.md](../architecture/RESILIENCE_GUIDE.md) — circuit breakers, cooldowns, model lockouts +- [TROUBLESHOOTING.md](../guides/TROUBLESHOOTING.md) — diagnosing upstream 400s +- Source: `src/lib/db/reasoningCache.ts`, `open-sse/services/reasoningCache.ts`, `open-sse/translator/index.ts` +- Migration: `src/lib/db/migrations/033_create_reasoning_cache.sql` +- API route: `src/app/api/cache/reasoning/route.ts` +- Original issue: #1628 diff --git a/docs/screenshots/10-providers-aitradepulse.png b/docs/screenshots/10-providers-aitradepulse.png new file mode 100644 index 0000000000..f0f6324d2b Binary files /dev/null and b/docs/screenshots/10-providers-aitradepulse.png differ diff --git a/docs/screenshots/11-combos-aitradepulse.png b/docs/screenshots/11-combos-aitradepulse.png new file mode 100644 index 0000000000..ded3f6a9e6 Binary files /dev/null and b/docs/screenshots/11-combos-aitradepulse.png differ diff --git a/docs/screenshots/ai-aitradepulse-dashboard.png b/docs/screenshots/ai-aitradepulse-dashboard.png new file mode 100644 index 0000000000..5dac9818a5 Binary files /dev/null and b/docs/screenshots/ai-aitradepulse-dashboard.png differ diff --git a/docs/security/COMPLIANCE.md b/docs/security/COMPLIANCE.md new file mode 100644 index 0000000000..ce4c631f0a --- /dev/null +++ b/docs/security/COMPLIANCE.md @@ -0,0 +1,230 @@ +--- +title: "Compliance & Audit" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Compliance & Audit + +> **Source of truth:** `src/lib/compliance/`, `src/app/api/compliance/` +> **Last updated:** 2026-05-13 — v3.8.0 + +OmniRoute records administrative actions, authentication events, provider +credential lifecycle changes, and MCP tool invocations to SQLite-backed audit +tables. This page covers what gets logged, where it lives, how long it is +retained, how API keys can opt out, and how to query the data. + +The implementation lives in `src/lib/compliance/index.ts` (T-43 — "Compliance +Controls") and `src/lib/compliance/providerAudit.ts`. Audit writes never throw: +on any failure the call is silently swallowed so audit logging cannot break the +main request flow. + +## What Gets Logged + +### Administrative audit events (`audit_log`) + +Every call to `logAuditEvent({ action, actor, target, details, ... })` produces +one row. Action strings follow a `domain.verb` (or `domain.verb.outcome`) +pattern. Confirmed in-tree action types include: + +| Action | Source | +| ------------------------------------ | --------------------------------------- | +| `auth.login.success` | `src/app/api/auth/login/route.ts` | +| `auth.login.failed` | `src/app/api/auth/login/route.ts` | +| `auth.login.locked` | `src/app/api/auth/login/route.ts` | +| `auth.login.error` | `src/app/api/auth/login/route.ts` | +| `auth.login.misconfigured` | `src/app/api/auth/login/route.ts` | +| `auth.login.setup_required` | `src/app/api/auth/login/route.ts` | +| `auth.logout.success` | `src/app/api/auth/logout/route.ts` | +| `provider.credentials.created` | `src/app/api/providers/route.ts` | +| `provider.credentials.updated` | `src/app/api/providers/[id]/route.ts` | +| `provider.credentials.revoked` | `src/app/api/providers/[id]/route.ts` | +| `provider.credentials.batch_revoked` | `src/app/api/providers/route.ts` | +| `sync.token.created` | `src/app/api/sync/tokens/route.ts` | +| `sync.token.revoked` | `src/app/api/sync/tokens/[id]/route.ts` | +| `compliance.cleanup` | `src/lib/compliance/index.ts` | + +Each entry captures `action`, `actor` (defaults to `"system"`), `target`, +`details`/`metadata` (JSON), `ip_address`, `resource_type`, `status`, +`request_id`, and `timestamp`. Sensitive keys (`apiKey`, `accessToken`, +`refreshToken`, `password`, anything matching `*token`/`*secret`/`*apikey`, +etc.) are recursively redacted to `"[redacted]"` before the row is written. + +### MCP tool calls (`mcp_tool_audit`) + +Every MCP tool invocation writes a row through +`open-sse/mcp-server/audit.ts`. Schema (from +`src/lib/db/migrations/002_mcp_a2a_tables.sql`): + +| Column | Notes | +| ---------------- | ----------------------------------- | +| `id` | autoincrement | +| `tool_name` | MCP tool identifier | +| `input_hash` | sha256 of input (no payload stored) | +| `output_summary` | short, truncated summary | +| `duration_ms` | wall time | +| `api_key_id` | caller (nullable) | +| `success` | `1` / `0` | +| `error_code` | terminal error code on failure | +| `created_at` | ISO timestamp | + +### Request / usage logs + +These are operational telemetry (not strictly admin audit) but share the same +retention pipeline: + +- `usage_history` — per-request usage roll-up +- `call_logs` — full per-request log (subject to row-cap, see below) +- `proxy_logs` — proxy traffic log (subject to row-cap) +- `request_detail_logs` — legacy detailed request log (still pruned if present) + +## Storage Schema + +`audit_log` is created lazily by `ensureAuditLogSchema()` on first use: + +```sql +CREATE TABLE IF NOT EXISTS audit_log ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + timestamp TEXT NOT NULL DEFAULT (datetime('now')), + action TEXT NOT NULL, + actor TEXT NOT NULL DEFAULT 'system', + target TEXT, + details TEXT, + ip_address TEXT, + resource_type TEXT, + status TEXT, + request_id TEXT, + metadata TEXT +); +``` + +Indexes are created on `timestamp`, `action`, `actor`, `resource_type`, +`status`, and `request_id`. Missing columns on legacy DBs are added via +`ALTER TABLE` on demand. + +## Retention & Cleanup + +Two separate retention windows are honoured: + +| Env var | Default | Applies to | +| --------------------------- | -------- | ----------------------------------------------------------------- | +| `APP_LOG_RETENTION_DAYS` | `7` | `audit_log`, `mcp_tool_audit` | +| `CALL_LOG_RETENTION_DAYS` | `7` | `usage_history`, `call_logs`, `proxy_logs`, `request_detail_logs` | +| `CALL_LOGS_TABLE_MAX_ROWS` | `100000` | Row-cap trim for `call_logs` | +| `PROXY_LOGS_TABLE_MAX_ROWS` | `100000` | Row-cap trim for `proxy_logs` | + +`cleanupExpiredLogs()` runs the retention pass. It is invoked on server startup +from `src/server-init.ts` and `src/instrumentation-node.ts`. Each run logs a +`compliance.cleanup` audit event with the per-table delete counts. Proxy/call +log trimming is batched (`BATCH_SIZE = 5000`) to avoid long write locks. + +Defaults are defined in `src/lib/logEnv.ts` +(`DEFAULT_APP_LOG_RETENTION_DAYS = 7`, `DEFAULT_CALL_LOG_RETENTION_DAYS = 7`). + +## `noLog` Opt-Out (per API key) + +API keys can be flagged so their downstream call traffic is not logged. The +flag lives on the `api_keys` table (`no_log INTEGER DEFAULT 0`) and is mirrored +into an in-memory set for hot-path lookups. + +```bash +# Create a no-log key (management auth required) +curl -X POST http://localhost:20128/api/keys \ + -H "Cookie: auth_token=..." \ + -H "Content-Type: application/json" \ + -d '{"name": "Privacy key", "noLog": true}' +``` + +Helpers (`src/lib/compliance/index.ts`): + +- `setNoLog(apiKeyId, true|false)` — toggle the in-memory entry +- `isNoLog(apiKeyId)` — checked on the request path; falls back to a 30 s + cached read from `api_keys.no_log` +- `NO_LOG_API_KEY_IDS` (env, comma-separated) — preloaded into the in-memory + set on boot; useful when you cannot toggle the column directly + +Administrative audit events (login, provider changes, MCP tool calls, etc.) +are **not** affected by `noLog` — only per-request traffic logging is opted +out. + +## REST API + +| Endpoint | Method | Description | Auth | +| --------------------------- | ------ | ------------------------------------------ | ---------- | +| `/api/compliance/audit-log` | `GET` | Paginated admin audit entries with filters | management | +| `/api/mcp/audit` | `GET` | Paginated MCP tool audit entries | (open-sse) | +| `/api/mcp/audit/stats` | `GET` | Aggregated MCP audit stats | (open-sse) | + +No CSV export endpoint is shipped today — export from the dashboard or query +the SQLite database directly. + +### Querying `/api/compliance/audit-log` + +Supported query params (all optional, all use `LIKE %value%` matching for +text filters): + +- `action`, `actor`, `target`, `resourceType` (or `resource_type`), + `status`, `requestId` (or `request_id`) +- `from` / `since`, `to` / `until` — ISO timestamps +- `limit` (default `50`, min `1`, max `500`) +- `offset` (default `0`, max `10_000`) + +The response is a JSON array. Pagination metadata is returned in headers: +`x-total-count`, `x-page-limit`, `x-page-offset`. + +```bash +curl "http://localhost:20128/api/compliance/audit-log?action=provider.credentials&from=2026-05-01" \ + -H "Cookie: auth_token=..." +``` + +## Dashboard + +The dashboard exposes audit data at **`/dashboard/audit`** +(`src/app/(dashboard)/dashboard/audit/page.tsx`). The page has two tabs: + +- **Compliance** (`ComplianceTab.tsx`) — admin audit events from + `/api/compliance/audit-log`. Filters by event type, severity (info / warning + / critical, derived from action + status), and date range. Severity is + computed client-side from the action/status strings. +- **MCP** (`McpAuditTab.tsx`) — MCP tool audit from `/api/mcp/audit`, with + filters by tool name and success/failure. + +Both tabs paginate with page sizes of `50` (compliance) and `25` (MCP). + +## Provider Credential Helpers + +`src/lib/compliance/providerAudit.ts` provides shaping helpers used by the +provider-management routes when they emit credential events: + +- `summarizeProviderConnectionForAudit(connection)` — strips `apiKey`, + `accessToken`, `refreshToken`, `idToken`, and + `providerSpecificData.consoleApiKey` before the connection snapshot is + written to `details`. +- `getProviderAuditTarget(connection)` — composes a stable + `"<provider>:<name|id>"` string for the `target` field. +- `extractProviderWarnings(...payloads)` — scans provider responses for + policy/safety warnings (`[sanitizer]`, `prompt injection detected`, + `content has been filtered`, `safety filter`, `policy violation`) and + surfaces up to 5 hits, each truncated to 400 chars. + +## Best Practices + +- Flag API keys handling PII (legal, medical, etc.) with `noLog: true`. +- Tune `APP_LOG_RETENTION_DAYS` / `CALL_LOG_RETENTION_DAYS` to meet your + retention policy. The 7-day defaults are conservative. +- Export the audit table off-platform (`sqlite3 dump`) on whatever cadence + your compliance program requires — no built-in archival exists. +- Track `auth.login.failed` and `auth.login.locked` counts for brute-force + detection. +- When adding new admin endpoints, call `logAuditEvent({ ... })` with a stable + `domain.verb.outcome` action string and pass the request context via + `getAuditRequestContext(request)` so IP and `requestId` are captured + automatically. + +## See Also + +- [`docs/security/GUARDRAILS.md`](./GUARDRAILS.md) — PII masking, prompt injection +- [`docs/frameworks/MCP-SERVER.md`](../frameworks/MCP-SERVER.md) — MCP tool catalog and scopes +- [`docs/reference/ENVIRONMENT.md`](../reference/ENVIRONMENT.md) — full env var reference +- Source: `src/lib/compliance/`, `src/app/api/compliance/`, + `src/app/api/mcp/audit/`, `src/lib/logEnv.ts` diff --git a/docs/security/GUARDRAILS.md b/docs/security/GUARDRAILS.md new file mode 100644 index 0000000000..29d6d5a519 --- /dev/null +++ b/docs/security/GUARDRAILS.md @@ -0,0 +1,269 @@ +--- +title: "Guardrails" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Guardrails + +> **Source of truth:** `src/lib/guardrails/` +> **Last updated:** 2026-05-13 — v3.8.0 + +Guardrails enforce safety, policy, and content transformations at the boundary +between OmniRoute and upstream providers. Each guardrail can inspect (and +optionally reject, transform, or annotate) request payloads (`preCall`) and +upstream responses (`postCall`). + +The system is **fail-open**: if a guardrail throws while executing, the registry +records the error and continues with the next guardrail rather than failing the +request. Blocking is an explicit decision (`block: true`), never an accident. + +## Built-in Guardrails + +The registry auto-loads three guardrails in priority order on import +(see `registry.ts` → `registerDefaultGuardrails()`): + +| Priority | Name | Stage(s) | File | +| -------- | ------------------ | -------------- | -------------------- | +| `5` | `vision-bridge` | `preCall` | `visionBridge.ts` | +| `10` | `pii-masker` | `pre` + `post` | `piiMasker.ts` | +| `20` | `prompt-injection` | `preCall` | `promptInjection.ts` | + +Lower priority numbers run **first**. + +### Vision Bridge (`visionBridge.ts`) + +Intercepts image-bearing requests aimed at **non-vision models** and replaces +the image parts with text descriptions produced by a configurable vision model +before the upstream call. This lets text-only providers transparently handle +multimodal payloads. + +Flow: + +1. Skip if the target model already supports vision (unless it appears in the + forced-bridge list `isVisionBridgeForcedModel`). +2. Extract image parts via `extractImageParts(messages)`. Skip if none. +3. Load runtime config from `getSettings()` (`visionBridgeEnabled`, + `visionBridgeModel`, `visionBridgePrompt`, `visionBridgeTimeout`, + `visionBridgeMaxImages`). +4. Cap images at `maxImages`, call the vision model **in parallel** + (`Promise.allSettled`), and inject `[Image N]: <description>` text parts + in their place — failed images become `[Image N]: (unavailable)`. +5. Return `modifiedPayload` + meta (`imagesProcessed`, `processingTimeMs`, + `visionModel`). + +Defaults live in `src/shared/constants/visionBridgeDefaults.ts`. The guardrail +exposes a `deps` constructor option so tests can inject fake `getSettings` and +`callVisionModel` implementations. + +### PII Masker (`piiMasker.ts`) + +Runs on **both** stages. + +- **`preCall`** clones the payload, walks `system`, `messages`, and `input` + arrays, and applies `processPII()` (from `@/shared/utils/inputSanitizer`) to + string `content`/`text` fields. When `PII_REDACTION_ENABLED=true` **and** + `INPUT_SANITIZER_MODE=redact`, detected PII is stripped/redacted in the + outbound payload. Otherwise the call records detection counts without + rewriting content. +- **`postCall`** deep-clones the response, runs `sanitizePIIResponse()` plus + the Responses-API-shape masker (`maskResponsesOutput` — covers + `output_text` and `output[].content[].text`). If any redaction occurs, the + modified response replaces the original. + +The guardrail never blocks; it only annotates (`meta.detections`, +`meta.redacted`) or rewrites. + +### Prompt Injection (`promptInjection.ts`) + +Detects adversarial structures in user-supplied content and enforces the +configured policy. Behavior is driven by environment variables and constructor +options: + +| Setting | Env var | Default | Effect | +| --------------- | ----------------------------------------------- | ------- | --------------------------------------- | +| Enabled | `INPUT_SANITIZER_ENABLED` | `true` | When `false`, guardrail short-circuits. | +| Mode | `INJECTION_GUARD_MODE` / `INPUT_SANITIZER_MODE` | `warn` | `block`, `warn`, or `log`. | +| Block threshold | `blockThreshold` option | `high` | Minimum severity required to block. | + +Detection sources: + +1. `sanitizeRequest()` from `@/shared/utils/inputSanitizer` (shared detector + set used elsewhere in the pipeline). +2. Built-in `DEFAULT_GUARD_PATTERNS` (currently `system_override_inline` and + `markdown_system_block`, both `high` severity). +3. Optional `customPatterns` passed via constructor options (strings, regex, + or `{ name, pattern, severity }` records). + +When `mode === "block"` **and** at least one detection meets the severity +threshold, `preCall` returns `{ block: true, message: "Request rejected: +suspicious content detected" }`. In `warn`/`log` modes the guardrail logs but +allows the call. The shared helper `evaluatePromptInjection()` is also exported +for callers that need to evaluate prompts without going through the registry. + +## Base Contract (`base.ts`) + +```typescript +class BaseGuardrail { + enabled: boolean; + name: string; + priority: number; + + constructor(name: string, options?: { enabled?: boolean; priority?: number }); + + async preCall(payload: unknown, context: GuardrailContext): Promise<GuardrailResult | void>; + + async postCall(response: unknown, context: GuardrailContext): Promise<GuardrailResult | void>; +} + +interface GuardrailResult<TValue = unknown> { + block?: boolean; // true short-circuits the chain + message?: string; // surfaced when blocking + meta?: Record<string, unknown> | null; + modifiedPayload?: TValue; // returned by preCall to rewrite the request + modifiedResponse?: TValue; // returned by postCall to rewrite the response +} + +interface GuardrailContext { + apiKeyInfo?: Record<string, unknown> | null; + disabledGuardrails?: string[] | null; + endpoint?: string | null; + headers?: Headers | Record<string, unknown> | null; + log?: GuardrailLog | Console | null; + method?: string | null; + model?: string | null; + provider?: string | null; + sourceFormat?: string | null; + stream?: boolean; + targetFormat?: string | null; +} +``` + +A guardrail signals "no change" by returning either `void`, `{}`, or +`{ block: false }`. Returning a `modifiedPayload`/`modifiedResponse` replaces +the value flowing through the chain for downstream guardrails. + +## Registry (`registry.ts`) + +The singleton `guardrailRegistry` exposes: + +- `register(guardrail)` — adds (or replaces by normalized name) a guardrail and + re-sorts by ascending `priority`. +- `clear()` / `list()` — administrative helpers. +- `runPreCallHooks(payload, context)` — iterates active guardrails, threads the + payload through `modifiedPayload`, and stops on the first `block: true`. +- `runPostCallHooks(response, context)` — same flow on the response side. +- `resetGuardrailsForTests({ registerDefaults })` — clears state and optionally + re-registers the defaults for clean test isolation. + +Both runners return `{ blocked, payload|response, results, guardrail?, message? }` +where `results` is an array of `GuardrailExecutionResult` records that include +per-guardrail `blocked`, `skipped`, `modified`, `error`, and `meta` fields, +useful for tracing. + +### Disabling Guardrails Per-Request + +`resolveDisabledGuardrails({ apiKeyInfo, body, headers })` aggregates a +de-duplicated list of guardrail names that should be skipped for the current +request. Sources (all optional, all merged): + +- `apiKeyInfo.disabledGuardrails` +- Request body `disabledGuardrails` (top-level) +- Request body `metadata.disabledGuardrails` +- Header `x-omniroute-disabled-guardrails` (or legacy + `x-disabled-guardrails`) + +Values may be arrays of strings or a comma-separated string; names are +normalized to lowercase kebab-case (`pii_masker` → `pii-masker`). The result +is passed through `context.disabledGuardrails` to the registry, which skips +matching guardrails (`skipped: true` in `results`). + +## Execution Order + +For each request flowing through `src/sse/handlers/chat.ts` and +`open-sse/handlers/chatCore.ts`: + +1. `resolveDisabledGuardrails(...)` builds the skip list from API key, body, + and headers. +2. `guardrailRegistry.runPreCallHooks(body, ctx)` runs guardrails in ascending + priority order: + - Disabled guardrails are recorded as `skipped`. + - Each guardrail's `preCall` may rewrite the payload via `modifiedPayload`. + - The first `block: true` short-circuits the chain and the handler returns + a guardrail rejection response. +3. The (potentially rewritten) payload flows into combo routing and upstream + dispatch. +4. After the response is assembled, `guardrailRegistry.runPostCallHooks(...)` + runs the same chain on the response. `block: true` here drops the upstream + response. + +Guardrails that throw are recorded with `error: <message>` and logged via +`logger.warn`, but the chain continues — fail-open by design. + +## Configuration + +Environment variables read by the built-in guardrails: + +| Variable | Used by | Effect | +| ------------------------------------- | -------------------------------- | ----------------------------------------------------- | +| `INPUT_SANITIZER_ENABLED` | `prompt-injection` | Set `false` to disable detection entirely. | +| `INPUT_SANITIZER_MODE` | `prompt-injection`, `pii-masker` | Shared mode: `warn`, `block`, `log`, or `redact`. | +| `INJECTION_GUARD_MODE` | `prompt-injection` | Legacy alias for `INPUT_SANITIZER_MODE`. | +| `PII_REDACTION_ENABLED` | `pii-masker` | When `true` + mode `redact`, request PII is stripped. | +| `PII_RESPONSE_SANITIZATION` / `_MODE` | `pii-masker` (downstream) | Controls response-side masker behavior. | + +The Vision Bridge reads runtime config from the DB-backed settings store +(`getSettings()`), not env vars: `visionBridgeEnabled`, `visionBridgeModel`, +`visionBridgePrompt`, `visionBridgeTimeout`, `visionBridgeMaxImages`. Defaults +live in `src/shared/constants/visionBridgeDefaults.ts`. + +## Custom Guardrails + +```typescript +import { BaseGuardrail, guardrailRegistry } from "@/lib/guardrails"; + +class BudgetGuardrail extends BaseGuardrail { + constructor() { + super("budget", { priority: 50 }); + } + + async preCall(payload, ctx) { + if (ctx.apiKeyInfo?.budgetExceeded) { + return { block: true, message: "Daily budget exceeded" }; + } + return { block: false }; + } +} + +guardrailRegistry.register(new BudgetGuardrail()); +``` + +Steps: + +1. Create `src/lib/guardrails/myGuardrail.ts` extending `BaseGuardrail`. +2. Implement `preCall` and/or `postCall`. +3. Either register at import time (push from `registerDefaultGuardrails`) or + call `guardrailRegistry.register(...)` at runtime — the registry replaces + any prior guardrail with the same normalized name. +4. Add tests under `tests/unit/` (existing examples: + `tests/unit/guardrails-registry.test.ts`, + `tests/unit/prompt-injection-guard.test.ts`, + `tests/unit/guardrails/visionBridge.test.ts`). + +## Testing + +Use `resetGuardrailsForTests()` between tests to start from a known state. +Pass `{ registerDefaults: false }` to start with an empty registry and +register only the guardrails under test. The Vision Bridge guardrail accepts +dependency injection (`deps.getSettings`, `deps.callVisionModel`) so tests can +exercise the full flow without DB or network access. + +## See Also + +- `src/lib/guardrails/` — implementation +- `src/shared/utils/inputSanitizer.ts` — shared detector that powers + prompt-injection and PII masking +- `src/shared/constants/visionBridgeDefaults.ts` — Vision Bridge defaults and + forced-bridge model list +- `docs/architecture/RESILIENCE_GUIDE.md` — orthogonal layer (circuit breaker, cooldowns) +- `docs/reference/ENVIRONMENT.md` — full env var reference diff --git a/docs/security/STEALTH_GUIDE.md b/docs/security/STEALTH_GUIDE.md new file mode 100644 index 0000000000..f814c61b41 --- /dev/null +++ b/docs/security/STEALTH_GUIDE.md @@ -0,0 +1,250 @@ +--- +title: "Stealth Guide" +version: 3.8.0 +lastUpdated: 2026-05-13 +--- + +# Stealth Guide + +> **Source of truth:** `open-sse/utils/tlsClient.ts`, `open-sse/services/{chatgptTlsClient,claudeCodeCCH,claudeCodeFingerprint,claudeCodeObfuscation,claudeCodeCompatible,antigravityObfuscation}.ts`, `open-sse/config/cliFingerprints.ts`, `src/mitm/` +> **Last updated:** 2026-05-13 — v3.8.0 +> **Audience:** Engineers maintaining provider-specific stealth integrations. + +OmniRoute integrates with providers whose edges actively fingerprint non-official clients (TLS JA3/JA4, header ordering, JSON body shape, integrity tokens). This page documents the stealth surfaces OmniRoute exposes and where they are implemented. + +## Legal and Ethical Notice + +Stealth features exist so OmniRoute can act as a compatibility layer between user-owned official accounts (Claude Code CLI, ChatGPT Desktop/Web, Antigravity, Cursor, etc.) and OmniRoute's unified API. They are **not** for evading fraud detection, sharing credentials, or violating provider Terms of Service. The maintainers expect operators to comply with the upstream ToS they signed when creating accounts. + +--- + +## TLS Fingerprinting Layer + +### `open-sse/utils/tlsClient.ts` — wreq-js (Chrome 124) + +Lazy-loaded `wreq-js` session that impersonates **Chrome 124 on macOS**. Used as a generic JA3/JA4 wrapper for upstreams behind Cloudflare. Falls back to native fetch when `wreq-js` is not installed (`available = false`). + +- Singleton session: `browser: "chrome_124", os: "macos"` +- Proxy resolution (priority): `HTTPS_PROXY` → `HTTP_PROXY` → `ALL_PROXY` (also lower-case) +- Timeout: `TLS_CLIENT_TIMEOUT_MS` (inherits from `FETCH_TIMEOUT_MS`, default 600000) +- `wreq-js` Response is fetch-compatible (`headers`, `text()`, `json()`, `clone()`, `body`). + +### `open-sse/services/chatgptTlsClient.ts` — tls-client-node (Firefox 148) + +Dedicated TLS impersonator for `chatgpt.com`. ChatGPT's Cloudflare config pins `cf_clearance` to JA3/JA4 + HTTP/2 SETTINGS frame ordering — undici's handshake gets `cf-mitigated: challenge` even with valid cookies. + +- Profile: `firefox_148` (must match the Firefox 148 `User-Agent` sent) +- Mode: `runtimeMode: "native"` (koffi-loaded shared library; avoids managed sidecar HTTP) +- `withRandomTLSExtensionOrder: true` +- `tlsFetchChatGpt(url, options)` supports streaming (writes body to temp file, tailed as `ReadableStream`) +- Hang detection: `raceWithTimeout` + `TlsClientHangError` triggers `resetClientCache()` so the next call respawns the binding +- Proxy resolution (priority): per-call `proxyUrl` → `OMNIROUTE_TLS_PROXY_URL` → `HTTPS_PROXY`/`HTTP_PROXY`/`ALL_PROXY` (the native binding does **not** read these envs itself; it must be threaded through) +- Errors: `TlsClientUnavailableError` (binary missing), `TlsClientHangError` (binding deadlocked) + +--- + +## Claude Code Stealth Bundle + +When `cliCompatMode` is on, OmniRoute reshapes outgoing Claude requests so they are indistinguishable from `claude-cli` traffic. Three modules collaborate: + +### `claudeCodeFingerprint.ts` + +Computes the 3-char `cc_version` fingerprint embedded in the billing header: + +``` +SHA256(SALT + msg[4] + msg[7] + msg[20] + version)[:3] +``` + +- `FINGERPRINT_SALT = "59cf53e54c78"` (hardcoded; matches official client) +- Inputs: chars at index 4, 7, 20 of the first user message text + version string +- Output: 3-char hex prefix + +### `claudeCodeCCH.ts` (Client Content Hash) + +Server-side integrity check the official Claude Code CLI computes via Bun/Zig. OmniRoute reimplements with `xxhash-wasm`: + +1. Serialize body with `cch=00000;` placeholder +2. `xxhash64(bytes, seed) & 0xFFFFF` +3. Zero-padded 5-char lowercase hex +4. Replace `cch=00000;` with the computed token + +Constants: + +- Seed: `0x6e52736ac806831e` +- Pattern: `/\bcch=([0-9a-f]{5});/` + +### `claudeCodeObfuscation.ts` + +Inserts a Unicode **zero-width joiner** (`U+200D`) after the first character of "sensitive" client names so upstream filters cannot grep them. Default word list: + +``` +opencode, open-code, cline, roo-cline, roo_cline, cursor, windsurf, +aider, continue.dev, copilot, avante, codecompanion +``` + +Applied to: `system` blocks, all `messages[].content`, and `tools[].description` / `tools[].function.description`. Operator-overridable via `setSensitiveWords()`. + +### `claudeCodeCompatible.ts` — `anthropic-compatible-cc-*` providers + +For third-party Anthropic relays that only accept "real Claude Code" traffic: + +- `CLAUDE_CODE_COMPATIBLE_USER_AGENT = "claude-cli/2.1.137 (external, sdk-cli)"` +- `CLAUDE_CODE_COMPATIBLE_STAINLESS_PACKAGE_VERSION = "0.81.0"` +- `CLAUDE_CODE_COMPATIBLE_STAINLESS_RUNTIME_VERSION = "v24.3.0"` +- `anthropic-beta = "claude-code-20250219,interleaved-thinking-2025-05-14,effort-2025-11-24"` +- `CONTEXT_1M_BETA_HEADER = "context-1m-2025-08-07"` (Opus/Sonnet 4.x family) +- Default path: `/v1/messages?beta=true` + +Sister modules in the same bundle: + +- `claudeCodeConstraints.ts` — temperature + cache-control rules +- `claudeCodeToolRemapper.ts` — tool-name remapping +- `claudeCodeExtraRemap.ts` — extra payload normalization + +--- + +## Antigravity Stealth + +### `antigravityObfuscation.ts` + +Same zero-width-joiner trick as Claude Code, but with an expanded word list that also masks: `claude code`, `claude-code`, `kilo code`, `kilocode`, **`omniroute`**. Mirrors ZeroGravity's `ZEROGRAVITY_SENSITIVE_WORDS` and CLIProxyAPI's cloak system. + +### `antigravityHeaderScrub.ts` + +Strips Stainless SDK markers (`x-stainless-lang`, `x-stainless-package-version`, `x-stainless-os`, `x-stainless-arch`, `x-stainless-runtime`, `x-stainless-runtime-version`, `x-stainless-timeout`, `x-stainless-retry-count`, `x-stainless-helper-method`) before forwarding. + +--- + +## CLI Fingerprint Registry — `open-sse/config/cliFingerprints.ts` + +Per-provider table that pins **exact** header ordering and JSON body field ordering captured from mitmproxy traces of the official CLIs. Currently registered: `codex`, `claude`, plus runtime-derived profiles in `providerHeaderProfiles.ts` for `antigravity`, `qwen`, `github`. + +```ts +interface CliFingerprint { + headerOrder: string[]; // case-sensitive + bodyFieldOrder: string[]; // top-level JSON keys + userAgent?: string | (() => string); + extraHeaders?: Record<string, string>; +} +``` + +Toggle per provider via env (see below). When disabled, headers/body keys appear in whatever order Node/JSON gave them — easy to fingerprint. + +--- + +## MITM Proxy (Antigravity, Linux/macOS/Windows) + +For CLIs whose binaries cannot be redirected via `OPENAI_BASE_URL`, OmniRoute runs a local TLS-terminating proxy. Endpoints live under `src/app/api/cli-tools/antigravity-mitm/`. + +| Method | Endpoint | Purpose | +| ------ | --------------------------------------- | ------------------------------------------------ | +| GET | `/api/cli-tools/antigravity-mitm` | Status — running, pid, dnsConfigured, certExists | +| POST | `/api/cli-tools/antigravity-mitm` | Start MITM (requires `apiKey` + `sudoPassword`) | +| DELETE | `/api/cli-tools/antigravity-mitm` | Stop MITM | +| GET | `/api/cli-tools/antigravity-mitm/alias` | List model aliases | +| PUT | `/api/cli-tools/antigravity-mitm/alias` | Save model aliases for a tool | + +Target intercepted host: **`daily-cloudcode-pa.googleapis.com`** (Antigravity's upstream). + +### Start sequence (`src/mitm/manager.ts::startMitm`) + +1. Generate self-signed cert via `selfsigned` (RSA-2048, SHA-256, 1y) — `cert/generate.ts` +2. Install cert to system trust store — `cert/install.ts` +3. Add hosts entry `127.0.0.1 daily-cloudcode-pa.googleapis.com` — `dns/dnsConfig.ts` +4. Spawn `src/mitm/server.cjs` with `ROUTER_API_KEY` + `MITM_LOCAL_PORT` (default `443`) +5. Persist PID to `<DATA_DIR>/mitm/.mitm.pid` + +### Linux dynamic trust-store detection — `cert/install.ts` + +`getLinuxCertConfig()` walks a priority list and picks the first existing directory: + +| Distro family | Directory | Update command | +| ------------------------ | ------------------------------------------- | ------------------------ | +| Debian / Ubuntu | `/usr/local/share/ca-certificates` | `update-ca-certificates` | +| Arch / CachyOS / Manjaro | `/etc/ca-certificates/trust-source/anchors` | `update-ca-trust` | +| Fedora / RHEL / CentOS | `/etc/pki/ca-trust/source/anchors` | `update-ca-trust` | +| openSUSE | `/etc/pki/trust/anchors` | `update-ca-certificates` | + +Cert filename: `omniroute-mitm.crt`. Fingerprint match via `getCertFingerprint()` (SHA-1 of DER). + +Additionally, `updateNssDatabases()` installs into per-user NSS DBs when `certutil` is available: `~/.pki/nssdb`, `~/snap/chromium/.../nssdb`, all Firefox profiles (including snap), under the nickname **`OmniRoute MITM Root CA`**. + +### macOS / Windows + +- **macOS:** `security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain` +- **Windows:** elevated PowerShell → `certutil -addstore Root` + +### Auth + +All MITM endpoints require management auth (`requireCliToolsAuth`). The sudo password is cached in module scope (never `globalThis`) and cleared on `stopMitm()`. + +--- + +## User-Agent Overrides — env vars (`.env.example` section 12) + +| Variable | Default | +| ------------------------ | --------------------------------------------- | +| `CLAUDE_USER_AGENT` | `claude-cli/2.1.137 (external, cli)` | +| `CODEX_USER_AGENT` | `codex-cli/0.130.0 (Windows 10.0.26200; x64)` | +| `GITHUB_USER_AGENT` | `GitHubCopilotChat/0.45.1` | +| `ANTIGRAVITY_USER_AGENT` | `antigravity/1.23.2 darwin/arm64` | +| `KIRO_USER_AGENT` | `AWS-SDK-JS/3.0.0 kiro-ide/1.0.0` | +| `QODER_USER_AGENT` | `Qoder-Cli` | +| `QWEN_USER_AGENT` | `QwenCode/0.15.9 (linux; x64)` | +| `CURSOR_USER_AGENT` | `Cursor/3.3` | +| `GEMINI_CLI_USER_AGENT` | `google-api-nodejs-client/10.3.0` | + +Consumed by `open-sse/executors/base.ts::buildHeaders()` via dynamic lookup. **Bump these when providers release new CLI versions** — stale UA strings start getting rejected as outdated clients. + +## CLI Compatibility Mode Toggles (`.env.example` section 13) + +| Variable | Effect | +| -------------------------- | ------------------------------- | +| `CLI_COMPAT_CODEX=1` | Codex fingerprint | +| `CLI_COMPAT_CLAUDE=1` | claude-cli fingerprint | +| `CLI_COMPAT_GITHUB=1` | GitHub Copilot Chat fingerprint | +| `CLI_COMPAT_ANTIGRAVITY=1` | Antigravity fingerprint | +| `CLI_COMPAT_KIRO=1` | Kiro | +| `CLI_COMPAT_CURSOR=1` | Cursor | +| `CLI_COMPAT_KIMI_CODING=1` | Kimi Coding | +| `CLI_COMPAT_KILOCODE=1` | KiloCode | +| `CLI_COMPAT_CLINE=1` | Cline | +| `CLI_COMPAT_QWEN=1` | Qwen Code | +| `CLI_COMPAT_ALL=1` | Enable all of the above | + +The provider IP is **always preserved** — the toggle only reshapes the request wire image, it does not switch IP egress. + +--- + +## Inbound Header Sanitization + +OmniRoute scrubs inbound client headers before forwarding so a request that arrives from Cursor doesn't leak `User-Agent: Cursor/X.Y.Z` to a Claude upstream. See `src/shared/constants/upstreamHeaders.ts` for the denylist, kept in lockstep with the Zod schemas and unit tests. + +--- + +## Updating Fingerprints When a Provider Rotates + +1. Capture official CLI traffic with `mitmproxy` (TLS interception + dump) +2. Extract JA3/JA4 and the literal header order +3. Update the relevant `CLI_FINGERPRINTS[...]` entry +4. Bump matching `*_USER_AGENT` default in `.env.example` +5. If TLS handshake itself changed: update `chatgptTlsClient.ts::CHATGPT_PROFILE` or wreq-js `browser:` option +6. Run `chatgptTlsClient.test.ts` and a manual canary against the live provider +7. Ship in a patch release; document in `CHANGELOG.md` + +--- + +## Tests + +- `open-sse/services/__tests__/chatgptTlsClient.test.ts` — proxy resolution priority, abort handling, hang recovery +- `tests/unit/anthropic-cache-fingerprint.test.ts` — fingerprint determinism +- `tests/unit/chatgpt-web.test.ts` — end-to-end stealth path for ChatGPT + +--- + +## See Also + +- [RESILIENCE_GUIDE.md](../architecture/RESILIENCE_GUIDE.md) — what happens when a stealth path gets a `403` +- [TROUBLESHOOTING.md](../guides/TROUBLESHOOTING.md) +- [ENVIRONMENT.md](../reference/ENVIRONMENT.md) — full env reference +- [CLI-TOOLS.md](../reference/CLI-TOOLS.md) — operator view of the MITM workflow diff --git a/electron/package-lock.json b/electron/package-lock.json index bf0e8bb6a1..30f3ccdb59 100644 --- a/electron/package-lock.json +++ b/electron/package-lock.json @@ -13,7 +13,7 @@ "electron-updater": "^6.8.5" }, "devDependencies": { - "electron": "^41.5.1", + "electron": "^42.0.1", "electron-builder": "^26.9.1" } }, @@ -139,35 +139,48 @@ } }, "node_modules/@electron/get": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/@electron/get/-/get-2.0.3.tgz", - "integrity": "sha512-Qkzpg2s9GnVV2I2BjRksUi43U5e6+zaQMcjoJy0C+C5oxaKl+fmckGDQFtRpZpZV0NQekuZZ+tGz7EA9TVnQtQ==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/@electron/get/-/get-5.0.0.tgz", + "integrity": "sha512-pjoBpru1KdEtcExBnuHAP1cAc/5faoedw0hzJkL3o4/IJp7HNF1+fbrdxT3gMYRX2oJfvnA/WXeCTVQpYYxyJA==", "dev": true, "license": "MIT", "dependencies": { "debug": "^4.1.1", - "env-paths": "^2.2.0", - "fs-extra": "^8.1.0", - "got": "^11.8.5", + "env-paths": "^3.0.0", + "graceful-fs": "^4.2.11", "progress": "^2.0.3", - "semver": "^6.2.0", + "semver": "^7.6.3", "sumchecker": "^3.0.1" }, "engines": { - "node": ">=12" + "node": ">=22.12.0" }, "optionalDependencies": { - "global-agent": "^3.0.0" + "undici": "^7.24.4" } }, - "node_modules/@electron/get/node_modules/semver": { - "version": "6.3.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", - "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "node_modules/@electron/get/node_modules/env-paths": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-3.0.0.tgz", + "integrity": "sha512-dtJUTepzMW3Lm/NPxRf3wP4642UWhjL2sQxc+ym2YMj1m/H2zDNQOlezafzkHwn6sMstjHTwG6iQQsctDW/b1A==", "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@electron/get/node_modules/undici": { + "version": "7.25.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-7.25.0.tgz", + "integrity": "sha512-xXnp4kTyor2Zq+J1FfPI6Eq3ew5h6Vl0F/8d9XU5zZQf1tX9s2Su1/3PiMmUANFULpmksxkClamIZcaUqryHsQ==", + "dev": true, + "license": "MIT", + "optional": true, + "engines": { + "node": ">=20.18.1" } }, "node_modules/@electron/notarize": { @@ -408,72 +421,6 @@ "node": ">= 10.0.0" } }, - "node_modules/@electron/windows-sign": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/@electron/windows-sign/-/windows-sign-1.2.2.tgz", - "integrity": "sha512-dfZeox66AvdPtb2lD8OsIIQh12Tp0GNCRUDfBHIKGpbmopZto2/A8nSpYYLoedPIHpqkeblZ/k8OV0Gy7PYuyQ==", - "dev": true, - "license": "BSD-2-Clause", - "optional": true, - "peer": true, - "dependencies": { - "cross-dirname": "^0.1.0", - "debug": "^4.3.4", - "fs-extra": "^11.1.1", - "minimist": "^1.2.8", - "postject": "^1.0.0-alpha.6" - }, - "bin": { - "electron-windows-sign": "bin/electron-windows-sign.js" - }, - "engines": { - "node": ">=14.14" - } - }, - "node_modules/@electron/windows-sign/node_modules/fs-extra": { - "version": "11.3.5", - "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.5.tgz", - "integrity": "sha512-eKpRKAovdpZtR1WopLHxlBWvAgPny3c4gX1G5Jhwmmw4XJj0ifSD5qB5TOo8hmA0wlRKDAOAhEE1yVPgs6Fgcg==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true, - "dependencies": { - "graceful-fs": "^4.2.0", - "jsonfile": "^6.0.1", - "universalify": "^2.0.0" - }, - "engines": { - "node": ">=14.14" - } - }, - "node_modules/@electron/windows-sign/node_modules/jsonfile": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz", - "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true, - "dependencies": { - "universalify": "^2.0.0" - }, - "optionalDependencies": { - "graceful-fs": "^4.1.6" - } - }, - "node_modules/@electron/windows-sign/node_modules/universalify": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", - "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true, - "engines": { - "node": ">= 10.0.0" - } - }, "node_modules/@isaacs/fs-minipass": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz", @@ -1432,15 +1379,6 @@ "buffer": "^5.1.0" } }, - "node_modules/cross-dirname": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/cross-dirname/-/cross-dirname-0.1.0.tgz", - "integrity": "sha512-+R08/oI0nl3vfPcqftZRpytksBXDzOUveBq/NBVx0sUp1axwzPQrKinNx5yd5sxPu8j1wIy8AfnVQ+5eFdha6Q==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true - }, "node_modules/cross-spawn": { "version": "7.0.6", "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", @@ -1792,22 +1730,22 @@ } }, "node_modules/electron": { - "version": "41.5.1", - "resolved": "https://registry.npmjs.org/electron/-/electron-41.5.1.tgz", - "integrity": "sha512-l3sIu10LcXe38iNZMfTR4EKmVc1K3Luw5HBfjvd2xszj6DHhU4yuXqlb1wtSAt1+7QY817w/be59bIkaFLLUBA==", + "version": "42.0.1", + "resolved": "https://registry.npmjs.org/electron/-/electron-42.0.1.tgz", + "integrity": "sha512-d8HnycE970DGESe91Nj30eonFBUcAI9EZ1TwUGJVzSAnJZdh0BkFEinAXjdklvDYst+bVDc8HsksCuqVLrnqdg==", "dev": true, - "hasInstallScript": true, "license": "MIT", "dependencies": { - "@electron/get": "^2.0.0", + "@electron/get": "^5.0.0", "@types/node": "^24.9.0", "extract-zip": "^2.0.1" }, "bin": { - "electron": "cli.js" + "electron": "cli.js", + "install-electron": "install.js" }, "engines": { - "node": ">= 12.20.55" + "node": ">= 22.12.0" } }, "node_modules/electron-builder": { @@ -1836,19 +1774,6 @@ "node": ">=14.0.0" } }, - "node_modules/electron-builder-squirrel-windows": { - "version": "26.9.1", - "resolved": "https://registry.npmjs.org/electron-builder-squirrel-windows/-/electron-builder-squirrel-windows-26.9.1.tgz", - "integrity": "sha512-mz3b6Fj1yQ7NGffz5hhHUZ4Y8vJhluSjjYi+UjqCdF3AKbIsFoi85xdUFc0aJ4c7dh05h7hHKqeiGkKb5BEalQ==", - "dev": true, - "license": "MIT", - "peer": true, - "dependencies": { - "app-builder-lib": "26.9.1", - "builder-util": "26.9.0", - "electron-winstaller": "5.4.0" - } - }, "node_modules/electron-builder/node_modules/fs-extra": { "version": "10.1.0", "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz", @@ -1993,44 +1918,6 @@ "node": ">= 10.0.0" } }, - "node_modules/electron-winstaller": { - "version": "5.4.0", - "resolved": "https://registry.npmjs.org/electron-winstaller/-/electron-winstaller-5.4.0.tgz", - "integrity": "sha512-bO3y10YikuUwUuDUQRM4KfwNkKhnpVO7IPdbsrejwN9/AABJzzTQ4GeHwyzNSrVO+tEH3/Np255a3sVZpZDjvg==", - "dev": true, - "hasInstallScript": true, - "license": "MIT", - "peer": true, - "dependencies": { - "@electron/asar": "^3.2.1", - "debug": "^4.1.1", - "fs-extra": "^7.0.1", - "lodash": "^4.17.21", - "temp": "^0.9.0" - }, - "engines": { - "node": ">=8.0.0" - }, - "optionalDependencies": { - "@electron/windows-sign": "^1.1.2" - } - }, - "node_modules/electron-winstaller/node_modules/fs-extra": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz", - "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==", - "dev": true, - "license": "MIT", - "peer": true, - "dependencies": { - "graceful-fs": "^4.1.2", - "jsonfile": "^4.0.0", - "universalify": "^0.1.0" - }, - "engines": { - "node": ">=6 <7 || >=8" - } - }, "node_modules/emoji-regex": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", @@ -2304,21 +2191,6 @@ "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", "license": "MIT" }, - "node_modules/fs-extra": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz", - "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==", - "dev": true, - "license": "MIT", - "dependencies": { - "graceful-fs": "^4.2.0", - "jsonfile": "^4.0.0", - "universalify": "^0.1.0" - }, - "engines": { - "node": ">=6 <7 || >=8" - } - }, "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", @@ -3040,20 +2912,6 @@ "node": ">= 18" } }, - "node_modules/mkdirp": { - "version": "0.5.6", - "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", - "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", - "dev": true, - "license": "MIT", - "peer": true, - "dependencies": { - "minimist": "^1.2.6" - }, - "bin": { - "mkdirp": "bin/cmd.js" - } - }, "node_modules/mkdirp-classic": { "version": "0.5.3", "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", @@ -3305,36 +3163,6 @@ "node": ">=18" } }, - "node_modules/postject": { - "version": "1.0.0-alpha.6", - "resolved": "https://registry.npmjs.org/postject/-/postject-1.0.0-alpha.6.tgz", - "integrity": "sha512-b9Eb8h2eVqNE8edvKdwqkrY6O7kAwmI8kcnBv1NScolYJbo59XUF0noFq+lxbC1yN20bmC0WBEbDC5H/7ASb0A==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true, - "dependencies": { - "commander": "^9.4.0" - }, - "bin": { - "postject": "dist/cli.js" - }, - "engines": { - "node": ">=14.0.0" - } - }, - "node_modules/postject/node_modules/commander": { - "version": "9.5.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz", - "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==", - "dev": true, - "license": "MIT", - "optional": true, - "peer": true, - "engines": { - "node": "^12.20.0 || >=14" - } - }, "node_modules/prebuild-install": { "version": "7.1.3", "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", @@ -3553,21 +3381,6 @@ "node": ">= 4" } }, - "node_modules/rimraf": { - "version": "2.6.3", - "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.3.tgz", - "integrity": "sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==", - "deprecated": "Rimraf versions prior to v4 are no longer supported", - "dev": true, - "license": "ISC", - "peer": true, - "dependencies": { - "glob": "^7.1.3" - }, - "bin": { - "rimraf": "bin.js" - } - }, "node_modules/roarr": { "version": "2.15.4", "resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz", @@ -3958,21 +3771,6 @@ "node": ">=18" } }, - "node_modules/temp": { - "version": "0.9.4", - "resolved": "https://registry.npmjs.org/temp/-/temp-0.9.4.tgz", - "integrity": "sha512-yYrrsWnrXMcdsnu/7YMYAofM1ktpL5By7vZhf15CrXijWWrEYZks5AXBudalfSWJLlnen/QUJUB5aoB0kqZUGA==", - "dev": true, - "license": "MIT", - "peer": true, - "dependencies": { - "mkdirp": "^0.5.1", - "rimraf": "~2.6.2" - }, - "engines": { - "node": ">=6.0.0" - } - }, "node_modules/temp-file": { "version": "3.4.0", "resolved": "https://registry.npmjs.org/temp-file/-/temp-file-3.4.0.tgz", diff --git a/electron/package.json b/electron/package.json index 52fe8aa7d0..cad621a095 100644 --- a/electron/package.json +++ b/electron/package.json @@ -9,10 +9,13 @@ }, "license": "MIT", "homepage": "https://omniroute.online", + "engines": { + "node": ">=22.22.2 <23 || >=24.0.0 <27" + }, "scripts": { "start": "electron .", "dev": "electron . --no-sandbox", - "prepare:bundle": "node ../scripts/prepare-electron-standalone.mjs", + "prepare:bundle": "node ../scripts/build/prepare-electron-standalone.mjs", "build": "npm run prepare:bundle && electron-builder", "build:win": "npm run prepare:bundle && electron-builder --win", "build:mac": "npm run prepare:bundle && electron-builder --mac", @@ -26,8 +29,8 @@ "electron-updater": "^6.8.5" }, "devDependencies": { - "electron": "^41.5.1", - "electron-builder": "^26.9.1" + "electron": "^42.0.1", + "electron-builder": "^26.10.0" }, "overrides": { "@xmldom/xmldom": "^0.9.10", diff --git a/llm.txt b/llm.txt index 5435818193..313aa501e7 100644 --- a/llm.txt +++ b/llm.txt @@ -1,6 +1,6 @@ # OmniRoute -> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 160+ AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (29 tools), A2A v0.3 protocol, Memory/Skills systems, and an Electron desktop app. +> OmniRoute is a free, open-source AI Gateway that acts as a universal API proxy for multi-provider LLMs. It provides smart routing, automatic fallback, load balancing, and format translation across 177 AI providers — all through a single OpenAI-compatible endpoint. Includes a built-in MCP Server (37 tools), A2A v0.3 protocol, Memory/Skills systems, Cloud Agents (codex-cloud, devin, jules), Guardrails framework, and an Electron desktop app. ## Overview @@ -12,9 +12,9 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Tech Stack -- **Runtime:** Node.js >= 18 < 24, ES Modules (`"type": "module"`) +- **Runtime:** Node.js `>=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27`, ES Modules (`"type": "module"`) - **Framework:** Next.js 16 (App Router) with TypeScript 5.9 -- **Database:** SQLite via better-sqlite3 (local, zero-config, 16 migrations) +- **Database:** SQLite via better-sqlite3 (local, zero-config, 55 migrations) - **State management:** Zustand (client), SQLite (server persistence) - **UI:** React 19, Tailwind CSS 4, Recharts for analytics, @lobehub/icons for 130+ provider SVG icons - **Auth:** OAuth 2.0 (PKCE) for providers, bcrypt for local user auth @@ -41,7 +41,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo │ │ │ ├── auto-combo/ # Auto-combo engine dashboard │ │ │ ├── cache/ # Cache dashboard (semantic cache stats) │ │ │ ├── cli-tools/ # CLI tool configuration (Claude Code, Codex, Gemini CLI, etc.) -│ │ │ ├── combos/ # Model combo management (13 strategies + 4 templates) +│ │ │ ├── combos/ # Model combo management (14 strategies + 4 templates) │ │ │ ├── costs/ # Cost tracking per provider/model │ │ │ ├── endpoint/ # Unified: Endpoint Proxy, MCP, A2A, API Endpoints tabs │ │ │ ├── health/ # System health (uptime, circuit breakers, latency) @@ -182,7 +182,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ├── open-sse/ # Standalone SSE server (npm workspace) │ ├── config/ # Model registries (providerRegistry, embedding, image, audio, video, │ │ # music, rerank, moderation, search, CLI fingerprints, Ollama models) -│ ├── executors/ # Provider-specific request executors (14 executors) +│ ├── executors/ # Provider-specific request executors (31 executors) │ │ ├── base.ts # Base executor with shared logic │ │ ├── default.ts # Default OpenAI-compatible executor │ │ ├── cursor.ts # Cursor IDE (protobuf + checksum) @@ -282,24 +282,25 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ## Key Features (v3.8.0) ### Core Proxy -- **160+ AI providers** with automatic format translation -- **4 provider categories**: Free (4), OAuth (8), API Key (120+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) -- **13 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay +- **177 AI providers** with automatic format translation +- **4 provider categories**: Free (5), OAuth (14), API Key (123+), Self-Hosted (8+), Custom (OpenAI/Anthropic-compatible) +- **14 routing strategies**: priority, weighted, round-robin, fill-first, p2c, random, least-used, cost-optimized, strict-random, auto, lkgp, context-optimized, context-relay, **reset-aware** (v3.8) - **4-tier fallback**: Subscription → API Key → Cheap → Free - **Context Relay strategy**: Session handoff summaries on account rotation for continuity -- **Auto-combo engine**: Self-healing routing optimization with 6-factor scoring, bandit exploration, progressive cooldown +- **Auto-combo engine**: Self-healing routing optimization with **9-factor scoring** (health/quota/costInv/latencyInv/taskFit/specificityMatch/stability/tierPriority/tierAffinity), bandit exploration, progressive cooldown - **Semantic caching** with cache hit/miss headers - **Idempotency** with configurable dedup window -- **Circuit breaker** per provider with configurable thresholds +- **3-layer resilience**: Provider Circuit Breaker / Connection Cooldown / Model Lockout - **Provider Icons**: 130+ provider logos via `@lobehub/icons` (SVG) with PNG fallback - **Model Auto-Sync**: 24h scheduler refreshes model lists for 16 providers - **Registered Keys API**: Auto-provision API keys via `POST /api/v1/registered-keys` with quota enforcement - **Memory System**: Persistent conversational memory with extraction, injection, retrieval, and summarization - **Skills System**: Extensible skill framework with registry, executor, sandbox, built-in and custom skills -- **Prompt Injection Guard**: Middleware-level prompt injection detection +- **Cloud Agents**: Codex Cloud, Devin, Jules — autonomous coding agents with task lifecycle management +- **Guardrails Framework**: Hot-reloadable registry with vision-bridge, pii-masker, prompt-injection (priority-ordered) - **MITM Proxy**: Certificate management, DNS handling, and target routing - **Cloudflare Tunnels**: Managed tunnel creation for remote access -- **122 unit test files** with comprehensive coverage (55% statements/lines/functions, 60% branches) +- **Coverage gate**: 75% statements/lines/functions, 70% branches (measured ~82%) ### Security - **Data Loss Prevention**: SQLite migration safety bounds abort startup on dangerous massive schema overrides. Pre-migration `VACUUM INTO` backups isolate rollback snapshots. @@ -315,7 +316,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo ### Dashboard Pages (23 sections) - **Providers** — OAuth, API key, and free provider management with ProviderIcon SVG icons -- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 13 strategies +- **Combos** — Multi-model combo builder with 4 templates (Free Stack, High Availability, Cost Saver, Balanced) + 14 strategies - **Auto-Combo** — Auto-combo engine dashboard with scoring metrics - **Analytics** — Token consumption, cost, heatmaps, distributions - **Health** — Uptime, memory, latency percentiles, circuit breakers @@ -345,25 +346,24 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - **Gemini** — `/v1beta/models`, `/v1beta/models/{...path}` - **Ollama** — `/v1/api/chat`, `/api/tags` - **Search** — `/v1/search` (Perplexity, Serper, Brave, Exa, Tavily) -- **MCP** — 29-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) -- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, smart-routing + quota-management skills) +- **MCP** — 37-tool MCP server with scope-based auth (3 transports: stdio, SSE, streamable HTTP) +- **A2A** — Agent-to-Agent v0.3 protocol (JSON-RPC 2.0, 5 skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report) - **ACP** — Agent Communication Protocol registry and manager -### MCP Server (29 Tools) -| Category | Tools | -|-----------|-------| -| Core (20) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing` | -| Cache (2) | `cache_stats`, `cache_flush` | +### MCP Server (37 Tools) +| Category | Tools | +|------------|-------| +| Core (30) | `get_health`, `list_combos`, `get_combo_metrics`, `switch_combo`, `check_quota`, `route_request`, `cost_report`, `list_models_catalog`, `web_search`, `simulate_route`, `set_budget_guard`, `set_routing_strategy`, `set_resilience_profile`, `test_combo`, `get_provider_metrics`, `best_combo_for_task`, `explain_route`, `get_session_snapshot`, `db_health_check`, `sync_pricing`, `cache_stats`, `cache_flush`, and advanced routing/diagnostics tools (see `docs/frameworks/MCP-SERVER.md` for full inventory) | | Memory (3) | `memory_search`, `memory_add`, `memory_clear` | | Skills (4) | `skills_list`, `skills_enable`, `skills_execute`, `skills_executions` | -**MCP Auth Scopes (10):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience` +**MCP Auth Scopes (~13):** `read:health`, `read:combos`, `write:combos`, `read:quota`, `read:usage`, `read:models`, `execute:completions`, `execute:search`, `write:budget`, `write:resilience`, plus memory/skills scopes — full list in `docs/frameworks/MCP-SERVER.md`. ### Provider Categories -**Free Providers (4):** Qoder AI, Qwen Code, Gemini CLI (deprecated), Kiro AI +**Free Providers (5):** Qoder AI, Qwen Code (deprecated), Gemini CLI, Kiro AI, Windsurf -**OAuth Providers (8):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline +**OAuth Providers (14):** Claude Code, Antigravity, OpenAI Codex, GitHub Copilot, Cursor IDE, Kimi Coding, Kilo Code, Cline, Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo **API Key Providers (48+):** OpenAI, Anthropic, Gemini (Google AI Studio), DeepSeek, Groq, xAI (Grok), Mistral, Perplexity, Together AI, Fireworks AI, Cerebras, Cohere, NVIDIA NIM, Nebius AI, SiliconFlow, Hyperbolic, HuggingFace, OpenRouter, Vertex AI, Cloudflare Workers AI, Scaleway AI, AI/ML API, Pollinations AI, Puter AI, LongCat AI, Alibaba Cloud (DashScope), Alibaba Intl, Alibaba (AliCode), Kimi, Kimi Coding (API Key), Minimax, Minimax (China), Blackbox AI, Synthetic, Kilo Gateway, Z.AI, GLM Coding, Deepgram, AssemblyAI, ElevenLabs, Cartesia, PlayHT, Inworld, NanoBanana, SD WebUI, ComfyUI, Ollama Cloud, Perplexity Search, Serper Search, Brave Search, Exa Search, Tavily Search, OpenCode Zen, OpenCode Go, Bailian Coding Plan @@ -382,7 +382,7 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 3. **Connection-based provider model:** Providers are stored as "connections" in SQLite. Each connection has an `id`, `provider`, `authType` (oauth/apikey/free), `isActive` flag, and credentials. Multiple connections per provider for multi-account rotation. -4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 13 strategies including auto-combo with self-healing and context-relay for session continuity. +4. **Combo system for fallback:** Users create "combos" — ordered lists of `provider/model` pairs. The proxy tries each in order until one succeeds. Supports 14 strategies including auto-combo with self-healing and context-relay for session continuity. 5. **SSE proxy pipeline:** The proxy pipeline is middleware-based: request → auth resolution → rate limiting → circuit breaker → format translation → upstream call → response translation → SSE streaming back to client. @@ -436,15 +436,15 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 4. **Environment variables:** All configuration is in `.env` (from `.env.example`). Key vars: `PORT`, `NEXT_PUBLIC_BASE_URL`, `API_KEY`, `ADMIN_PASSWORD`. -5. **Database layer:** Operations go through `src/lib/db/` modules (21 domain-specific files). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. +5. **Database layer:** Operations go through `src/lib/db/` modules (45+ domain-specific files, 55 migrations). `localDb.ts` is re-exports only — add new functions to the proper `db/*.ts` module. -6. **Tests use Node.js built-in test runner:** 122 unit test files. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). +6. **Tests** use Node.js built-in test runner + Vitest. Run `npm test`. Vitest for MCP/autoCombo (`npm run test:vitest`). Playwright for E2E (`npm run test:e2e`). Coverage gate: 75% statements/lines/functions, 70% branches. 7. **MCP and A2A pages are embedded as tabs inside `/dashboard/endpoint`**, not standalone routes. 8. **ACP agents** are in `src/lib/acp/registry.ts` with detection cache. Custom agents stored via settings DB. -9. **Auto-combo engine** in `open-sse/services/autoCombo/` — 6-factor scoring, 4 mode packs, bandit exploration, progressive cooldown. +9. **Auto-combo engine** in `open-sse/services/autoCombo/` — **9-factor scoring** (health 0.22, quota 0.17, costInv 0.17, latencyInv 0.13, taskFit 0.08, specificityMatch 0.08, stability 0.05, tierPriority 0.05, tierAffinity 0.05), 4 mode packs, bandit exploration, progressive cooldown. 10. **Docker:** Dockerfile has two targets: `runner-base` and `runner-cli`. `docker-compose.yml` for dev (3 profiles), `docker-compose.prod.yml` for production (port 20130). @@ -464,6 +464,33 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo 18. **Node.js 24+ compatibility**: The login page (`/api/settings/require-login`) detects the Node.js version and sends `nodeVersion`/`nodeCompatible` fields. The login UI renders a warning banner when `nodeCompatible` is false. +19. **Cloud Agents** in `src/lib/cloudAgent/` — three external autonomous coding agents (Codex Cloud, Devin, Jules) with task lifecycle endpoints under `/api/v1/agents/tasks/`. Require management auth, not client auth. + +20. **Guardrails framework** in `src/lib/guardrails/` — hot-reloadable registry. Built-ins (priority-ordered): `vision-bridge` (5) → `pii-masker` (10) → `prompt-injection` (20). Fail-open model: exceptions never block traffic. Per-request opt-out via `x-omniroute-disabled-guardrails` header. + +21. **Authz pipeline** (`src/server/authz/`): every request is classified as `PUBLIC`, `CLIENT_API`, or `MANAGEMENT`, then run through policy + enforce stages. See `docs/architecture/AUTHZ_GUIDE.md`. + +22. **Three resilience layers** are distinct (do not conflate them): + - **Provider Circuit Breaker** (`src/shared/utils/circuitBreaker.ts`) — whole-provider scope. + - **Connection Cooldown** (`src/sse/services/auth.ts::markAccountUnavailable`) — one key/account scope. + - **Model Lockout** (`open-sse/services/accountFallback.ts`) — provider + connection + model scope. + +## v3.8.0 Highlights + +- **Cloud Agents** (Codex Cloud, Devin, Jules) with task lifecycle management and management-auth enforcement +- **Guardrails framework**: hot-reloadable registry with vision-bridge, pii-masker, prompt-injection +- **9-factor Auto-Combo scoring** (was 6-factor in earlier versions) +- **`reset-aware` routing strategy** (14th strategy) — picks the account whose quota will reset soonest +- **A2A protocol expanded to 5 skills**: smart-routing, quota-management, provider-discovery, cost-analysis, health-report +- **MCP server expanded to 37 tools** (30 base + 3 memory + 4 skills) across ~13 scopes +- **OAuth providers expanded to 14**: added Qwen, Kiro, Qoder, Gemini, Windsurf, GitLab Duo +- **Coverage gate raised to 75/75/75/70** (was 60% across the board) — measured ~82% +- **Reasoning replay** (`docs/routing/REASONING_REPLAY.md`) — capture and inspect provider reasoning streams +- **Compliance + Evals + Webhooks** documentation introduced +- **Stealth guide** (`docs/security/STEALTH_GUIDE.md`) — TLS / CLI fingerprint configuration +- **Tunnels guide** (`docs/ops/TUNNELS_GUIDE.md`) — Cloudflare tunnel management +- **Electron guide** (`docs/guides/ELECTRON_GUIDE.md`) — desktop app build + signing + ## Links - Repository: https://github.com/diegosouzapw/OmniRoute @@ -471,3 +498,14 @@ OmniRoute solves the problem of managing multiple AI provider subscriptions, quo - npm: https://www.npmjs.com/package/omniroute - Docker Hub: https://hub.docker.com/r/diegosouzapw/omniroute - Documentation: See `/docs/` directory + +### Documentation Index + +- **Architecture & Reference**: `docs/architecture/ARCHITECTURE.md`, `docs/architecture/CODEBASE_DOCUMENTATION.md`, `docs/architecture/REPOSITORY_MAP.md`, `docs/reference/API_REFERENCE.md`, `docs/reference/PROVIDER_REFERENCE.md`, `docs/reference/openapi.yaml` +- **Operator guides**: `docs/guides/USER_GUIDE.md`, `docs/reference/CLI-TOOLS.md`, `docs/guides/TROUBLESHOOTING.md`, `docs/ops/COVERAGE_PLAN.md` +- **Protocols**: `docs/frameworks/MCP-SERVER.md`, `docs/frameworks/A2A-SERVER.md`, `docs/frameworks/AGENT_PROTOCOLS_GUIDE.md`, `docs/frameworks/CLOUD_AGENT.md` +- **Routing & resilience**: `docs/routing/AUTO-COMBO.md`, `docs/architecture/RESILIENCE_GUIDE.md` +- **Security**: `docs/architecture/AUTHZ_GUIDE.md`, `docs/security/GUARDRAILS.md`, `docs/security/COMPLIANCE.md`, `docs/security/STEALTH_GUIDE.md` +- **Extensibility**: `docs/frameworks/SKILLS.md`, `docs/frameworks/MEMORY.md`, `docs/frameworks/EVALS.md`, `docs/frameworks/WEBHOOKS.md`, `docs/routing/REASONING_REPLAY.md` +- **Platform**: `docs/guides/ELECTRON_GUIDE.md`, `docs/ops/TUNNELS_GUIDE.md` +- **AI agents**: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` diff --git a/open-sse/config/audioRegistry.ts b/open-sse/config/audioRegistry.ts index b0c18cafd0..359214aabb 100644 --- a/open-sse/config/audioRegistry.ts +++ b/open-sse/config/audioRegistry.ts @@ -17,6 +17,7 @@ export interface AudioProvider { authType: string; authHeader: string; format?: string; + supportedFormats?: string[]; async?: boolean; models: AudioModel[]; } @@ -124,8 +125,8 @@ export const AUDIO_SPEECH_PROVIDERS: Record<string, AudioProvider> = { authType: "apikey", authHeader: "bearer", models: [ - { id: "tts-1", name: "TTS 1" }, { id: "tts-1-hd", name: "TTS 1 HD" }, + { id: "tts-1", name: "TTS 1" }, { id: "gpt-4o-mini-tts", name: "GPT-4o Mini TTS" }, ], }, @@ -226,8 +227,9 @@ export const AUDIO_SPEECH_PROVIDERS: Record<string, AudioProvider> = { authType: "apikey", authHeader: "basic", format: "inworld", + supportedFormats: ["mp3", "wav", "opus", "pcm"], models: [ - { id: "inworld-tts-1.5-max", name: "Inworld TTS 1.5 Max" }, + { id: "inworld-tts-2", name: "Inworld TTS 2" }, { id: "inworld-tts-1.5-mini", name: "Inworld TTS 1.5 Mini" }, ], }, @@ -242,8 +244,8 @@ export const AUDIO_SPEECH_PROVIDERS: Record<string, AudioProvider> = { authHeader: "x-api-key", format: "cartesia", models: [ - { id: "sonic-2", name: "Sonic 2" }, { id: "sonic-3", name: "Sonic 3" }, + { id: "sonic-2", name: "Sonic 2" }, ], }, @@ -297,6 +299,7 @@ export const AUDIO_SPEECH_PROVIDERS: Record<string, AudioProvider> = { authType: "apikey", authHeader: "bearer", format: "xiaomi-mimo-tts", + supportedFormats: ["mp3", "wav"], models: [ { id: "mimo-v2.5-tts", name: "MiMo V2.5 TTS" }, { id: "mimo-v2.5-tts-voicedesign", name: "MiMo V2.5 Voice Design" }, diff --git a/open-sse/config/constants.ts b/open-sse/config/constants.ts index b55085526d..8d3b1b979d 100644 --- a/open-sse/config/constants.ts +++ b/open-sse/config/constants.ts @@ -22,6 +22,12 @@ export const STREAM_IDLE_TIMEOUT_MS = upstreamTimeouts.streamIdleTimeoutMs; // first token, while dead 200 OK streams fail fast enough for combo fallback. export const STREAM_READINESS_TIMEOUT_MS = upstreamTimeouts.streamReadinessTimeoutMs; +// Heartbeat interval for synthetic SSE keepalive emission toward the downstream +// client (Capy, Claude Code, OpenAI SDK, etc). Keeps strict proxies from +// dropping the connection during long upstream thinking phases. Set to 0 to +// disable. Override with SSE_HEARTBEAT_INTERVAL_MS env var. +export const SSE_HEARTBEAT_INTERVAL_MS = upstreamTimeouts.sseHeartbeatIntervalMs; + // Timeout for reading the full response body after headers arrive (ms). // Prevents indefinite hangs when the upstream sends headers but stalls on the body. // Defaults to FETCH_TIMEOUT_MS. Override with FETCH_BODY_TIMEOUT_MS env var. @@ -142,13 +148,23 @@ export const RateLimitReason = { // ─── Provider Resilience Profiles ─────────────────────────────────────────── // Separate behavior for OAuth (low-limit, session-based) vs API Key (high-limit, metered) +// Circuit-breaker thresholds and reset windows are overridable via +// OMNIROUTE_CIRCUIT_BREAKER_* env vars so operators can dampen or harden +// behavior without recompiling. +function envInt(name: string, fallback: number): number { + const raw = process.env[name]; + if (raw === undefined || raw === null || raw === "") return fallback; + const parsed = Number(raw); + return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback; +} + export const PROVIDER_PROFILES = { oauth: { transientCooldown: 5000, // 5s (session tokens — short recovery) rateLimitCooldown: 60000, // 60s default when no retry-after header maxBackoffLevel: 8, // Higher ceiling (sessions may stay bad longer) - circuitBreakerThreshold: 8, // Scaled for 500+ connections (was 3) - circuitBreakerReset: 60000, // 1min reset + circuitBreakerThreshold: envInt("OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD", 8), + circuitBreakerReset: envInt("OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS", 60000), // Provider-level circuit breaker (entire provider cooldown after repeated failures) providerFailureThreshold: 10, // Scaled for 500+ connections (was 3) providerFailureWindowMs: 900000, // 15min window (was 10min) @@ -158,8 +174,8 @@ export const PROVIDER_PROFILES = { transientCooldown: 3000, // 3s (API providers recover faster) rateLimitCooldown: 0, // 0 = respect retry-after header from provider maxBackoffLevel: 5, // Lower ceiling (API quotas reset at known intervals) - circuitBreakerThreshold: 12, // Scaled for 500+ connections (was 5) - circuitBreakerReset: 30000, // 30s reset + circuitBreakerThreshold: envInt("OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD", 12), + circuitBreakerReset: envInt("OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS", 30000), // Provider-level circuit breaker (entire provider cooldown after repeated failures) providerFailureThreshold: 15, // Scaled for 500+ connections (was 5) providerFailureWindowMs: 1800000, // 30min window (was 20min) @@ -172,8 +188,8 @@ export const PROVIDER_PROFILES = { transientCooldown: 2000, // 2s (local — very fast recovery) rateLimitCooldown: 5000, // 5s (local — no real rate limits) maxBackoffLevel: 3, // Low ceiling (local either works or doesn't) - circuitBreakerThreshold: 2, // Opens fast (if local is down, it's down) - circuitBreakerReset: 15000, // 15s reset (check again quickly) + circuitBreakerThreshold: envInt("OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD", 2), + circuitBreakerReset: envInt("OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS", 15000), // Provider-level circuit breaker (entire provider cooldown after repeated failures) providerFailureThreshold: 2, // 2 failures trigger provider cooldown providerFailureWindowMs: 300000, // 5min window for counting failures diff --git a/open-sse/config/errorConfig.ts b/open-sse/config/errorConfig.ts index 84c6df8bd4..3bcad8edcc 100644 --- a/open-sse/config/errorConfig.ts +++ b/open-sse/config/errorConfig.ts @@ -105,6 +105,18 @@ export const ERROR_RULES: ErrorRule[] = [ backoff: true, reason: "rate_limit_exceeded", }, + { + id: "hour_quota_exceeded", + text: "hour quota", + backoff: true, + reason: "quota_exhausted", + }, + { + id: "quota_has_been_exceeded", + text: "quota has been exceeded", + backoff: true, + reason: "quota_exhausted", + }, { id: "quota_exceeded", text: "quota exceeded", diff --git a/open-sse/config/glmProvider.ts b/open-sse/config/glmProvider.ts index 6271b57096..26b0e833a8 100644 --- a/open-sse/config/glmProvider.ts +++ b/open-sse/config/glmProvider.ts @@ -236,11 +236,16 @@ function addBetaQuery(url: string): string { } export function isAnthropicGlmBaseUrl(baseUrl: string): boolean { - return /\/api\/anthropic(?:\/|$)/i.test(stripQueryAndTrailingSlash(baseUrl)); + const base = stripQueryAndTrailingSlash(baseUrl).toLowerCase(); + return base.includes("/api/anthropic/") || base.endsWith("/api/anthropic"); } export function isCodingGlmBaseUrl(baseUrl: string): boolean { - return /\/api\/coding\/paas\/v\d+(?:\/|$)/i.test(stripQueryAndTrailingSlash(baseUrl)); + const base = stripQueryAndTrailingSlash(baseUrl).toLowerCase(); + const idx = base.indexOf("/api/coding/paas/v"); + if (idx === -1) return false; + const afterV = base.charCodeAt(idx + "/api/coding/paas/v".length); + return afterV >= 48 && afterV <= 57; // first char after 'v' must be a digit } export function getGlmBaseUrl( diff --git a/open-sse/config/providerHeaderProfiles.ts b/open-sse/config/providerHeaderProfiles.ts index 99cf3386bb..2e58750055 100644 --- a/open-sse/config/providerHeaderProfiles.ts +++ b/open-sse/config/providerHeaderProfiles.ts @@ -186,17 +186,3 @@ export function getCursorRegistryHeaders( "User-Agent": getCursorUserAgent(version), }; } - -export function getCursorUsageHeaders( - accessToken: string, - version = CURSOR_REGISTRY_VERSION -): Record<string, string> { - const userAgent = getCursorUserAgent(version); - return { - Authorization: `Bearer ${accessToken}`, - Accept: "application/json", - "User-Agent": userAgent, - "x-cursor-client-version": version, - "x-cursor-user-agent": userAgent, - }; -} diff --git a/open-sse/config/providerModels.ts b/open-sse/config/providerModels.ts index 6b210ec20e..66c7778b5a 100644 --- a/open-sse/config/providerModels.ts +++ b/open-sse/config/providerModels.ts @@ -61,5 +61,8 @@ export function getModelsByProviderId(providerId: string): RegistryModel[] { export function supportsXHighEffort(aliasOrId: string, modelId: string): boolean { const alias = PROVIDER_ID_TO_ALIAS[aliasOrId] || aliasOrId; + const providerModels = PROVIDER_MODELS[alias] || PROVIDER_MODELS[aliasOrId]; + // Unknown provider (not in registry) — pass through unchanged. + if (!providerModels) return true; return getProviderModel(alias, modelId)?.supportsXHighEffort === true; } diff --git a/open-sse/config/providerRegistry.ts b/open-sse/config/providerRegistry.ts index 52e769aa19..358ae98b10 100644 --- a/open-sse/config/providerRegistry.ts +++ b/open-sse/config/providerRegistry.ts @@ -130,18 +130,161 @@ const KIMI_CODING_SHARED = { executor: "default", baseUrl: "https://api.kimi.com/coding/v1/messages", authHeader: "x-api-key", + // Kimi K2.6 native context per Moonshot platform docs and cross-provider + // catalog (openrouter, moonshot, ali, deepinfra, etc. all advertise 262144). + // Without this, contextManager.ts:getTokenLimit falls back to + // DEFAULT_LIMITS.default = 128000 because the Kimi Code OAuth product is + // not synced via models.dev. The under-reported value cascades into + // /v1/models advertised context_length=128000 and downstream client + // assumptions about prompt budget (e.g. Capy computing + // prompt_cap = context_length - request.max_tokens). + defaultContextLength: 262144, headers: { "Anthropic-Version": ANTHROPIC_VERSION_HEADER, }, models: [ - { id: "kimi-k2.6", name: "Kimi K2.6" }, - { id: "kimi-k2.6-thinking", name: "Kimi K2.6 Thinking" }, + { id: "kimi-k2.6", name: "Kimi K2.6", contextLength: 262144, maxOutputTokens: 262144 }, + { + id: "kimi-k2.6-thinking", + name: "Kimi K2.6 Thinking", + contextLength: 262144, + maxOutputTokens: 262144, + }, ] as RegistryModel[], } as const; const buildModels = (ids: readonly string[]): RegistryModel[] => ids.map((id) => ({ id, name: id })); +const COMMAND_CODE_MODELS: RegistryModel[] = [ + { + id: "claude-opus-4-7", + name: "Claude Opus 4.7 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 32000, + }, + { + id: "claude-opus-4-6", + name: "Claude Opus 4.6 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 32000, + }, + { + id: "claude-sonnet-4-6", + name: "Claude Sonnet 4.6 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 16384, + }, + { + id: "claude-haiku-4-5-20251001", + name: "Claude Haiku 4.5 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 8192, + }, + { + id: "gpt-5.5", + name: "GPT-5.5 (CC)", + supportsReasoning: true, + contextLength: 256000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.4", + name: "GPT-5.4 (CC)", + supportsReasoning: true, + contextLength: 256000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.3-codex", + name: "GPT-5.3 Codex (CC)", + supportsReasoning: true, + contextLength: 256000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.4-mini", + name: "GPT-5.4 Mini (CC)", + supportsReasoning: false, + contextLength: 256000, + maxOutputTokens: 128000, + }, + { + id: "deepseek/deepseek-v4-pro", + name: "DeepSeek V4 Pro (CC)", + supportsReasoning: true, + contextLength: 1000000, + maxOutputTokens: 384000, + }, + { + id: "deepseek/deepseek-v4-flash", + name: "DeepSeek V4 Flash (CC)", + supportsReasoning: true, + contextLength: 1000000, + maxOutputTokens: 384000, + }, + { + id: "moonshotai/Kimi-K2.6", + name: "Kimi K2.6 (CC)", + supportsReasoning: true, + contextLength: 262144, + maxOutputTokens: 131072, + }, + { + id: "moonshotai/Kimi-K2.5", + name: "Kimi K2.5 (CC)", + supportsReasoning: true, + contextLength: 262144, + maxOutputTokens: 131072, + }, + { + id: "zai-org/GLM-5.1", + name: "GLM-5.1 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 131072, + }, + { + id: "zai-org/GLM-5", + name: "GLM-5 (CC)", + supportsReasoning: true, + contextLength: 200000, + maxOutputTokens: 131072, + }, + { + id: "MiniMaxAI/MiniMax-M2.7", + name: "MiniMax M2.7 (CC)", + supportsReasoning: true, + contextLength: 1048576, + maxOutputTokens: 131072, + }, + { + id: "MiniMaxAI/MiniMax-M2.5", + name: "MiniMax M2.5 (CC)", + supportsReasoning: true, + contextLength: 1048576, + maxOutputTokens: 131072, + }, + { + id: "Qwen/Qwen3.6-Max-Preview", + name: "Qwen 3.6 Max (CC)", + supportsReasoning: true, + contextLength: 1000000, + maxOutputTokens: 131072, + }, + { + id: "Qwen/Qwen3.6-Plus", + name: "Qwen 3.6 Plus (CC)", + supportsReasoning: true, + contextLength: 1000000, + maxOutputTokens: 131072, + }, +]; + const GPT_5_5_CONTEXT_LENGTH = 1050000; const GPT_5_5_CODEX_CAPABILITIES = { targetFormat: "openai-responses", @@ -272,7 +415,12 @@ const CHAT_OPENAI_COMPAT_MODELS: Record<string, RegistryModel[]> = { codestral: buildModels(["codestral-2405", "codestral-latest"]), upstage: buildModels(["solar-pro3", "solar-mini"]), maritalk: buildModels(["sabia-4", "sabia-3.1", "sabiazinho-4", "sabiazinho-3"]), - "xiaomi-mimo": buildModels(["mimo-v2.5-pro", "mimo-v2.5", "mimo-v2-omni", "mimo-v2-flash"]), + "xiaomi-mimo": [ + { id: "mimo-v2.5-pro", name: "MiMo-V2.5-Pro", contextLength: 1048576, maxOutputTokens: 131072 }, + { id: "mimo-v2.5", name: "MiMo-V2.5", contextLength: 1048576, maxOutputTokens: 131072 }, + { id: "mimo-v2-omni", name: "MiMo-V2-Omni", contextLength: 262144, maxOutputTokens: 131072 }, + { id: "mimo-v2-flash", name: "MiMo-V2-Flash", contextLength: 262144, maxOutputTokens: 65536 }, + ], "inference-net": buildModels([ "meta-llama/Llama-3.3-70B-Instruct", "deepseek-ai/DeepSeek-R1", @@ -370,11 +518,48 @@ export const REGISTRY: Record<string, RegistryEntry> = { tokenUrl: "https://console.anthropic.com/v1/oauth/token", }, models: [ - { id: "claude-opus-4-7", name: "Claude Opus 4.7", supportsXHighEffort: true }, - { id: "claude-opus-4-6", name: "Claude Opus 4.6", supportsXHighEffort: false }, - { id: "claude-sonnet-4-6", name: "Claude 4.6 Sonnet", supportsXHighEffort: false }, - { id: "claude-sonnet-4-5-20250929", name: "Claude 4.5 Sonnet", supportsXHighEffort: false }, - { id: "claude-haiku-4-5-20251001", name: "Claude 4.5 Haiku", supportsXHighEffort: false }, + { + id: "claude-opus-4-7", + name: "Claude Opus 4.7", + supportsXHighEffort: true, + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { + id: "claude-opus-4-6", + name: "Claude Opus 4.6", + supportsXHighEffort: false, + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { + id: "claude-opus-4-5-20251101", + name: "Claude Opus 4.5", + supportsXHighEffort: false, + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-sonnet-4-6", + name: "Claude 4.6 Sonnet", + supportsXHighEffort: false, + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-sonnet-4-5-20250929", + name: "Claude 4.5 Sonnet", + supportsXHighEffort: false, + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-haiku-4-5-20251001", + name: "Claude 4.5 Haiku", + supportsXHighEffort: false, + contextLength: 200000, + maxOutputTokens: 64000, + }, ], }, @@ -447,11 +632,45 @@ export const REGISTRY: Record<string, RegistryEntry> = { tokenUrl: "https://auth.openai.com/oauth/token", }, models: [ - { id: "gpt-5.5", name: "GPT 5.5", ...GPT_5_5_CODEX_CAPABILITIES }, - { id: "gpt-5.5-xhigh", name: "GPT 5.5 (xHigh)", ...GPT_5_5_CODEX_CAPABILITIES }, - { id: "gpt-5.5-high", name: "GPT 5.5 (High)", ...GPT_5_5_CODEX_CAPABILITIES }, - { id: "gpt-5.5-medium", name: "GPT 5.5 (Medium)", ...GPT_5_5_CODEX_CAPABILITIES }, - { id: "gpt-5.5-low", name: "GPT 5.5 (Low)", ...GPT_5_5_CODEX_CAPABILITIES }, + // gpt-5.5 codex OAuth backend caps context at 400K (not the public-API + // 1.05M). Public refs : openai/codex#19208, #19319, #19464 ; + // opencode#24171. max_output_tokens is stripped server-side + // (litellm#21193, codex#4138) so 128K is informational only. + { + id: "gpt-5.5", + name: "GPT 5.5", + ...GPT_5_5_CODEX_CAPABILITIES, + contextLength: 400000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.5-xhigh", + name: "GPT 5.5 (xHigh)", + ...GPT_5_5_CODEX_CAPABILITIES, + contextLength: 400000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.5-high", + name: "GPT 5.5 (High)", + ...GPT_5_5_CODEX_CAPABILITIES, + contextLength: 400000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.5-medium", + name: "GPT 5.5 (Medium)", + ...GPT_5_5_CODEX_CAPABILITIES, + contextLength: 400000, + maxOutputTokens: 128000, + }, + { + id: "gpt-5.5-low", + name: "GPT 5.5 (Low)", + ...GPT_5_5_CODEX_CAPABILITIES, + contextLength: 400000, + maxOutputTokens: 128000, + }, { id: "gpt-5.4", name: "GPT 5.4", targetFormat: "openai-responses" }, { id: "gpt-5.4-mini", name: "GPT 5.4 Mini", targetFormat: "openai-responses" }, { id: "gpt-5.3-codex-spark", name: "GPT 5.3 Codex Spark" }, @@ -553,20 +772,56 @@ export const REGISTRY: Record<string, RegistryEntry> = { defaultContextLength: 128000, headers: getGitHubCopilotChatHeaders(), models: [ - { id: "gpt-5-mini", name: "GPT-5 Mini" }, + { id: "gpt-5-mini", name: "GPT-5 Mini", targetFormat: "openai-responses" }, { id: "gpt-5.3-codex", name: "GPT-5.3 Codex", targetFormat: "openai-responses" }, { id: "gpt-5.4-mini", name: "GPT-5.4 Mini", targetFormat: "openai-responses" }, { id: "gpt-5.4", name: "GPT-5.4", targetFormat: "openai-responses" }, { id: "gpt-5.5", name: "GPT-5.5", ...GPT_5_5_CODEX_CAPABILITIES }, - { id: "claude-haiku-4.5", name: "Claude Haiku 4.5" }, - { id: "claude-sonnet-4.5", name: "Claude Sonnet 4.5" }, - { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6" }, - { id: "claude-opus-4-5-20251101", name: "Claude Opus 4.5 (Full ID)" }, - { id: "claude-opus-4.6", name: "Claude Opus 4.6" }, - { id: "claude-opus-4.7", name: "Claude Opus 4.7" }, - { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro" }, - { id: "gemini-3-flash-preview", name: "Gemini 3 Flash" }, - { id: "oswe-vscode-prime", name: "Raptor Mini" }, + { + id: "claude-haiku-4.5", + name: "Claude Haiku 4.5", + targetFormat: "openai-responses", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-sonnet-4.5", + name: "Claude Sonnet 4.5", + targetFormat: "openai-responses", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-sonnet-4.6", + name: "Claude Sonnet 4.6", + targetFormat: "openai-responses", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-opus-4-5-20251101", + name: "Claude Opus 4.5 (Full ID)", + targetFormat: "openai-responses", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-opus-4.6", + name: "Claude Opus 4.6", + targetFormat: "openai-responses", + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { + id: "claude-opus-4.7", + name: "Claude Opus 4.7", + targetFormat: "openai-responses", + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro", targetFormat: "openai-responses" }, + { id: "gemini-3-flash-preview", name: "Gemini 3 Flash", targetFormat: "openai-responses" }, + { id: "oswe-vscode-prime", name: "Raptor Mini", targetFormat: "openai-responses" }, //{ id: "?", name: "Goldeneye" }, ], }, @@ -586,14 +841,43 @@ export const REGISTRY: Record<string, RegistryEntry> = { authUrl: "https://prod.us-east-1.auth.desktop.kiro.dev", }, models: [ - { id: "claude-opus-4.7", name: "Claude Opus 4.7" }, - { id: "claude-opus-4.6", name: "Claude Opus 4.6" }, - { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6" }, - { id: "claude-sonnet-4.5", name: "Claude Sonnet 4.5" }, - { id: "claude-haiku-4.5", name: "Claude Haiku 4.5" }, - //{ id: "?", name: "DeepSeek V3.2" }, - //{ id: "?", name: "MiniMax M2.5" }, - //{ id: "?", name: "GLM-5" }, + { id: "auto-kiro", name: "Auto (Kiro picks best model)" }, + { + id: "claude-opus-4.7", + name: "Claude Opus 4.7", + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { + id: "claude-opus-4.6", + name: "Claude Opus 4.6", + contextLength: 1000000, + maxOutputTokens: 128000, + }, + { + id: "claude-sonnet-4.6", + name: "Claude Sonnet 4.6", + contextLength: 200000, + maxOutputTokens: 64000, + }, + // models for kiro free tier + { + id: "claude-sonnet-4.5", + name: "Claude Sonnet 4.5", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { + id: "claude-haiku-4.5", + name: "Claude Haiku 4.5", + contextLength: 200000, + maxOutputTokens: 64000, + }, + { id: "deepseek-3.2", name: "DeepSeek V3.2" }, + { id: "minimax-m2.5", name: "MiniMax M2.5" }, + { id: "minimax-m2.1", name: "MiniMax M2.1" }, + { id: "glm-5", name: "GLM-5" }, + { id: "qwen3-coder-next", name: "Qwen3 Coder Next" }, ], }, @@ -613,6 +897,44 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "auto", name: "Auto (Server Picks)" }, { id: "composer-2-fast", name: "Composer 2 Fast" }, { id: "composer-2", name: "Composer 2" }, + // + { id: "gpt-5.5-none", name: "GPT 5.5 None" }, + { id: "gpt-5.5-none-fast", name: "GPT 5.5 None Fast" }, + { id: "gpt-5.5-low", name: "GPT 5.5 Low" }, + { id: "gpt-5.5-low-fast", name: "GPT 5.5 Low Fast" }, + { id: "gpt-5.5-medium", name: "GPT 5.5 Medium" }, + { id: "gpt-5.5-medium-fast", name: "GPT 5.5 Medium Fast" }, + { id: "gpt-5.5-high", name: "GPT 5.5 High" }, + { id: "gpt-5.5-high-fast", name: "GPT 5.5 High Fast" }, + { id: "gpt-5.5-extra-high", name: "GPT 5.5 Extra High" }, + { id: "gpt-5.5-extra-high-fast", name: "GPT 5.5 Extra High Fast" }, + // + { id: "gpt-5.4-low", name: "GPT 5.4 Low" }, + { id: "gpt-5.4-low-fast", name: "GPT 5.4 Low Fast" }, + { id: "gpt-5.4-medium", name: "GPT 5.4 Medium" }, + { id: "gpt-5.4-medium-fast", name: "GPT 5.4 Medium Fast" }, + { id: "gpt-5.4-high", name: "GPT 5.4 High" }, + { id: "gpt-5.4-high-fast", name: "GPT 5.4 High Fast" }, + { id: "gpt-5.4-xhigh", name: "GPT 5.4 XHigh" }, + { id: "gpt-5.4-xhigh-fast", name: "GPT 5.4 XHigh Fast" }, + // + { id: "gpt-5.4-mini-none", name: "GPT 5.4 Mini None" }, + { id: "gpt-5.4-mini-low", name: "GPT 5.4 Mini Low" }, + { id: "gpt-5.4-mini-medium", name: "GPT 5.4 Mini Medium" }, + { id: "gpt-5.4-mini-high", name: "GPT 5.4 Mini High" }, + { id: "gpt-5.4-mini-xhigh", name: "GPT 5.4 Mini XHigh" }, + // + { id: "gpt-5.4-nano-none", name: "GPT 5.4 Nano None" }, + { id: "gpt-5.4-nano-low", name: "GPT 5.4 Nano Low" }, + { id: "gpt-5.4-nano-medium", name: "GPT 5.4 Nano Medium" }, + { id: "gpt-5.4-nano-high", name: "GPT 5.4 Nano High" }, + { id: "gpt-5.4-nano-xhigh", name: "GPT 5.4 Nano XHigh" }, + // + { id: "gpt-5.3-codex-spark-preview-low", name: "GPT 5.3 Codex Spark Preview Low" }, + { id: "gpt-5.3-codex-spark-preview", name: "GPT 5.3 Codex Spark Preview" }, + { id: "gpt-5.3-codex-spark-preview-high", name: "GPT 5.3 Codex Spark Preview High" }, + { id: "gpt-5.3-codex-spark-preview-xhigh", name: "GPT 5.3 Codex Spark Preview XHigh" }, + // { id: "gpt-5.3-codex-low", name: "GPT 5.3 Codex Low" }, { id: "gpt-5.3-codex-low-fast", name: "GPT 5.3 Codex Low Fast" }, { id: "gpt-5.3-codex", name: "GPT 5.3 Codex" }, @@ -621,95 +943,47 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "gpt-5.3-codex-high-fast", name: "GPT 5.3 Codex High Fast" }, { id: "gpt-5.3-codex-xhigh", name: "GPT 5.3 Codex XHigh" }, { id: "gpt-5.3-codex-xhigh-fast", name: "GPT 5.3 Codex XHigh Fast" }, - { id: "gpt-5.2", name: "GPT 5.2" }, - { id: "gpt-5.3-codex-spark-preview-low", name: "GPT 5.3 Codex Spark Preview Low" }, - { id: "gpt-5.3-codex-spark-preview", name: "GPT 5.3 Codex Spark Preview" }, - { id: "gpt-5.3-codex-spark-preview-high", name: "GPT 5.3 Codex Spark Preview High" }, - { id: "gpt-5.3-codex-spark-preview-xhigh", name: "GPT 5.3 Codex Spark Preview XHigh" }, - { id: "gpt-5.2-codex-low", name: "GPT 5.2 Codex Low" }, - { id: "gpt-5.2-codex-low-fast", name: "GPT 5.2 Codex Low Fast" }, - { id: "gpt-5.2-codex", name: "GPT 5.2 Codex" }, - { id: "gpt-5.2-codex-fast", name: "GPT 5.2 Codex Fast" }, - { id: "gpt-5.2-codex-high", name: "GPT 5.2 Codex High" }, - { id: "gpt-5.2-codex-high-fast", name: "GPT 5.2 Codex High Fast" }, - { id: "gpt-5.2-codex-xhigh", name: "GPT 5.2 Codex XHigh" }, - { id: "gpt-5.2-codex-xhigh-fast", name: "GPT 5.2 Codex XHigh Fast" }, - { id: "gpt-5.1-codex-max-low", name: "GPT 5.1 Codex Max Low" }, - { id: "gpt-5.1-codex-max-low-fast", name: "GPT 5.1 Codex Max Low Fast" }, - { id: "gpt-5.1-codex-max-medium", name: "GPT 5.1 Codex Max Medium" }, - { id: "gpt-5.1-codex-max-medium-fast", name: "GPT 5.1 Codex Max Medium Fast" }, - { id: "gpt-5.1-codex-max-high", name: "GPT 5.1 Codex Max High" }, - { id: "gpt-5.1-codex-max-high-fast", name: "GPT 5.1 Codex Max High Fast" }, - { id: "gpt-5.1-codex-max-xhigh", name: "GPT 5.1 Codex Max XHigh" }, - { id: "gpt-5.1-codex-max-xhigh-fast", name: "GPT 5.1 Codex Max XHigh Fast" }, - { id: "gpt-5.5-high", name: "GPT 5.5 High" }, - { id: "gpt-5.5-high-fast", name: "GPT 5.5 High Fast" }, - { id: "claude-opus-4-7-thinking-high", name: "Claude Opus 4.7 Thinking High" }, - { id: "gpt-5.4-high", name: "GPT 5.4 High" }, - { id: "gpt-5.4-high-fast", name: "GPT 5.4 High Fast" }, - { id: "claude-4.6-opus-high-thinking", name: "Claude 4.6 Opus High Thinking" }, - { id: "claude-4.6-opus-high-thinking-fast", name: "Claude 4.6 Opus High Thinking Fast" }, - { id: "claude-4.6-sonnet-medium", name: "Claude 4.6 Sonnet Medium" }, - { id: "claude-4.6-sonnet-medium-thinking", name: "Claude 4.6 Sonnet Medium Thinking" }, - { id: "gpt-5.5-none", name: "GPT 5.5 None" }, - { id: "gpt-5.5-none-fast", name: "GPT 5.5 None Fast" }, - { id: "gpt-5.5-low", name: "GPT 5.5 Low" }, - { id: "gpt-5.5-low-fast", name: "GPT 5.5 Low Fast" }, - { id: "gpt-5.5-medium", name: "GPT 5.5 Medium" }, - { id: "gpt-5.5-medium-fast", name: "GPT 5.5 Medium Fast" }, - { id: "gpt-5.5-extra-high", name: "GPT 5.5 Extra High" }, - { id: "gpt-5.5-extra-high-fast", name: "GPT 5.5 Extra High Fast" }, - { id: "claude-opus-4-7-low", name: "Claude Opus 4.7 Low" }, - { id: "claude-opus-4-7-medium", name: "Claude Opus 4.7 Medium" }, - { id: "claude-opus-4-7-high", name: "Claude Opus 4.7 High" }, - { id: "claude-opus-4-7-xhigh", name: "Claude Opus 4.7 XHigh" }, - { id: "claude-opus-4-7-max", name: "Claude Opus 4.7 Max" }, - { id: "claude-opus-4-7-thinking-low", name: "Claude Opus 4.7 Thinking Low" }, - { id: "claude-opus-4-7-thinking-medium", name: "Claude Opus 4.7 Thinking Medium" }, - { id: "claude-opus-4-7-thinking-xhigh", name: "Claude Opus 4.7 Thinking XHigh" }, - { id: "claude-opus-4-7-thinking-max", name: "Claude Opus 4.7 Thinking Max" }, - { id: "gpt-5.4-low", name: "GPT 5.4 Low" }, - { id: "gpt-5.4-medium", name: "GPT 5.4 Medium" }, - { id: "gpt-5.4-medium-fast", name: "GPT 5.4 Medium Fast" }, - { id: "gpt-5.4-xhigh", name: "GPT 5.4 XHigh" }, - { id: "gpt-5.4-xhigh-fast", name: "GPT 5.4 XHigh Fast" }, - { id: "claude-4.6-opus-high", name: "Claude 4.6 Opus High" }, - { id: "claude-4.6-opus-max", name: "Claude 4.6 Opus Max" }, - { id: "claude-4.6-opus-max-thinking", name: "Claude 4.6 Opus Max Thinking" }, - { id: "claude-4.6-opus-max-thinking-fast", name: "Claude 4.6 Opus Max Thinking Fast" }, - { id: "claude-4.5-opus-high", name: "Claude 4.5 Opus High" }, - { id: "claude-4.5-opus-high-thinking", name: "Claude 4.5 Opus High Thinking" }, + // { id: "gpt-5.2-low", name: "GPT 5.2 Low" }, { id: "gpt-5.2-low-fast", name: "GPT 5.2 Low Fast" }, + { id: "gpt-5.2", name: "GPT 5.2" }, { id: "gpt-5.2-fast", name: "GPT 5.2 Fast" }, { id: "gpt-5.2-high", name: "GPT 5.2 High" }, { id: "gpt-5.2-high-fast", name: "GPT 5.2 High Fast" }, { id: "gpt-5.2-xhigh", name: "GPT 5.2 XHigh" }, { id: "gpt-5.2-xhigh-fast", name: "GPT 5.2 XHigh Fast" }, - { id: "gemini-3.1-pro", name: "Gemini 3.1 Pro" }, - { id: "gpt-5.4-mini-none", name: "GPT 5.4 Mini None" }, - { id: "gpt-5.4-mini-low", name: "GPT 5.4 Mini Low" }, - { id: "gpt-5.4-mini-medium", name: "GPT 5.4 Mini Medium" }, - { id: "gpt-5.4-mini-high", name: "GPT 5.4 Mini High" }, - { id: "gpt-5.4-mini-xhigh", name: "GPT 5.4 Mini XHigh" }, - { id: "gpt-5.4-nano-none", name: "GPT 5.4 Nano None" }, - { id: "gpt-5.4-nano-low", name: "GPT 5.4 Nano Low" }, - { id: "gpt-5.4-nano-medium", name: "GPT 5.4 Nano Medium" }, - { id: "gpt-5.4-nano-high", name: "GPT 5.4 Nano High" }, - { id: "gpt-5.4-nano-xhigh", name: "GPT 5.4 Nano XHigh" }, - { id: "grok-4.3", name: "Grok 4.3" }, + // + { id: "claude-opus-4-7-low", name: "Claude Opus 4.7 Low" }, + { id: "claude-opus-4-7-medium", name: "Claude Opus 4.7 Medium" }, + { id: "claude-opus-4-7-high", name: "Claude Opus 4.7 High" }, + { id: "claude-opus-4-7-xhigh", name: "Claude Opus 4.7 XHigh" }, + { id: "claude-opus-4-7-max", name: "Claude Opus 4.7 Max" }, + + { id: "claude-opus-4-7-thinking-low", name: "Claude Opus 4.7 Thinking Low" }, + { id: "claude-opus-4-7-thinking-medium", name: "Claude Opus 4.7 Thinking Medium" }, + { id: "claude-opus-4-7-thinking-high", name: "Claude Opus 4.7 Thinking High" }, + { id: "claude-opus-4-7-thinking-xhigh", name: "Claude Opus 4.7 Thinking XHigh" }, + { id: "claude-opus-4-7-thinking-max", name: "Claude Opus 4.7 Thinking Max" }, + // + { id: "claude-4.6-opus-high", name: "Claude 4.6 Opus High" }, + { id: "claude-4.6-opus-high-thinking", name: "Claude 4.6 Opus High Thinking" }, + { id: "claude-4.6-opus-high-thinking-fast", name: "Claude 4.6 Opus High Thinking Fast" }, + { id: "claude-4.6-opus-max", name: "Claude 4.6 Opus Max" }, + { id: "claude-4.6-opus-max-thinking", name: "Claude 4.6 Opus Max Thinking" }, + { id: "claude-4.6-opus-max-thinking-fast", name: "Claude 4.6 Opus Max Thinking Fast" }, + // + { id: "claude-4.6-sonnet-medium", name: "Claude 4.6 Sonnet Medium" }, + { id: "claude-4.6-sonnet-medium-thinking", name: "Claude 4.6 Sonnet Medium Thinking" }, + // { id: "claude-4.5-sonnet", name: "Claude 4.5 Sonnet" }, { id: "claude-4.5-sonnet-thinking", name: "Claude 4.5 Sonnet Thinking" }, - { id: "gpt-5.1-low", name: "GPT 5.1 Low" }, - { id: "gpt-5.1", name: "GPT 5.1" }, - { id: "gpt-5.1-high", name: "GPT 5.1 High" }, + // + { id: "gemini-3.1-pro", name: "Gemini 3.1 Pro" }, + // { id: "gemini-3-flash", name: "Gemini 3 Flash" }, - { id: "gpt-5.1-codex-mini-low", name: "GPT 5.1 Codex Mini Low" }, - { id: "gpt-5.1-codex-mini", name: "GPT 5.1 Codex Mini" }, - { id: "gpt-5.1-codex-mini-high", name: "GPT 5.1 Codex Mini High" }, - { id: "claude-4-sonnet", name: "Claude 4 Sonnet" }, - { id: "claude-4-sonnet-thinking", name: "Claude 4 Sonnet Thinking" }, - { id: "gpt-5-mini", name: "GPT 5 Mini" }, + // + { id: "grok-4.3", name: "Grok 4.3" }, + // { id: "kimi-k2.5", name: "Kimi K2.5" }, ], }, @@ -730,7 +1004,8 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "gpt-5.4-mini", name: "GPT-5.4 Mini" }, { id: "gpt-5.4-nano", name: "GPT-5.4 Nano" }, { id: "gpt-4.1", name: "GPT-4.1" }, - { id: "gpt-4o", name: "GPT-4o" }, + { id: "gpt-4o", name: "GPT-4o", contextLength: 128000 }, + { id: "gpt-4o-2024-11-20", name: "GPT-4o (Nov 2024)", contextLength: 128000 }, { id: "o3", name: "O3", unsupportedParams: REASONING_UNSUPPORTED }, ], }, @@ -781,8 +1056,8 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "minimax-m2.5", name: "MiniMax M2.5", targetFormat: "claude" }, { id: "qwen3.6-plus", name: "Qwen3.6 Plus" }, { id: "qwen3.5-plus", name: "Qwen3.5 Plus" }, - { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" }, - { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash" }, + { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, + { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash", supportsReasoning: true }, ], }, @@ -801,8 +1076,7 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "big-pickle", name: "Big Pickle" }, { id: "gpt-5-nano", name: "GPT 5 Nano", contextLength: 400000 }, { id: "minimax-m2.5-free", name: "MiniMax M2.5 Free", contextLength: 204800 }, - { id: "hy3-preview-free", name: "Hy3 Preview Free", contextLength: 256000 }, - { id: "ling-2.6-flash-free", name: "Ling 2.6 Flash Free", contextLength: 262000 }, + { id: "ling-2.6-1t-free", name: "Ling 2.6 Free", contextLength: 262000 }, { id: "trinity-large-preview-free", name: "Trinity Large Preview Free", @@ -846,6 +1120,20 @@ export const REGISTRY: Record<string, RegistryEntry> = { passthroughModels: true, }, + "command-code": { + id: "command-code", + alias: "cmd", + format: "openai", + executor: "command-code", + baseUrl: "https://api.commandcode.ai", + chatPath: "/alpha/generate", + authType: "apikey", + authHeader: "Authorization", + authPrefix: "Bearer ", + defaultContextLength: 200000, + models: COMMAND_CODE_MODELS, + }, + openrouter: { id: "openrouter", alias: "openrouter", @@ -895,7 +1183,7 @@ export const REGISTRY: Record<string, RegistryEntry> = { "glm-cn": { id: "glm-cn", - alias: "glm-cn", + alias: "glmcn", format: "openai", executor: "glm", baseUrl: "https://open.bigmodel.cn/api/coding/paas/v4/chat/completions", @@ -927,23 +1215,20 @@ export const REGISTRY: Record<string, RegistryEntry> = { alias: "bcp", format: "claude", executor: "default", - baseUrl: "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1/messages", + baseUrl: "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1", chatPath: "/messages", - urlSuffix: "?beta=true", authType: "apikey", authHeader: "x-api-key", headers: { "Anthropic-Version": ANTHROPIC_VERSION_HEADER, }, models: [ - { id: "qwen3.5-plus", name: "Qwen3.5 Plus" }, - { id: "qwen3-max-2026-01-23", name: "Qwen3 Max (2026-01-23)" }, - { id: "qwen3-coder-next", name: "Qwen3 Coder Next" }, - { id: "qwen3-coder-plus", name: "Qwen3 Coder Plus" }, - { id: "MiniMax-M2.5", name: "MiniMax M2.5" }, + { id: "qwen3.6-plus", name: "Qwen3.6 Plus(vision)" }, + { id: "qwen3.5-plus", name: "Qwen3.5 Plus(vision)" }, + { id: "qwen3-max-2026-01-23", name: "Qwen3 Max" }, + { id: "kimi-k2.5", name: "Kimi K2.5(vision)" }, { id: "glm-5", name: "GLM 5" }, - { id: "glm-4.7", name: "GLM 4.7" }, - { id: "kimi-k2.5", name: "Kimi K2.5" }, + { id: "MiniMax-M2.5", name: "MiniMax M2.5" }, ], }, @@ -1028,8 +1313,8 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "google/gemini-3.1-pro-preview", name: "Gemini 3.1 Pro" }, { id: "google/gemini-3-flash-preview", name: "Gemini 3 Flash" }, { id: "google/gemini-3.1-flash-lite", name: "Gemini 3.1 Flash Lite" }, - { id: "deepseek/deepseek-v4-pro", name: "DeepSeek V4 Pro" }, - { id: "deepseek/deepseek-v4-flash", name: "DeepSeek V4 Flash" }, + { id: "deepseek/deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, + { id: "deepseek/deepseek-v4-flash", name: "DeepSeek V4 Flash", supportsReasoning: true }, { id: "moonshotai/kimi-k2.6", name: "Kimi K2.6" }, ], passthroughModels: true, @@ -1060,12 +1345,233 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "google/gemini-3.1-pro-preview", name: "Gemini 3.1 Pro" }, { id: "google/gemini-3-flash-preview", name: "Gemini 3 Flash" }, { id: "openai/gpt-5.5", name: "GPT-5.5" }, - { id: "deepseek/deepseek-v4-flash", name: "DeepSeek V4 Flash" }, - { id: "deepseek/deepseek-v4-pro", name: "DeepSeek V4 Pro" }, + { id: "deepseek/deepseek-v4-flash", name: "DeepSeek V4 Flash", supportsReasoning: true }, + { id: "deepseek/deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, ], passthroughModels: true, }, + windsurf: { + id: "windsurf", + alias: "ws", + format: "windsurf", + executor: "windsurf", + // gRPC-web endpoint — handled entirely inside WindsurfExecutor. + // Model IDs are the canonical Windsurf catalog names (with dots), auto-synced + // from the Windsurf cloud via GetCascadeModelConfigs. Source: guanxiaol/WindsurfPoolAPI. + baseUrl: "https://server.self-serve.windsurf.com", + authType: "oauth", + authHeader: "Authorization", + authPrefix: "Bearer ", + defaultContextLength: 200000, + // Model IDs verified against model_configs_v2.bin from Devin CLI binary (2026.5.x). + // dot-notation = OmniRoute ID; executor MODEL_ALIAS_MAP maps it to Windsurf modelUid. + models: [ + // ── Cognition / SWE ────────────────────────────────────────────────── + { id: "swe-1.6-fast", name: "SWE-1.6 Fast" }, + { id: "swe-1.6", name: "SWE-1.6" }, + { id: "swe-1.5-fast", name: "SWE-1.5 Fast" }, + { id: "swe-1.5", name: "SWE-1.5" }, + { id: "swe-check", name: "SWE Check" }, + // ── Claude Opus 4.7 — effort-tiered ───────────────────────────────── + { id: "claude-opus-4.7-max", name: "Claude Opus 4.7 Max", contextLength: 200000 }, + { id: "claude-opus-4.7-xhigh", name: "Claude Opus 4.7 XHigh", contextLength: 200000 }, + { id: "claude-opus-4.7-high", name: "Claude Opus 4.7 High", contextLength: 200000 }, + { id: "claude-opus-4.7-medium", name: "Claude Opus 4.7 Medium", contextLength: 200000 }, + { id: "claude-opus-4.7-low", name: "Claude Opus 4.7 Low", contextLength: 200000 }, + { id: "claude-opus-4.7-review", name: "Claude Opus 4.7 Review", contextLength: 200000 }, + // ── Claude Sonnet/Opus 4.6 ────────────────────────────────────────── + { + id: "claude-sonnet-4.6-thinking-1m", + name: "Claude Sonnet 4.6 Thinking 1M", + contextLength: 1000000, + }, + { id: "claude-sonnet-4.6-1m", name: "Claude Sonnet 4.6 1M", contextLength: 1000000 }, + { + id: "claude-sonnet-4.6-thinking", + name: "Claude Sonnet 4.6 Thinking", + contextLength: 200000, + }, + { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6", contextLength: 200000 }, + { id: "claude-opus-4.6-thinking", name: "Claude Opus 4.6 Thinking", contextLength: 200000 }, + { id: "claude-opus-4.6", name: "Claude Opus 4.6", contextLength: 200000 }, + // ── Claude 4.5 ────────────────────────────────────────────────────── + { id: "claude-opus-4.5-thinking", name: "Claude Opus 4.5 Thinking", contextLength: 200000 }, + { id: "claude-opus-4.5", name: "Claude Opus 4.5", contextLength: 200000 }, + { + id: "claude-sonnet-4.5-thinking", + name: "Claude Sonnet 4.5 Thinking", + contextLength: 200000, + }, + { id: "claude-sonnet-4.5", name: "Claude Sonnet 4.5", contextLength: 200000 }, + { id: "claude-haiku-4.5", name: "Claude Haiku 4.5", contextLength: 200000 }, + // ── Claude 4.1 / 4 ────────────────────────────────────────────────── + { id: "claude-4.1-opus-thinking", name: "Claude 4.1 Opus Thinking", contextLength: 200000 }, + { id: "claude-4.1-opus", name: "Claude 4.1 Opus", contextLength: 200000 }, + { id: "claude-4-opus-thinking", name: "Claude 4 Opus Thinking", contextLength: 200000 }, + { id: "claude-4-opus", name: "Claude 4 Opus", contextLength: 200000 }, + { id: "claude-4-sonnet-thinking", name: "Claude 4 Sonnet Thinking", contextLength: 200000 }, + { id: "claude-4-sonnet", name: "Claude 4 Sonnet", contextLength: 200000 }, + // ── Claude 3.x ────────────────────────────────────────────────────── + { + id: "claude-3.7-sonnet-thinking", + name: "Claude 3.7 Sonnet Thinking", + contextLength: 200000, + }, + { id: "claude-3.7-sonnet", name: "Claude 3.7 Sonnet", contextLength: 200000 }, + { id: "claude-3.5-sonnet", name: "Claude 3.5 Sonnet", contextLength: 200000 }, + // ── GPT-5.5 — effort-tiered (+ fast/priority variants) ────────────── + { id: "gpt-5.5-xhigh-fast", name: "GPT-5.5 XHigh Fast", contextLength: 200000 }, + { id: "gpt-5.5-xhigh", name: "GPT-5.5 XHigh", contextLength: 200000 }, + { id: "gpt-5.5-high-fast", name: "GPT-5.5 High Fast", contextLength: 200000 }, + { id: "gpt-5.5-high", name: "GPT-5.5 High", contextLength: 200000 }, + { id: "gpt-5.5-medium-fast", name: "GPT-5.5 Medium Fast", contextLength: 200000 }, + { id: "gpt-5.5-medium", name: "GPT-5.5 Medium", contextLength: 200000 }, + { id: "gpt-5.5-low-fast", name: "GPT-5.5 Low Fast", contextLength: 200000 }, + { id: "gpt-5.5-low", name: "GPT-5.5 Low", contextLength: 200000 }, + { id: "gpt-5.5-none-fast", name: "GPT-5.5 None Fast", contextLength: 200000 }, + { id: "gpt-5.5-none", name: "GPT-5.5 None", contextLength: 200000 }, + { id: "gpt-5.5-review", name: "GPT-5.5 Review", contextLength: 200000 }, + // ── GPT-5.4 — effort-tiered (+ mini + fast variants) ──────────────── + { id: "gpt-5.4-xhigh-fast", name: "GPT-5.4 XHigh Fast", contextLength: 200000 }, + { id: "gpt-5.4-xhigh", name: "GPT-5.4 XHigh", contextLength: 200000 }, + { id: "gpt-5.4-high-fast", name: "GPT-5.4 High Fast", contextLength: 200000 }, + { id: "gpt-5.4-high", name: "GPT-5.4 High", contextLength: 200000 }, + { id: "gpt-5.4-medium-fast", name: "GPT-5.4 Medium Fast", contextLength: 200000 }, + { id: "gpt-5.4-medium", name: "GPT-5.4 Medium", contextLength: 200000 }, + { id: "gpt-5.4-low-fast", name: "GPT-5.4 Low Fast", contextLength: 200000 }, + { id: "gpt-5.4-low", name: "GPT-5.4 Low", contextLength: 200000 }, + { id: "gpt-5.4-none-fast", name: "GPT-5.4 None Fast", contextLength: 200000 }, + { id: "gpt-5.4-none", name: "GPT-5.4 None", contextLength: 200000 }, + { id: "gpt-5.4-mini-xhigh", name: "GPT-5.4 Mini XHigh", contextLength: 128000 }, + { id: "gpt-5.4-mini-high", name: "GPT-5.4 Mini High", contextLength: 128000 }, + { id: "gpt-5.4-mini-medium", name: "GPT-5.4 Mini Medium", contextLength: 128000 }, + { id: "gpt-5.4-mini-low", name: "GPT-5.4 Mini Low", contextLength: 128000 }, + // ── GPT-5.3 Codex — effort-tiered (+ fast variants) ───────────────── + { id: "gpt-5.3-codex-xhigh-fast", name: "GPT-5.3 Codex XHigh Fast", contextLength: 200000 }, + { id: "gpt-5.3-codex-xhigh", name: "GPT-5.3 Codex XHigh", contextLength: 200000 }, + { id: "gpt-5.3-codex-high-fast", name: "GPT-5.3 Codex High Fast", contextLength: 200000 }, + { id: "gpt-5.3-codex-high", name: "GPT-5.3 Codex High", contextLength: 200000 }, + { id: "gpt-5.3-codex-medium-fast", name: "GPT-5.3 Codex Medium Fast", contextLength: 200000 }, + { id: "gpt-5.3-codex-medium", name: "GPT-5.3 Codex Medium", contextLength: 200000 }, + { id: "gpt-5.3-codex-low-fast", name: "GPT-5.3 Codex Low Fast", contextLength: 200000 }, + { id: "gpt-5.3-codex-low", name: "GPT-5.3 Codex Low", contextLength: 200000 }, + // ── GPT-5.2 ───────────────────────────────────────────────────────── + { id: "gpt-5.2-xhigh", name: "GPT-5.2 XHigh", contextLength: 200000 }, + { id: "gpt-5.2-high", name: "GPT-5.2 High", contextLength: 200000 }, + { id: "gpt-5.2-medium", name: "GPT-5.2 Medium", contextLength: 200000 }, + { id: "gpt-5.2-low", name: "GPT-5.2 Low", contextLength: 200000 }, + { id: "gpt-5.2-none", name: "GPT-5.2 None", contextLength: 200000 }, + // ── GPT-5 ──────────────────────────────────────────────────────────── + { id: "gpt-5-codex", name: "GPT-5 Codex", contextLength: 200000 }, + { id: "gpt-5", name: "GPT-5", contextLength: 200000 }, + // ── GPT-4.1 / 4o ──────────────────────────────────────────────────── + { id: "gpt-4.1", name: "GPT-4.1", contextLength: 200000 }, + { id: "gpt-4.1-mini", name: "GPT-4.1 Mini", contextLength: 128000 }, + { id: "gpt-4.1-nano", name: "GPT-4.1 Nano", contextLength: 32000 }, + { id: "gpt-4o", name: "GPT-4o", contextLength: 128000 }, + { id: "gpt-4o-mini", name: "GPT-4o Mini", contextLength: 128000 }, + // ── Gemini ─────────────────────────────────────────────────────────── + { id: "gemini-3.1-pro-high", name: "Gemini 3.1 Pro High", contextLength: 1000000 }, + { id: "gemini-3.1-pro-low", name: "Gemini 3.1 Pro Low", contextLength: 1000000 }, + { id: "gemini-3.0-pro", name: "Gemini 3.0 Pro", contextLength: 1000000 }, + { id: "gemini-3.0-flash-high", name: "Gemini 3.0 Flash High", contextLength: 1000000 }, + { id: "gemini-3.0-flash-medium", name: "Gemini 3.0 Flash Medium", contextLength: 1000000 }, + { id: "gemini-3.0-flash-low", name: "Gemini 3.0 Flash Low", contextLength: 1000000 }, + { id: "gemini-3.0-flash-minimal", name: "Gemini 3.0 Flash Minimal", contextLength: 1000000 }, + { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro", contextLength: 1000000 }, + { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash", contextLength: 1000000 }, + // ── Others ─────────────────────────────────────────────────────────── + { id: "deepseek-v4", name: "DeepSeek V4", contextLength: 64000 }, + { id: "deepseek-r1", name: "DeepSeek R1", contextLength: 64000 }, + { id: "deepseek-v3-2", name: "DeepSeek V3-2", contextLength: 64000 }, + { id: "deepseek-v3", name: "DeepSeek V3", contextLength: 64000 }, + { id: "grok-3-mini-thinking", name: "Grok 3 Mini Thinking", contextLength: 131000 }, + { id: "grok-3-mini", name: "Grok 3 Mini", contextLength: 131000 }, + { id: "grok-3", name: "Grok 3", contextLength: 131000 }, + { id: "grok-code-fast-1", name: "Grok Code Fast 1", contextLength: 131000 }, + { id: "kimi-k2.6", name: "Kimi K2.6", contextLength: 131000 }, + { id: "kimi-k2.5", name: "Kimi K2.5", contextLength: 131000 }, + { id: "kimi-k2", name: "Kimi K2", contextLength: 131000 }, + { id: "glm-5.1", name: "GLM-5.1", contextLength: 128000 }, + { id: "glm-5", name: "GLM-5", contextLength: 128000 }, + { id: "glm-4.7", name: "GLM-4.7", contextLength: 128000 }, + ], + }, + + // ── Devin CLI (Official — ACP JSON-RPC over stdio) ────────────────────────── + // Uses the official `devin` binary via `devin acp --agent-type summarizer`. + // Requires devin CLI installed (https://cli.devin.ai) and authenticated + // via `devin auth login` or WINDSURF_API_KEY env var. + // Model IDs are passed directly to the ACP session/new `model` param. + "devin-cli": { + id: "devin-cli", + alias: "dv", + format: "openai", + executor: "devin-cli", + baseUrl: "devin://acp/stdio", + authType: "oauth", + authHeader: "Authorization", + authPrefix: "Bearer ", + defaultContextLength: 200000, + models: [ + // Cognition / SWE — default model family recommended for coding tasks + { id: "swe-1.6-fast", name: "SWE-1.6 Fast" }, + { id: "swe-1.6", name: "SWE-1.6" }, + { id: "swe-1.5-fast", name: "SWE-1.5 Fast" }, + { id: "swe-1.5", name: "SWE-1.5" }, + { id: "swe-check", name: "SWE Check" }, + // Claude Opus 4.7 + { id: "claude-opus-4.7-max", name: "Claude Opus 4.7 Max", contextLength: 200000 }, + { id: "claude-opus-4.7-high", name: "Claude Opus 4.7 High", contextLength: 200000 }, + { id: "claude-opus-4.7-medium", name: "Claude Opus 4.7 Medium", contextLength: 200000 }, + { id: "claude-opus-4.7-low", name: "Claude Opus 4.7 Low", contextLength: 200000 }, + // Claude Sonnet/Opus 4.6 + { + id: "claude-sonnet-4.6-thinking-1m", + name: "Claude Sonnet 4.6 Thinking 1M", + contextLength: 1000000, + }, + { + id: "claude-sonnet-4.6-thinking", + name: "Claude Sonnet 4.6 Thinking", + contextLength: 200000, + }, + { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6", contextLength: 200000 }, + { id: "claude-opus-4.6-thinking", name: "Claude Opus 4.6 Thinking", contextLength: 200000 }, + { id: "claude-opus-4.6", name: "Claude Opus 4.6", contextLength: 200000 }, + // Claude 4.5 + { id: "claude-sonnet-4.5", name: "Claude Sonnet 4.5", contextLength: 200000 }, + { id: "claude-haiku-4.5", name: "Claude Haiku 4.5", contextLength: 200000 }, + // GPT-5.5 + { id: "gpt-5.5-xhigh", name: "GPT-5.5 XHigh", contextLength: 200000 }, + { id: "gpt-5.5-high", name: "GPT-5.5 High", contextLength: 200000 }, + { id: "gpt-5.5-medium", name: "GPT-5.5 Medium", contextLength: 200000 }, + { id: "gpt-5.5-low", name: "GPT-5.5 Low", contextLength: 200000 }, + // GPT-5.4 + { id: "gpt-5.4-high", name: "GPT-5.4 High", contextLength: 200000 }, + { id: "gpt-5.4-medium", name: "GPT-5.4 Medium", contextLength: 200000 }, + { id: "gpt-5.4-low", name: "GPT-5.4 Low", contextLength: 200000 }, + // GPT-5.3 Codex + { id: "gpt-5.3-codex-high", name: "GPT-5.3 Codex High", contextLength: 200000 }, + { id: "gpt-5.3-codex-medium", name: "GPT-5.3 Codex Medium", contextLength: 200000 }, + { id: "gpt-5.3-codex-low", name: "GPT-5.3 Codex Low", contextLength: 200000 }, + // GPT-5.2 + { id: "gpt-5.2-high", name: "GPT-5.2 High", contextLength: 200000 }, + { id: "gpt-5.2-medium", name: "GPT-5.2 Medium", contextLength: 200000 }, + { id: "gpt-5.2-low", name: "GPT-5.2 Low", contextLength: 200000 }, + // Gemini + { id: "gemini-3.1-pro-high", name: "Gemini 3.1 Pro High", contextLength: 1000000 }, + { id: "gemini-3.0-pro", name: "Gemini 3.0 Pro", contextLength: 1000000 }, + { id: "gemini-3.0-flash-high", name: "Gemini 3.0 Flash High", contextLength: 1000000 }, + { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro", contextLength: 1000000 }, + // Others + { id: "deepseek-v4", name: "DeepSeek V4", contextLength: 64000 }, + { id: "kimi-k2.6", name: "Kimi K2.6", contextLength: 131000 }, + { id: "glm-5.1", name: "GLM-5.1", contextLength: 128000 }, + ], + }, + minimax: { id: "minimax", alias: "minimax", @@ -1119,7 +1625,7 @@ export const REGISTRY: Record<string, RegistryEntry> = { // Seed list — runtime /v1/models discovery keeps this fresh. // Source: GET https://crof.ai/v1/models (2026-04-25). models: [ - { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" }, + { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, { id: "deepseek-v3.2", name: "DeepSeek V3.2" }, { id: "kimi-k2.6", name: "Kimi K2.6" }, { id: "kimi-k2.6-precision", name: "Kimi K2.6 (Precision)" }, @@ -1188,8 +1694,8 @@ export const REGISTRY: Record<string, RegistryEntry> = { authType: "apikey", authHeader: "bearer", models: [ - { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash" }, - { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" }, + { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash", supportsReasoning: true }, + { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, ], }, @@ -1232,17 +1738,43 @@ export const REGISTRY: Record<string, RegistryEntry> = { alias: "bzl", format: "openai", executor: "default", - baseUrl: "https://bazaarlink.ai/api/v1", + baseUrl: "https://bazaarlink.ai/api/v1/chat/completions", + modelsUrl: "https://bazaarlink.ai/api/v1/models", authType: "apikey", authHeader: "bearer", models: [ { id: "auto:free", name: "Auto Free (Zero Cost)" }, - { id: "openai/gpt-4o", name: "GPT-4o" }, - { id: "anthropic/claude-sonnet-4", name: "Claude Sonnet 4" }, - { id: "google/gemini-2.0-flash", name: "Gemini 2.0 Flash" }, - { id: "deepseek/deepseek-chat", name: "DeepSeek Chat" }, - { id: "meta/llama-3.1-70b", name: "Llama 3.1 70B" }, - { id: "qwen/qwen-2.5-72b", name: "Qwen 2.5 72B" }, + { id: "claude-opus-4.7", name: "Claude Opus 4.7" }, + { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6" }, + { id: "claude-haiku-4.5", name: "Claude Haiku 4.5" }, + { id: "gpt-5.5", name: "GPT-5.5" }, + { id: "gpt-5.4", name: "GPT-5.4" }, + { id: "gpt-5.4-mini", name: "GPT-5.4 Mini" }, + { id: "gpt-5.4-nano", name: "GPT-5.4 Nano" }, + { id: "grok-4.3", name: "Grok 4.3" }, + { id: "grok-4.20", name: "Grok 4.20" }, + { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro" }, + { id: "gemini-3-flash-preview", name: "Gemini 3 Flash" }, + { id: "gemini-3.1-flash-lite-preview", name: "Gemini 3.1 Flash Lite" }, + { id: "gemma-4-31b-it", name: "Gemma 4 31B" }, + { id: "gemma-4-26b-a4b-it", name: "Gemma 4 26B A4B" }, + { id: "deepseek-v3.2", name: "DeepSeek V3.2" }, + { id: "kimi-k2.6", name: "Kimi K2.6" }, + { id: "kimi-k2.5", name: "Kimi K2.5" }, + { id: "glm-5.1", name: "GLM 5.1" }, + { id: "glm-5", name: "GLM 5" }, + { id: "mimo-v2.5-pro", name: "MiMo-V2.5-Pro" }, + { id: "mimo-v2.5", name: "MiMo-V2.5" }, + { id: "minimax-m2.7", name: "MiniMax M2.7" }, + { id: "minimax-m2.5", name: "MiniMax M2.5" }, + { id: "llama-4-maverick", name: "Llama 4 Maverick" }, + { id: "llama-4-scout", name: "Llama 4 Scout" }, + { id: "llama-3.3-70b-instruct", name: "Llama 3.3 70B" }, + { id: "qwen3.6-plus", name: "Qwen 3.6 Plus" }, + { id: "mistral-large-2512", name: "Mistral Large 3" }, + { id: "mistral-medium-3.1", name: "Mistral Medium 3.1" }, + { id: "mistral-small-2603", name: "Mistral Small 4" }, + { id: "nemotron-3-super-120b-a12b", name: "Nemotron 3 Super" }, ], }, completions: { @@ -1250,16 +1782,18 @@ export const REGISTRY: Record<string, RegistryEntry> = { alias: "cpl", format: "openai", executor: "default", - baseUrl: "https://completions.me/api/v1", + baseUrl: "https://completions.me/api/v1/chat/completions", authType: "apikey", authHeader: "bearer", models: [ { id: "claude-opus-4.6", name: "Claude Opus 4.6" }, - { id: "claude-sonnet-4.5", name: "Claude Sonnet 4.5" }, + { id: "claude-sonnet-4.6", name: "Claude Sonnet 4.6" }, + { id: "claude-haiku-4.5", name: "Claude Haiku 4.5" }, { id: "gpt-5.2", name: "GPT-5.2" }, - { id: "gpt-4o", name: "GPT-4o" }, - { id: "gemini-3.1-pro", name: "Gemini 3.1 Pro" }, - { id: "gemini-2.0-flash", name: "Gemini 2.0 Flash" }, + { id: "gpt-5-mini", name: "GPT-5 Mini" }, + { id: "gpt-4.1", name: "GPT-4.1" }, + { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro" }, + { id: "gemini-3-flash-preview", name: "Gemini 3 Flash" }, ], }, enally: { @@ -1460,7 +1994,11 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "accounts/fireworks/models/minimax-m2p7", name: "MiniMax M2.7" }, { id: "accounts/fireworks/models/qwen3p6-plus", name: "Qwen3.6 Plus" }, { id: "accounts/fireworks/models/glm-5p1", name: "GLM 5.1" }, - { id: "accounts/fireworks/models/deepseek-v4-pro", name: "DeepSeek V4 Pro" }, + { + id: "accounts/fireworks/models/deepseek-v4-pro", + name: "DeepSeek V4 Pro", + supportsReasoning: true, + }, ], }, @@ -1490,8 +2028,8 @@ export const REGISTRY: Record<string, RegistryEntry> = { // Note: rate limits vary by plan (free = "Light usage", Pro = more, Max = 5x Pro). // Users can generate API keys at https://ollama.com/settings/api-keys models: [ - { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" }, - { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash" }, + { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, + { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash", supportsReasoning: true }, { id: "kimi-k2.6", name: "Kimi K2.6" }, { id: "glm-5.1", name: "GLM 5.1" }, { id: "minimax-m2.7", name: "MiniMax M2.7" }, @@ -1536,7 +2074,7 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "qwen/qwen3.5-397b-a17b", name: "Qwen3.5-397B-A17B" }, { id: "qwen/qwen3.5-122b-a10b", name: "Qwen3.5-122B-A10B" }, { id: "stepfun-ai/step-3.5-flash", name: "Step 3.5 Flash" }, - { id: "deepseek-ai/deepseek-v4-pro", name: "DeepSeek V4 Pro" }, + { id: "deepseek-ai/deepseek-v4-pro", name: "DeepSeek V4 Pro", supportsReasoning: true }, { id: "openai/gpt-oss-120b", name: "GPT OSS 120B", toolCalling: false }, { id: "openai/gpt-oss-20b", name: "GPT OSS 20B", toolCalling: false }, { id: "nvidia/nemotron-3-super-120b-a12b", name: "Nemotron 3 Super 120B A12B" }, @@ -1819,8 +2357,16 @@ export const REGISTRY: Record<string, RegistryEntry> = { { id: "google/gemini-3-flash", name: "Gemini 3 Flash (Puter)" }, { id: "google/gemini-3.1-pro-preview", name: "Gemini 3.1 Pro (Puter)" }, // DeepSeek — use deepseek/ prefix (confirmed working) - { id: "deepseek/deepseek-v4-pro", name: "DeepSeek V4 Pro (Puter)" }, - { id: "deepseek/deepseek-v4-flash", name: "DeepSeek V4 Flash (Puter)" }, + { + id: "deepseek/deepseek-v4-pro", + name: "DeepSeek V4 Pro (Puter)", + supportsReasoning: true, + }, + { + id: "deepseek/deepseek-v4-flash", + name: "DeepSeek V4 Flash (Puter)", + supportsReasoning: true, + }, // xAI Grok — use x-ai/ prefix { id: "x-ai/grok-4.3", name: "Grok 4.3 (Puter)" }, { id: "x-ai/grok-4.20", name: "Grok 4.20 (Puter)" }, diff --git a/open-sse/config/runway.ts b/open-sse/config/runway.ts index a76719d757..7ea0c6bea0 100644 --- a/open-sse/config/runway.ts +++ b/open-sse/config/runway.ts @@ -4,13 +4,12 @@ export const RUNWAYML_API_VERSION = "2024-11-06"; export const RUNWAYML_SUPPORTED_VIDEO_MODELS = [ { id: "gen4.5", name: "Gen-4.5" }, { id: "gen4_turbo", name: "Gen-4 Turbo" }, + { id: "gen3a_turbo", name: "Gen-3 Alpha Turbo" }, { id: "veo3.1", name: "Veo 3.1" }, { id: "veo3.1_fast", name: "Veo 3.1 Fast" }, - { id: "veo3", name: "Veo 3" }, - { id: "gen3a_turbo", name: "Gen-3 Alpha Turbo" }, ]; -export const RUNWAYML_IMAGE_REQUIRED_MODELS = new Set(["gen4_turbo", "gen3a_turbo"]); +export const RUNWAYML_IMAGE_REQUIRED_MODELS = new Set(["gen4_turbo"]); export function normalizeRunwayBaseUrl(baseUrl?: string | null) { const normalized = String(baseUrl || "") diff --git a/open-sse/config/searchRegistry.ts b/open-sse/config/searchRegistry.ts index c092d53d7e..724d349525 100644 --- a/open-sse/config/searchRegistry.ts +++ b/open-sse/config/searchRegistry.ts @@ -186,6 +186,38 @@ export const SEARCH_PROVIDERS: Record<string, SearchProviderConfig> = { timeoutMs: 10_000, cacheTTLMs: 3 * 60 * 1000, }, + + "ollama-search": { + id: "ollama-search", + name: "Ollama Search", + baseUrl: "https://ollama.com/api/web_search", + method: "POST", + authType: "apikey", + authHeader: "bearer", + costPerQuery: 0, + freeMonthlyQuota: 1000, + searchTypes: ["web"], + defaultMaxResults: 5, + maxMaxResults: 10, + timeoutMs: 10_000, + cacheTTLMs: 5 * 60 * 1000, + }, + + "zai-search": { + id: "zai-search", + name: "Z.AI Coding Plan Search", + baseUrl: "https://api.z.ai/api/mcp/web_search_prime/mcp", + method: "POST", + authType: "apikey", + authHeader: "bearer", + costPerQuery: 0, + freeMonthlyQuota: 0, + searchTypes: ["web"], + defaultMaxResults: 5, + maxMaxResults: 50, + timeoutMs: 10_000, + cacheTTLMs: 5 * 60 * 1000, + }, }; /** @@ -194,6 +226,8 @@ export const SEARCH_PROVIDERS: Record<string, SearchProviderConfig> = { */ export const SEARCH_CREDENTIAL_FALLBACKS: Record<string, string> = { "perplexity-search": "perplexity", + "ollama-search": "ollama-cloud", + "zai-search": "zai", }; /** diff --git a/open-sse/executors/antigravity.ts b/open-sse/executors/antigravity.ts index 4edc387408..9d6fce0dab 100644 --- a/open-sse/executors/antigravity.ts +++ b/open-sse/executors/antigravity.ts @@ -1,5 +1,11 @@ import crypto, { randomUUID } from "crypto"; -import { BaseExecutor, mergeUpstreamExtraHeaders, type ExecuteInput } from "./base.ts"; +import { + BaseExecutor, + mergeUpstreamExtraHeaders, + type ExecuteInput, + type ExecutorLog, + type ProviderCredentials, +} from "./base.ts"; import { applyFingerprint, isCliCompatEnabled } from "../config/cliFingerprints.ts"; import { PROVIDERS, OAUTH_ENDPOINTS, HTTP_STATUS } from "../config/constants.ts"; import { scrubProxyAndFingerprintHeaders } from "../services/antigravityHeaderScrub.ts"; @@ -42,11 +48,43 @@ const CREDITS_EXHAUSTED_TTL_MS = 5 * 60 * 60 * 1000; // 5 hours const BARE_PRO_IDS = new Set(["gemini-3.1-pro"]); -function getChunkedOrFixedBody(bodyStr: string, stream: boolean) { +interface AntigravityContent { + role: string; + parts: unknown[]; + [key: string]: unknown; +} + +type AntigravityCredentials = ProviderCredentials & { + projectId?: string | null; + expiresIn?: number; +}; + +type AntigravityChunkContent = Record<string, unknown> & { + role?: string; + parts?: Array< + Record<string, unknown> & { + text?: unknown; + functionCall?: Record<string, unknown>; + functionResponse?: unknown; + thought?: unknown; + thoughtSignature?: unknown; + } + >; +}; + +type AntigravityCreditEntry = { + creditType?: string; + creditAmount?: string; +}; + +function getChunkedOrFixedBody(bodyStr: string, stream: boolean): BodyInit { if (stream) { - return (async function* () { - yield new TextEncoder().encode(bodyStr); - })(); + return new ReadableStream({ + async start(controller) { + controller.enqueue(new TextEncoder().encode(bodyStr)); + controller.close(); + }, + }); } return bodyStr; } @@ -366,7 +404,8 @@ export class AntigravityExecutor extends BaseExecutor { super("antigravity", PROVIDERS.antigravity); } - buildUrl(model, stream, urlIndex = 0) { + buildUrl(model: string, _stream: boolean, urlIndex = 0): string { + void model; const baseUrls = this.getBaseUrls(); const baseUrl = baseUrls[urlIndex] || baseUrls[0]; // Always use streaming endpoint — the non-streaming `generateContent` causes @@ -377,7 +416,7 @@ export class AntigravityExecutor extends BaseExecutor { return `${baseUrl}/v1internal:streamGenerateContent?alt=sse`; } - buildHeaders(credentials, stream = true) { + buildHeaders(credentials: AntigravityCredentials, _stream = true): Record<string, string> { const raw = { "Content-Type": "application/json", Authorization: `Bearer ${credentials.accessToken}`, @@ -389,12 +428,26 @@ export class AntigravityExecutor extends BaseExecutor { return scrubProxyAndFingerprintHeaders(raw); } - transformRequest(model, body, stream, credentials): AntigravityRequestEnvelope | Response { + transformRequest( + model: string, + body: unknown, + _stream: boolean, + credentials: AntigravityCredentials + ): AntigravityRequestEnvelope | Response { // TODO: Consider removing project override like gemini-cli.ts — stored projectId // can become stale for Cloud Code accounts, causing 403 "has not been used in project X". // Antigravity accounts may have more stable project IDs, but the risk exists. - const bodyProjectId = body?.project; - const credentialsProjectId = credentials?.projectId; + const normalizeProjectId = (value: unknown): string | null => { + if (typeof value !== "string") return null; + const trimmedValue = value.trim(); + return trimmedValue ? trimmedValue : null; + }; + const bodyRecord = asRecord(body) ?? {}; + const bodyProjectId = normalizeProjectId(bodyRecord.project); + const credentialsProjectId = normalizeProjectId(credentials?.projectId); + const providerSpecificProjectId = normalizeProjectId( + (credentials?.providerSpecificData as Record<string, unknown> | undefined)?.projectId + ); const allowBodyProjectOverride = process.env.OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE === "1"; // Default: prefer OAuth-stored projectId over incoming body.project to avoid @@ -403,7 +456,7 @@ export class AntigravityExecutor extends BaseExecutor { const projectId = allowBodyProjectOverride && bodyProjectId ? bodyProjectId - : credentialsProjectId || bodyProjectId; + : credentialsProjectId || providerSpecificProjectId || bodyProjectId; if (!projectId) { // (#489) Return a structured error instead of throwing — gives the client a clear signal @@ -427,16 +480,21 @@ export class AntigravityExecutor extends BaseExecutor { const upstreamModel = cleanModelName(model); const isClaude = upstreamModel.toLowerCase().includes("claude"); - const baseBody = body && typeof body === "object" ? body : {}; + const baseBody = bodyRecord; const normalizedBody = shouldStripCloudCodeThinking(this.provider, upstreamModel) ? stripCloudCodeThinkingConfig(baseBody) : baseBody; + const normalizedRequest = asRecord(normalizedBody.request); + const rawContents = Array.isArray(normalizedRequest?.contents) + ? normalizedRequest.contents + : []; // Fix contents for Gemini-compatible Cloud Code requests via Antigravity. // Claude-branded Antigravity models use the same streamGenerateContent schema. - const normalizedContents = - normalizedBody.request?.contents?.map((c) => { - let role = c.role; + const normalizedContents: AntigravityContent[] = + rawContents.map((content): AntigravityContent => { + const c = content as AntigravityChunkContent; + let role = typeof c.role === "string" ? c.role : "user"; if (c.parts?.some((p) => p.functionResponse)) { role = "user"; } @@ -453,7 +511,7 @@ export class AntigravityExecutor extends BaseExecutor { return { ...c, role, parts }; }) || []; - const contents: any[] = []; + const contents: AntigravityContent[] = []; for (const c of normalizedContents) { if (!Array.isArray(c.parts) || c.parts.length === 0) continue; if (contents.length > 0 && contents[contents.length - 1].role === c.role) { @@ -464,14 +522,17 @@ export class AntigravityExecutor extends BaseExecutor { } const rawTransformedRequest = { - ...normalizedBody.request, + ...normalizedRequest, ...(contents.length > 0 && { contents }), - sessionId: getAntigravitySessionId(credentials, normalizedBody.request?.sessionId), + sessionId: getAntigravitySessionId( + credentials, + typeof normalizedRequest?.sessionId === "string" ? normalizedRequest.sessionId : undefined + ), safetySettings: undefined, toolConfig: - normalizedBody.request?.tools?.length > 0 + Array.isArray(normalizedRequest?.tools) && normalizedRequest.tools.length > 0 ? { functionCallingConfig: { mode: "VALIDATED" } } - : normalizedBody.request?.toolConfig, + : normalizedRequest?.toolConfig, }; const transformedRequest = isClaude @@ -522,7 +583,10 @@ export class AntigravityExecutor extends BaseExecutor { return envelope; } - async refreshCredentials(credentials, log) { + async refreshCredentials( + credentials: AntigravityCredentials, + log?: ExecutorLog | null + ): Promise<AntigravityCredentials | null> { if (!credentials.refreshToken) return null; try { @@ -543,26 +607,30 @@ export class AntigravityExecutor extends BaseExecutor { if (!response.ok) return null; - const tokens = await response.json(); + const tokens = (await response.json()) as Record<string, unknown>; log?.info?.("TOKEN", "Antigravity refreshed"); return { - accessToken: tokens.access_token, - refreshToken: tokens.refresh_token || credentials.refreshToken, - expiresIn: tokens.expires_in, + accessToken: typeof tokens.access_token === "string" ? tokens.access_token : undefined, + refreshToken: + typeof tokens.refresh_token === "string" + ? tokens.refresh_token + : credentials.refreshToken, + expiresIn: typeof tokens.expires_in === "number" ? tokens.expires_in : undefined, projectId: credentials.projectId, }; } catch (error) { - log?.error?.("TOKEN", `Antigravity refresh error: ${error.message}`); + const message = error instanceof Error ? error.message : String(error); + log?.error?.("TOKEN", `Antigravity refresh error: ${message}`); return null; } } - generateSessionId() { + generateSessionId(): string { return `-${parseInt(randomUUID().replace(/-/g, "").substring(0, 8), 16) % 9_000_000_000_000_000_000}`; } - parseRetryHeaders(headers) { + parseRetryHeaders(headers: Headers | null | undefined): number | null { if (!headers?.get) return null; const retryAfter = headers.get("retry-after"); @@ -595,7 +663,7 @@ export class AntigravityExecutor extends BaseExecutor { // Parse retry time from Antigravity error message body // Format: "Your quota will reset after 2h7m23s" or "1h30m" or "45m" or "30s" - parseRetryFromErrorMessage(errorMessage) { + parseRetryFromErrorMessage(errorMessage: unknown): number | null { if (!errorMessage || typeof errorMessage !== "string") return null; const match = errorMessage.match(/reset (?:after|in) (\d+h)?(\d+m)?(\d+s)?/i); @@ -619,9 +687,22 @@ export class AntigravityExecutor extends BaseExecutor { * Parses Gemini-format SSE chunks and assembles text content + usage into one * OpenAI-format chat.completion payload. */ - collectStreamToResponse(response, model, url, headers, transformedBody, log?, signal?) { + collectStreamToResponse( + response: Response, + model: string, + url: string, + headers: Record<string, string>, + transformedBody: Record<string, unknown>, + log?: ExecutorLog | null, + signal?: AbortSignal | null + ) { + if (!response.body) { + return Promise.resolve({ response, url, headers, transformedBody }); + } + const reader = response.body.getReader(); const decoder = new TextDecoder(); + const logger = log || undefined; const SSE_COLLECT_TIMEOUT_MS = 120_000; @@ -653,7 +734,7 @@ export class AntigravityExecutor extends BaseExecutor { decoder.decode(value, { stream: true }), partialLine, collected, - log + logger ); } } catch (err) { @@ -662,8 +743,8 @@ export class AntigravityExecutor extends BaseExecutor { log?.warn?.("SSE_COLLECT", `Error collecting SSE stream: ${msg}`); // Fall through — return whatever was collected so far } - processAntigravitySSEText(decoder.decode(), partialLine, collected, log); - flushAntigravitySSEText(partialLine, collected, log); + processAntigravitySSEText(decoder.decode(), partialLine, collected, logger); + flushAntigravitySSEText(partialLine, collected, logger); const result = { id: `chatcmpl-${Date.now()}-${crypto.randomUUID().slice(0, 8)}`, @@ -709,7 +790,7 @@ export class AntigravityExecutor extends BaseExecutor { let lastError = null; let lastStatus = 0; const MAX_AUTO_RETRIES = 3; - const retryAttemptsByUrl = {}; // Track retry attempts per URL + const retryAttemptsByUrl: Record<number, number> = {}; // Track retry attempts per URL // Always stream upstream — buildUrl always returns the streaming endpoint. // For non-streaming clients, we collect the SSE below and return a synthetic @@ -802,7 +883,7 @@ export class AntigravityExecutor extends BaseExecutor { let response = await fetch(url, { method: "POST", headers: finalHeaders, - body: getChunkedOrFixedBody(serializedRequest.bodyString, stream) as any, + body: getChunkedOrFixedBody(serializedRequest.bodyString, stream), ...(stream ? { duplex: "half" } : {}), signal, }); @@ -814,7 +895,7 @@ export class AntigravityExecutor extends BaseExecutor { response = await fetch(url, { method: "POST", headers: retryHeaders, - body: getChunkedOrFixedBody(serializedRequest.bodyString, stream) as any, + body: getChunkedOrFixedBody(serializedRequest.bodyString, stream), ...(stream ? { duplex: "half" } : {}), signal, }); @@ -884,7 +965,7 @@ export class AntigravityExecutor extends BaseExecutor { const creditsResp = await fetch(url, { method: "POST", headers: finalCreditsHeaders, - body: getChunkedOrFixedBody(serializedCreditsRequest.bodyString, stream) as any, + body: getChunkedOrFixedBody(serializedCreditsRequest.bodyString, stream), ...(stream ? { duplex: "half" } : {}), signal, }); @@ -1124,11 +1205,12 @@ export class AntigravityExecutor extends BaseExecutor { try { const parsed = JSON.parse(payload); if (Array.isArray(parsed?.remainingCredits)) { - const googleCredit = parsed.remainingCredits.find( - (c) => c?.creditType === "GOOGLE_ONE_AI" - ); + const googleCredit = parsed.remainingCredits.find((c: unknown) => { + const credit = asRecord(c); + return credit?.creditType === "GOOGLE_ONE_AI"; + }) as AntigravityCreditEntry | undefined; if (googleCredit) { - const balance = parseInt(googleCredit.creditAmount, 10); + const balance = parseInt(String(googleCredit.creditAmount ?? ""), 10); if (!isNaN(balance)) { updateAntigravityRemainingCredits(accountId, balance); } diff --git a/open-sse/executors/base.ts b/open-sse/executors/base.ts index 832810f841..e9750e2dc5 100644 --- a/open-sse/executors/base.ts +++ b/open-sse/executors/base.ts @@ -1,5 +1,6 @@ import { HTTP_STATUS, FETCH_TIMEOUT_MS } from "../config/constants.ts"; import { applyFingerprint, isCliCompatEnabled } from "../config/cliFingerprints.ts"; +import { supportsXHighEffort } from "../config/providerModels.ts"; import { getRotatingApiKey } from "../services/apiKeyRotator.ts"; import { getOpenAICompatibleType, isClaudeCodeCompatible } from "../services/provider.ts"; import type { ProviderRequestDefaults } from "../services/providerRequestDefaults.ts"; @@ -68,6 +69,7 @@ export type ProviderCredentials = { accessToken?: string; refreshToken?: string; apiKey?: string; + projectId?: string | null; expiresAt?: string; connectionId?: string; // T07: used for API key rotation index maxConcurrent?: number | null; @@ -171,6 +173,77 @@ export function mergeAbortSignals(primary: AbortSignal, secondary: AbortSignal): return controller.signal; } +/** + * Sanitize reasoning_effort for providers that don't accept all values. + * + * The claude→openai translator emits reasoning_effort=xhigh when the client + * sends output_config.effort=max on a Claude-shape request. Combined with + * runtime alias remapping (e.g. claude-opus-4-6 → mimo/mimo-v2.5-pro), this + * routes xhigh to OpenAI-shape providers that don't accept the value: + * + * xiaomi-mimo : low|medium|high only — 400 literal_error on xhigh + * mistral : devstral models reject reasoning_effort entirely + * github : claude/haiku/oswe models reject reasoning_effort entirely + * + * Each rejection burns a combo fallback attempt before reaching a working + * provider. Apply provider-aware sanitation here (after transformRequest, so + * reintroductions by per-provider transforms are also caught) before fetch. + * Models that genuinely support xhigh (registry flag supportsXHighEffort) + * pass through unchanged. + */ +const MISTRAL_NO_REASONING_EFFORT_PATTERN = /devstral/i; +const GITHUB_NO_REASONING_EFFORT_PATTERN = /(claude|haiku|oswe)/i; +export function sanitizeReasoningEffortForProvider( + body: unknown, + provider: string, + model: string | undefined, + log?: { info?: (tag: string, msg: string) => void } | null +): unknown { + if (!body || typeof body !== "object" || Array.isArray(body)) return body; + const b = body as Record<string, unknown>; + const reasoning = + b.reasoning && typeof b.reasoning === "object" && !Array.isArray(b.reasoning) + ? (b.reasoning as Record<string, unknown>) + : null; + const effort = b.reasoning_effort ?? reasoning?.effort; + if (effort === undefined) return body; + const effortStr = typeof effort === "string" ? effort.toLowerCase() : ""; + const modelStr = model || ""; + + if (effortStr === "xhigh" && !supportsXHighEffort(provider, modelStr)) { + log?.info?.( + "REASONING_SANITIZE", + `${provider}/${modelStr}: downgraded reasoning_effort xhigh → high` + ); + const next: Record<string, unknown> = { ...b, reasoning_effort: "high" }; + if (reasoning) { + next.reasoning = { ...reasoning, effort: "high" }; + } + return next; + } + + const rejecting = + (provider === "mistral" && MISTRAL_NO_REASONING_EFFORT_PATTERN.test(modelStr)) || + (provider === "github" && GITHUB_NO_REASONING_EFFORT_PATTERN.test(modelStr)); + if (rejecting) { + log?.info?.( + "REASONING_SANITIZE", + `${provider}/${modelStr}: removed unsupported reasoning_effort` + ); + const next: Record<string, unknown> = { ...b }; + delete next.reasoning_effort; + if (reasoning) { + const r = { ...reasoning }; + delete r.effort; + if (Object.keys(r).length === 0) delete next.reasoning; + else next.reasoning = r; + } + return next; + } + + return body; +} + /** * BaseExecutor - Base class for provider executors. * Implements the Strategy pattern: subclasses override specific methods @@ -484,7 +557,18 @@ export class BaseExecutor { appendAnthropicBetaHeader(headers, CONTEXT_1M_BETA_HEADER); } - const transformedBody = await this.transformRequest(model, body, stream, activeCredentials); + const rawTransformedBody = await this.transformRequest( + model, + body, + stream, + activeCredentials + ); + const transformedBody = sanitizeReasoningEffortForProvider( + rawTransformedBody, + this.provider, + model, + log + ); try { // Only enforce the timeout while waiting for the initial fetch() response. diff --git a/open-sse/executors/cliproxyapi.ts b/open-sse/executors/cliproxyapi.ts index 69e2f05bb8..86a0670404 100644 --- a/open-sse/executors/cliproxyapi.ts +++ b/open-sse/executors/cliproxyapi.ts @@ -27,6 +27,91 @@ const DEFAULT_PORT = 8317; const DEFAULT_HOST = "127.0.0.1"; const HEALTH_CHECK_TIMEOUT_MS = 5000; +// Anthropic's reserved tool-name namespace: ^mcp_[^_].* triggers their +// server-side MCP connector billing gate, returning a misleading +// "out of extra usage" 400. Two-underscore (mcp__X) and capitalized +// (Mcp_X) variants pass cleanly. +const MCP_RESERVED_PREFIX_RE = /^mcp_(?=[^_])/; + +function rewriteMcpToolName(name: string): string | null { + if (typeof name !== "string" || !MCP_RESERVED_PREFIX_RE.test(name)) return null; + return "M" + name.slice(1); // mcp_call → Mcp_call +} + +/** + * Rewrite ^mcp_[^_] tool names on a body destined for Anthropic's + * /v1/messages. Returns a reverse map (rewritten → original) that the SSE + * response stream uses to restore the client's original names on tool_use + * blocks coming back. + * + * Non-mutating: replaces nested array elements with cloned objects rather + * than mutating in place, so the caller's input body is not affected. The + * outer `body` reference itself is the cloned `transformed` object from + * `transformRequest` — we mutate its top-level `tools`, `messages`, and + * `tool_choice` properties to point at the new clones. + */ +function applyMcpToolNameRewrite(body: Record<string, unknown>): Map<string, string> { + const reverseMap = new Map<string, string>(); + const remember = (original: string, rewritten: string) => { + reverseMap.set(rewritten, original); + }; + + const tools = body.tools; + if (Array.isArray(tools)) { + body.tools = tools.map((tool) => { + if (!tool || typeof tool !== "object") return tool; + const t = tool as Record<string, unknown>; + const original = typeof t.name === "string" ? t.name : ""; + const rewritten = rewriteMcpToolName(original); + if (rewritten) { + remember(original, rewritten); + return { ...t, name: rewritten }; + } + return tool; + }); + } + + const messages = body.messages; + if (Array.isArray(messages)) { + body.messages = messages.map((msg) => { + if (!msg || typeof msg !== "object") return msg; + const m = msg as Record<string, unknown>; + const content = m.content; + if (!Array.isArray(content)) return msg; + let mutated = false; + const newContent = content.map((block) => { + if (!block || typeof block !== "object") return block; + const b = block as Record<string, unknown>; + if (b.type !== "tool_use") return block; + const original = typeof b.name === "string" ? b.name : ""; + const rewritten = rewriteMcpToolName(original); + if (rewritten) { + mutated = true; + remember(original, rewritten); + return { ...b, name: rewritten }; + } + return block; + }); + return mutated ? { ...m, content: newContent } : msg; + }); + } + + const toolChoice = body.tool_choice; + if (toolChoice && typeof toolChoice === "object") { + const tc = toolChoice as Record<string, unknown>; + if (tc.type === "tool" && typeof tc.name === "string") { + const rewritten = rewriteMcpToolName(tc.name); + if (rewritten) { + const original = tc.name; + body.tool_choice = { ...tc, name: rewritten }; + remember(original, rewritten); + } + } + } + + return reverseMap; +} + function resolveCliproxyapiBaseUrl(): string { const host = process.env.CLIPROXYAPI_HOST || DEFAULT_HOST; const port = parseInt(process.env.CLIPROXYAPI_PORT || String(DEFAULT_PORT), 10); @@ -64,11 +149,62 @@ export class CliproxyapiExecutor extends BaseExecutor { _urlIndex = 0, _credentials: ProviderCredentials | null = null ): string { - // Always OpenAI-compatible. CLIProxyAPI detects Claude models internally - // and applies full emulation (CCH, billing header, system prompt, uTLS). + // Default endpoint when called without body context (kept for back-compat). + // execute() picks the right endpoint from the body shape; see selectEndpoint(). return `${this.upstreamBaseUrl}/v1/chat/completions`; } + /** + * Returns true when the body matches the Anthropic Messages wire shape. + * + * chatCore detects target=claude when the request comes from a Claude-source + * client (`/v1/messages`, Anthropic-version header, claude/* model). In that + * case no openai translation is applied and the executor sees the original + * Anthropic body: top-level `system` as an array of content blocks, and + * `messages[].content` as arrays. Routing those bodies to CPA's + * /v1/chat/completions causes CPA to emit OpenAI-style SSE chunks, which + * Anthropic SDK clients (Capy, claude-cli, etc.) cannot parse — the result + * looks like a 200 server-side with "0 chunks received" client-side. + * + * CPA exposes /v1/messages natively (claude executor with uTLS spoof, + * billing header, CCH signing, etc.) and emits proper Anthropic SSE: + * `event: message_start`, `content_block_delta`, etc. + */ + private isAnthropicShape(body: unknown): boolean { + if (!body || typeof body !== "object") return false; + const b = body as Record<string, unknown>; + // Strong signal: top-level `system` field is unique to the Anthropic + // Messages API. OpenAI Chat Completions encodes system as a role:"system" + // entry inside messages[], not at body level. Accept both string and + // array-of-content-blocks forms (Anthropic supports both per the docs). + if (b.system !== undefined) return true; + // Strong signal: top-level `thinking` field is Anthropic-only. OpenAI + // uses `reasoning` / `reasoning_effort`. Even adaptive/raw Capy shapes + // emit thinking, so this catches minimal Capy bodies (string content, + // no system block) that would otherwise miss the messages[0].content + // array check below. + if (b.thinking !== undefined) return true; + // Strong signal: top-level `metadata.user_id` is the CC wire-image + // identifier; OpenAI request bodies don't carry it. + if ( + b.metadata && + typeof b.metadata === "object" && + (b.metadata as Record<string, unknown>).user_id !== undefined + ) + return true; + // Strong signal: messages[0].content is an array of Anthropic content blocks + const msgs = b.messages; + if (Array.isArray(msgs) && msgs.length > 0) { + const first = msgs[0] as Record<string, unknown>; + if (Array.isArray(first?.content)) return true; + } + return false; + } + + private selectEndpoint(body: unknown): string { + return this.isAnthropicShape(body) ? "/v1/messages" : "/v1/chat/completions"; + } + buildHeaders(credentials: ProviderCredentials | null, stream = true): Record<string, string> { const key = credentials?.apiKey || credentials?.accessToken; @@ -99,6 +235,59 @@ export class CliproxyapiExecutor extends BaseExecutor { transformed.model = model; } + // For Anthropic-shape bodies routed to CPA's /v1/messages, strip the + // Capy/Anthropic-SDK premium extras that Anthropic gates with + // "Extra usage is required" / "out of extra usage" (400). CPA does its + // own Claude Code wire-image cloak (CCH, billing header, uTLS, metadata + // user_id, system sentinel) downstream — but it forwards client extras + // like output_config.effort=xhigh which trigger the extras-billing gate. + // + // Mirrors the runtime "Patch I2/I4" effect previously applied via patch.mjs. + // Strips are no-op when fields are absent (OpenAI-shape passthrough). + if (this.isAnthropicShape(transformed)) { + delete transformed.output_config; + delete transformed.context_management; + delete transformed.client_info; + delete transformed.prompt_cache_key; + delete transformed.safety_identifier; + delete transformed.metadata; + + // Conditional thinking strip: preserve Anthropic-valid shapes + // ({type:"enabled"|"disabled", budget_tokens:N}) that applyThinkingBudget + // already normalized. Strip non-Anthropic shapes (e.g. Capy's + // {type:"adaptive", display:"summarized"}) which trigger Anthropic 400 + // "Extra usage required" / "out of extra usage". The `display` field is + // a Capy-specific hint Anthropic doesn't accept. + const thinking = transformed.thinking; + if (thinking && typeof thinking === "object") { + const t = thinking as Record<string, unknown>; + const validType = t.type === "enabled" || t.type === "disabled"; + const hasValidBudget = typeof t.budget_tokens === "number" && t.budget_tokens >= 0; + const hasInvalidExtras = "display" in t; + if (!validType || !hasValidBudget || hasInvalidExtras) { + delete transformed.thinking; + } + } + + // Rewrite tool names matching Anthropic's reserved ^mcp_[^_] namespace. + // Anthropic returns "out of extra usage" / "Extra usage required" 400 + // when a client-declared tool name collides with their server-side MCP + // connector tools. Bisected character-by-character against the real + // Anthropic API via CPA (uTLS spoof, Claude OAuth): + // mcp_call, mcp_query, mcp_x, mcp_test → 400 (gate hit) + // Mcp_call, _mcp_call, mcp__call, mcp-call, mcpcall, my_mcp_call → 200 + // The "Mcp_" capitalization is the smallest stable rewrite that + // preserves readability. The reverse map below is propagated to + // chatCore via body._toolNameMap, which the SSE passthrough stream + // uses (utils/stream.ts:restoreClaudePassthroughToolUseName) to + // rewrite tool_use.name back to the client's original namespace on + // the response side. Capy sees mcp_call back in tool_use blocks. + const toolNameMap = applyMcpToolNameRewrite(transformed); + if (toolNameMap.size > 0) { + transformed._toolNameMap = toolNameMap; + } + } + return transformed; } @@ -111,7 +300,9 @@ export class CliproxyapiExecutor extends BaseExecutor { log?: any; upstreamExtraHeaders?: Record<string, string> | null; }) { - const url = this.buildUrl(input.model, input.stream, 0, input.credentials); + const endpoint = this.selectEndpoint(input.body); + const url = `${this.upstreamBaseUrl}${endpoint}`; + const shape = endpoint === "/v1/messages" ? "anthropic" : "openai"; const headers = this.buildHeaders(input.credentials, input.stream); const transformedBody = this.transformRequest( input.model, @@ -126,12 +317,21 @@ export class CliproxyapiExecutor extends BaseExecutor { ? mergeAbortSignals(input.signal, timeoutSignal) : timeoutSignal; - input.log?.info?.("CPA", `CLIProxyAPI → ${url} (model: ${input.model})`); + input.log?.info?.("CPA", `CLIProxyAPI → ${url} (model: ${input.model}, shape: ${shape})`); + + // _toolNameMap is an in-memory channel to chatCore for response-side + // tool name restoration; never send it over the wire. + const wireBody = + transformedBody && typeof transformedBody === "object" + ? JSON.stringify(transformedBody, (key, value) => + key === "_toolNameMap" ? undefined : value + ) + : JSON.stringify(transformedBody); const response = await fetch(url, { method: "POST", headers, - body: JSON.stringify(transformedBody), + body: wireBody, signal: combinedSignal, }); @@ -144,11 +344,18 @@ export class CliproxyapiExecutor extends BaseExecutor { /** * Health check — verifies CLIProxyAPI is reachable. + * + * CPA 6.x doesn't expose a /health endpoint; previously we hit /health + * and got 404, which made the dashboard report "CLIProxyAPI not + * detected" even when the service was up and successfully serving + * /v1/messages. Probe /v1/models instead (returns 200 with the + * advertised model list), which is the closest thing CPA has to a + * liveness probe and works on every CPA version we've tested. */ async healthCheck(): Promise<{ ok: boolean; latencyMs: number; error?: string }> { const start = Date.now(); try { - const res = await fetch(`${this.upstreamBaseUrl}/health`, { + const res = await fetch(`${this.upstreamBaseUrl}/v1/models`, { signal: AbortSignal.timeout(HEALTH_CHECK_TIMEOUT_MS), }); return { diff --git a/open-sse/executors/codex.ts b/open-sse/executors/codex.ts index 7db15a834c..b68ed08c6b 100644 --- a/open-sse/executors/codex.ts +++ b/open-sse/executors/codex.ts @@ -3,7 +3,9 @@ import { BaseExecutor, mergeUpstreamExtraHeaders, setUserAgentHeader, + type ExecutorLog, type ExecuteInput, + type ProviderCredentials, } from "./base.ts"; import { CODEX_CHAT_DEFAULT_INSTRUCTIONS, @@ -19,6 +21,7 @@ import { applyCodexClientIdentityHeaders, applyCodexClientMetadata, createCodexClientIdentity, + type CodexClientIdentity, } from "../config/codexIdentity.ts"; import { getAccessToken } from "../services/tokenRefresh.ts"; import { @@ -1088,7 +1091,12 @@ export class CodexExecutor extends BaseExecutor { }; } - buildUrl(model: string, stream: boolean, urlIndex = 0, credentials: any = null) { + buildUrl( + model: string, + stream: boolean, + urlIndex = 0, + credentials: ProviderCredentials | null = null + ) { void model; void stream; void urlIndex; @@ -1110,7 +1118,7 @@ export class CodexExecutor extends BaseExecutor { * Always request event-stream from upstream, even when client requested stream=false. * Includes chatgpt-account-id header for strict workspace binding. */ - buildHeaders(credentials, stream = true) { + buildHeaders(credentials: ProviderCredentials, stream = true) { const isCompactRequest = isCompactResponsesEndpoint(credentials?.requestEndpointPath); const headers = super.buildHeaders(credentials, isCompactRequest ? false : true); headers.Version = getCodexClientVersion(); @@ -1118,10 +1126,13 @@ export class CodexExecutor extends BaseExecutor { // Add workspace binding header if workspaceId is persisted const workspaceId = credentials?.providerSpecificData?.workspaceId; - if (workspaceId) { + if (typeof workspaceId === "string" && workspaceId) { headers["chatgpt-account-id"] = workspaceId; } - const clientIdentity = credentials?.providerSpecificData?.codexClientIdentity; + const clientIdentity = credentials?.providerSpecificData?.codexClientIdentity as + | CodexClientIdentity + | null + | undefined; // Originator header — identifies the client type to the Codex backend. // Ref: openai/codex login/src/auth/default_client.rs DEFAULT_ORIGINATOR = "codex_cli_rs" @@ -1148,7 +1159,7 @@ export class CodexExecutor extends BaseExecutor { * Ref: openai/codex core/src/client.rs line 853 */ private getPromptCacheSessionId( - credentials, + credentials: ProviderCredentials | null | undefined, body: Record<string, unknown> | null ): string | null { const promptCacheKey = normalizeCodexSessionId(body?.prompt_cache_key); @@ -1173,7 +1184,7 @@ export class CodexExecutor extends BaseExecutor { * have expired or become invalid. chatCore.ts calls this on 401; previously the * base class returned null causing the request to fail instead of refreshing. */ - async refreshCredentials(credentials, log) { + async refreshCredentials(credentials: ProviderCredentials, log?: ExecutorLog | null) { if (!credentials?.refreshToken) { log?.warn?.("TOKEN_REFRESH", "Codex: no refresh token available, re-authentication required"); return null; @@ -1192,11 +1203,19 @@ export class CodexExecutor extends BaseExecutor { /** * Transform request before sending - inject default instructions if missing */ - transformRequest(model, body, stream, credentials) { + transformRequest( + model: string, + bodyInput: unknown, + stream: boolean, + credentials: ProviderCredentials + ) { + void stream; // Do not mutate the caller's payload in place. Combo quality checks and // other post-execute paths still inspect the original request body. - body = - body && typeof body === "object" ? structuredClone(body) : ({} as Record<string, unknown>); + const body: Record<string, unknown> = + bodyInput && typeof bodyInput === "object" + ? structuredClone(bodyInput as Record<string, unknown>) + : {}; const nativeCodexPassthrough = body?._nativeCodexPassthrough === true; const isCompactRequest = isCompactResponsesEndpoint(credentials?.requestEndpointPath); @@ -1259,7 +1278,7 @@ export class CodexExecutor extends BaseExecutor { }, ]; } else if (!body.input && Array.isArray(body.prompt)) { - body.input = body.prompt.map((p: any) => ({ + body.input = body.prompt.map((p: unknown) => ({ type: "message", role: "user", content: [{ type: "input_text", text: typeof p === "string" ? p : JSON.stringify(p) }], @@ -1350,10 +1369,14 @@ export class CodexExecutor extends BaseExecutor { if (splitModel.effort) { modelEffort = splitModel.effort; body.model = splitModel.baseModel; - cleanModel = body.model; + cleanModel = splitModel.baseModel; } - const explicitReasoning = normalizeEffortValue(body?.reasoning?.effort); + const reasoningRecord = + body.reasoning && typeof body.reasoning === "object" && !Array.isArray(body.reasoning) + ? (body.reasoning as Record<string, unknown>) + : null; + const explicitReasoning = normalizeEffortValue(reasoningRecord?.effort); const requestReasoningEffort = normalizeEffortValue(body.reasoning_effort); const fallbackReasoningEffort = allowConnectionReasoningDefaults ? requestDefaults.reasoningEffort || "medium" @@ -1363,12 +1386,12 @@ export class CodexExecutor extends BaseExecutor { if (explicitReasoning) { body.reasoning = { - ...(body.reasoning && typeof body.reasoning === "object" ? body.reasoning : {}), + ...(reasoningRecord || {}), effort: clampEffort(cleanModel, explicitReasoning), }; } else if (rawEffort) { body.reasoning = { - ...(body.reasoning && typeof body.reasoning === "object" ? body.reasoning : {}), + ...(reasoningRecord || {}), effort: clampEffort(cleanModel, rawEffort), }; } @@ -1401,7 +1424,13 @@ export class CodexExecutor extends BaseExecutor { } } if (!isCompactRequest) { - applyCodexClientMetadata(body, credentials?.providerSpecificData?.codexClientIdentity); + applyCodexClientMetadata( + body, + credentials?.providerSpecificData?.codexClientIdentity as + | CodexClientIdentity + | null + | undefined + ); } // Delete session_id and conversation_id from the body. diff --git a/open-sse/executors/commandCode.ts b/open-sse/executors/commandCode.ts new file mode 100644 index 0000000000..0797477962 --- /dev/null +++ b/open-sse/executors/commandCode.ts @@ -0,0 +1,544 @@ +import { randomUUID } from "node:crypto"; + +import { REGISTRY } from "../config/providerRegistry.ts"; +import { BaseExecutor, mergeUpstreamExtraHeaders, type ExecuteInput } from "./base.ts"; + +type JsonRecord = Record<string, unknown>; + +const COMMAND_CODE_VERSION = "0.24.1"; +const MAX_COMMAND_CODE_TOKENS = 200_000; +const encoder = new TextEncoder(); + +function isRecord(value: unknown): value is JsonRecord { + return typeof value === "object" && value !== null && !Array.isArray(value); +} + +function asRecordArray(value: unknown): JsonRecord[] { + return Array.isArray(value) ? value.filter(isRecord) : []; +} + +function stringValue(value: unknown): string | undefined { + return typeof value === "string" ? value : undefined; +} + +function numberValue(value: unknown): number | undefined { + return typeof value === "number" && Number.isFinite(value) ? value : undefined; +} + +function recordOrEmpty(value: unknown): JsonRecord { + if (isRecord(value)) return value; + if (typeof value === "string" && value.trim()) { + try { + const parsed: unknown = JSON.parse(value); + if (isRecord(parsed)) return parsed; + } catch { + // Tool argument fragments may be incomplete in streamed deltas. + } + } + return {}; +} + +function normalizeContentText(content: unknown): string { + if (typeof content === "string") return content; + return asRecordArray(content) + .filter((part) => part.type === "text") + .map((part) => stringValue(part.text) || "") + .join("\n"); +} + +function convertTools(tools: unknown): unknown[] { + return asRecordArray(tools).map((tool) => { + const fn = isRecord(tool.function) ? tool.function : tool; + return { + type: "function", + name: stringValue(fn.name) || "", + description: stringValue(fn.description) || "", + input_schema: isRecord(fn.parameters) ? fn.parameters : {}, + }; + }); +} + +function completeToolCallIds(messages: JsonRecord[]): Set<string> { + const callIds = new Set<string>(); + const resultIds = new Set<string>(); + + for (const message of messages) { + if (message.role === "assistant") { + for (const call of asRecordArray(message.tool_calls)) { + const id = stringValue(call.id); + if (id) callIds.add(id); + } + } else if (message.role === "tool") { + const id = stringValue(message.tool_call_id); + if (id) resultIds.add(id); + } + } + + return new Set([...callIds].filter((id) => resultIds.has(id))); +} + +function convertMessages(messages: unknown): { system: string; messages: unknown[] } { + const source = asRecordArray(messages); + const pairedToolCallIds = completeToolCallIds(source); + const out: unknown[] = []; + const system: string[] = []; + + for (const message of source) { + const role = stringValue(message.role); + if (role === "system" || role === "developer") { + const text = normalizeContentText(message.content); + if (text) system.push(text); + continue; + } + + if (role === "user") { + out.push({ role: "user", content: message.content ?? "" }); + continue; + } + + if (role === "assistant") { + const parts: unknown[] = []; + const text = normalizeContentText(message.content); + if (text) parts.push({ type: "text", text }); + + for (const call of asRecordArray(message.tool_calls)) { + const id = stringValue(call.id) || ""; + if (!id || !pairedToolCallIds.has(id)) continue; + const fn = isRecord(call.function) ? call.function : {}; + parts.push({ + type: "tool-call", + toolCallId: id, + toolName: stringValue(fn.name) || "", + input: recordOrEmpty(fn.arguments), + }); + } + + if (parts.length > 0) out.push({ role: "assistant", content: parts }); + continue; + } + + if (role === "tool") { + const toolCallId = stringValue(message.tool_call_id) || ""; + if (!toolCallId || !pairedToolCallIds.has(toolCallId)) continue; + out.push({ + role: "tool", + content: [ + { + type: "tool-result", + toolCallId, + toolName: stringValue(message.name) || "", + output: { type: "text", value: normalizeContentText(message.content) }, + }, + ], + }); + } + } + + return { system: system.join("\n\n"), messages: out }; +} + +function clampMaxTokens(value: unknown): number { + const numeric = numberValue(value) ?? MAX_COMMAND_CODE_TOKENS; + return Math.max(1, Math.min(Math.floor(numeric), MAX_COMMAND_CODE_TOKENS)); +} + +function buildCommandCodeBody(model: string, body: unknown): JsonRecord { + const input = isRecord(body) ? body : {}; + const converted = convertMessages(input.messages); + const explicitSystem = typeof input.system === "string" ? input.system : ""; + const system = [converted.system, explicitSystem].filter(Boolean).join("\n\n"); + + return { + config: { + workingDir: "/workspace", + date: new Date().toISOString().slice(0, 10), + environment: "external", + structure: [], + isGitRepo: false, + currentBranch: "", + mainBranch: "", + gitStatus: "", + recentCommits: [], + }, + memory: "", + taste: "", + permissionMode: "standard", + params: { + model, + messages: converted.messages, + tools: convertTools(input.tools), + system, + max_tokens: clampMaxTokens(input.max_tokens ?? input.max_completion_tokens), + stream: false, + }, + }; +} + +function parseStreamLine(line: string): unknown | undefined { + let trimmed = line.trim(); + if (!trimmed || trimmed.startsWith(":") || trimmed.startsWith("event:")) return undefined; + if (trimmed.startsWith("data:")) trimmed = trimmed.slice(5).trim(); + if (!trimmed || trimmed === "[DONE]") return undefined; + + try { + return JSON.parse(trimmed); + } catch { + return undefined; + } +} + +function mapFinishReason(reason: unknown): "stop" | "length" | "tool_calls" { + if (reason === "tool-calls" || reason === "tool_calls" || reason === "toolUse") + return "tool_calls"; + if ( + reason === "length" || + reason === "max_tokens" || + reason === "max-tokens" || + reason === "max_output_tokens" + ) { + return "length"; + } + return "stop"; +} + +function chatCompletionChunk( + id: string, + model: string, + delta: JsonRecord, + finishReason: unknown = null +) { + return { + id, + object: "chat.completion.chunk", + created: Math.floor(Date.now() / 1000), + model, + choices: [{ index: 0, delta, finish_reason: finishReason }], + }; +} + +function sse(data: unknown): Uint8Array { + return encoder.encode(`data: ${JSON.stringify(data)}\n\n`); +} + +type AggregateState = { + content: string; + reasoning: string; + toolCalls: JsonRecord[]; + finishReason: "stop" | "length" | "tool_calls"; + usage: JsonRecord | null; +}; + +function applyEventToAggregate(event: JsonRecord, state: AggregateState): void { + switch (event.type) { + case "text-delta": + state.content += stringValue(event.text) || ""; + break; + case "reasoning-delta": + state.reasoning += stringValue(event.text) || ""; + break; + case "tool-call": { + const args = recordOrEmpty(event.input ?? event.args ?? event.arguments); + state.toolCalls.push({ + id: stringValue(event.toolCallId) || stringValue(event.id) || randomUUID(), + type: "function", + function: { + name: stringValue(event.toolName) || stringValue(event.name) || "", + arguments: JSON.stringify(args), + }, + }); + break; + } + case "finish": + state.finishReason = mapFinishReason(event.finishReason); + state.usage = isRecord(event.totalUsage) ? event.totalUsage : null; + break; + } +} + +function applyEventToAggregateOrThrow(event: JsonRecord, state: AggregateState): void { + if (event.type === "error") { + const error = isRecord(event.error) ? event.error : {}; + throw new Error( + stringValue(error.message) || stringValue(event.error) || "Command Code stream error" + ); + } + + applyEventToAggregate(event, state); +} + +function usageFromCommandCode(usage: JsonRecord | null) { + if (!usage) return undefined; + const details = isRecord(usage.inputTokenDetails) ? usage.inputTokenDetails : {}; + const prompt = + (numberValue(usage.inputTokens) || 0) + (numberValue(details.cacheReadTokens) || 0); + const completion = numberValue(usage.outputTokens) || 0; + return { + prompt_tokens: prompt, + completion_tokens: completion, + total_tokens: prompt + completion, + }; +} + +function createStreamResponse( + upstream: Response, + model: string, + signal?: AbortSignal | null +): Response { + const id = `chatcmpl-${randomUUID()}`; + const reader = upstream.body?.getReader(); + const decoder = new TextDecoder(); + let buffer = ""; + let sentRole = false; + let closed = false; + const state: AggregateState = { + content: "", + reasoning: "", + toolCalls: [], + finishReason: "stop", + usage: null, + }; + + const stream = new ReadableStream<Uint8Array>({ + start(controller) { + if (!reader) { + controller.error(new Error("Command Code response missing body")); + return; + } + + const abort = () => { + closed = true; + reader.cancel().catch(() => undefined); + controller.error(new DOMException("The operation was aborted", "AbortError")); + }; + signal?.addEventListener("abort", abort, { once: true }); + + const emitEvent = (event: unknown) => { + if (!isRecord(event) || closed) return; + if (!sentRole) { + sentRole = true; + controller.enqueue(sse(chatCompletionChunk(id, model, { role: "assistant" }))); + } + + switch (event.type) { + case "text-delta": { + const text = stringValue(event.text) || ""; + if (text) controller.enqueue(sse(chatCompletionChunk(id, model, { content: text }))); + state.content += text; + break; + } + case "reasoning-delta": { + const text = stringValue(event.text) || ""; + if (text) { + controller.enqueue(sse(chatCompletionChunk(id, model, { reasoning_content: text }))); + state.reasoning += text; + } + break; + } + case "tool-call": { + const index = state.toolCalls.length; + const args = recordOrEmpty(event.input ?? event.args ?? event.arguments); + const toolCall = { + id: stringValue(event.toolCallId) || stringValue(event.id) || randomUUID(), + type: "function", + function: { + name: stringValue(event.toolName) || stringValue(event.name) || "", + arguments: JSON.stringify(args), + }, + }; + state.toolCalls.push(toolCall); + controller.enqueue( + sse(chatCompletionChunk(id, model, { tool_calls: [{ index, ...toolCall }] })) + ); + break; + } + case "reasoning-end": + break; + case "finish": { + state.finishReason = mapFinishReason(event.finishReason); + state.usage = isRecord(event.totalUsage) ? event.totalUsage : null; + controller.enqueue(sse(chatCompletionChunk(id, model, {}, state.finishReason))); + controller.enqueue(encoder.encode("data: [DONE]\n\n")); + closed = true; + controller.close(); + reader.cancel().catch(() => undefined); + break; + } + case "error": { + const error = isRecord(event.error) ? event.error : {}; + throw new Error( + stringValue(error.message) || stringValue(event.error) || "Command Code stream error" + ); + } + } + }; + + const pump = async () => { + try { + for (;;) { + if (closed) return; + const { done, value } = await reader.read(); + if (done) break; + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split("\n"); + buffer = lines.pop() || ""; + for (const line of lines) emitEvent(parseStreamLine(line)); + } + if (buffer.trim()) emitEvent(parseStreamLine(buffer)); + if (!closed) { + if (!sentRole) + controller.enqueue(sse(chatCompletionChunk(id, model, { role: "assistant" }))); + controller.enqueue(sse(chatCompletionChunk(id, model, {}, state.finishReason))); + controller.enqueue(encoder.encode("data: [DONE]\n\n")); + controller.close(); + } + } catch (error) { + controller.error(error); + } finally { + signal?.removeEventListener("abort", abort); + try { + reader.releaseLock(); + } catch { + // Reader may already be released/cancelled. + } + } + }; + + pump(); + }, + cancel() { + closed = true; + return reader?.cancel(); + }, + }); + + return new Response(stream, { + status: 200, + headers: { "Content-Type": "text/event-stream; charset=utf-8", "Cache-Control": "no-cache" }, + }); +} + +async function createJsonResponse( + upstream: Response, + model: string, + signal?: AbortSignal | null +): Promise<Response> { + const reader = upstream.body?.getReader(); + if (!reader) throw new Error("Command Code response missing body"); + + const decoder = new TextDecoder(); + let buffer = ""; + const state: AggregateState = { + content: "", + reasoning: "", + toolCalls: [], + finishReason: "stop", + usage: null, + }; + + try { + for (;;) { + if (signal?.aborted) throw new DOMException("The operation was aborted", "AbortError"); + const { done, value } = await reader.read(); + if (done) break; + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split("\n"); + buffer = lines.pop() || ""; + for (const line of lines) { + const event = parseStreamLine(line); + if (!isRecord(event)) continue; + applyEventToAggregateOrThrow(event, state); + } + } + if (buffer.trim()) { + const event = parseStreamLine(buffer); + if (isRecord(event)) applyEventToAggregateOrThrow(event, state); + } + } finally { + try { + await reader.cancel(); + } catch { + // Reader may already be closed. + } + try { + reader.releaseLock(); + } catch { + // Reader may already be released. + } + } + + const message: JsonRecord = { role: "assistant", content: state.content }; + if (state.reasoning) message.reasoning_content = state.reasoning; + if (state.toolCalls.length > 0) message.tool_calls = state.toolCalls; + + const payload: JsonRecord = { + id: `chatcmpl-${randomUUID()}`, + object: "chat.completion", + created: Math.floor(Date.now() / 1000), + model, + choices: [{ index: 0, message, finish_reason: state.finishReason }], + }; + const usage = usageFromCommandCode(state.usage); + if (usage) payload.usage = usage; + + return new Response(JSON.stringify(payload), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); +} + +export class CommandCodeExecutor extends BaseExecutor { + constructor(provider = "command-code") { + super(provider, REGISTRY["command-code"]); + } + + buildUrl() { + const baseUrl = (this.config.baseUrl || "https://api.commandcode.ai").replace(/\/$/, ""); + return `${baseUrl}${this.config.chatPath || "/alpha/generate"}`; + } + + async execute({ model, body, stream, credentials, signal, upstreamExtraHeaders }: ExecuteInput) { + const apiKey = credentials?.apiKey || credentials?.accessToken; + if (!apiKey) throw new Error("Command Code API key required"); + + const headers: Record<string, string> = { + "Content-Type": "application/json", + Authorization: `Bearer ${apiKey}`, + "x-command-code-version": COMMAND_CODE_VERSION, + "x-cli-environment": "external", + "x-project-slug": "pi-cc", + "x-taste-learning": "false", + "x-co-flag": "false", + "x-session-id": randomUUID(), + }; + mergeUpstreamExtraHeaders(headers, upstreamExtraHeaders); + + const transformedBody = buildCommandCodeBody(model, body); + const url = this.buildUrl(); + const upstream = await fetch(url, { + method: "POST", + headers, + body: JSON.stringify(transformedBody), + signal: signal || undefined, + }); + + if (!upstream.ok) { + const errorText = await upstream.text().catch(() => ""); + return { + response: new Response(errorText || `Command Code API error ${upstream.status}`, { + status: upstream.status, + statusText: upstream.statusText, + headers: upstream.headers, + }), + url, + headers, + transformedBody, + }; + } + + const response = stream + ? createStreamResponse(upstream, model, signal) + : await createJsonResponse(upstream, model, signal); + + return { response, url, headers, transformedBody }; + } +} diff --git a/open-sse/executors/default.ts b/open-sse/executors/default.ts index 83dd52309a..0b033f468d 100644 --- a/open-sse/executors/default.ts +++ b/open-sse/executors/default.ts @@ -11,6 +11,7 @@ import { getGigachatAccessToken } from "../services/gigachatAuth.ts"; import { getRegistryEntry } from "../config/providerRegistry.ts"; import { applyProviderRequestDefaults } from "../services/providerRequestDefaults.ts"; import { + detectFormat, getOpenAICompatibleType, getTargetFormat, isClaudeCodeCompatible, @@ -31,7 +32,7 @@ function normalizeBaseUrl(baseUrl) { function normalizeBailianMessagesUrl(baseUrl) { const normalized = normalizeBaseUrl(baseUrl).replace(/\?beta=true$/, ""); const messagesUrl = normalized.endsWith("/messages") ? normalized : `${normalized}/messages`; - return `${messagesUrl}?beta=true`; + return messagesUrl; } function normalizeHerokuChatUrl(baseUrl) { @@ -147,8 +148,12 @@ export class DefaultExecutor extends BaseExecutor { return normalizeDataRobotChatUrl(baseUrl); } case "azure-ai": { + const forceResponses = + credentials?.providerSpecificData?._omnirouteForceResponsesUpstream === true; const apiType = - credentials?.providerSpecificData?.apiType === "responses" ? "responses" : "chat"; + forceResponses || credentials?.providerSpecificData?.apiType === "responses" + ? "responses" + : "chat"; const baseUrl = credentials?.providerSpecificData?.baseUrl || this.config.baseUrl; return normalizeAzureAiChatUrl(baseUrl, apiType); } @@ -161,8 +166,12 @@ export class DefaultExecutor extends BaseExecutor { return normalizeWatsonxChatUrl(baseUrl); } case "oci": { + const forceResponses = + credentials?.providerSpecificData?._omnirouteForceResponsesUpstream === true; const apiType = - credentials?.providerSpecificData?.apiType === "responses" ? "responses" : "chat"; + forceResponses || credentials?.providerSpecificData?.apiType === "responses" + ? "responses" + : "chat"; const baseUrl = credentials?.providerSpecificData?.baseUrl || this.config.baseUrl; return normalizeOciChatUrl(baseUrl, apiType); } @@ -393,6 +402,11 @@ export class DefaultExecutor extends BaseExecutor { transformRequest(model, body, stream, credentials) { const cleanedBody = super.transformRequest(model, body, stream, credentials); let withDefaults = applyProviderRequestDefaults(cleanedBody, this.config.requestDefaults); + const targetFormat = getTargetFormat(this.provider, credentials?.providerSpecificData); + const requestFormat = + withDefaults && typeof withDefaults === "object" && !Array.isArray(withDefaults) + ? detectFormat(withDefaults as Record<string, unknown>) + : "openai"; if (typeof withDefaults === "object" && withDefaults !== null && !Array.isArray(withDefaults)) { if (this.provider?.startsWith?.("anthropic-compatible-")) { @@ -401,10 +415,7 @@ export class DefaultExecutor extends BaseExecutor { delete withoutStreamOptions.stream_options; withDefaults = withoutStreamOptions; } - } else if ( - stream && - getTargetFormat(this.provider, credentials?.providerSpecificData) === "openai" - ) { + } else if (stream && targetFormat === "openai" && requestFormat !== "openai-responses") { if (!credentials?.providerSpecificData?.disableStreamOptions) { withDefaults = { ...withDefaults, @@ -418,10 +429,17 @@ export class DefaultExecutor extends BaseExecutor { delete withoutStreamOptions.stream_options; withDefaults = withoutStreamOptions; } + } else if ( + (targetFormat === "openai-responses" || requestFormat === "openai-responses") && + Object.prototype.hasOwnProperty.call(withDefaults, "stream_options") + ) { + const withoutStreamOptions = { ...withDefaults } as Record<string, unknown>; + delete withoutStreamOptions.stream_options; + withDefaults = withoutStreamOptions; } // #1961: Map max_tokens -> max_completion_tokens for recent OpenAI models - if (getTargetFormat(this.provider, credentials?.providerSpecificData) === "openai") { + if (targetFormat === "openai") { const isRecentOpenAI = /^(o1|o3|o4|gpt-5)/i.test(model); if (isRecentOpenAI && withDefaults && typeof withDefaults === "object") { const defaultsRecord = withDefaults as Record<string, unknown>; diff --git a/open-sse/executors/devin-cli.ts b/open-sse/executors/devin-cli.ts new file mode 100644 index 0000000000..528cd25308 --- /dev/null +++ b/open-sse/executors/devin-cli.ts @@ -0,0 +1,470 @@ +/** + * DevinCliExecutor — routes completions through the official Devin CLI binary + * via the Agent Client Protocol (ACP) JSON-RPC 2.0 over stdio. + * + * Protocol flow: + * 1. Spawn `devin acp --agent-type summarizer` as a subprocess + * (summarizer = no file-system tools → pure text replies, safe for proxy use) + * 2. Send: initialize → session/new (with model + cwd) → session/prompt + * 3. Receive: session/update notifications (streaming text deltas) + * 4. Emit deltas as OpenAI-compatible SSE chunks + * 5. Kill subprocess on [DONE] or error + * + * Authentication: + * credentials.apiKey / accessToken → passed as WINDSURF_API_KEY env var to devin. + * If not set, devin falls back to credentials stored by `devin auth login`. + * + * Binary discovery: + * 1. CLI_DEVIN_BIN env var (absolute path override) + * 2. PATH lookup ("devin" / "devin.exe") + * 3. %LOCALAPPDATA%\devin\cli\bin\devin.exe (Windows installer) + * 4. ~/.local/share/devin/bin/devin (Linux installer) + * + * Model selection: + * Passed directly to ACP session/new as `model` param (e.g. "swe-1.6-fast", + * "claude-sonnet-4.6", "gpt-5.5-high"). Devin CLI resolves them against its + * model_configs_v2.bin catalog on startup. + */ + +import { spawn } from "node:child_process"; +import path from "node:path"; +import os from "node:os"; +import fs from "node:fs"; +import { BaseExecutor, type ExecuteInput, type ProviderCredentials } from "./base.ts"; + +// ─── Binary discovery ──────────────────────────────────────────────────────── + +function resolveDevinBin(): string { + // 1. Explicit override + const envBin = process.env.CLI_DEVIN_BIN?.trim(); + if (envBin) return envBin; + + // 2. Common name (PATH lookup handled by spawn shell option) + const isWin = process.platform === "win32"; + + // 3. Windows installer default: %LOCALAPPDATA%\devin\cli\bin\devin.exe + if (isWin) { + const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"); + const winPath = path.join(localAppData, "devin", "cli", "bin", "devin.exe"); + if (fs.existsSync(winPath)) return winPath; + } + + // 4. Linux/macOS installer paths + const home = os.homedir(); + for (const candidate of [ + path.join(home, ".local", "share", "devin", "bin", "devin"), + path.join(home, ".devin", "bin", "devin"), + ]) { + if (fs.existsSync(candidate)) return candidate; + } + + // Fallback — rely on PATH + return isWin ? "devin.exe" : "devin"; +} + +// ─── ACP JSON-RPC helpers ──────────────────────────────────────────────────── + +type AcpMessage = { + jsonrpc: "2.0"; + method?: string; + result?: unknown; + error?: { code: number; message: string }; + params?: unknown; + id?: number | null; +}; + +function rpc(method: string, params: unknown, id?: number): string { + const msg: AcpMessage = { jsonrpc: "2.0", method, params }; + if (id !== undefined) msg.id = id; + return JSON.stringify(msg) + "\n"; +} + +// ─── Multi-turn message → single prompt builder ─────────────────────────────── + +type OpenAIMsg = { role?: string; content?: unknown }; + +function buildPromptText(messages: OpenAIMsg[]): string { + // Devin CLI (summarizer mode) receives a single text prompt. + // We inline the whole conversation so the model has full context. + const lines: string[] = []; + for (const m of messages) { + const role = String(m.role || "user"); + let text = ""; + if (typeof m.content === "string") { + text = m.content; + } else if (Array.isArray(m.content)) { + for (const p of m.content) { + if (p && typeof p === "object" && (p as Record<string, unknown>).type === "text") { + text += String((p as Record<string, unknown>).text || ""); + } + } + } + if (!text.trim()) continue; + if (role === "system") { + lines.push(`[System]\n${text}`); + } else if (role === "assistant") { + lines.push(`[Assistant]\n${text}`); + } else { + lines.push(`[User]\n${text}`); + } + } + return lines.join("\n\n") || "(empty)"; +} + +// ─── DevinCliExecutor ───────────────────────────────────────────────────────── + +export class DevinCliExecutor extends BaseExecutor { + constructor() { + super("devin-cli", { id: "devin-cli", baseUrl: "" }); + } + + buildUrl(): string { + return "devin://acp/stdio"; + } + + buildHeaders(): Record<string, string> { + return {}; + } + + transformRequest(): unknown { + return null; + } + + async execute({ model, body, stream: _stream, credentials, signal, log }: ExecuteInput): Promise<{ + response: Response; + url: string; + headers: Record<string, string>; + transformedBody: unknown; + }> { + const b = (body ?? {}) as Record<string, unknown>; + const messages: OpenAIMsg[] = Array.isArray(b.messages) ? (b.messages as OpenAIMsg[]) : []; + const promptText = buildPromptText(messages); + const apiKey = + credentials.apiKey || credentials.accessToken || process.env.WINDSURF_API_KEY || ""; + const devinBin = resolveDevinBin(); + + log?.info?.("DEVIN", `devin acp → model=${model}, bin=${devinBin}`); + + const sseStream = new ReadableStream<Uint8Array>({ + start(controller) { + const enc = new TextEncoder(); + const emit = (data: string) => controller.enqueue(enc.encode(data)); + + const env: NodeJS.ProcessEnv = { ...process.env }; + if (apiKey) env.WINDSURF_API_KEY = apiKey; + + const child = spawn(devinBin, ["acp", "--agent-type", "summarizer"], { + env, + stdio: ["pipe", "pipe", "pipe"], + // On Windows, devin.exe may need shell resolution + shell: process.platform === "win32", + }); + + let spawnError: Error | null = null; + let stdinClosed = false; + + child.on("error", (err) => { + spawnError = err; + const msg = + err.message.includes("ENOENT") || err.message.includes("not found") + ? `Devin CLI not found: ${devinBin}. Install via https://cli.devin.ai or set CLI_DEVIN_BIN env var.` + : `Devin CLI spawn error: ${err.message}`; + emit( + `data: ${JSON.stringify({ error: { message: msg, type: "devin_cli_error", code: "spawn_failed" } })}\n\n` + ); + emit("data: [DONE]\n\n"); + controller.close(); + }); + + if (signal) { + signal.addEventListener("abort", () => { + if (!child.killed) child.kill("SIGTERM"); + }); + } + + // ── JSON-RPC state machine ────────────────────────────────────────── + let idCounter = 1; + let sessionId: string | null = null; + let initDone = false; + let sessionCreated = false; + let promptSent = false; + let responseId = `chatcmpl-devin-${Date.now()}`; + let created = Math.floor(Date.now() / 1000); + let roleEmitted = false; + let totalText = ""; + let finished = false; + + const sendRpc = (method: string, params: unknown) => { + if (stdinClosed || child.stdin.destroyed) return; + const id = idCounter++; + try { + child.stdin.write(rpc(method, params, id)); + } catch { + /* ignore write errors after close */ + } + return id; + }; + + const finish = (error?: string) => { + if (finished) return; + finished = true; + + if (error) { + emit( + `data: ${JSON.stringify({ error: { message: error, type: "devin_cli_error" } })}\n\n` + ); + } else { + // Emit finish chunk + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: {}, finish_reason: "stop" }], + usage: { + prompt_tokens: Math.ceil(promptText.length / 4), + completion_tokens: Math.ceil(totalText.length / 4), + total_tokens: Math.ceil((promptText.length + totalText.length) / 4), + estimated: true, + }, + })}\n\n` + ); + } + emit("data: [DONE]\n\n"); + + // Gracefully close stdin → devin will exit + try { + if (!stdinClosed) { + stdinClosed = true; + child.stdin.end(); + } + } catch { + /* ignore */ + } + + // Give it 2s to exit cleanly, then SIGKILL + const killTimer = setTimeout(() => { + if (!child.killed) child.kill("SIGKILL"); + }, 2000); + killTimer.unref?.(); + + controller.close(); + }; + + // ── stdout reader (NDJSON) ────────────────────────────────────────── + let buffer = ""; + + child.stdout.on("data", (chunk: Buffer) => { + buffer += chunk.toString("utf8"); + let nl: number; + // Each ACP message is a newline-terminated JSON line + while ((nl = buffer.indexOf("\n")) !== -1) { + const line = buffer.slice(0, nl).trim(); + buffer = buffer.slice(nl + 1); + if (!line) continue; + + let msg: AcpMessage; + try { + msg = JSON.parse(line); + } catch { + continue; // ignore non-JSON lines (banner text, etc.) + } + + // ── Initialize response ─────────────────────────────────────── + if (!initDone && msg.result !== undefined && !msg.method) { + initDone = true; + // Create session: send session/new with model and a temp cwd + sendRpc("session/new", { + cwd: process.cwd(), + model: model || undefined, + }); + continue; + } + + // ── session/new response → get sessionId ────────────────────── + if (initDone && !sessionCreated && msg.result !== undefined && !msg.method) { + const res = msg.result as Record<string, unknown>; + sessionId = (res?.sessionId as string) || null; + if (!sessionId) { + finish("Devin ACP: session/new returned no sessionId"); + return; + } + sessionCreated = true; + // Send the prompt + promptSent = true; + sendRpc("session/prompt", { + sessionId, + content: [{ type: "text", text: promptText }], + }); + continue; + } + + // ── session/prompt response (ack) ───────────────────────────── + if (sessionCreated && promptSent && msg.result !== undefined && !msg.method) { + // Acknowledged — streaming notifications will follow + continue; + } + + // ── Streaming notifications (session/update) ────────────────── + if (msg.method === "session/update" || msg.method === "$/update") { + const params = msg.params as Record<string, unknown> | undefined; + if (!params) continue; + + const type = params.type as string | undefined; + + if (type === "message_delta" || type === "text_delta" || type === "content_delta") { + const delta = + (params.content as string) || + (params.delta as string) || + (params.text as string) || + ""; + if (delta) { + if (!roleEmitted) { + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [ + { + index: 0, + delta: { role: "assistant", content: "" }, + finish_reason: null, + }, + ], + })}\n\n` + ); + roleEmitted = true; + } + totalText += delta; + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: { content: delta }, finish_reason: null }], + })}\n\n` + ); + } + } else if (type === "message_stop" || type === "stop" || type === "done") { + finish(); + return; + } else if (type === "error") { + finish(String(params.message || params.error || "Devin ACP error")); + return; + } + continue; + } + + // ── session/prompt final result (non-streaming path) ────────── + if (promptSent && msg.result !== undefined && !msg.method && !finished) { + const res = msg.result as Record<string, unknown> | undefined; + // Extract text from result if we haven't streamed anything yet + if (!roleEmitted && res) { + const content = extractResultText(res); + if (content) { + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [ + { + index: 0, + delta: { role: "assistant", content: "" }, + finish_reason: null, + }, + ], + })}\n\n` + ); + totalText = content; + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: { content }, finish_reason: null }], + })}\n\n` + ); + } + } + const stopReason = (res?.stopReason as string) || ""; + if (stopReason && stopReason !== "cancelled") { + finish(); + } + } + + // ── Error responses ─────────────────────────────────────────── + if (msg.error) { + finish(`Devin ACP error ${msg.error.code}: ${msg.error.message}`); + return; + } + } + }); + + child.stderr.on("data", (chunk: Buffer) => { + log?.debug?.("DEVIN", `stderr: ${chunk.toString("utf8").slice(0, 200)}`); + }); + + child.on("close", (code) => { + if (!finished) { + if (code !== 0 && !spawnError) { + finish(roleEmitted ? undefined : `Devin CLI exited with code ${code}`); + } else { + finish(); + } + } + }); + + // ── Send initialize ─────────────────────────────────────────────── + sendRpc("initialize", { + protocolVersion: "0.3", + clientInfo: { name: "omniroute", version: "1.0" }, + capabilities: {}, + }); + }, + }); + + return { + response: new Response(sseStream, { + status: 200, + headers: { + "Content-Type": "text/event-stream", + "Cache-Control": "no-cache", + Connection: "keep-alive", + }, + }), + url: "devin://acp/stdio", + headers: {}, + transformedBody: { model, promptLength: (body as Record<string, unknown>)?.messages }, + }; + } +} + +// ─── Helpers ───────────────────────────────────────────────────────────────── + +/** Try to extract text from a final ACP session/prompt result object. */ +function extractResultText(result: Record<string, unknown>): string { + // Common result shapes: + // { message: { content: "..." } } + // { messages: [{ content: "..." }] } + // { content: "..." } + // { text: "..." } + if (typeof result.content === "string") return result.content; + if (typeof result.text === "string") return result.text; + const msg = result.message as Record<string, unknown> | undefined; + if (msg && typeof msg.content === "string") return msg.content; + const msgs = result.messages as Array<Record<string, unknown>> | undefined; + if (Array.isArray(msgs)) { + return msgs + .filter((m) => m.role === "assistant") + .map((m) => String(m.content || "")) + .join("\n"); + } + return ""; +} diff --git a/open-sse/executors/gemini-cli.ts b/open-sse/executors/gemini-cli.ts index d97fcc504e..1b77fc4b5b 100644 --- a/open-sse/executors/gemini-cli.ts +++ b/open-sse/executors/gemini-cli.ts @@ -310,13 +310,15 @@ export class GeminiCLIExecutor extends BaseExecutor { ? cloneGeminiCliRecord(bodyRecord.request as Record<string, any>) : {}; + const storedProject = + bodyRecord.project || + credentials.projectId || + (credentials.providerSpecificData as Record<string, unknown>)?.projectId || + ""; + const envelope: Record<string, any> = { model: currentModel, - project: - bodyRecord.project || - credentials.projectId || - (credentials.providerSpecificData as Record<string, unknown>)?.projectId || - "", + project: storedProject, user_prompt_id: bodyRecord.user_prompt_id || generateGeminiCliRequestId(), request: { ...requestRecord, @@ -330,9 +332,9 @@ export class GeminiCLIExecutor extends BaseExecutor { } } - // Refresh the project ID via loadCodeAssist (cached for 30s) only when project not provided - // and credentials have an access token - if (!envelope.project && credentials.accessToken) { + // Native Gemini CLI refreshes the Cloud Code project periodically because + // stored project IDs can go stale. Keep the stored value as a fallback. + if (credentials.accessToken) { const freshProject = await this.refreshProject(credentials.accessToken, currentModel); if (freshProject) { envelope.project = freshProject; diff --git a/open-sse/executors/index.ts b/open-sse/executors/index.ts index 03b4d1b079..512fb38c1b 100644 --- a/open-sse/executors/index.ts +++ b/open-sse/executors/index.ts @@ -19,9 +19,12 @@ import { ChatGptWebExecutor } from "./chatgpt-web.ts"; import { BlackboxWebExecutor } from "./blackbox-web.ts"; import { MuseSparkWebExecutor } from "./muse-spark-web.ts"; import { AzureOpenAIExecutor } from "./azure-openai.ts"; +import { CommandCodeExecutor } from "./commandCode.ts"; import { GitlabExecutor } from "./gitlab.ts"; import { NlpCloudExecutor } from "./nlpcloud.ts"; import { PetalsExecutor } from "./petals.ts"; +import { WindsurfExecutor } from "./windsurf.ts"; +import { DevinCliExecutor } from "./devin-cli.ts"; const executors = { antigravity: new AntigravityExecutor(), @@ -37,6 +40,8 @@ const executors = { glmt: new GlmExecutor("glmt"), cu: new CursorExecutor(), // Alias for cursor "azure-openai": new AzureOpenAIExecutor(), + "command-code": new CommandCodeExecutor(), + cmd: new CommandCodeExecutor(), // Alias gitlab: new GitlabExecutor(), "gitlab-duo": new GitlabExecutor("gitlab-duo"), nlpcloud: new NlpCloudExecutor(), @@ -62,6 +67,10 @@ const executors = { "bb-web": new BlackboxWebExecutor(), // Alias "muse-spark-web": new MuseSparkWebExecutor(), "ms-web": new MuseSparkWebExecutor(), // Alias + windsurf: new WindsurfExecutor(), + ws: new WindsurfExecutor(), // Alias + "devin-cli": new DevinCliExecutor(), + devin: new DevinCliExecutor(), // Alias }; const defaultCache = new Map(); @@ -99,6 +108,9 @@ export { ChatGptWebExecutor } from "./chatgpt-web.ts"; export { BlackboxWebExecutor } from "./blackbox-web.ts"; export { MuseSparkWebExecutor } from "./muse-spark-web.ts"; export { AzureOpenAIExecutor } from "./azure-openai.ts"; +export { CommandCodeExecutor } from "./commandCode.ts"; export { GitlabExecutor } from "./gitlab.ts"; export { NlpCloudExecutor } from "./nlpcloud.ts"; export { PetalsExecutor } from "./petals.ts"; +export { WindsurfExecutor } from "./windsurf.ts"; +export { DevinCliExecutor } from "./devin-cli.ts"; diff --git a/open-sse/executors/pollinations.ts b/open-sse/executors/pollinations.ts index 653026fdf3..285557b910 100644 --- a/open-sse/executors/pollinations.ts +++ b/open-sse/executors/pollinations.ts @@ -41,8 +41,12 @@ export class PollinationsExecutor extends BaseExecutor { return headers; } - transformRequest(model: string, body: any, _stream: boolean, _credentials: any): any { - // Pollinations uses provider aliases directly: "openai", "claude", "gemini", etc. + transformRequest(model: string, body: any, stream: boolean, _credentials: any): any { + if (typeof body === "object" && body !== null) { + body.model = model; + body.stream = stream; + body.jsonMode = true; + } return body; } } diff --git a/open-sse/executors/windsurf.ts b/open-sse/executors/windsurf.ts new file mode 100644 index 0000000000..684cc2eb6d --- /dev/null +++ b/open-sse/executors/windsurf.ts @@ -0,0 +1,754 @@ +/** + * WindsurfExecutor — routes requests to Windsurf (Devin CLI / Codeium) backend. + * + * Wire protocol: gRPC-web over HTTPS (Content-Type: application/grpc-web+proto). + * Service: exa.language_server_pb.LanguageServerService + * Method: GetChatMessage (unary → streamed as SSE) + * + * Authentication: + * credentials.accessToken = Codeium API key from windsurf.com/show-auth-token + * — placed in Metadata.api_key protobuf field of every request. + * + * Model IDs accepted by this executor (snake_case sent to Windsurf wire): + * Cognition SWE: swe-1, swe-1-5, swe-1-6, swe-1-6-fast, swe-1-lite + * Claude: claude-4-5-sonnet, claude-4-5-opus, claude-4-sonnet, claude-4-opus, + * claude-3-7-sonnet, claude-3-7-sonnet-thinking + * Gemini: gemini-2-5-pro, gemini-2-5-flash, gemini-3-0-pro, gemini-3-0-flash + * OpenAI: gpt-4-1, gpt-4-5, o1, o1-mini + * + * OmniRoute → Windsurf model-ID mapping lives in MODEL_ID_MAP below. + */ + +import { BaseExecutor, mergeUpstreamExtraHeaders, type ExecuteInput } from "./base.ts"; +import { PROVIDERS } from "../config/constants.ts"; +import { randomUUID } from "node:crypto"; + +// ─── Windsurf API constants ────────────────────────────────────────────────── + +const WS_BASE_URL = "https://server.self-serve.windsurf.com"; +const WS_SERVICE = "exa.language_server_pb.LanguageServerService"; +const WS_METHOD_CHAT = "GetChatMessage"; +const WS_CHAT_URL = `${WS_BASE_URL}/${WS_SERVICE}/${WS_METHOD_CHAT}`; + +const WS_IDE_NAME = "windsurf"; +const WS_IDE_VERSION = "3.14.0"; +const WS_EXT_VERSION = "3.14.0"; +const WS_LOCALE = "en-US"; + +// ─── Model alias normalizer ────────────────────────────────────────────────── +// +// Model names are passed directly to the Windsurf API as ModelOrAlias strings. +// The API accepts the catalog names as-is (e.g. "claude-4.5-sonnet", "swe-1.6-fast"). +// +// This table handles only OmniRoute-style backwards-compat aliases where users +// might type dashes instead of dots (e.g. "swe-1-6-fast" → "swe-1.6-fast"). + +// Model IDs — source: model_configs_v2.bin extracted from Devin CLI binary. +// OmniRoute uses dot-notation user IDs (e.g. "gpt-5.5-high"). +// Windsurf API accepts dash-notation modelUids (e.g. "gpt-5-5-high"). +// This map normalises dot→dash for newer models and handles legacy aliases. +const MODEL_ALIAS_MAP: Record<string, string> = { + // ── SWE ───────────────────────────────────────────────────────────────── + "swe-1.6-fast": "swe-1-6-fast", + "swe-1.6": "swe-1-6", + "swe-1.5-fast": "swe-1p5", // fast variant + "swe-1.5": "swe-1p5", + "swe-check": "swe-check", + // ── Claude Opus 4.7 ────────────────────────────────────────────────────── + "claude-opus-4.7-max": "claude-opus-4-7-max", + "claude-opus-4.7-xhigh": "claude-opus-4-7-xhigh", + "claude-opus-4.7-high": "claude-opus-4-7-high", + "claude-opus-4.7-medium": "claude-opus-4-7-medium", + "claude-opus-4.7-low": "claude-opus-4-7-low", + "claude-opus-4.7-review": "opus-4-7-review", + // ── Claude Opus/Sonnet 4.6 ─────────────────────────────────────────────── + "claude-sonnet-4.6-thinking-1m": "claude-sonnet-4-6-thinking-1m", + "claude-sonnet-4.6-1m": "claude-sonnet-4-6-1m", + "claude-sonnet-4.6-thinking": "claude-sonnet-4-6-thinking", + "claude-sonnet-4.6": "claude-sonnet-4-6", + "claude-opus-4.6-thinking": "claude-opus-4-6-thinking", + "claude-opus-4.6": "claude-opus-4-6", + // ── Claude 4.5 ─────────────────────────────────────────────────────────── + "claude-opus-4.5-thinking": "MODEL_CLAUDE_4_5_OPUS_THINKING", + "claude-opus-4.5": "MODEL_CLAUDE_4_5_OPUS", + "claude-sonnet-4.5-thinking": "MODEL_PRIVATE_3", + "claude-sonnet-4.5": "MODEL_PRIVATE_2", + "claude-haiku-4.5": "MODEL_PRIVATE_11", + // backward-compat flat names + "claude-4.5-opus-thinking": "MODEL_CLAUDE_4_5_OPUS_THINKING", + "claude-4.5-opus": "MODEL_CLAUDE_4_5_OPUS", + "claude-4.5-sonnet-thinking": "MODEL_PRIVATE_3", + "claude-4.5-sonnet": "MODEL_PRIVATE_2", + "claude-4.5-haiku": "MODEL_PRIVATE_11", + // ── Claude 4 ───────────────────────────────────────────────────────────── + "claude-4-opus-thinking": "MODEL_CLAUDE_4_OPUS_THINKING", + "claude-4-opus": "MODEL_CLAUDE_4_OPUS", + "claude-4-sonnet-thinking": "MODEL_CLAUDE_4_SONNET_THINKING", + "claude-4-sonnet": "MODEL_CLAUDE_4_SONNET", + "claude-4.1-opus-thinking": "MODEL_CLAUDE_4_1_OPUS_THINKING", + "claude-4.1-opus": "MODEL_CLAUDE_4_1_OPUS", + // ── Claude 3.x ─────────────────────────────────────────────────────────── + "claude-3.7-sonnet-thinking": "CLAUDE_3_7_SONNET_20250219_THINKING", + "claude-3.7-sonnet": "CLAUDE_3_7_SONNET_20250219", + "claude-3.5-sonnet": "CLAUDE_3_5_SONNET_20241022", + // ── GPT-5.5 ────────────────────────────────────────────────────────────── + "gpt-5.5-xhigh-fast": "gpt-5-5-xhigh-priority", + "gpt-5.5-high-fast": "gpt-5-5-high-priority", + "gpt-5.5-medium-fast": "gpt-5-5-medium-priority", + "gpt-5.5-low-fast": "gpt-5-5-low-priority", + "gpt-5.5-none-fast": "gpt-5-5-none-priority", + "gpt-5.5-xhigh": "gpt-5-5-xhigh", + "gpt-5.5-high": "gpt-5-5-high", + "gpt-5.5-medium": "gpt-5-5-medium", + "gpt-5.5-low": "gpt-5-5-low", + "gpt-5.5-none": "gpt-5-5-none", + "gpt-5.5-review": "gpt-5-5-review", + "gpt-5.5": "gpt-5-5-medium", // default effort level + // ── GPT-5.4 ────────────────────────────────────────────────────────────── + "gpt-5.4-xhigh-fast": "gpt-5-4-xhigh-priority", + "gpt-5.4-high-fast": "gpt-5-4-high-priority", + "gpt-5.4-medium-fast": "gpt-5-4-medium-priority", + "gpt-5.4-low-fast": "gpt-5-4-low-priority", + "gpt-5.4-none-fast": "gpt-5-4-none-priority", + "gpt-5.4-xhigh": "gpt-5-4-xhigh", + "gpt-5.4-high": "gpt-5-4-high", + "gpt-5.4-medium": "gpt-5-4-medium", + "gpt-5.4-low": "gpt-5-4-low", + "gpt-5.4-none": "gpt-5-4-none", + "gpt-5.4-mini-xhigh": "gpt-5-4-mini-xhigh", + "gpt-5.4-mini-high": "gpt-5-4-mini-high", + "gpt-5.4-mini-medium": "gpt-5-4-mini-medium", + "gpt-5.4-mini-low": "gpt-5-4-mini-low", + "gpt-5.4": "gpt-5-4-medium", // default effort level + // ── GPT-5.3-Codex ──────────────────────────────────────────────────────── + "gpt-5.3-codex-xhigh-fast": "gpt-5-3-codex-xhigh-priority", + "gpt-5.3-codex-high-fast": "gpt-5-3-codex-high-priority", + "gpt-5.3-codex-medium-fast": "gpt-5-3-codex-medium-priority", + "gpt-5.3-codex-low-fast": "gpt-5-3-codex-low-priority", + "gpt-5.3-codex-xhigh": "gpt-5-3-codex-xhigh", + "gpt-5.3-codex-high": "gpt-5-3-codex-high", + "gpt-5.3-codex-medium": "gpt-5-3-codex-medium", + "gpt-5.3-codex-low": "gpt-5-3-codex-low", + "gpt-5.3-codex": "gpt-5-3-codex-medium", + // ── GPT-5.2 ────────────────────────────────────────────────────────────── + "gpt-5.2-xhigh": "MODEL_GPT_5_2_XHIGH", + "gpt-5.2-high": "MODEL_GPT_5_2_HIGH", + "gpt-5.2-medium": "MODEL_GPT_5_2_MEDIUM", + "gpt-5.2-low": "MODEL_GPT_5_2_LOW", + "gpt-5.2-none": "MODEL_GPT_5_2_NONE", + "gpt-5.2": "MODEL_GPT_5_2_MEDIUM", + // ── GPT-5 ──────────────────────────────────────────────────────────────── + "gpt-5-codex": "gpt-5-codex", + "gpt-5": "gpt-5", + // ── GPT-4.1 / 4o ───────────────────────────────────────────────────────── + "gpt-4.1": "MODEL_CHAT_GPT_4_1_2025_04_14", + "gpt-4.1-mini": "gpt-4.1-mini", + "gpt-4.1-nano": "gpt-4.1-nano", + "gpt-4o": "MODEL_CHAT_GPT_4O_2024_08_06", + "gpt-4o-mini": "gpt-4o-mini", + // ── Gemini ──────────────────────────────────────────────────────────────── + "gemini-3.1-pro-high": "gemini-3-1-pro-high", + "gemini-3.1-pro-low": "gemini-3-1-pro-low", + "gemini-3.1-pro": "gemini-3-1-pro-high", + "gemini-3.0-pro": "gemini-3-pro", + "gemini-3.0-flash-high": "MODEL_GOOGLE_GEMINI_3_0_FLASH_HIGH", + "gemini-3.0-flash-medium": "MODEL_GOOGLE_GEMINI_3_0_FLASH_MEDIUM", + "gemini-3.0-flash-low": "MODEL_GOOGLE_GEMINI_3_0_FLASH_LOW", + "gemini-3.0-flash-minimal": "MODEL_GOOGLE_GEMINI_3_0_FLASH_MINIMAL", + "gemini-3.0-flash": "MODEL_GOOGLE_GEMINI_3_0_FLASH_HIGH", + "gemini-2.5-pro": "MODEL_GOOGLE_GEMINI_2_5_PRO", + "gemini-2.5-flash": "gemini-2.5-flash", + // ── Others ─────────────────────────────────────────────────────────────── + "deepseek-v4": "deepseek-v4", + "deepseek-r1": "deepseek-r1", + "deepseek-v3-2": "deepseek-v3-2", + "deepseek-v3": "deepseek-v3", + "grok-3-mini-thinking": "MODEL_XAI_GROK_3_MINI_REASONING", + "grok-3-mini": "grok-3-mini", + "grok-3": "MODEL_XAI_GROK_3", + "grok-code-fast-1": "grok-code-fast-1", + "kimi-k2.6": "kimi-k2-6", + "kimi-k2.5": "kimi-k2-5", + "kimi-k2": "MODEL_KIMI_K2", + "glm-5.1": "glm-5-1", + "glm-5": "glm-5", + "glm-4.7": "MODEL_GLM_4_7", +}; + +function resolveWsModelId(model: string): string { + return MODEL_ALIAS_MAP[model] ?? model; +} + +// ─── Minimal protobuf encoder ──────────────────────────────────────────────── +// +// Implements only what is needed for GetChatMessageRequest. +// Wire types: 0 = varint, 2 = length-delimited. + +function encodeVarint(value: number): Uint8Array { + const bytes: number[] = []; + let v = value >>> 0; + while (v > 0x7f) { + bytes.push((v & 0x7f) | 0x80); + v >>>= 7; + } + bytes.push(v & 0x7f); + return new Uint8Array(bytes); +} + +function concatBytes(arrays: Uint8Array[]): Uint8Array { + const total = arrays.reduce((n, a) => n + a.length, 0); + const out = new Uint8Array(total); + let off = 0; + for (const a of arrays) { + out.set(a, off); + off += a.length; + } + return out; +} + +const TEXT_ENC = new TextEncoder(); +const TEXT_DEC = new TextDecoder(); + +/** Encode a length-delimited field (strings and nested messages share wire type 2). */ +function encodeField(fieldNum: number, payload: Uint8Array): Uint8Array { + const tag = encodeVarint((fieldNum << 3) | 2); + const len = encodeVarint(payload.length); + return concatBytes([tag, len, payload]); +} + +/** Encode a UTF-8 string field. */ +function encodeString(fieldNum: number, value: string): Uint8Array { + return encodeField(fieldNum, TEXT_ENC.encode(value)); +} + +/** Encode a nested message field. */ +function encodeMessage(fieldNum: number, msg: Uint8Array): Uint8Array { + return encodeField(fieldNum, msg); +} + +// ─── Protobuf message builders ─────────────────────────────────────────────── + +function buildMetadata(apiKey: string, sessionId: string): Uint8Array { + return concatBytes([ + encodeString(1, apiKey), + encodeString(2, WS_IDE_NAME), + encodeString(3, WS_IDE_VERSION), + encodeString(4, WS_EXT_VERSION), + encodeString(5, sessionId), + encodeString(6, WS_LOCALE), + ]); +} + +function buildModelOrAlias(model: string): Uint8Array { + // ModelOrAlias wraps the model identifier in field 1 + return encodeString(1, model); +} + +type WsChatMessage = { role: string; content: string; toolCallId?: string }; + +function buildChatMessage(msg: WsChatMessage): Uint8Array { + const parts: Uint8Array[] = [encodeString(1, msg.role), encodeString(2, msg.content)]; + if (msg.toolCallId) parts.push(encodeString(3, msg.toolCallId)); + return concatBytes(parts); +} + +function buildGetChatMessageRequest( + apiKey: string, + model: string, + messages: WsChatMessage[] +): Uint8Array { + const sessionId = randomUUID(); + const cascadeId = randomUUID(); + + const parts: Uint8Array[] = [ + encodeMessage(1, buildMetadata(apiKey, sessionId)), // metadata + encodeString(2, cascadeId), // cascade_id + encodeMessage(3, buildModelOrAlias(model)), // model_or_alias + ]; + + for (const msg of messages) { + parts.push(encodeMessage(4, buildChatMessage(msg))); // repeated messages + } + + return concatBytes(parts); +} + +// ─── gRPC-web framing ──────────────────────────────────────────────────────── + +/** Wrap a protobuf message in a 5-byte gRPC-web data frame. */ +function grpcWebFrame(payload: Uint8Array): Uint8Array { + const frame = new Uint8Array(5 + payload.length); + frame[0] = 0x00; // compression flag: no compression + const view = new DataView(frame.buffer); + view.setUint32(1, payload.length, false); // big-endian length + frame.set(payload, 5); + return frame; +} + +// ─── Protobuf response decoder ─────────────────────────────────────────────── +// +// CompletionChunk (oneof): +// field 1 (length-delimited) → ContentChunk { field 1: string text } +// field 2 (length-delimited) → ToolCallChunk (skipped for now) +// field 3 (length-delimited) → DoneChunk { field 1: UsageStats } +// field 4 (length-delimited) → ErrorChunk { field 1: string message } +// +// GetChatMessageResponse (unary fallback): +// field 1 (length-delimited) → content string (heuristic) +// field 2 (length-delimited) → nested message (heuristic) + +type DecodedChunk = + | { kind: "content"; text: string } + | { kind: "done"; promptTokens: number; completionTokens: number } + | { kind: "error"; message: string } + | { kind: "unknown" }; + +/** Read a varint from buf starting at offset; returns [value, newOffset]. */ +function readVarint(buf: Uint8Array, offset: number): [number, number] { + let result = 0; + let shift = 0; + while (offset < buf.length) { + const b = buf[offset++]; + result |= (b & 0x7f) << shift; + if ((b & 0x80) === 0) break; + shift += 7; + } + return [result >>> 0, offset]; +} + +/** Decode a single protobuf message payload as a CompletionChunk. */ +function decodeCompletionChunk(buf: Uint8Array): DecodedChunk { + let offset = 0; + while (offset < buf.length) { + let tag: number; + [tag, offset] = readVarint(buf, offset); + const fieldNum = tag >>> 3; + const wireType = tag & 0x07; + + if (wireType === 2) { + // length-delimited + let len: number; + [len, offset] = readVarint(buf, offset); + const payload = buf.slice(offset, offset + len); + offset += len; + + if (fieldNum === 1) { + // ContentChunk — field 1 inside = text string + const text = decodeContentChunk(payload); + if (text !== null) return { kind: "content", text }; + } else if (fieldNum === 3) { + // DoneChunk — field 1 inside = UsageStats + const usage = decodeDoneChunk(payload); + return { kind: "done", promptTokens: usage[0], completionTokens: usage[1] }; + } else if (fieldNum === 4) { + // ErrorChunk — field 1 inside = error message string + const msg = decodeStringField(payload, 1); + return { kind: "error", message: msg ?? "unknown windsurf error" }; + } + // field 2 = ToolCallChunk — not yet handled; skip + } else if (wireType === 0) { + let _v: number; + [_v, offset] = readVarint(buf, offset); + } else if (wireType === 1) { + offset += 8; + } else if (wireType === 5) { + offset += 4; + } else { + break; // unknown wire type — stop parsing + } + } + return { kind: "unknown" }; +} + +/** Extract text string from ContentChunk (field 1 = string). */ +function decodeContentChunk(buf: Uint8Array): string | null { + return decodeStringField(buf, 1); +} + +/** Extract prompt_tokens + completion_tokens from DoneChunk.UsageStats. */ +function decodeDoneChunk(buf: Uint8Array): [number, number] { + // DoneChunk: field 1 = UsageStats (nested) + // UsageStats: field 1 = prompt_tokens (varint), field 2 = completion_tokens (varint) + let offset = 0; + let usageBytes: Uint8Array | null = null; + while (offset < buf.length) { + let tag: number; + [tag, offset] = readVarint(buf, offset); + const fieldNum = tag >>> 3; + const wireType = tag & 0x07; + if (wireType === 2) { + let len: number; + [len, offset] = readVarint(buf, offset); + if (fieldNum === 1) usageBytes = buf.slice(offset, offset + len); + offset += len; + } else if (wireType === 0) { + let _v: number; + [_v, offset] = readVarint(buf, offset); + } else { + break; + } + } + if (!usageBytes) return [0, 0]; + let promptTokens = 0; + let completionTokens = 0; + offset = 0; + while (offset < usageBytes.length) { + let tag: number; + [tag, offset] = readVarint(usageBytes, offset); + const fieldNum = tag >>> 3; + const wireType = tag & 0x07; + if (wireType === 0) { + let v: number; + [v, offset] = readVarint(usageBytes, offset); + if (fieldNum === 1) promptTokens = v; + else if (fieldNum === 2) completionTokens = v; + } else if (wireType === 2) { + let len: number; + [len, offset] = readVarint(usageBytes, offset); + offset += len; + } else { + break; + } + } + return [promptTokens, completionTokens]; +} + +/** Read a length-delimited string at a given field number from buf. */ +function decodeStringField(buf: Uint8Array, targetField: number): string | null { + let offset = 0; + while (offset < buf.length) { + let tag: number; + [tag, offset] = readVarint(buf, offset); + const fieldNum = tag >>> 3; + const wireType = tag & 0x07; + if (wireType === 2) { + let len: number; + [len, offset] = readVarint(buf, offset); + const payload = buf.slice(offset, offset + len); + offset += len; + if (fieldNum === targetField) return TEXT_DEC.decode(payload); + } else if (wireType === 0) { + let _v: number; + [_v, offset] = readVarint(buf, offset); + } else if (wireType === 1) { + offset += 8; + } else if (wireType === 5) { + offset += 4; + } else { + break; + } + } + return null; +} + +// ─── Convert OpenAI messages → Windsurf WsChatMessage[] ────────────────────── + +type OpenAIMessage = { + role?: string; + content?: unknown; + tool_call_id?: string; +}; + +function openAIMessagesToWs(messages: OpenAIMessage[]): WsChatMessage[] { + const out: WsChatMessage[] = []; + for (const m of messages) { + const role = String(m.role || "user"); + let content = ""; + if (typeof m.content === "string") { + content = m.content; + } else if (Array.isArray(m.content)) { + // Multi-part: concatenate text parts + for (const part of m.content) { + if (part && typeof part === "object" && (part as Record<string, unknown>).type === "text") { + content += String((part as Record<string, unknown>).text || ""); + } + } + } + out.push({ role, content, toolCallId: m.tool_call_id }); + } + return out; +} + +// ─── gRPC-web response stream parser ───────────────────────────────────────── +// +// gRPC-web frame layout: +// byte 0: flag (0x00 = data, 0x80 = trailers) +// bytes 1-4: message length (big-endian uint32) +// bytes 5…: protobuf payload +// +// The response body is a concatenated sequence of these frames. + +function* parseGrpcWebFrames(buf: Uint8Array): Generator<{ flag: number; payload: Uint8Array }> { + let offset = 0; + while (offset + 5 <= buf.length) { + const flag = buf[offset]; + const len = + (buf[offset + 1] << 24) | (buf[offset + 2] << 16) | (buf[offset + 3] << 8) | buf[offset + 4]; + offset += 5; + if (len < 0 || offset + len > buf.length) break; + yield { flag, payload: buf.slice(offset, offset + len) }; + offset += len; + } +} + +// ─── WindsurfExecutor ───────────────────────────────────────────────────────── + +export class WindsurfExecutor extends BaseExecutor { + constructor() { + super("windsurf", PROVIDERS["windsurf"] || { id: "windsurf", baseUrl: WS_CHAT_URL }); + } + + buildUrl(): string { + return WS_CHAT_URL; + } + + buildHeaders(credentials: { accessToken?: string; apiKey?: string }): Record<string, string> { + const token = credentials.accessToken || credentials.apiKey || ""; + return { + "Content-Type": "application/grpc-web+proto", + Accept: "application/grpc-web+proto", + // Codeium API key also goes in Metadata.api_key (protobuf field) — see request body. + // Some endpoints also accept it as a Bearer token header. + ...(token ? { Authorization: `Bearer ${token}` } : {}), + "User-Agent": `windsurf/${WS_IDE_VERSION}`, + "X-Grpc-Web": "1", + }; + } + + transformRequest(): unknown { + // Request body is built manually in execute() because it requires the model + messages + return null; + } + + async execute({ + model, + body, + stream, + credentials, + signal, + log, + upstreamExtraHeaders, + }: ExecuteInput): Promise<{ + response: Response; + url: string; + headers: Record<string, string>; + transformedBody: unknown; + }> { + const apiKey = credentials.accessToken || credentials.apiKey || ""; + const wsModel = resolveWsModelId(model); + + // Parse OpenAI messages from request body + const b = (body ?? {}) as Record<string, unknown>; + const rawMessages = Array.isArray(b.messages) ? (b.messages as OpenAIMessage[]) : []; + const wsMessages = openAIMessagesToWs(rawMessages); + + if (wsMessages.length === 0) { + wsMessages.push({ role: "user", content: "" }); + } + + // Build and frame the protobuf request + const protoPayload = buildGetChatMessageRequest(apiKey, wsModel, wsMessages); + const framedPayload = grpcWebFrame(protoPayload); + + const url = this.buildUrl(); + const headers = this.buildHeaders(credentials); + mergeUpstreamExtraHeaders(headers, upstreamExtraHeaders); + + log?.info?.("WS", `Windsurf → ${wsModel} (${wsMessages.length} messages)`); + + const upstream = await fetch(url, { + method: "POST", + headers, + body: framedPayload, + signal: signal ?? undefined, + }); + + if (!upstream.ok && upstream.status !== 200) { + return { response: upstream, url, headers, transformedBody: protoPayload }; + } + + // Transform gRPC-web binary response → SSE stream + const sseResponse = this.transformToSSE(upstream, model, stream); + return { response: sseResponse, url, headers, transformedBody: protoPayload }; + } + + /** Convert a gRPC-web response body into an OpenAI-compatible SSE stream. */ + private transformToSSE(upstream: Response, model: string, _stream: boolean): Response { + const responseId = `chatcmpl-ws-${Date.now()}`; + const created = Math.floor(Date.now() / 1000); + + const transformStream = new TransformStream<Uint8Array, Uint8Array>({ + async transform(chunk, controller) { + // Accumulate — gRPC-web frames may arrive split across fetch chunks. + // For simplicity we buffer the entire message set in flush(). + controller.enqueue(chunk); + }, + }); + + // We need to buffer the full response to parse gRPC frames. + // Use a ReadableStream that: + // 1. reads the entire upstream body + // 2. parses gRPC-web frames + // 3. emits SSE events + const sseStream = new ReadableStream<Uint8Array>({ + async start(controller) { + const enc = new TextEncoder(); + let roleEmitted = false; + let totalText = ""; + let promptTokens = 0; + let completionTokens = 0; + let hadError: string | null = null; + + function emit(data: string) { + controller.enqueue(enc.encode(data)); + } + + try { + const bodyBytes = upstream.body ? await readStream(upstream.body) : new Uint8Array(0); + + for (const { flag, payload } of parseGrpcWebFrames(bodyBytes)) { + if (flag === 0x80) { + // Trailer frame — contains grpc-status, grpc-message + const trailer = TEXT_DEC.decode(payload); + const statusMatch = /grpc-status:\s*(\d+)/i.exec(trailer); + if (statusMatch && statusMatch[1] !== "0") { + const msgMatch = /grpc-message:\s*(.+)/i.exec(trailer); + hadError = msgMatch + ? decodeURIComponent(msgMatch[1].trim()) + : `gRPC status ${statusMatch[1]}`; + } + continue; + } + + if (flag !== 0x00) continue; // skip unknown flags + + const chunk = decodeCompletionChunk(payload); + + if (chunk.kind === "content" && chunk.text) { + totalText += chunk.text; + if (!roleEmitted) { + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [ + { index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }, + ], + })}\n\n` + ); + roleEmitted = true; + } + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: { content: chunk.text }, finish_reason: null }], + })}\n\n` + ); + } else if (chunk.kind === "done") { + promptTokens = chunk.promptTokens; + completionTokens = chunk.completionTokens; + } else if (chunk.kind === "error") { + hadError = chunk.message; + } + } + + if (hadError) { + emit( + `data: ${JSON.stringify({ + error: { message: hadError, type: "windsurf_error", code: "upstream_error" }, + })}\n\n` + ); + emit("data: [DONE]\n\n"); + controller.close(); + return; + } + + // If nothing was streamed but we got a response, treat the decoded + // text as the full reply (unary response path). + if (!roleEmitted && totalText) { + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [ + { index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }, + ], + })}\n\n` + ); + emit( + `data: ${JSON.stringify({ + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: { content: totalText }, finish_reason: null }], + })}\n\n` + ); + } + + // Finish chunk + const finishPayload: Record<string, unknown> = { + id: responseId, + object: "chat.completion.chunk", + created, + model, + choices: [{ index: 0, delta: {}, finish_reason: "stop" }], + }; + if (promptTokens > 0 || completionTokens > 0) { + finishPayload.usage = { + prompt_tokens: promptTokens, + completion_tokens: completionTokens, + total_tokens: promptTokens + completionTokens, + }; + } + emit(`data: ${JSON.stringify(finishPayload)}\n\n`); + emit("data: [DONE]\n\n"); + } catch (err) { + const msg = err instanceof Error ? err.message : String(err); + emit( + `data: ${JSON.stringify({ + error: { message: `Windsurf stream error: ${msg}`, type: "windsurf_error" }, + })}\n\n` + ); + emit("data: [DONE]\n\n"); + } + + controller.close(); + }, + }); + + void transformStream; // unused — kept for reference + + return new Response(sseStream, { + status: 200, + headers: { + "Content-Type": "text/event-stream", + "Cache-Control": "no-cache", + Connection: "keep-alive", + }, + }); + } +} + +/** Read an entire ReadableStream<Uint8Array> into a single Uint8Array. */ +async function readStream(readable: ReadableStream<Uint8Array>): Promise<Uint8Array> { + const chunks: Uint8Array[] = []; + const reader = readable.getReader(); + try { + while (true) { + const { done, value } = await reader.read(); + if (done) break; + if (value) chunks.push(value); + } + } finally { + reader.releaseLock(); + } + return concatBytes(chunks); +} diff --git a/open-sse/handlers/audioSpeech.ts b/open-sse/handlers/audioSpeech.ts index 2342a6d9ea..ffa2542aa8 100644 --- a/open-sse/handlers/audioSpeech.ts +++ b/open-sse/handlers/audioSpeech.ts @@ -428,7 +428,21 @@ async function handleHuggingFaceTtsSpeech(providerConfig, body, modelId, token) * POST { text, voiceId, modelId, audioConfig } → JSON { audioContent: "<base64>" } * Docs: https://docs.inworld.ai/api-reference/ttsAPI/texttospeech/synthesize-speech */ +const INWORLD_AUDIO_FORMATS = { + mp3: { audioEncoding: "MP3", mimeType: "audio/mpeg" }, + wav: { audioEncoding: "WAV", mimeType: "audio/wav" }, + opus: { audioEncoding: "OPUS", mimeType: "audio/opus" }, + pcm: { audioEncoding: "PCM", mimeType: "audio/pcm" }, +}; + async function handleInworldSpeech(providerConfig, body, modelId, token) { + const requestedFormat = + typeof body.response_format === "string" ? body.response_format.toLowerCase() : "mp3"; + const audioFormat = INWORLD_AUDIO_FORMATS[requestedFormat]; + if (!audioFormat) { + return errorResponse(400, "Inworld TTS supports response_format mp3, wav, opus, or pcm only"); + } + const res = await fetch(providerConfig.baseUrl, { method: "POST", headers: { @@ -440,7 +454,7 @@ async function handleInworldSpeech(providerConfig, body, modelId, token) { voiceId: body.voice || undefined, modelId, audioConfig: { - audioEncoding: body.response_format === "wav" ? "LINEAR16" : "MP3", + audioEncoding: audioFormat.audioEncoding, }, }), }); @@ -452,7 +466,10 @@ async function handleInworldSpeech(providerConfig, body, modelId, token) { const data = await res.json(); // Decode base64 audioContent to binary const audioBuffer = Uint8Array.from(atob(data.audioContent ?? ""), (c) => c.charCodeAt(0)); - const mimeType = body.response_format === "wav" ? "audio/wav" : "audio/mpeg"; + const mimeType = + typeof data.contentType === "string" && data.contentType + ? data.contentType + : audioFormat.mimeType; return new Response(audioBuffer, { status: 200, diff --git a/open-sse/handlers/chatCore.ts b/open-sse/handlers/chatCore.ts index fbcde7c28c..7146188bc2 100644 --- a/open-sse/handlers/chatCore.ts +++ b/open-sse/handlers/chatCore.ts @@ -11,7 +11,7 @@ import { } from "../utils/stream.ts"; import { ensureStreamReadiness } from "../utils/streamReadiness.ts"; import { createStreamController, pipeWithDisconnect } from "../utils/streamHandler.ts"; -import { createSseHeartbeatTransform } from "../utils/sseHeartbeat.ts"; +import { createSseHeartbeatTransform, shapeForClientFormat } from "../utils/sseHeartbeat.ts"; import { addBufferToUsage, filterUsageForFormat, estimateUsage } from "../utils/usageTracking.ts"; import { refreshWithRetry } from "../services/tokenRefresh.ts"; import { createRequestLogger } from "../utils/requestLogger.ts"; @@ -32,8 +32,10 @@ import { import { COOLDOWN_MS, HTTP_STATUS, + FETCH_BODY_TIMEOUT_MS, MAX_TOOLS_LIMIT, PROVIDER_MAX_TOKENS, + SSE_HEARTBEAT_INTERVAL_MS, STREAM_IDLE_TIMEOUT_MS, STREAM_READINESS_TIMEOUT_MS, } from "../config/constants.ts"; @@ -44,7 +46,13 @@ import { } from "../services/errorClassifier.ts"; import { updateProviderConnection } from "@/lib/db/providers"; import { isDetailedLoggingEnabled } from "@/lib/db/detailedLogs"; -import { getCallLogPipelineCaptureStreamChunks } from "@/lib/logEnv"; +import { + getCallLogPipelineCaptureStreamChunks, + getChatLogTextLimit, + getChatLogArrayTailItems, + getChatLogMaxDepth, + getChatLogMaxObjectKeys, +} from "@/lib/logEnv"; import { logAuditEvent } from "@/lib/compliance"; import { extractProviderWarnings } from "@/lib/compliance/providerAudit"; import { adaptBodyForCompression } from "../services/compression/bodyAdapter.ts"; @@ -121,7 +129,7 @@ import { buildAccountSemaphoreKey, markBlocked as markAccountSemaphoreBlocked, } from "../services/accountSemaphore.ts"; -import { lockModelIfPerModelQuota } from "../services/accountFallback.ts"; +import { lockModel, lockModelIfPerModelQuota } from "../services/accountFallback.ts"; import { generateSignature, getCachedResponse, @@ -178,12 +186,13 @@ import { import { setGeminiThoughtSignatureMode } from "../services/geminiThoughtSignatureStore.ts"; import { fetchLiveProviderLimits } from "@/lib/usage/providerLimits"; import { isClaudeExtraUsageBlockEnabled } from "@/lib/providers/claudeExtraUsage"; +import { + classifyModelScope429, + getModelScopeRetryDelayMs, + isModelScopeProvider, +} from "../services/modelscopePolicy.ts"; const MEMORY_EXTRACTION_TEXT_LIMIT = 64 * 1024; -const CHAT_LOG_TEXT_LIMIT = 64 * 1024; -const CHAT_LOG_ARRAY_TAIL_ITEMS = 24; -const CHAT_LOG_MAX_DEPTH = 6; -const CHAT_LOG_MAX_OBJECT_KEYS = 80; function capMemoryExtractionText(value: string): string { if (value.length <= MEMORY_EXTRACTION_TEXT_LIMIT) return value; @@ -191,28 +200,30 @@ function capMemoryExtractionText(value: string): string { } function truncateChatLogText(value: string): string { - if (value.length <= CHAT_LOG_TEXT_LIMIT) return value; - const head = value.slice(0, Math.floor(CHAT_LOG_TEXT_LIMIT / 2)); - const tail = value.slice(-Math.ceil(CHAT_LOG_TEXT_LIMIT / 2)); - return `${head}\n[...truncated ${value.length - CHAT_LOG_TEXT_LIMIT} chars...]\n${tail}`; + const limit = getChatLogTextLimit(); + if (value.length <= limit) return value; + const head = value.slice(0, Math.floor(limit / 2)); + const tail = value.slice(-Math.ceil(limit / 2)); + return `${head}\n[...truncated ${value.length - limit} chars...]\n${tail}`; } function cloneBoundedChatLogPayload(value: unknown, depth = 0): unknown { if (value === null || value === undefined) return value; if (typeof value === "string") return truncateChatLogText(value); if (typeof value !== "object") return value; - if (depth >= CHAT_LOG_MAX_DEPTH) return "[MaxDepth]"; + if (depth >= getChatLogMaxDepth()) return "[MaxDepth]"; + + const maxTailItems = getChatLogArrayTailItems(); if (Array.isArray(value)) { - const retained = - value.length > CHAT_LOG_ARRAY_TAIL_ITEMS ? value.slice(-CHAT_LOG_ARRAY_TAIL_ITEMS) : value; + const retained = value.length > maxTailItems ? value.slice(-maxTailItems) : value; const cloned = retained.map((item) => cloneBoundedChatLogPayload(item, depth + 1)); - if (value.length > CHAT_LOG_ARRAY_TAIL_ITEMS) { + if (value.length > maxTailItems) { return [ { _omniroute_truncated_array: true, originalLength: value.length, - retainedTailItems: CHAT_LOG_ARRAY_TAIL_ITEMS, + retainedTailItems: maxTailItems, }, ...cloned, ]; @@ -222,11 +233,12 @@ function cloneBoundedChatLogPayload(value: unknown, depth = 0): unknown { const result: Record<string, unknown> = {}; const entries = Object.entries(value as Record<string, unknown>); - for (const [key, item] of entries.slice(0, CHAT_LOG_MAX_OBJECT_KEYS)) { + const maxKeys = getChatLogMaxObjectKeys(); + for (const [key, item] of maxKeys > 0 ? entries.slice(0, maxKeys) : entries) { result[key] = cloneBoundedChatLogPayload(item, depth + 1); } - if (entries.length > CHAT_LOG_MAX_OBJECT_KEYS) { - result._omniroute_truncated_keys = entries.length - CHAT_LOG_MAX_OBJECT_KEYS; + if (maxKeys > 0 && entries.length > maxKeys) { + result._omniroute_truncated_keys = entries.length - maxKeys; } return result; } @@ -574,6 +586,146 @@ function normalizeNonStreamingEventPayload(rawBody: string, contentType: string) return rawBody; } +const NON_STREAMING_SSE_TERMINAL_TYPES = new Set([ + "message_stop", + "response.completed", + "response.done", + "response.cancelled", + "response.canceled", + "response.failed", + "response.incomplete", +]); + +type NonStreamingSseTerminalState = { + currentEvent: string; + pendingLine: string; +}; + +function processNonStreamingSseTerminalLine( + state: NonStreamingSseTerminalState, + rawLine: string +): boolean { + const trimmed = rawLine.trim(); + if (!trimmed || trimmed.startsWith(":")) { + if (!trimmed) state.currentEvent = ""; + return false; + } + + if (trimmed.startsWith("event:")) { + state.currentEvent = trimmed.slice(6).trim(); + return false; + } + + if (!trimmed.startsWith("data:")) return false; + const data = trimmed.slice(5).trim(); + if (data === "[DONE]") return true; + if (!data) return false; + + try { + const parsed = JSON.parse(data); + const eventType = + parsed && typeof parsed === "object" && typeof parsed.type === "string" + ? parsed.type + : state.currentEvent; + return NON_STREAMING_SSE_TERMINAL_TYPES.has(eventType); + } catch { + // Keep reading malformed data so the parser can report a useful upstream error. + return false; + } +} + +function appendNonStreamingSseTerminalSignal( + state: NonStreamingSseTerminalState, + chunk: string +): boolean { + const lines = `${state.pendingLine}${chunk}`.split(/\r?\n/); + state.pendingLine = lines.pop() ?? ""; + + for (const rawLine of lines) { + if (processNonStreamingSseTerminalLine(state, rawLine)) return true; + } + + return false; +} + +function createBodyTimeoutError(timeoutMs: number): Error { + const err = new Error(`Response body read timeout after ${timeoutMs}ms`); + err.name = "BodyTimeoutError"; + return err; +} + +function readStreamChunkWithTimeout( + reader: ReadableStreamDefaultReader<Uint8Array>, + timeoutMs: number +): Promise<ReadableStreamReadResult<Uint8Array>> { + if (timeoutMs <= 0) return reader.read(); + + return new Promise((resolve, reject) => { + const timeout = setTimeout(() => reject(createBodyTimeoutError(timeoutMs)), timeoutMs); + reader.read().then( + (value) => { + clearTimeout(timeout); + resolve(value); + }, + (error) => { + clearTimeout(timeout); + reject(error); + } + ); + }); +} + +async function readNonStreamingResponseBody( + response: Response, + contentType: string, + upstreamStream: boolean +): Promise<string> { + if ( + !upstreamStream || + !response.body || + (!contentType.includes("text/event-stream") && !contentType.includes("application/x-ndjson")) + ) { + return withBodyTimeout<string>(response.text()); + } + + const reader = response.body.getReader(); + const decoder = new TextDecoder(); + const terminalState: NonStreamingSseTerminalState = { + currentEvent: "", + pendingLine: "", + }; + let rawBody = ""; + const deadline = FETCH_BODY_TIMEOUT_MS > 0 ? Date.now() + FETCH_BODY_TIMEOUT_MS : 0; + + try { + while (true) { + const timeoutMs = deadline > 0 ? deadline - Date.now() : 0; + if (deadline > 0 && timeoutMs <= 0) { + throw createBodyTimeoutError(FETCH_BODY_TIMEOUT_MS); + } + + const { done, value } = await readStreamChunkWithTimeout(reader, timeoutMs); + if (done) break; + if (!value) continue; + + const decodedChunk = decoder.decode(value, { stream: true }); + rawBody += decodedChunk; + if (appendNonStreamingSseTerminalSignal(terminalState, decodedChunk)) { + await reader.cancel("non-streaming bridge consumed terminal SSE event").catch(() => {}); + break; + } + } + } catch (error) { + await reader.cancel(error).catch(() => {}); + throw error; + } finally { + rawBody += decoder.decode(); + reader.releaseLock(); + } + + return rawBody; +} + function getHeaderValueCaseInsensitive( headers: Record<string, unknown> | Headers | null | undefined, targetName: string @@ -602,14 +754,39 @@ function toFiniteNumberOrNull(value: unknown): number | null { return null; } -function isSemaphoreTimeoutError(error: unknown): error is Error & { code: string } { +function isSemaphoreCapacityError(error: unknown): error is Error & { code: string } { return ( !!error && typeof error === "object" && - (error as { code?: unknown }).code === "SEMAPHORE_TIMEOUT" + ((error as { code?: unknown }).code === "SEMAPHORE_TIMEOUT" || + (error as { code?: unknown }).code === "SEMAPHORE_QUEUE_FULL") ); } +function createStreamingErrorResult(statusCode: number, message: string, code?: string) { + const errorBody = buildErrorBody(statusCode, message); + if (code) { + errorBody.error.code = code; + } + + const body = `data: ${JSON.stringify(errorBody)}\n\ndata: [DONE]\n\n`; + + return { + success: false as const, + status: statusCode, + error: message, + response: new Response(body, { + status: statusCode, + headers: { + "Content-Type": "text/event-stream", + "Cache-Control": "no-cache, no-transform", + Connection: "keep-alive", + "X-Accel-Buffering": "no", + }, + }), + }; +} + function wrapReadableStreamWithFinalize<T>( readable: ReadableStream<T>, finalize: () => void @@ -987,8 +1164,19 @@ export async function handleChatCore({ cachedSettings = null, }) { let { provider, model, extendedContext } = modelInfo; + // apiFormat is an optional custom-model marker injected by getModelInfo for + // providers whose models can route to /chat/completions or /responses + // (Azure AI Foundry, OCI generic OpenAI). It's not on the base ModelInfo + // shape, so we read it via a structural narrowing without `as any`. + const apiFormat: string | undefined = + modelInfo && typeof modelInfo === "object" && "apiFormat" in modelInfo + ? typeof (modelInfo as { apiFormat?: unknown }).apiFormat === "string" + ? ((modelInfo as { apiFormat?: string }).apiFormat as string) + : undefined + : undefined; const requestedModel = typeof body?.model === "string" && body.model.trim().length > 0 ? body.model : model; + const isModelScope = () => isModelScopeProvider(provider, credentials?.providerSpecificData); const startTime = Date.now(); // Per-request trace id + checkpoint helper. Lets us see exactly which await // a hung request was sitting on in `[STAGE_TRACE]` log lines. @@ -1223,7 +1411,9 @@ export async function handleChatCore({ const alias = PROVIDER_ID_TO_ALIAS[provider] || provider; const modelTargetFormat = getModelTargetFormat(alias, resolvedModel); const targetFormat = - modelTargetFormat || getTargetFormat(provider, credentials?.providerSpecificData); + apiFormat === "responses" + ? FORMATS.OPENAI_RESPONSES + : modelTargetFormat || getTargetFormat(provider, credentials?.providerSpecificData); const { body: bodyWithWebSearchFallback, fallback: webSearchFallbackPlan } = prepareWebSearchFallbackBody(body as Record<string, unknown>, { provider, @@ -2576,6 +2766,12 @@ export async function handleChatCore({ delete translatedBody.store; } + // Chat clients may send stream_options.include_usage, but OpenAI Responses + // upstreams (including Azure AI Foundry /responses) reject stream_options. + if (targetFormat === FORMATS.OPENAI_RESPONSES && "stream_options" in translatedBody) { + delete translatedBody.stream_options; + } + // Provider-specific max_tokens caps (#711) // Some providers reject requests when max_tokens exceeds their API limit. // Cap before sending to avoid upstream HTTP 400 errors. @@ -2661,12 +2857,41 @@ export async function handleChatCore({ ? { ...credentials, requestEndpointPath: endpointPath } : credentials; - if (!ccSessionId) return nextCredentials; + const providerSpecificData = + nextCredentials?.providerSpecificData && + typeof nextCredentials.providerSpecificData === "object" + ? { ...nextCredentials.providerSpecificData } + : {}; + + // Some providers (Azure AI Foundry, OCI OpenAI-compatible) choose upstream + // endpoint path from providerSpecificData.apiType. When a model routes to + // OpenAI Responses format, force apiType=responses unless explicitly set. + if ( + targetFormat === FORMATS.OPENAI_RESPONSES && + (provider === "azure-ai" || provider === "oci") && + providerSpecificData.apiType !== "responses" + ) { + providerSpecificData.apiType = "responses"; + } + + if ( + targetFormat === FORMATS.OPENAI_RESPONSES && + (provider === "azure-ai" || provider === "oci") + ) { + providerSpecificData._omnirouteForceResponsesUpstream = true; + } + + const withApiType = { + ...nextCredentials, + providerSpecificData, + }; + + if (!ccSessionId) return withApiType; return { - ...nextCredentials, + ...withApiType, providerSpecificData: { - ...(nextCredentials?.providerSpecificData || {}), + ...(withApiType?.providerSpecificData || {}), ccSessionId, }, }; @@ -2799,7 +3024,14 @@ export async function handleChatCore({ async () => { trace("inside_rate_limit"); let attempts = 0; - const maxAttempts = provider === "qwen" ? 3 : provider === "codex" ? 3 : 1; + const isModelScopeForRequest = isModelScope(); + const maxAttempts = isModelScopeForRequest + ? 3 + : provider === "qwen" + ? 3 + : provider === "codex" + ? 3 + : 1; // ── Codex 429 account-rotation state ───────────────────────────────── // Track excluded connection IDs for codex failover across attempts. @@ -2845,6 +3077,24 @@ export async function handleChatCore({ } } + if (isModelScope() && res.response.status === 429 && attempts < maxAttempts - 1) { + const bodyPeek = await res.response + .clone() + .text() + .catch(() => ""); + const decision = classifyModelScope429(bodyPeek, res.response.headers); + if (decision.retryable) { + const delay = getModelScopeRetryDelayMs(res.response.headers, attempts); + log?.warn?.( + "MODELSCOPE_RETRY", + `429 ${decision.kind}; retrying in ${delay}ms (model remaining: ${decision.snapshot.modelRemaining ?? "unknown"})` + ); + await new Promise((r) => setTimeout(r, delay)); + attempts++; + continue; + } + } + // Codex 429 account-rotation failover (disabled for context-relay so combo.ts can inject handoff) if ( provider === "codex" && @@ -2959,7 +3209,12 @@ export async function handleChatCore({ const status = rawResult.response.status; const statusText = rawResult.response.statusText; const headers = new Headers(rawResult.response.headers); - const payload = await withBodyTimeout<string>(rawResult.response.text()); + const contentType = (headers.get("content-type") || "").toLowerCase(); + const payload = await readNonStreamingResponseBody( + rawResult.response, + contentType, + upstreamStream + ); acquireAccountSemaphoreRelease(); return { @@ -2969,7 +3224,11 @@ export async function handleChatCore({ _dedupSnapshot: { status, statusText, - headers: Array.from(headers.entries()), + headers: (() => { + const arr: [string, string][] = []; + headers.forEach((v, k) => arr.push([k, v])); + return arr; + })(), payload, }, }; @@ -3051,16 +3310,13 @@ export async function handleChatCore({ ); } catch (error) { trackPendingRequest(model, provider, connectionId, false); - if (isSemaphoreTimeoutError(error)) { + if (isSemaphoreCapacityError(error)) { appendRequestLog({ model, provider, connectionId, status: `FAILED ${error.code}`, }).catch(() => {}); - if (isCombo) { - throw error; - } const failureMessage = error.message || "Semaphore timeout"; persistAttemptLogs({ status: HTTP_STATUS.RATE_LIMITED, @@ -3071,7 +3327,14 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(HTTP_STATUS.RATE_LIMITED, error.code); - return createErrorResult(HTTP_STATUS.RATE_LIMITED, failureMessage); + const result = stream + ? createStreamingErrorResult(HTTP_STATUS.RATE_LIMITED, failureMessage, error.code) + : createErrorResult(HTTP_STATUS.RATE_LIMITED, failureMessage); + return { + ...result, + errorType: "account_semaphore_capacity", + errorCode: error.code, + }; } const failureStatus = error.name === "AbortError" @@ -3220,6 +3483,8 @@ export async function handleChatCore({ let statusCode = providerResponse.status; let message = ""; let retryAfterMs: number | null = null; + let upstreamErrorCode: string | undefined; + let upstreamErrorType: string | undefined; if (upstreamErrorParsed) { statusCode = parsedStatusCode; @@ -3231,10 +3496,23 @@ export async function handleChatCore({ message = details.message; retryAfterMs = details.retryAfterMs; upstreamErrorBody = details.responseBody; + upstreamErrorCode = details.errorCode; + upstreamErrorType = details.errorType; } // T06/T10/T36: classify provider errors and persist terminal account states. - const errorType = classifyProviderError(statusCode, message, provider); + let errorType = classifyProviderError(statusCode, message, provider); + if (statusCode === 429 && isModelScope()) { + const decision = classifyModelScope429(message, providerResponse.headers); + errorType = + decision.kind === "quota_exhausted" + ? PROVIDER_ERROR_TYPES.QUOTA_EXHAUSTED + : PROVIDER_ERROR_TYPES.RATE_LIMITED; + log?.warn?.( + "MODELSCOPE_429", + `${decision.kind} (model remaining: ${decision.snapshot.modelRemaining ?? "unknown"}, total remaining: ${decision.snapshot.totalRemaining ?? "unknown"})` + ); + } if (connectionId && errorType) { try { if (errorType === PROVIDER_ERROR_TYPES.FORBIDDEN) { @@ -3271,7 +3549,12 @@ export async function handleChatCore({ if (accountSemaphoreKey) { markAccountSemaphoreBlocked(accountSemaphoreKey, quotaCooldownMs); } - if ( + if (isModelScope() && connectionId) { + lockModel(provider, connectionId, model, "quota_exhausted", quotaCooldownMs); + console.warn( + `[provider] Node ${connectionId} ModelScope model quota exhausted (${statusCode}) for ${model} - ${Math.ceil(quotaCooldownMs / 1000)}s (connection stays active)` + ); + } else if ( lockModelIfPerModelQuota( provider, connectionId, @@ -3399,7 +3682,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "model_unavailable"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } catch { persistAttemptLogs({ @@ -3411,7 +3700,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "model_unavailable"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } else { persistAttemptLogs({ @@ -3423,7 +3718,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "model_unavailable"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } else if (isContextOverflowError(statusCode, message)) { const familyCandidates = getModelFamily(currentModel).filter( @@ -3459,7 +3760,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "context_overflow"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } catch { persistAttemptLogs({ @@ -3471,7 +3778,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "context_overflow"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } else { persistAttemptLogs({ @@ -3483,7 +3796,13 @@ export async function handleChatCore({ cacheSource: "upstream", }); persistFailureUsage(statusCode, "context_overflow"); - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } else { persistAttemptLogs({ @@ -3566,7 +3885,13 @@ export async function handleChatCore({ } if (!emergencyFallbackServed) { - return createErrorResult(statusCode, errMsg, retryAfterMs); + return createErrorResult( + statusCode, + errMsg, + retryAfterMs, + upstreamErrorCode, + upstreamErrorType + ); } } // ── End T5 ─────────────────────────────────────────────────────────────── @@ -3578,7 +3903,11 @@ export async function handleChatCore({ const contentType = (providerResponse.headers.get("content-type") || "").toLowerCase(); let responseBody; let responsePayloadFormat = targetFormat; - const rawBody = await withBodyTimeout<string>(providerResponse.text()); + const rawBody = await readNonStreamingResponseBody( + providerResponse, + contentType, + upstreamStream + ); const normalizedProviderPayload = normalizePayloadForLog(rawBody); const looksLikeSSE = contentType.includes("text/event-stream") || @@ -3805,7 +4134,7 @@ export async function handleChatCore({ try { const firstChoice = translatedResponse?.choices?.[0]; const msg = firstChoice?.message; - cacheReasoningFromAssistantMessage(msg, provider, model); + cacheReasoningFromAssistantMessage(msg, provider, model, { requestId: skillRequestId, messageIndex: 0 }); } catch { // Cache capture is non-critical — never block the response } @@ -3971,7 +4300,6 @@ export async function handleChatCore({ success: true, response: new Response(JSON.stringify(translatedResponse), { headers: { - ...Object.fromEntries(providerHeaders.entries()), "Content-Type": "application/json", [OMNIROUTE_RESPONSE_HEADERS.cache]: "MISS", ...buildOmniRouteResponseMetaHeaders({ @@ -4038,9 +4366,11 @@ export async function handleChatCore({ const responseHeaders: Record<string, string> = { ...Object.fromEntries( - Array.from(providerResponse.headers.entries()).filter( - ([k]) => k.toLowerCase() !== "content-type" - ) + (() => { + const arr: [string, string][] = []; + providerResponse.headers.forEach((v, k) => arr.push([k, v])); + return arr; + })().filter(([k]) => k.toLowerCase() !== "content-type") ), "Content-Type": "text/event-stream", "Cache-Control": "no-cache, no-transform", @@ -4091,7 +4421,7 @@ export async function handleChatCore({ const body = streamResponseBody as Record<string, unknown>; const choices = body.choices as { message?: Record<string, unknown> }[] | undefined; const msg = choices?.[0]?.message; - cacheReasoningFromAssistantMessage(msg, provider, model); + cacheReasoningFromAssistantMessage(msg, provider, model, { requestId: skillRequestId, messageIndex: 0 }); } catch { // Cache capture is non-critical — never block the stream } @@ -4273,7 +4603,11 @@ export async function handleChatCore({ finalStream = pipeWithDisconnect(providerResponse, transformStream, streamController); } finalStream = finalStream.pipeThrough( - createSseHeartbeatTransform({ signal: streamController.signal }) + createSseHeartbeatTransform({ + signal: streamController.signal, + intervalMs: SSE_HEARTBEAT_INTERVAL_MS, + shape: shapeForClientFormat(clientResponseFormat), + }) ); return { diff --git a/open-sse/handlers/responseSanitizer.ts b/open-sse/handlers/responseSanitizer.ts index 4b85cb0119..f7cbb300fc 100644 --- a/open-sse/handlers/responseSanitizer.ts +++ b/open-sse/handlers/responseSanitizer.ts @@ -27,6 +27,10 @@ const ALLOWED_RESPONSES_USAGE_FIELDS = new Set([ type JsonRecord = Record<string, unknown>; +function isDeepSeekV4Model(model: unknown): boolean { + return typeof model === "string" && /deepseek[-/]v4/i.test(model); +} + function toRecord(value: unknown): JsonRecord | null { if (!value || typeof value !== "object" || Array.isArray(value)) return null; return value as JsonRecord; @@ -108,6 +112,7 @@ export function extractThinkingFromContent(text: string): { export function sanitizeOpenAIResponse(body: unknown): unknown { const bodyRecord = toRecord(body); if (!bodyRecord) return body; + const isDeepSeekV4 = isDeepSeekV4Model(bodyRecord.model); // Build sanitized response with only allowed top-level fields const sanitized: JsonRecord = {}; @@ -120,7 +125,9 @@ export function sanitizeOpenAIResponse(body: unknown): unknown { // Sanitize choices if (Array.isArray(bodyRecord.choices)) { - sanitized.choices = bodyRecord.choices.map((choice, idx) => sanitizeChoice(choice, idx)); + sanitized.choices = bodyRecord.choices.map((choice, idx) => + sanitizeChoice(choice, idx, isDeepSeekV4) + ); } else { sanitized.choices = []; } @@ -182,7 +189,7 @@ export function sanitizeResponsesApiResponse(body: unknown): unknown { /** * Sanitize a single choice object. */ -function sanitizeChoice(choice: unknown, defaultIndex: number): JsonRecord { +function sanitizeChoice(choice: unknown, defaultIndex: number, isDeepSeekV4 = false): JsonRecord { const choiceRecord = toRecord(choice); const sanitized: JsonRecord = { index: defaultIndex, @@ -199,7 +206,7 @@ function sanitizeChoice(choice: unknown, defaultIndex: number): JsonRecord { // Sanitize message (non-streaming) or delta (streaming) if (choiceRecord?.message !== undefined) { - sanitized.message = sanitizeMessage(choiceRecord.message); + sanitized.message = sanitizeMessage(choiceRecord.message, isDeepSeekV4); } if (choiceRecord?.delta !== undefined) { sanitized.delta = sanitizeMessage(choiceRecord.delta); @@ -216,7 +223,7 @@ function sanitizeChoice(choice: unknown, defaultIndex: number): JsonRecord { /** * Sanitize a message object, extracting <think> tags if present. */ -function sanitizeMessage(msg: unknown): unknown { +function sanitizeMessage(msg: unknown, isDeepSeekV4 = false): unknown { const msgRecord = toRecord(msg); if (!msgRecord) return msg; @@ -285,7 +292,13 @@ function sanitizeMessage(msg: unknown): unknown { // Non-streaming responses should not expose both visible content and reasoning_content. // Some clients drop the visible assistant text or render duplicated panels when both fields // are present in the final payload. Keep reasoning_content only for reasoning-only messages. - if (sanitized.reasoning_content !== undefined && hasVisibleMessageContent(sanitized.content)) { + if ( + sanitized.reasoning_content !== undefined && + hasVisibleMessageContent(sanitized.content) && + !msgRecord.tool_calls && + !msgRecord.function_call && + !isDeepSeekV4 + ) { delete sanitized.reasoning_content; } diff --git a/open-sse/handlers/responsesHandler.ts b/open-sse/handlers/responsesHandler.ts index 203b70ed4a..65d18e6d1e 100644 --- a/open-sse/handlers/responsesHandler.ts +++ b/open-sse/handlers/responsesHandler.ts @@ -7,7 +7,8 @@ import { CORS_HEADERS } from "../utils/cors.ts"; import { handleChatCore } from "./chatCore.ts"; import { convertResponsesApiFormat } from "../translator/helpers/responsesApiHelper.ts"; import { createResponsesApiTransformStream } from "../transformer/responsesTransformer.ts"; -import { createSseHeartbeatTransform } from "../utils/sseHeartbeat.ts"; +import { createSseHeartbeatTransform, HEARTBEAT_SHAPES } from "../utils/sseHeartbeat.ts"; +import { SSE_HEARTBEAT_INTERVAL_MS } from "../config/constants.ts"; /** * Handle /v1/responses request @@ -69,9 +70,13 @@ export async function handleResponsesCore({ // Transform SSE stream to Responses API format (no logging in worker) const transformStream = createResponsesApiTransformStream(null); - const transformedBody = response.body - .pipeThrough(transformStream) - .pipeThrough(createSseHeartbeatTransform({ signal })); + const transformedBody = response.body.pipeThrough(transformStream).pipeThrough( + createSseHeartbeatTransform({ + signal, + intervalMs: SSE_HEARTBEAT_INTERVAL_MS, + shape: HEARTBEAT_SHAPES.OPENAI_RESPONSES_IN_PROGRESS, + }) + ); return { success: true, diff --git a/open-sse/handlers/search.ts b/open-sse/handlers/search.ts index 01e2e68973..b86c22dcac 100644 --- a/open-sse/handlers/search.ts +++ b/open-sse/handlers/search.ts @@ -3,9 +3,9 @@ import { randomUUID } from "crypto"; * Search Handler * * Handles POST /v1/search requests. - * Routes to 10 search providers with automatic failover: + * Routes to 11 search providers with automatic failover: * serper-search, brave-search, perplexity-search, exa-search, tavily-search, - * google-pse-search, linkup-search, searchapi-search, youcom-search, searxng-search + * google-pse-search, linkup-search, searchapi-search, youcom-search, searxng-search, ollama-search, zai-search * * Request format: * { @@ -18,6 +18,10 @@ import { randomUUID } from "crypto"; import { getSearchProvider, type SearchProviderConfig } from "../config/searchRegistry.ts"; import { saveCallLog } from "@/lib/usageDb"; +import { safeOutboundFetch } from "@/shared/network/safeOutboundFetch"; +import { Client } from "@modelcontextprotocol/sdk/client/index.js"; +import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"; +import { z } from "zod"; // ── Types ──────────────────────────────────────────────────────────────── @@ -582,6 +586,26 @@ function buildSearxngRequest( }; } +function buildOllamaRequest( + config: SearchProviderConfig, + params: SearchRequestParams +): { url: string; init: RequestInit } { + return { + url: resolveSearchBaseUrl(config, params), + init: { + method: "POST", + headers: { + "Content-Type": "application/json", + ...(params.token ? { Authorization: `Bearer ${params.token}` } : {}), + }, + body: JSON.stringify({ + query: params.query, + max_results: params.maxResults, + }), + }, + }; +} + function buildRequest( config: SearchProviderConfig, params: SearchRequestParams @@ -596,6 +620,7 @@ function buildRequest( if (config.id === "searchapi-search") return buildSearchApiRequest(config, params); if (config.id === "youcom-search") return buildYouComRequest(config, params); if (config.id === "searxng-search") return buildSearxngRequest(config, params); + if (config.id === "ollama-search") return buildOllamaRequest(config, params); // Fallback for future providers: POST with bearer auth return { url: resolveSearchBaseUrl(config, params), @@ -881,6 +906,269 @@ function normalizeSearxngResponse( return { results, totalResults: results.length }; } +function normalizeOllamaResponse( + data: any, + _query: string, + _searchType: string +): { results: SearchResult[]; totalResults: number | null } { + const now = new Date().toISOString(); + const items = Array.isArray(data?.results) ? data.results : []; + + const results = items.map((item: any, idx: number) => + makeResult( + "ollama-search", + { + title: item?.title, + url: item?.url, + snippet: item?.content || "", + full_text: item?.content, + text_format: "text", + }, + idx, + now + ) + ); + + return { results, totalResults: results.length }; +} + +// ── Z.AI Coding Plan Search MCP Execution ─────────────────────────── + +// Schema for the Z.AI MCP web_search_prime tool result. Z.AI double-encodes +// the results array as a JSON string inside the MCP text content, so we +// safely unwrap it with a typed schema instead of `JSON.parse(parsed)`. +const ZaiSearchItemSchema = z + .object({ + title: z.string().optional(), + link: z.string().optional(), + content: z.string().optional(), + publish_date: z.string().optional(), + icon: z.string().optional(), + media: z.string().optional(), + }) + .passthrough(); + +type ZaiSearchItem = z.infer<typeof ZaiSearchItemSchema>; + +const ZaiSearchResultsSchema = z.array(ZaiSearchItemSchema); + +/** + * Unwrap the double-encoded JSON from a Z.AI MCP web_search_prime response. + * + * Quirk: the MCP server returns a text content block whose body is a JSON + * string. That JSON string, once parsed, is itself another JSON string + * containing the actual results array. We try a single parse first + * (in case the upstream behavior ever changes), then a nested parse. + * Both paths are validated through `ZaiSearchResultsSchema` so any shape + * regression upstream lands in our error path instead of corrupting results. + */ +function unwrapZaiContent(rawText: string): ZaiSearchItem[] | null { + let parsed: unknown; + try { + parsed = JSON.parse(rawText); + } catch { + return null; + } + + // Direct array path (defensive, in case Z.AI stops double-encoding). + const direct = ZaiSearchResultsSchema.safeParse(parsed); + if (direct.success) return direct.data; + + // Documented Z.AI behavior: parsed is a JSON string of the results array. + if (typeof parsed !== "string") return null; + let inner: unknown; + try { + inner = JSON.parse(parsed); + } catch { + return null; + } + const validated = ZaiSearchResultsSchema.safeParse(inner); + return validated.success ? validated.data : null; +} + +async function zaiSearchExecute(params: { + config: SearchProviderConfig; + query: string; + token: string; + params: SearchRequestParams; + signal?: AbortSignal; +}): Promise<{ results: SearchResult[]; totalResults: number | null }> { + const baseUrl = resolveSearchBaseUrl(params.config, params.params); + const transport = new StreamableHTTPClientTransport(new URL(baseUrl), { + fetch: safeOutboundFetch, + requestInit: { + headers: { + Authorization: `Bearer ${params.token}`, + }, + }, + }); + + const client = new Client({ name: "omniroute-search", version: "1.0" }, { capabilities: {} }); + + const { signal } = params; + + let abortHandler: (() => void) | undefined; + if (signal) { + if (signal.aborted) { + throw new DOMException("The operation was aborted", "AbortError"); + } + abortHandler = () => { + client.close().catch(() => {}); + }; + signal.addEventListener("abort", abortHandler, { once: true }); + } + + try { + await client.connect(transport); + + if (signal?.aborted) { + throw new DOMException("The operation was aborted", "AbortError"); + } + + const args: Record<string, unknown> = { + search_query: params.query, + }; + + const { includes } = parseDomainFilter(params.params.domainFilter); + if (includes.length > 0) { + args.search_domain_filter = includes.join(","); + } + + const toolResult = await client.callTool({ + name: "web_search_prime", + arguments: args, + }); + + const rawContent = Array.isArray(toolResult.content) ? toolResult.content : []; + const rawText = rawContent + .filter((c: any) => c?.type === "text") + .map((c: any) => (typeof c?.text === "string" ? c.text : "")) + .join("\n"); + + if (!rawText.trim()) { + return { results: [], totalResults: null }; + } + + const items = unwrapZaiContent(rawText); + if (!items) { + return { results: [], totalResults: null }; + } + + const now = new Date().toISOString(); + const results = items.map((item, idx) => + makeResult( + "zai-search", + { + title: item.title, + url: item.link, + snippet: item.content || "", + published_at: item.publish_date, + favicon_url: item.icon, + source_type: item.media, + }, + idx, + now + ) + ); + return { results, totalResults: results.length }; + } finally { + if (abortHandler && signal) { + signal.removeEventListener("abort", abortHandler); + } + await client.close(); + } +} + +async function tryZaiMCPProvider( + config: SearchProviderConfig, + params: Omit<SearchRequestParams, "token">, + token: string, + providerSpecificData: Record<string, unknown> | undefined, + startTime: number, + globalStartTime: number, + log?: any +): Promise<SearchHandlerResult> { + const { query, searchType, maxResults } = params; + + const remainingGlobal = GLOBAL_TIMEOUT_MS - (Date.now() - globalStartTime); + const timeout = Math.min(config.timeoutMs, Math.max(remainingGlobal, 1000)); + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), timeout); + + try { + const normalized = await zaiSearchExecute({ + config, + query, + token, + params: { ...params, token, providerSpecificData }, + signal: controller.signal, + }); + clearTimeout(timer); + + const results = normalized.results.slice(0, maxResults); + const duration = Date.now() - startTime; + + saveCallLog({ + method: config.method, + path: "/v1/search", + status: 200, + model: config.id, + provider: config.id, + duration, + requestType: "search", + tokens: { prompt_tokens: 0, completion_tokens: 0 }, + requestBody: { query: query.slice(0, 200), search_type: searchType, max_results: maxResults }, + responseBody: { results_count: results.length, cached: false }, + }).catch(() => { + /* non-critical — logging must not block search response */ + }); + + return { + success: true, + data: { + provider: config.id, + query, + results, + answer: null, + usage: { queries_used: 1, search_cost_usd: config.costPerQuery }, + metrics: { + response_time_ms: duration, + upstream_latency_ms: duration, + total_results_available: normalized.totalResults, + }, + errors: [], + }, + }; + } catch (err: any) { + clearTimeout(timer); + + const isTimeout = err.name === "AbortError"; + if (log) { + log.error("SEARCH", `${config.id} MCP ${isTimeout ? "timeout" : "error"}: ${err.message}`); + } + + saveCallLog({ + method: config.method, + path: "/v1/search", + status: isTimeout ? 504 : 502, + model: config.id, + provider: config.id, + duration: Date.now() - startTime, + requestType: "search", + error: err.message, + requestBody: { query: query.slice(0, 200), search_type: searchType, max_results: maxResults }, + }).catch(() => { + /* non-critical — logging must not block search response */ + }); + + return { + success: false, + status: isTimeout ? 504 : 502, + error: `Search provider ${isTimeout ? "timeout" : "error"}: ${err.message}`, + }; + } +} + function normalizeResponse( providerId: string, data: any, @@ -899,6 +1187,7 @@ function normalizeResponse( if (providerId === "searchapi-search") return normalizeSearchApiResponse(data, query, searchType); if (providerId === "youcom-search") return normalizeYouComResponse(data, query, searchType); if (providerId === "searxng-search") return normalizeSearxngResponse(data, query, searchType); + if (providerId === "ollama-search") return normalizeOllamaResponse(data, query, searchType); return { results: [], totalResults: null }; } @@ -1012,6 +1301,19 @@ async function tryProvider( } const { query, searchType, maxResults } = params; + + if (config.id === "zai-search" && token) { + return tryZaiMCPProvider( + config, + params, + token, + providerSpecificData, + startTime, + globalStartTime, + log + ); + } + let url = ""; let init: RequestInit = {}; try { diff --git a/open-sse/handlers/sseParser.ts b/open-sse/handlers/sseParser.ts index 44beadf0da..7432590a4f 100644 --- a/open-sse/handlers/sseParser.ts +++ b/open-sse/handlers/sseParser.ts @@ -22,9 +22,19 @@ function readSSEEvents(rawSSE) { } try { + const data = JSON.parse(payload); + if ( + currentEvent && + data && + typeof data === "object" && + !Array.isArray(data) && + typeof data.type !== "string" + ) { + data.type = currentEvent; + } events.push({ event: currentEvent || undefined, - data: JSON.parse(payload), + data, }); } catch { // Ignore malformed SSE events and continue best-effort parsing. @@ -41,12 +51,21 @@ function readSSEEvents(rawSSE) { } if (line.startsWith("event:")) { + // Some relays omit the blank separator between Claude events. Flush the + // previous event before accepting the next event name. + if (currentData.length > 0) flush(); currentEvent = line.slice(6).trim(); continue; } if (line.startsWith("data:")) { - currentData.push(line.slice(5).trimStart()); + const dataLine = line.slice(5).trimStart(); + if (dataLine.trim() === "[DONE]") { + flush(); + currentEvent = ""; + continue; + } + currentData.push(dataLine); } } diff --git a/open-sse/mcp-server/README.md b/open-sse/mcp-server/README.md index f70c86014f..9c358d6599 100644 --- a/open-sse/mcp-server/README.md +++ b/open-sse/mcp-server/README.md @@ -1,6 +1,8 @@ # OmniRoute MCP Server -> **Model Context Protocol server** that exposes OmniRoute's gateway intelligence as **16 tools** for AI agents. +> **Model Context Protocol server** that exposes OmniRoute's gateway intelligence as **37 tools** for AI agents. +> +> **Source of truth for the full tool catalog and REST surface:** [`docs/frameworks/MCP-SERVER.md`](../../docs/MCP-SERVER.md). This README focuses on architecture, configuration, and integration examples; the catalog below is a summary subset. The MCP Server allows any AI agent (Claude Desktop, Cursor, VS Code Copilot, custom agents) to **monitor, control, and optimize** the OmniRoute AI gateway programmatically. @@ -18,8 +20,9 @@ The MCP Server allows any AI agent (Claude Desktop, Cursor, VS Code Copilot, cus ┌──────────────────────────────────────────────────────────────────┐ │ OmniRoute MCP Server │ │ ┌──────────────┐ ┌─────────────────┐ ┌────────────────────┐ │ -│ │ Scope │ │ 16 MCP Tools │ │ Audit Logger │ │ -│ │ Enforcement │──│ (Phase 1 + 2) │──│ (SHA-256/SQLite) │ │ +│ │ Scope │ │ 37 MCP Tools │ │ Audit Logger │ │ +│ │ Enforcement │──│ (core + memory │──│ (SHA-256/SQLite) │ │ +│ │ │ │ + skills + …) │ │ │ │ │ └──────────────┘ └────────┬────────┘ └────────────────────┘ │ └─────────────────────────────┼────────────────────────────────────┘ │ HTTP (internal) diff --git a/open-sse/mcp-server/tools/advancedTools.ts b/open-sse/mcp-server/tools/advancedTools.ts index 723a061925..86dc3930ed 100644 --- a/open-sse/mcp-server/tools/advancedTools.ts +++ b/open-sse/mcp-server/tools/advancedTools.ts @@ -428,7 +428,7 @@ export async function handleSetRoutingStrategy(args: { ...currentConfig, auto: { ...currentAutoConfig, - routingStrategy: args.autoRoutingStrategy, + routerStrategy: args.autoRoutingStrategy, }, }; } @@ -447,7 +447,7 @@ export async function handleSetRoutingStrategy(args: { const updatedConfig = toRecord(updatedCombo.config); const resolvedAutoStrategy = - toString(toRecord(updatedConfig.auto).routingStrategy) || + toString(toRecord(updatedConfig.auto).routerStrategy) || (normalizedStrategy === "auto" ? (args.autoRoutingStrategy ?? "rules") : ""); const result = { diff --git a/open-sse/services/accountFallback.ts b/open-sse/services/accountFallback.ts index 446b9510c1..12271a22cf 100644 --- a/open-sse/services/accountFallback.ts +++ b/open-sse/services/accountFallback.ts @@ -22,10 +22,14 @@ import { getCircuitBreaker, STATE, } from "../../src/shared/utils/circuitBreaker"; +import { classify429FromError, type FailureKind } from "../../src/shared/utils/classify429"; +import { resolveUseUpstream429BreakerHints } from "../../src/shared/utils/providerHints"; type ProviderProfile = { baseCooldownMs: number; useUpstreamRetryHints: boolean; + /** Issue #2100 follow-up. Stored override; undefined → per-provider default. */ + useUpstream429BreakerHints?: boolean; maxBackoffSteps: number; failureThreshold: number; resetTimeoutMs: number; @@ -40,6 +44,7 @@ type ProviderProfile = { providerCooldownMs: number; }; type JsonRecord = Record<string, unknown>; +type RateLimitReasonValue = (typeof RateLimitReason)[keyof typeof RateLimitReason]; type ModelLockoutEntry = { reason: string; until: number; @@ -53,6 +58,17 @@ type ModelFailureState = { lastFailureAt: number; resetAfterMs: number; }; +type AccountState = JsonRecord & { + id?: string | null; + rateLimitedUntil?: string | null; + backoffLevel?: number | null; + lastError?: unknown; + status?: string; +}; + +function toJsonRecord(value: unknown): JsonRecord { + return value && typeof value === "object" && !Array.isArray(value) ? (value as JsonRecord) : {}; +} // Provider-level failure tracking for circuit breaker behavior // Error codes that count toward provider-level failure threshold @@ -182,6 +198,9 @@ function buildProviderProfile( return { baseCooldownMs: connectionCooldown.baseCooldownMs, useUpstreamRetryHints: connectionCooldown.useUpstreamRetryHints, + // Issue #2100 follow-up: propagate stored override (boolean | undefined) + // so the runtime resolver picks user setting first, then per-provider default. + useUpstream429BreakerHints: connectionCooldown.useUpstream429BreakerHints, maxBackoffSteps: connectionCooldown.maxBackoffSteps, failureThreshold: providerBreaker.failureThreshold, resetTimeoutMs: providerBreaker.resetTimeoutMs, @@ -203,7 +222,7 @@ function buildProviderProfile( * Get the resilience profile for a provider (oauth or apikey). * @param {string} provider - Provider ID or alias */ -export function getProviderProfile(provider) { +export function getProviderProfile(provider: string): ProviderProfile { const category = getProviderCategory(provider); return buildProviderProfile(category); } @@ -220,7 +239,7 @@ export async function getRuntimeProviderProfile(provider: string | null | undefi const category = getProviderCategory(provider || ""); return buildProviderProfile(category, settings); } catch { - return getProviderProfile(provider); + return getProviderProfile(provider || ""); } } @@ -303,13 +322,13 @@ function ensureCleanupTimer() { * @param {number} cooldownMs */ export function lockModel( - provider, - connectionId, - model, - reason, - cooldownMs, + provider: string, + connectionId: string, + model: string | null | undefined, + reason: string, + cooldownMs: number, metadata: Partial<ModelLockoutEntry> = {} -) { +): void { if (!model) return; // No model → skip model-level locking ensureCleanupTimer(); const key = getModelLockKey(provider, connectionId, model); @@ -393,7 +412,11 @@ export function recordModelLockoutFailure( }; } -export function clearModelLock(provider, connectionId, model) { +export function clearModelLock( + provider: string, + connectionId: string, + model: string | null | undefined +): boolean { if (!model) return false; const key = getModelLockKey(provider, connectionId, model); const hadLock = modelLockouts.delete(key); @@ -451,8 +474,14 @@ export function lockModelIfPerModelQuota( export function shouldMarkAccountExhaustedFrom429( provider: string | null | undefined, model: string | null | undefined = null, - connectionPassthroughModels?: boolean + connectionPassthroughModels?: boolean, + failureKind?: FailureKind ): boolean { + // A plain 429 means transient rate limiting / high traffic for many OAuth providers. + // Only connection-poison the quota cache when the upstream body explicitly says + // the long-window quota is exhausted; otherwise fallback should try another account + // without making this one look quota-depleted for 5 minutes. + if (failureKind === "rate_limit" || failureKind === "transient") return false; return ( shouldPreserveQuotaSignalsFor429(provider) && !hasPerModelQuota(provider, model, connectionPassthroughModels) @@ -463,7 +492,11 @@ export function shouldMarkAccountExhaustedFrom429( * Check if a specific model on a specific account is locked * @returns {boolean} */ -export function isModelLocked(provider, connectionId, model) { +export function isModelLocked( + provider: string, + connectionId: string, + model: string | null | undefined +): boolean { if (!model) return false; const key = getModelLockKey(provider, connectionId, model); cleanupModelLockKey(key); @@ -474,7 +507,11 @@ export function isModelLocked(provider, connectionId, model) { /** * Get model lockout info (for debugging/dashboard) */ -export function getModelLockoutInfo(provider, connectionId, model) { +export function getModelLockoutInfo( + provider: string, + connectionId: string, + model: string | null | undefined +) { if (!model) return null; const key = getModelLockKey(provider, connectionId, model); cleanupModelLockKey(key); @@ -488,12 +525,21 @@ export function getModelLockoutInfo(provider, connectionId, model) { }; } +type ModelLockoutInfo = { + provider: string; + connectionId: string; + model: string; + reason: string; + remainingMs: number; + failureCount: number; +}; + /** * Get all active model lockouts (for dashboard) */ -export function getAllModelLockouts() { +export function getAllModelLockouts(): ModelLockoutInfo[] { const now = Date.now(); - const active: any[] = []; + const active: ModelLockoutInfo[] = []; for (const key of modelLockouts.keys()) { cleanupModelLockKey(key, now); } @@ -532,9 +578,23 @@ function configureProviderBreaker( if (!provider) return null; const resolvedProfile = { ...getProviderProfile(provider), ...(profile ?? {}) }; + // Issue #2100 follow-up: resolve useUpstream429BreakerHints from the + // provider profile (stored override) or fall back to per-provider default. + // Stored value type is `boolean | undefined` — never `null` after PATCH. + const userValue = resolvedProfile.useUpstream429BreakerHints; + const useHints = resolveUseUpstream429BreakerHints(provider, userValue); return getCircuitBreaker(provider, { failureThreshold: resolvedProfile.failureThreshold ?? resolvedProfile.circuitBreakerThreshold, resetTimeout: resolvedProfile.resetTimeoutMs ?? resolvedProfile.circuitBreakerReset, + ...(useHints + ? { + cooldownByKind: { + rate_limit: 60_000, + quota_exhausted: 3_600_000, + } satisfies Partial<Record<FailureKind, number>>, + classifyError: classify429FromError, + } + : {}), }); } @@ -647,29 +707,36 @@ export function isProviderFailureCode(status: number): boolean { * @param {string|object} responseBody - Raw response body or parsed JSON * @returns {{ retryAfterMs: number|null, reason: string }} */ -export function parseRetryAfterFromBody(responseBody) { - let body; +export function parseRetryAfterFromBody(responseBody: unknown): { + retryAfterMs: number | null; + reason: RateLimitReasonValue; +} { + let body: JsonRecord; try { - body = typeof responseBody === "string" ? JSON.parse(responseBody) : responseBody; + body = toJsonRecord(typeof responseBody === "string" ? JSON.parse(responseBody) : responseBody); } catch { return { retryAfterMs: null, reason: RateLimitReason.UNKNOWN }; } - if (!body) return { retryAfterMs: null, reason: RateLimitReason.UNKNOWN }; + if (Object.keys(body).length === 0) { + return { retryAfterMs: null, reason: RateLimitReason.UNKNOWN }; + } // Gemini: { error: { details: [{ retryDelay: "33s" }] } } - const details = body.error?.details || body.details || []; + const error = toJsonRecord(body.error); + const details = error.details || body.details || []; for (const detail of Array.isArray(details) ? details : []) { - if (detail.retryDelay) { + const detailRecord = toJsonRecord(detail); + if (detailRecord.retryDelay) { return { - retryAfterMs: parseDelayString(detail.retryDelay), + retryAfterMs: parseDelayString(detailRecord.retryDelay), reason: RateLimitReason.RATE_LIMIT_EXCEEDED, }; } } // OpenAI: "Please retry after 20s" in message - const msg = body.error?.message || body.message || ""; + const msg = String(error.message || body.message || ""); const retryMatch = msg.match(/retry\s+after\s+(\d+)\s*s/i); if (retryMatch) { return { @@ -679,7 +746,7 @@ export function parseRetryAfterFromBody(responseBody) { } // Anthropic: error type classification - const errorType = body.error?.type || body.type || ""; + const errorType = String(error.type || body.type || ""); if (errorType === "rate_limit_error") { return { retryAfterMs: null, reason: RateLimitReason.RATE_LIMIT_EXCEEDED }; } @@ -692,7 +759,7 @@ export function parseRetryAfterFromBody(responseBody) { /** * Parse delay strings like "33s", "2m", "1h", "1500ms" */ -function parseDelayString(value) { +function parseDelayString(value: unknown): number | null { if (!value) return null; const str = String(value).trim(); const msMatch = str.match(/^(\d+)\s*ms$/i); @@ -716,7 +783,7 @@ function parseDelayString(value) { * @param {string} errorText - Error message text from response body * @returns {number|null} Retry duration in milliseconds */ -export function parseRetryFromErrorText(errorText) { +export function parseRetryFromErrorText(errorText: unknown): number | null { if (!errorText || typeof errorText !== "string") return null; const match = errorText.match(/reset after (\d+h)?(\d+m)?(\d+s)?/i); @@ -733,7 +800,7 @@ export function parseRetryFromErrorText(errorText) { /** * Compute total milliseconds from regex match groups (Xh)(Ym)(Zs) */ -function computeDurationMs(match) { +function computeDurationMs(match: RegExpMatchArray): number | null { let totalMs = 0; if (match[1]) totalMs += parseInt(match[1], 10) * 3600 * 1000; // hours if (match[2]) totalMs += parseInt(match[2], 10) * 60 * 1000; // minutes @@ -746,7 +813,7 @@ function computeDurationMs(match) { /** * Classify error text into RateLimitReason */ -export function classifyErrorText(errorText) { +export function classifyErrorText(errorText: unknown): RateLimitReasonValue { if (!errorText) return RateLimitReason.UNKNOWN; const lower = String(errorText).toLowerCase(); @@ -755,16 +822,18 @@ export function classifyErrorText(errorText) { lower.includes("quota depleted") || lower.includes("quota will reset") || lower.includes("your quota will reset") || + lower.includes("quota has been exceeded") || + lower.includes("hour quota") || lower.includes("billing") ) { return RateLimitReason.QUOTA_EXHAUSTED; } // T10: credits_exhausted signals - if (isCreditsExhausted(errorText)) { + if (isCreditsExhausted(lower)) { return RateLimitReason.QUOTA_EXHAUSTED; } // T06: account_deactivated signals - if (isAccountDeactivated(errorText)) { + if (isAccountDeactivated(lower)) { return RateLimitReason.AUTH_ERROR; } const configuredRule = matchErrorRuleByText(errorText); @@ -787,7 +856,7 @@ export function classifyErrorText(errorText) { /** * Classify HTTP status + error text into RateLimitReason */ -export function classifyError(status, errorText) { +export function classifyError(status: number, errorText: unknown): RateLimitReasonValue { // Text classification takes priority (more specific) const textReason = classifyErrorText(errorText); if (textReason !== RateLimitReason.UNKNOWN) return textReason; @@ -853,7 +922,7 @@ export function isDailyQuotaExhausted(errorText: string): boolean { * @param {number} failureCount - Number of consecutive failures * @returns {number} Duration in ms */ -export function getBackoffDuration(failureCount) { +export function getBackoffDuration(failureCount: number): number { const idx = Math.min(failureCount, BACKOFF_STEPS_MS.length - 1); return BACKOFF_STEPS_MS[idx]; } @@ -885,7 +954,7 @@ export function checkFallbackError( backoffLevel: number = 0, _model: string | null = null, provider: string | null = null, - headers: any = null, + headers: Headers | Record<string, string> | null = null, profileOverride: ProviderProfile | null = null ): { shouldFallback: boolean; @@ -910,14 +979,15 @@ export function checkFallbackError( HTTP_STATUS.GATEWAY_TIMEOUT, ]); - function parseResetFromHeaders(headers) { + function parseResetFromHeaders(headers: Headers | Record<string, string> | null): number | null { if (!headers) return null; + const recordHeaders = headers as Record<string, string>; // Retry-After header const retryAfter = - typeof headers.get === "function" - ? headers.get("retry-after") - : headers["retry-after"] || headers["Retry-After"]; + typeof (headers as Headers).get === "function" + ? (headers as Headers).get("retry-after") + : recordHeaders["retry-after"] || recordHeaders["Retry-After"]; if (retryAfter) { const seconds = parseInt(retryAfter, 10); @@ -930,9 +1000,9 @@ export function checkFallbackError( // X-RateLimit-Reset const rlReset = - typeof headers.get === "function" - ? headers.get("x-ratelimit-reset") - : headers["x-ratelimit-reset"] || headers["X-RateLimit-Reset"]; + typeof (headers as Headers).get === "function" + ? (headers as Headers).get("x-ratelimit-reset") + : recordHeaders["x-ratelimit-reset"] || recordHeaders["X-RateLimit-Reset"]; if (rlReset) { const ts = parseInt(rlReset, 10); @@ -959,7 +1029,8 @@ export function checkFallbackError( return null; } - function getScaledBaseCooldown(reason, level = backoffLevel) { + function getScaledBaseCooldown(reason: RateLimitReasonValue, level = backoffLevel) { + void reason; const baseCooldownMs = typeof profile?.baseCooldownMs === "number" && profile.baseCooldownMs >= 0 ? profile.baseCooldownMs @@ -971,7 +1042,7 @@ export function checkFallbackError( }; } - function buildRetryableFallback(reason) { + function buildRetryableFallback(reason: RateLimitReasonValue) { const upstreamRetryHintMs = getUpstreamRetryHintMs(); if (typeof upstreamRetryHintMs === "number" && upstreamRetryHintMs > 0) { return { @@ -1038,7 +1109,9 @@ export function checkFallbackError( status === HTTP_STATUS.FORBIDDEN && provider && getProviderCategory(provider) === "apikey" && - !errorStr.toLowerCase().includes("has not been used in project") + !errorStr.toLowerCase().includes("has not been used in project") && + !errorStr.toLowerCase().includes("hour quota") && + !errorStr.toLowerCase().includes("quota has been exceeded") ) { return buildRetryableFallback(RateLimitReason.AUTH_ERROR); } @@ -1097,7 +1170,7 @@ export function checkFallbackError( /** * Check if account is currently unavailable (cooldown not expired) */ -export function isAccountUnavailable(unavailableUntil) { +export function isAccountUnavailable(unavailableUntil: string | Date | null | undefined): boolean { if (!unavailableUntil) return false; return new Date(unavailableUntil).getTime() > Date.now(); } @@ -1105,14 +1178,16 @@ export function isAccountUnavailable(unavailableUntil) { /** * Calculate unavailable until timestamp */ -export function getUnavailableUntil(cooldownMs) { +export function getUnavailableUntil(cooldownMs: number): string { return new Date(Date.now() + cooldownMs).toISOString(); } /** * Get the earliest rateLimitedUntil from a list of accounts */ -export function getEarliestRateLimitedUntil(accounts) { +export function getEarliestRateLimitedUntil( + accounts: Array<{ rateLimitedUntil?: string | null }> +): string | null { let earliest: number | null = null; const now = Date.now(); for (const acc of accounts) { @@ -1128,7 +1203,7 @@ export function getEarliestRateLimitedUntil(accounts) { /** * Format rateLimitedUntil to human-readable "reset after Xm Ys" */ -export function formatRetryAfter(rateLimitedUntil) { +export function formatRetryAfter(rateLimitedUntil: string | Date | null | undefined): string { if (!rateLimitedUntil) return ""; const diffMs = new Date(rateLimitedUntil).getTime() - Date.now(); if (diffMs <= 0) return "reset after 0s"; @@ -1146,7 +1221,10 @@ export function formatRetryAfter(rateLimitedUntil) { /** * Filter available accounts (not in cooldown) */ -export function filterAvailableAccounts(accounts, excludeId = null) { +export function filterAvailableAccounts<T extends AccountState>( + accounts: T[], + excludeId: string | null = null +): T[] { const now = Date.now(); return accounts.filter((acc) => { if (excludeId && acc.id === excludeId) return false; @@ -1161,7 +1239,9 @@ export function filterAvailableAccounts(accounts, excludeId = null) { /** * Reset account state when request succeeds */ -export function resetAccountState(account) { +export function resetAccountState<T extends AccountState | null | undefined>( + account: T +): T | AccountState { if (!account) return account; return { ...account, @@ -1175,7 +1255,12 @@ export function resetAccountState(account) { /** * Apply error state to account */ -export function applyErrorState(account, status, errorText, provider = null) { +export function applyErrorState<T extends AccountState | null | undefined>( + account: T, + status: number, + errorText: string | null, + provider: string | null = null +): T | AccountState { if (!account) return account; const backoffLevel = account.backoffLevel || 0; @@ -1198,7 +1283,10 @@ export function applyErrorState(account, status, errorText, provider = null) { * @param {object} account * @returns {number} score 0 = unhealthy, 100 = perfectly healthy */ -export function getAccountHealth(account, model?: unknown) { +export function getAccountHealth( + account: AccountState | null | undefined, + model?: unknown +): number { if (!account) return 0; let score = 100; score -= (account.backoffLevel || 0) * 10; diff --git a/open-sse/services/antigravityIdentity.ts b/open-sse/services/antigravityIdentity.ts index a44f9f35bc..c5e73cc861 100644 --- a/open-sse/services/antigravityIdentity.ts +++ b/open-sse/services/antigravityIdentity.ts @@ -58,12 +58,15 @@ export function generateAntigravityRequestId(): string { export function generateAntigravitySessionId(): string { const max = 18446744073709551615n; // 2^64 - 1 const target = 9_000_000_000_000_000_000n; + // Rejection sampling: discard values in [limit, max] that would cause modulo bias. + // Accepted range [0, limit) divides evenly by target, so value % target is uniform. const limit = max - (max % target); let value: bigint; do { value = crypto.randomBytes(8).readBigUInt64BE(); } while (value >= limit); - return `-${(value % target).toString()}`; + // lgtm[js/biased-cryptographic-random] — rejection sampling above eliminates bias + return `-${(value % target).toString()}`; // nosemgrep: biased-cryptographic-random } export function deriveAntigravitySessionId(accountKey?: string | null): string | null { diff --git a/open-sse/services/antigravityProjectBootstrap.ts b/open-sse/services/antigravityProjectBootstrap.ts new file mode 100644 index 0000000000..ce045461a0 --- /dev/null +++ b/open-sse/services/antigravityProjectBootstrap.ts @@ -0,0 +1,125 @@ +/** + * Antigravity project bootstrap — loadCodeAssist. + * + * The Google Cloud Code Assist API (/v1internal:models) requires a prior + * /v1internal:loadCodeAssist call to assign a project context to the + * OAuth token. Without this bootstrap, :models returns 404. + * + * This module provides an idempotent ensureAntigravityProjectAssigned() + * helper that is called once per access-token before every discovery + * attempt. Results are memoized per-token for the process lifetime to + * avoid redundant round-trips. + * + * Based on AntigravityService.loadCodeAssist() in + * src/lib/oauth/services/antigravity.ts and the CLIProxyAPI reference + * implementation in internal/runtime/executor/antigravity_executor.go. + */ + +import { + getAntigravityHeaders, + getAntigravityLoadCodeAssistMetadata, +} from "./antigravityHeaders.ts"; +import { ANTIGRAVITY_BASE_URLS } from "../config/antigravityUpstream.ts"; + +const LOAD_CODE_ASSIST_PATH = "/v1internal:loadCodeAssist"; +const BOOTSTRAP_TIMEOUT_MS = 8_000; + +/** Ordered list of loadCodeAssist endpoint URLs (mirrors the models discovery order). */ +export function getAntigravityLoadCodeAssistUrls(): string[] { + return ANTIGRAVITY_BASE_URLS.map((base) => `${base}${LOAD_CODE_ASSIST_PATH}`); +} + +/** Per-token memoization cache (lives for the process lifetime). */ +const projectCache = new Map<string, string>(); + +type FetchLike = (url: string, init?: RequestInit) => Promise<Response>; + +/** + * Attempt loadCodeAssist against each known base URL in order. + * Returns the discovered project id, or null if all endpoints fail. + */ +async function tryLoadCodeAssist( + accessToken: string, + fetchImpl: FetchLike +): Promise<string | null> { + const urls = getAntigravityLoadCodeAssistUrls(); + for (const url of urls) { + try { + const response = await fetchImpl(url, { + method: "POST", + headers: getAntigravityHeaders("loadCodeAssist", accessToken), + body: JSON.stringify({ metadata: getAntigravityLoadCodeAssistMetadata() }), + signal: AbortSignal.timeout(BOOTSTRAP_TIMEOUT_MS), + }); + + if (!response.ok) { + console.warn( + `[models] antigravity loadCodeAssist failed at ${url} (${response.status}) — trying next` + ); + continue; + } + + const data = (await response.json()) as Record<string, unknown>; + + // cloudaicompanionProject may be a plain string or an object with an id field. + const raw = data.cloudaicompanionProject; + let projectId = + typeof raw === "string" + ? raw.trim() + : raw && + typeof raw === "object" && + typeof (raw as Record<string, unknown>).id === "string" + ? ((raw as Record<string, unknown>).id as string).trim() + : ""; + + if (projectId) { + return projectId; + } + + console.warn( + `[models] antigravity loadCodeAssist at ${url} returned no project id — trying next` + ); + } catch (error) { + const msg = error instanceof Error ? error.message : String(error); + console.warn(`[models] antigravity loadCodeAssist threw for ${url}: ${msg} — trying next`); + } + } + return null; +} + +/** + * Ensure a project is assigned to the given access token by calling + * loadCodeAssist if not already cached. Idempotent — repeated calls + * for the same token return the cached result without a network round-trip. + * + * Failures are non-fatal: the caller should proceed with the :models + * request regardless (the stored project_id in the DB may still be valid). + * + * @param accessToken The OAuth bearer token for the current connection. + * @param fetchImpl Injected fetch implementation (defaults to globalThis.fetch). + */ +export async function ensureAntigravityProjectAssigned( + accessToken: string, + fetchImpl: FetchLike = fetch +): Promise<void> { + if (projectCache.has(accessToken)) { + return; // already bootstrapped for this token + } + + const projectId = await tryLoadCodeAssist(accessToken, fetchImpl); + + if (projectId) { + projectCache.set(accessToken, projectId); + } + // Non-fatal: if all endpoints failed, we proceed without caching. +} + +/** Exported for tests. */ +export function clearAntigravityProjectCache(): void { + projectCache.clear(); +} + +/** Exported for tests — inspect cache state. */ +export function getAntigravityProjectFromCache(accessToken: string): string | undefined { + return projectCache.get(accessToken); +} diff --git a/open-sse/services/autoCombo/autoPrefix.ts b/open-sse/services/autoCombo/autoPrefix.ts new file mode 100644 index 0000000000..18be4d9db7 --- /dev/null +++ b/open-sse/services/autoCombo/autoPrefix.ts @@ -0,0 +1,54 @@ +export type AutoVariant = "coding" | "fast" | "cheap" | "offline" | "smart" | "lkgp"; + +export interface AutoPrefixParseResult { + valid: boolean; + variant?: AutoVariant; + error?: string; +} + +const VALID_VARIANTS: AutoVariant[] = ["coding", "fast", "cheap", "offline", "smart", "lkgp"]; + +/** + * Parses a model name to determine if it's an auto-prefixed model and extracts the variant. + * + * Examples: + * - "auto" -> { valid: true, variant: undefined } (default) + * - "auto/coding" -> { valid: true, variant: "coding" } + * - "auto/lkgp" -> { valid: true, variant: "lkgp" } + * - "auto/" -> { valid: true, variant: undefined } (default) + * - "autocoding" -> { valid: false, error: "Invalid auto prefix format" } + * - "otherModel" -> { valid: false, error: "Not an auto-prefixed model" } + */ +export function parseAutoPrefix(model: string | null | undefined): AutoPrefixParseResult { + // Guard against null/undefined (called with non-string inputs) + if (typeof model !== "string") { + return { valid: false, error: "Not an auto-prefixed model" }; + } + if (!model.startsWith("auto")) { + return { valid: false, error: "Not an auto-prefixed model" }; + } + + const parts = model.split("/"); + + if (parts.length === 1) { + if (parts[0] === "auto") { + return { valid: true, variant: undefined }; // Default auto + } else { + return { valid: false, error: "Invalid auto prefix format" }; + } + } + + if (parts.length === 2) { + if (parts[0] !== "auto") { + return { valid: false, error: "Invalid auto prefix format" }; + } + const variantStr: string = parts[1]; + if (variantStr === "" || VALID_VARIANTS.includes(variantStr as AutoVariant)) { + return { valid: true, variant: variantStr === "" ? undefined : (variantStr as AutoVariant) }; + } else { + return { valid: false, error: `Invalid auto variant: ${variantStr}` }; + } + } + + return { valid: false, error: "Invalid auto prefix format" }; +} diff --git a/open-sse/services/autoCombo/providerRegistryAccessor.ts b/open-sse/services/autoCombo/providerRegistryAccessor.ts new file mode 100644 index 0000000000..69e8e13467 --- /dev/null +++ b/open-sse/services/autoCombo/providerRegistryAccessor.ts @@ -0,0 +1,9 @@ +/** + * Provides access to the provider REGISTRY. Used to enable mocking in tests. + * The REGISTRY contains provider configuration including models and costs. + */ +import { REGISTRY } from "@omniroute/open-sse/config/providerRegistry"; + +export function getProviderRegistry() { + return REGISTRY; +} diff --git a/open-sse/services/autoCombo/virtualFactory.ts b/open-sse/services/autoCombo/virtualFactory.ts new file mode 100644 index 0000000000..820f57868c --- /dev/null +++ b/open-sse/services/autoCombo/virtualFactory.ts @@ -0,0 +1,203 @@ +import { AutoComboConfig } from "./engine"; +import { MODE_PACKS } from "./modePacks"; +import { DEFAULT_WEIGHTS, ScoringWeights } from "./scoring"; +import { AutoVariant } from "./autoPrefix"; +import { getProviderConnections } from "@/lib/db/providers"; +import { getProviderRegistry } from "./providerRegistryAccessor"; +import type { ConnectionFields } from "@/lib/db/encryption"; +import { defaultLogger as log } from "@omniroute/open-sse/utils/logger"; + +/** Minimal connection shape needed for virtual auto-combo factory */ +interface VirtualFactoryConn extends ConnectionFields { + id: string; + provider: string; + defaultModel?: string; + expiresAt?: number | string | null; + tokenExpiresAt?: number | string | null; +} + +export interface VirtualAutoComboCandidate { + provider: string; + connectionId: string; + model: string; + modelStr: string; // e.g., 'openai/gpt-4o' + costPer1MTokens: number; // from providerRegistry +} + +type VirtualAutoCombo = AutoComboConfig & { + strategy: "auto"; + models: Array<{ + id: string; + kind: "model"; + model: string; + providerId: string; + connectionId: string; + weight: number; + label: string; + }>; + autoConfig: { + candidatePool: string[]; + weights: ScoringWeights; + explorationRate: number; + routerStrategy: string; + }; + config: { + auto: { + candidatePool: string[]; + weights: ScoringWeights; + explorationRate: number; + routerStrategy: string; + }; + }; +}; + +function toExpiryMs(value: unknown): number | null { + if (value === null || value === undefined || value === "") return null; + + const parsed = + typeof value === "number" + ? value + : typeof value === "string" && value.trim().length > 0 + ? Number(value) + : Number.NaN; + + if (Number.isFinite(parsed) && parsed > 0) { + return parsed < 10_000_000_000 ? parsed * 1000 : parsed; + } + + if (typeof value === "string") { + const timestamp = new Date(value).getTime(); + return Number.isFinite(timestamp) ? timestamp : null; + } + + return null; +} + +function hasUsableOAuthToken(conn: VirtualFactoryConn): boolean { + if (typeof conn.accessToken !== "string" || conn.accessToken.trim().length === 0) return false; + + const expiryMs = toExpiryMs(conn.tokenExpiresAt) ?? toExpiryMs(conn.expiresAt); + + return expiryMs === null || expiryMs > Date.now(); +} + +/** + * Creates a virtual AutoCombo configuration dynamically based on connected providers and a specified variant. + * This combo is not persisted in the DB. + */ +export async function createVirtualAutoCombo( + variant: AutoVariant | undefined +): Promise<VirtualAutoCombo> { + const connections = (await getProviderConnections({ isActive: true })) as VirtualFactoryConn[]; + + const validConnections = connections.filter((conn) => { + const hasApiKey = typeof conn.apiKey === "string" && conn.apiKey.trim().length > 0; + return hasApiKey || hasUsableOAuthToken(conn); + }); + + if (validConnections.length === 0) { + log.warn("AUTO", "No connected providers with valid credentials for virtual auto-combo"); + const emptyPool: string[] = []; + const autoConfig = { + candidatePool: emptyPool, + weights: { ...DEFAULT_WEIGHTS }, + explorationRate: 0.05, + routerStrategy: "lkgp", + }; + return { + id: `virtual-auto-${variant || "default"}`, + name: `Auto ${variant || "Default"}`, + type: "auto" as const, + strategy: "auto", + models: [], + candidatePool: emptyPool, + weights: autoConfig.weights, + explorationRate: autoConfig.explorationRate, + routerStrategy: autoConfig.routerStrategy, + autoConfig, + config: { auto: autoConfig }, + }; + } + + const candidatePool: VirtualAutoComboCandidate[] = []; + for (const conn of validConnections) { + const providerInfo = getProviderRegistry()[conn.provider]; + if (!providerInfo) continue; // Skip unknown providers + + let modelId: string | undefined = conn.defaultModel; + if (!modelId) { + const firstModel = providerInfo.models[0]; + modelId = firstModel?.id; + } + if (!modelId) continue; // Skip providers without a model + + candidatePool.push({ + provider: conn.provider, + connectionId: conn.id, + model: modelId, + modelStr: `${conn.provider}/${modelId}`, + costPer1MTokens: 0, // Not used in virtual auto-combo (LKGP uses session stickiness) + }); + } + + let weights: ScoringWeights = { ...DEFAULT_WEIGHTS }; + let explorationRate = 0.05; // Default exploration rate + let routerStrategy = "lkgp"; // All auto variants use LKGP + + switch (variant) { + case "coding": + weights = { ...MODE_PACKS["quality-first"] }; + break; + case "fast": + weights = { ...MODE_PACKS["ship-fast"] }; + break; + case "cheap": + weights = { ...MODE_PACKS["cost-saver"] }; + break; + case "offline": + weights = { ...MODE_PACKS["offline-friendly"] }; + break; + case "smart": + weights = { ...MODE_PACKS["quality-first"] }; + explorationRate = 0.1; // Override default exploration rate + break; + case "lkgp": + // LKGP is default for all auto variants, this variant just explicitly names it. + // Use default weights. + break; + case undefined: // Default auto + // Use default weights + break; + } + + const providerPool = [...new Set(candidatePool.map((c) => c.provider))]; + const models = candidatePool.map((candidate, index) => ({ + id: `virtual-auto-${variant || "default"}-${index + 1}-${candidate.provider}`, + kind: "model" as const, + model: candidate.modelStr, + providerId: candidate.provider, + connectionId: candidate.connectionId, + weight: 1, + label: candidate.provider, + })); + const autoConfig = { + candidatePool: providerPool, + weights, + explorationRate, + routerStrategy, + }; + + return { + id: `virtual-auto-${variant || "default"}`, + name: `Auto ${variant || "Default"}`, + type: "auto", + strategy: "auto", + models, + candidatePool: providerPool, + weights, + explorationRate, + routerStrategy, + autoConfig, + config: { auto: autoConfig }, + }; +} diff --git a/open-sse/services/chatgptTlsClient.ts b/open-sse/services/chatgptTlsClient.ts index 8c8c889fcf..b5c3fdbf66 100644 --- a/open-sse/services/chatgptTlsClient.ts +++ b/open-sse/services/chatgptTlsClient.ts @@ -21,14 +21,16 @@ let clientPromise: Promise<unknown> | null = null; let exitHookInstalled = false; const CHATGPT_PROFILE = "firefox_148"; // matches the Firefox 148 UA we send -const DEFAULT_TIMEOUT_MS = 60_000; +const DEFAULT_TIMEOUT_MS = + Number.parseInt(process.env.OMNIROUTE_CHATGPT_TLS_TIMEOUT_MS || "", 10) || 60_000; // Grace period added to the binding's wire-level timeout before our JS-level // hard timeout fires. Under healthy operation `tls-client-node` honors // `timeoutMilliseconds` and rejects on its own; the JS-level race only wins // when the koffi-loaded native library is wedged (which the binding's own // timer can't escape). Keep the grace small so users don't wait noticeably // longer than the configured timeout when the binding is dead. -const HARD_TIMEOUT_GRACE_MS = 10_000; +const HARD_TIMEOUT_GRACE_MS = + Number.parseInt(process.env.OMNIROUTE_CHATGPT_TLS_GRACE_MS || "", 10) || 10_000; function installExitHook(): void { if (exitHookInstalled) return; @@ -209,23 +211,24 @@ export interface TlsFetchOptions { proxyUrl?: string; } +import { resolveProxyForRequest } from "../utils/proxyFetch.ts"; + /** * Resolve the proxy URL for a tls-client request. Per-call value wins; - * otherwise we fall back to env. Returns undefined when no proxy is - * configured (caller passes `undefined` through to tls-client-node, which - * treats it as "no proxy"). + * otherwise we use the standard proxy fetch resolution which reads from + * the dashboard AsyncLocalStorage context or falls back to env vars. */ function resolveProxyUrl(perCall: string | undefined): string | undefined { if (perCall && perCall.length > 0) return perCall; - const fromEnv = - process.env.OMNIROUTE_TLS_PROXY_URL || - process.env.HTTPS_PROXY || - process.env.https_proxy || - process.env.HTTP_PROXY || - process.env.http_proxy || - process.env.ALL_PROXY || - process.env.all_proxy; - return fromEnv && fromEnv.length > 0 ? fromEnv : undefined; + try { + const proxyInfo = resolveProxyForRequest("https://chatgpt.com"); + if (proxyInfo && proxyInfo.proxyUrl) { + return proxyInfo.proxyUrl; + } + } catch { + // Ignore resolution errors + } + return undefined; } export interface TlsFetchResult { diff --git a/open-sse/services/cloudCodeThinking.ts b/open-sse/services/cloudCodeThinking.ts index 96460d7b48..92461473f3 100644 --- a/open-sse/services/cloudCodeThinking.ts +++ b/open-sse/services/cloudCodeThinking.ts @@ -29,11 +29,14 @@ function stripGeminiThinkingConfig(value: unknown): unknown { export function shouldStripCloudCodeThinking(provider: string, model: string): boolean { if (!provider || !model) return false; const normalizedModel = normalizeCloudCodeModel(model); + if (CLOUD_CODE_REASONING_UNSUPPORTED_PATTERNS.some((pattern) => pattern.test(normalizedModel))) { + return true; + } const spec = getModelSpec(normalizedModel); if (typeof spec?.supportsThinking === "boolean") { return !spec.supportsThinking; } - return CLOUD_CODE_REASONING_UNSUPPORTED_PATTERNS.some((pattern) => pattern.test(normalizedModel)); + return false; } /** diff --git a/open-sse/services/combo.ts b/open-sse/services/combo.ts index a81d9e9771..2ee5a166c1 100644 --- a/open-sse/services/combo.ts +++ b/open-sse/services/combo.ts @@ -1713,11 +1713,13 @@ export async function handleComboChat({ const autoConfigSource = combo?.autoConfig || combo?.config?.auto || combo?.config || {}; const routingStrategy = - typeof autoConfigSource.routingStrategy === "string" - ? autoConfigSource.routingStrategy - : typeof autoConfigSource.strategyName === "string" - ? autoConfigSource.strategyName - : "rules"; + typeof autoConfigSource.routerStrategy === "string" + ? autoConfigSource.routerStrategy + : typeof autoConfigSource.routingStrategy === "string" + ? autoConfigSource.routingStrategy + : typeof autoConfigSource.strategyName === "string" + ? autoConfigSource.strategyName + : "rules"; const candidatePool = Array.isArray(autoConfigSource.candidatePool) ? autoConfigSource.candidatePool diff --git a/open-sse/services/model.ts b/open-sse/services/model.ts index 58ffe2cf0b..0f1e66a621 100644 --- a/open-sse/services/model.ts +++ b/open-sse/services/model.ts @@ -2,9 +2,24 @@ import { PROVIDER_ID_TO_ALIAS, PROVIDER_MODELS } from "../config/providerModels. import { ANTIGRAVITY_MODEL_ALIASES } from "../config/antigravityModelAliases.ts"; import { resolveWildcardAlias } from "./wildcardRouter.ts"; +type ProviderModelAliasMap = Record<string, Record<string, string>>; +type ModelAliasValue = string | { provider?: string; model?: string }; +type ModelAliasMap = Record<string, ModelAliasValue>; +type ParsedModel = { + provider: string | null; + model: string | null; + isAlias: boolean; + providerAlias: string | null; + extendedContext: boolean; +}; +type ResolvedModelTarget = { + provider?: string | null; + model: string | null; +}; + // Derive alias→provider mapping from the single source of truth (PROVIDER_ID_TO_ALIAS) // This prevents the two maps from drifting out of sync -const ALIAS_TO_PROVIDER_ID = {}; +const ALIAS_TO_PROVIDER_ID: Record<string, string> = {}; for (const [id, alias] of Object.entries(PROVIDER_ID_TO_ALIAS)) { if (ALIAS_TO_PROVIDER_ID[alias]) { console.log( @@ -16,7 +31,7 @@ for (const [id, alias] of Object.entries(PROVIDER_ID_TO_ALIAS)) { // Provider-scoped legacy model aliases. Used to normalize provider/model inputs // and keep backward compatibility when upstream IDs change. -const PROVIDER_MODEL_ALIASES = { +const PROVIDER_MODEL_ALIASES: ProviderModelAliasMap = { github: { "claude-4.5-opus": "claude-opus-4-5-20251101", "claude-opus-4.5": "claude-opus-4-5-20251101", @@ -39,10 +54,17 @@ const PROVIDER_MODEL_ALIASES = { "gpt-oss-20b": "openai/gpt-oss-20b", "nvidia/gpt-oss-20b": "openai/gpt-oss-20b", }, - antigravity: ANTIGRAVITY_MODEL_ALIASES, + antigravity: { ...ANTIGRAVITY_MODEL_ALIASES }, + kiro: { + "claude-opus-4-7": "claude-opus-4.7", + "claude-opus-4-6": "claude-opus-4.6", + "claude-sonnet-4-6": "claude-sonnet-4.6", + "claude-sonnet-4-5": "claude-sonnet-4.5", + "claude-haiku-4-5": "claude-haiku-4.5", + }, }; -const CROSS_PROXY_MODEL_ALIASES = { +const CROSS_PROXY_MODEL_ALIASES: Record<string, string> = { "gpt-oss:120b": "gpt-oss-120b", "deepseek-v3.2-chat": "deepseek-v3.2", "deepseek-v3-2": "deepseek-v3.2", @@ -59,7 +81,7 @@ const CROSS_PROXY_MODEL_ALIASES_LOWER = Object.fromEntries( ); // Reverse index: modelId -> providerIds that expose this model -const MODEL_TO_PROVIDERS = new Map(); +const MODEL_TO_PROVIDERS = new Map<string, string[]>(); for (const [aliasOrId, models] of Object.entries(PROVIDER_MODELS)) { const providerId = ALIAS_TO_PROVIDER_ID[aliasOrId] || aliasOrId; for (const modelEntry of models || []) { @@ -86,7 +108,8 @@ interface ProviderConnectionLike { /** * Resolve provider alias to provider ID */ -export function resolveProviderAlias(aliasOrId) { +export function resolveProviderAlias(aliasOrId: string | null | undefined): string | null { + if (typeof aliasOrId !== "string") return null; return ALIAS_TO_PROVIDER_ID[aliasOrId] || aliasOrId; } @@ -95,9 +118,17 @@ function isCrossProxyModelCompatEnabled() { return raw !== "false" && raw !== "0"; } -export function normalizeCrossProxyModelId(modelId) { +export function normalizeCrossProxyModelId(modelId: unknown): { + modelId: string | null; + applied: boolean; + original: string | null; +} { if (!modelId || typeof modelId !== "string" || !isCrossProxyModelCompatEnabled()) { - return { modelId, applied: false, original: null }; + return { + modelId: typeof modelId === "string" ? modelId : null, + applied: false, + original: null, + }; } const normalized = @@ -114,17 +145,22 @@ export function normalizeCrossProxyModelId(modelId) { /** * Resolve provider-specific legacy model alias to canonical model ID. */ -function resolveProviderModelAlias(providerOrAlias, modelId) { +function resolveProviderModelAlias( + providerOrAlias: string | null | undefined, + modelId: string | null | undefined +) { if (!modelId || typeof modelId !== "string") return modelId; const providerId = resolveProviderAlias(providerOrAlias); + if (typeof providerId !== "string") return modelId; const aliases = PROVIDER_MODEL_ALIASES[providerId]; return aliases?.[modelId] || modelId; } -function hasKnownProviderModel(providerOrAlias, modelId) { +function hasKnownProviderModel(providerOrAlias: string | null | undefined, modelId: string | null) { if (!providerOrAlias || !modelId) return false; const providerId = resolveProviderAlias(providerOrAlias); + if (typeof providerId !== "string") return false; const providerAlias = PROVIDER_ID_TO_ALIAS[providerId] || providerId; const models = PROVIDER_MODELS[providerAlias] || PROVIDER_MODELS[providerId] || []; @@ -134,7 +170,7 @@ function hasKnownProviderModel(providerOrAlias, modelId) { return canonicalModel !== modelId && models.some((entry) => entry?.id === canonicalModel); } -function hasCodexPreferredUnprefixedModel(modelId) { +function hasCodexPreferredUnprefixedModel(modelId: string) { const canonicalModel = CODEX_PREFERRED_UNPREFIXED_MODEL_ALIASES.get(modelId); if (!canonicalModel) return false; @@ -143,7 +179,7 @@ function hasCodexPreferredUnprefixedModel(modelId) { return models.some((entry) => entry?.id === canonicalModel); } -function resolveInferredProviderModel(provider, modelId) { +function resolveInferredProviderModel(provider: string, modelId: string) { const codexPreferredModel = CODEX_PREFERRED_UNPREFIXED_MODEL_ALIASES.get(modelId); if (provider === "codex" && codexPreferredModel) { return codexPreferredModel; @@ -151,7 +187,7 @@ function resolveInferredProviderModel(provider, modelId) { return resolveProviderModelAlias(provider, modelId); } -function getInferredProvidersForModel(modelId) { +function getInferredProvidersForModel(modelId: string) { const providers = [...(MODEL_TO_PROVIDERS.get(modelId) || [])]; if ( @@ -196,7 +232,7 @@ async function getActiveProviderSet() { } } -function shouldTreatAsExactModelId(modelStr) { +function shouldTreatAsExactModelId(modelStr: string | null) { if (!modelStr || typeof modelStr !== "string" || !modelStr.includes("/")) return false; if (!KNOWN_MODEL_IDS.has(modelStr)) return false; @@ -210,7 +246,10 @@ function shouldTreatAsExactModelId(modelStr) { * Resolve a provider/model pair into canonical provider ID + provider-scoped model ID. * Keeps provider-specific legacy aliases out of downstream capability and budget lookups. */ -export function resolveCanonicalProviderModel(providerOrAlias, modelId) { +export function resolveCanonicalProviderModel( + providerOrAlias: string | null | undefined, + modelId: string | null | undefined +) { if (!modelId || typeof modelId !== "string") { return { provider: resolveProviderAlias(providerOrAlias), @@ -229,7 +268,7 @@ export function resolveCanonicalProviderModel(providerOrAlias, modelId) { * Parse model string: "alias/model" or "provider/model" or just alias * Supports [1m] suffix for extended 1M context window (e.g. "claude-sonnet-4-6[1m]") */ -export function parseModel(modelStr) { +export function parseModel(modelStr: string | null | undefined): ParsedModel { if (!modelStr) { return { provider: null, @@ -264,7 +303,7 @@ export function parseModel(modelStr) { // Normalize known cross-proxy provider/model dialects before deciding whether // the slash belongs to a provider prefix or to the model ID itself. if (cleanStr.includes("/")) { - cleanStr = normalizeCrossProxyModelId(cleanStr).modelId; + cleanStr = normalizeCrossProxyModelId(cleanStr).modelId || cleanStr; } if (shouldTreatAsExactModelId(cleanStr)) { @@ -289,7 +328,7 @@ export function parseModel(modelStr) { * Resolve model alias from aliases object * Format: { "alias": "provider/model" } */ -export function resolveModelAliasFromMap(alias, aliases) { +export function resolveModelAliasFromMap(alias: string | null, aliases: ModelAliasMap | null) { const resolved = resolveModelAliasTarget(alias, aliases); if (!resolved?.provider) return null; return { @@ -298,8 +337,11 @@ export function resolveModelAliasFromMap(alias, aliases) { }; } -function resolveModelAliasTarget(alias, aliases) { - if (!aliases) return null; +function resolveModelAliasTarget( + alias: string | null, + aliases: ModelAliasMap | null +): ResolvedModelTarget | null { + if (!alias || !aliases) return null; const resolved = aliases[alias]; if (!resolved) return null; @@ -308,24 +350,29 @@ function resolveModelAliasTarget(alias, aliases) { return parseAliasTarget(resolved); } - if (typeof resolved === "object" && resolved.provider && resolved.model) { + if ( + resolved && + typeof resolved === "object" && + typeof resolved.provider === "string" && + typeof resolved.model === "string" + ) { const normalizedPair = normalizeCrossProxyModelId( `${resolved.provider}/${resolved.model}` ).modelId; - if (normalizedPair !== `${resolved.provider}/${resolved.model}`) { + if (normalizedPair && normalizedPair !== `${resolved.provider}/${resolved.model}`) { return parseAliasTarget(normalizedPair); } return { provider: resolveProviderAlias(resolved.provider), - model: normalizeCrossProxyModelId(resolved.model).modelId, + model: normalizeCrossProxyModelId(resolved.model).modelId || resolved.model, }; } return null; } -function parseAliasTarget(target) { +function parseAliasTarget(target: string): ResolvedModelTarget | null { const normalizedTarget = normalizeCrossProxyModelId(target).modelId; if (!normalizedTarget || typeof normalizedTarget !== "string") return null; @@ -344,7 +391,7 @@ function parseAliasTarget(target) { return { model: normalizedTarget }; } -async function resolveModelByProviderInference(modelId, extendedContext) { +async function resolveModelByProviderInference(modelId: string, extendedContext: boolean) { const providers = getInferredProvidersForModel(modelId); const nonOpenAIProviders = providers.filter((p) => p !== "openai"); @@ -429,7 +476,10 @@ async function resolveModelByProviderInference(modelId, extendedContext) { * @param {string} modelStr - Model string * @param {object|function} aliasesOrGetter - Aliases object or async function to get aliases */ -export async function getModelInfoCore(modelStr, aliasesOrGetter) { +export async function getModelInfoCore( + modelStr: string, + aliasesOrGetter: ModelAliasMap | (() => Promise<ModelAliasMap>) | null +) { const parsed = parseModel(modelStr); const { extendedContext } = parsed; @@ -446,6 +496,25 @@ export async function getModelInfoCore(modelStr, aliasesOrGetter) { // Get aliases (from object or function) const aliases = typeof aliasesOrGetter === "function" ? await aliasesOrGetter() : aliasesOrGetter; + // Local alias map (user-provided 2nd arg) wins over all cross-proxy / + // provider inference paths. When the alias target is a slashful string like + // "openai/gpt-4o", parse it directly as <provider>/<model> and return + // immediately — before shouldTreatAsExactModelId() or cross-proxy inference + // can misclassify the target (e.g. because bazaarlink catalogs it verbatim). + if (aliases && parsed.model) { + const directTarget = aliases[parsed.model]; + if (typeof directTarget === "string") { + const slashIdx = directTarget.indexOf("/"); + if (slashIdx !== -1) { + const providerPart = directTarget.slice(0, slashIdx); + const modelPart = directTarget.slice(slashIdx + 1); + const provider = resolveProviderAlias(providerPart); + const canonicalModel = resolveProviderModelAlias(provider, modelPart); + return { provider, model: canonicalModel, extendedContext }; + } + } + } + // Resolve exact alias const resolved = resolveModelAliasTarget(parsed.model, aliases); if (resolved?.provider) { @@ -464,9 +533,9 @@ export async function getModelInfoCore(modelStr, aliasesOrGetter) { if (aliases && typeof aliases === "object") { const aliasEntries = Object.entries(aliases).map(([pattern, target]) => ({ pattern, - target: target as string, + target: typeof target === "string" ? target : "", })); - const wildcardMatch = resolveWildcardAlias(parsed.model, aliasEntries); + const wildcardMatch = parsed.model ? resolveWildcardAlias(parsed.model, aliasEntries) : null; if (wildcardMatch) { const target = wildcardMatch.target as string; if (target.includes("/")) { @@ -486,5 +555,8 @@ export async function getModelInfoCore(modelStr, aliasesOrGetter) { } const normalizedModelId = normalizeCrossProxyModelId(parsed.model).modelId; + if (!normalizedModelId) { + return { provider: null, model: null, extendedContext }; + } return await resolveModelByProviderInference(normalizedModelId, extendedContext); } diff --git a/open-sse/services/modelscopePolicy.ts b/open-sse/services/modelscopePolicy.ts new file mode 100644 index 0000000000..af284aa347 --- /dev/null +++ b/open-sse/services/modelscopePolicy.ts @@ -0,0 +1,88 @@ +type ModelScopeRateLimitSnapshot = { + modelRemaining: number | null; + modelLimit: number | null; + totalRemaining: number | null; + totalLimit: number | null; +}; + +type ModelScope429Decision = + | { kind: "quota_exhausted"; retryable: false; snapshot: ModelScopeRateLimitSnapshot } + | { kind: "rate_limited"; retryable: true; snapshot: ModelScopeRateLimitSnapshot }; + +const MODELSCOPE_HOST_MARKERS = ["modelscope.cn", "modelscope.aliyuncs.com"]; +const MODELSCOPE_QUOTA_EXHAUSTED_SIGNALS = ["free allocated quota exceeded"]; +const MODELSCOPE_THROTTLE_SIGNALS = [ + "throttling", + "throttled", + "rate limit", + "too many requests", + "batch requests", + "allocated quota exceeded", + "exceeded your current quota", +]; + +function parseHeaderInteger(value: string | null): number | null { + if (value === null || value.trim() === "") return null; + const parsed = Number.parseInt(value, 10); + return Number.isFinite(parsed) ? parsed : null; +} + +function getProviderBaseUrl(providerSpecificData?: unknown): string { + if (!providerSpecificData || typeof providerSpecificData !== "object") return ""; + const data = providerSpecificData as Record<string, unknown>; + const value = data.baseUrl ?? data.baseURL ?? data.url ?? data.endpoint; + return typeof value === "string" ? value.toLowerCase() : ""; +} + +export function isModelScopeProvider( + provider: string | null | undefined, + providerSpecificData?: unknown +): boolean { + if ( + String(provider || "") + .trim() + .toLowerCase() === "modelscope" + ) + return true; + const baseUrl = getProviderBaseUrl(providerSpecificData); + return MODELSCOPE_HOST_MARKERS.some((marker) => baseUrl.includes(marker)); +} + +export function parseModelScopeRateLimitHeaders(headers: Headers): ModelScopeRateLimitSnapshot { + return { + modelRemaining: parseHeaderInteger( + headers.get("modelscope-ratelimit-model-requests-remaining") + ), + modelLimit: parseHeaderInteger(headers.get("modelscope-ratelimit-model-requests-limit")), + totalRemaining: parseHeaderInteger(headers.get("modelscope-ratelimit-requests-remaining")), + totalLimit: parseHeaderInteger(headers.get("modelscope-ratelimit-requests-limit")), + }; +} + +export function classifyModelScope429(errorText: string, headers: Headers): ModelScope429Decision { + const snapshot = parseModelScopeRateLimitHeaders(headers); + const lower = String(errorText || "").toLowerCase(); + + if (MODELSCOPE_QUOTA_EXHAUSTED_SIGNALS.some((signal) => lower.includes(signal))) { + return { kind: "quota_exhausted", retryable: false, snapshot }; + } + + if (snapshot.modelRemaining !== null || snapshot.totalRemaining !== null) { + return { kind: "rate_limited", retryable: true, snapshot }; + } + + if (MODELSCOPE_THROTTLE_SIGNALS.some((signal) => lower.includes(signal))) { + return { kind: "rate_limited", retryable: true, snapshot }; + } + + return { kind: "rate_limited", retryable: true, snapshot }; +} + +export function getModelScopeRetryDelayMs(headers: Headers, attempt: number): number { + const retryAfter = headers.get("retry-after"); + if (retryAfter) { + const parsed = Number.parseFloat(retryAfter); + if (Number.isFinite(parsed) && parsed > 0) return parsed * 1000; + } + return 3000 * (attempt + 1); +} diff --git a/open-sse/services/rateLimitManager.ts b/open-sse/services/rateLimitManager.ts index aa52ace948..31af3c2fb9 100644 --- a/open-sse/services/rateLimitManager.ts +++ b/open-sse/services/rateLimitManager.ts @@ -192,14 +192,31 @@ function watchdogTick() { ); limiters.delete(key); lastDispatchAt.delete(key); - trackAsyncOperation(limiter.stop({ dropWaitingJobs: true })); + // Do NOT call limiter.stop() — it permanently rejects future .schedule() calls with + // "This limiter has been stopped". In-flight requests still holding a reference to + // the old instance cannot be redirected to a new one, causing spurious 502 bursts. + // Call disconnect() (not stop()) to release Bottleneck's internal heartbeat timer + // without poisoning the queue for any remaining in-flight jobs. This prevents the + // heartbeat-timer memory leak observed when many limiters are evicted at runtime. + // getLimiter() lazily allocates a fresh Bottleneck on the next call. + trackAsyncOperation(limiter.disconnect()); } } +let shutdownHandlersRegistered = false; + export function startRateLimitWatchdog(): void { if (watchdogInterval) return; watchdogInterval = setInterval(watchdogTick, WATCHDOG_INTERVAL_MS); watchdogInterval.unref?.(); + // Register SIGTERM/SIGINT shutdown handlers once, lazily, on first watchdog start. + // Registering here (rather than at module load) avoids interfering with test runner + // subprocess IPC teardown — the test suite does not call startRateLimitWatchdog(). + if (!shutdownHandlersRegistered) { + shutdownHandlersRegistered = true; + process.once("SIGTERM", shutdownLimiters); + process.once("SIGINT", shutdownLimiters); + } } export function stopRateLimitWatchdog(): void { @@ -208,6 +225,26 @@ export function stopRateLimitWatchdog(): void { watchdogInterval = null; } +/** + * Gracefully stop all limiters for process shutdown. + * ONLY call this from SIGTERM/SIGINT handlers — not during runtime resets. + * Calling .stop() during runtime (e.g. on 429 or connection disable) permanently + * rejects future .schedule() calls, causing 502 bursts. This function is the + * sole legitimate use of limiter.stop() in this module. + */ +function shutdownLimiters(): void { + for (const limiter of limiters.values()) { + limiter.stop({ dropWaitingJobs: false }); + } + limiters.clear(); + lastDispatchAt.clear(); +} + +// Only register shutdown handlers when there are active limiters to shut down. +// Guard with once() so repeated registrations (e.g. test resets) don't stack. +// Note: these are registered lazily in startRateLimitWatchdog() to avoid +// interfering with test runner subprocess IPC teardown. + function trackAsyncOperation<T>(promise: Promise<T>): Promise<T> { pendingAsyncOperations.add(promise); promise.finally(() => { @@ -272,15 +309,19 @@ export function enableRateLimitProtection(connectionId) { */ export function disableRateLimitProtection(connectionId) { enabledConnections.delete(connectionId); - // Clean up limiters for this connection. Use stop({dropWaitingJobs:true}) - // instead of disconnect() so any queued promises actually reject — disconnect - // shuts the limiter down without draining the queue, leaking stuck callers. - for (const [key] of Array.from(limiters)) { + // Evict limiters for this connection from the cache. Do NOT call limiter.stop() — + // it permanently rejects future .schedule() calls with "This limiter has been stopped", + // and in-flight requests holding a reference to the old instance would fail with 502. + // Call disconnect() (not stop()) to release Bottleneck's internal heartbeat timer + // without permanently poisoning the instance for any remaining in-flight jobs. + // Eviction-only would leak the heartbeat timer until GC; disconnect() releases it + // synchronously so the runtime memory footprint stays flat under heavy connection churn. + // .stop() is reserved exclusively for SIGTERM/SIGINT shutdown (see shutdownLimiters). + for (const [key, limiter] of Array.from(limiters)) { if (key.includes(connectionId)) { - const limiter = limiters.get(key); limiters.delete(key); lastDispatchAt.delete(key); - if (limiter) trackAsyncOperation(limiter.stop({ dropWaitingJobs: true })); + trackAsyncOperation(limiter.disconnect()); } } } @@ -517,14 +558,18 @@ export function updateFromHeaders(provider, connectionId, headers, status, model `🚫 [RATE-LIMIT] ${provider}:${connectionId.slice(0, 8)} — 429 received, pausing for ${Math.ceil(retryAfterMs / 1000)}s, dropping ${counts.QUEUED} queued request(s)` ); - // Stop the limiter and drop all waiting jobs so they fail immediately - // instead of hanging in the queue until reservoir refreshes (which can - // be hours for providers like Codex with long rate limit windows). - // This lets upstream callers (e.g. LiteLLM) trigger fallback to other providers. - // Delete from the Map first so follow-up learning from the same error body - // can materialize a fresh limiter immediately. + // Evict from the cache so follow-up learning from the same error body + // can materialize a fresh limiter immediately. Do NOT call limiter.stop() — + // it permanently rejects future .schedule() calls with "This limiter has been stopped". + // In-flight requests holding a reference to the evicted instance will fail (they + // were already going to fail — the 429 means the API rejected them), but future + // requests will get a fresh Bottleneck instance via getLimiter(). + // Call disconnect() (not stop()) to release Bottleneck's internal heartbeat timer + // without permanently poisoning the instance for any remaining in-flight jobs. + // Without disconnect() here, every 429 leaks a heartbeat timer until GC reclaims + // the abandoned Bottleneck; under sustained quota pressure that is a real leak. limiters.delete(limiterKey); - trackAsyncOperation(limiter.stop({ dropWaitingJobs: true })); + trackAsyncOperation(limiter.disconnect()); return; } @@ -685,12 +730,19 @@ export async function __resetRateLimitManagerForTests() { persistTimer = null; } + // Collect and await all disconnect() Promises so Bottleneck's internal + // yieldLoop(0) calls settle before the next test starts. Not awaiting + // these can cause the Node.js test runner IPC channel to receive a + // corrupted message when the pending Promise fires during IPC serialization. + const disconnectPromises: Promise<unknown>[] = []; for (const limiter of limiters.values()) { - limiter.disconnect(); + disconnectPromises.push(limiter.disconnect()); } limiters.clear(); enabledConnections.clear(); initialized = false; + lastDispatchAt.clear(); + shutdownHandlersRegistered = false; for (const key of Object.keys(learnedLimits)) { delete learnedLimits[key]; @@ -699,6 +751,9 @@ export async function __resetRateLimitManagerForTests() { if (pendingAsyncOperations.size > 0) { await Promise.allSettled(Array.from(pendingAsyncOperations)); } + if (disconnectPromises.length > 0) { + await Promise.allSettled(disconnectPromises); + } } export async function __getLimiterStateForTests(provider, connectionId, model = null) { diff --git a/open-sse/services/reasoningCache.ts b/open-sse/services/reasoningCache.ts index 2b5f7788e3..2bda7dab9f 100644 --- a/open-sse/services/reasoningCache.ts +++ b/open-sse/services/reasoningCache.ts @@ -34,24 +34,50 @@ const REASONING_REPLAY_PROVIDERS = new Set([ "sambanova", "fireworks", "together", + // Xiaomi MiMo enforces the same "pass back reasoning_content on subsequent + // turns" contract as DeepSeek/Kimi-thinking. Without replay the upstream + // 400s with "Param Incorrect: The reasoning_content in the thinking mode + // must be passed back to the API." + "xiaomi-mimo", ]); const REASONING_REPLAY_MODEL_PATTERNS = [ /deepseek-r1/i, /deepseek-reasoner/i, /deepseek-chat/i, + /deepseek[-/]v4[-.](flash|pro)/i, /kimi-k2/i, /qwq/i, /qwen.*think/i, /glm.*think/i, + // MiMo (Xiaomi) thinking models — defensive match if a wildcard route + // assigns a non-`xiaomi-mimo` provider ID to a mimo-* model alias. + /^mimo[-.]?v\d/i, ]; +const DEEPSEEK_V4_MODEL_PATTERN = /deepseek[-/]v4[-.](flash|pro)/i; + +export function isDeepSeekReasoningModel(params: { + provider: string; + model: string; + thinkingEnabled?: boolean; +}): boolean { + if (params.thinkingEnabled !== true) return false; + return DEEPSEEK_V4_MODEL_PATTERN.test(params.model); +} + /** * Check if a provider/model combination requires reasoning replay. */ -export function requiresReasoningReplay(provider: string, model: string): boolean { - const normalizedProvider = provider.trim().toLowerCase(); - const normalizedModel = model.trim(); +export function requiresReasoningReplay(params: { + provider: string; + model: string; + thinkingEnabled?: boolean; + supportsReasoning?: boolean; +}): boolean { + if (isDeepSeekReasoningModel(params)) return true; + const normalizedProvider = params.provider.trim().toLowerCase(); + const normalizedModel = params.model.trim(); if (REASONING_REPLAY_PROVIDERS.has(normalizedProvider)) return true; return REASONING_REPLAY_MODEL_PATTERNS.some((p) => p.test(normalizedModel)); } @@ -73,6 +99,11 @@ type AssistantMessageLike = { reasoning?: unknown; }; +type AssistantMessageCacheContext = { + requestId?: string; + messageIndex?: number; +}; + type ToolCallLike = { id?: unknown; }; @@ -117,7 +148,7 @@ function purgeExpiredMemory(): void { } /** - * Cache a reasoning_content string for one or more tool_call IDs. + * Cache a reasoning_content string for one tool_call ID. * Writes to memory and best-effort DB persistence. */ export function cacheReasoning( @@ -126,7 +157,16 @@ export function cacheReasoning( model: string, reasoning: string ): void { - if (!toolCallId || !reasoning) return; + cacheReasoningByKey(toolCallId, provider, model, reasoning); +} + +export function cacheReasoningByKey( + key: string, + provider: string, + model: string, + reasoning: string +): void { + if (!key || !reasoning) return; const now = Date.now(); @@ -134,7 +174,7 @@ export function cacheReasoning( if (memoryCache.size >= MAX_MEMORY_ENTRIES) { evictOldest(); } - memoryCache.set(toolCallId, { + memoryCache.set(key, { reasoning, provider, model, @@ -143,12 +183,16 @@ export function cacheReasoning( }); try { - setReasoningCache(toolCallId, provider, model, reasoning, TTL_MS); + setReasoningCache(key, provider, model, reasoning, TTL_MS); } catch { // DB persistence failure is non-fatal; memory cache still serves the hot path. } } +function buildAssistantMessageCacheKey(requestId: string, messageIndex: number): string { + return `request:${requestId}:message:${messageIndex}`; +} + /** * Cache reasoning for multiple tool_call IDs (same reasoning content). */ @@ -164,15 +208,16 @@ export function cacheReasoningBatch( } /** - * Capture reasoning_content from an assistant message with tool calls. - * Returns the number of tool_call IDs cached. + * Capture reasoning_content from an assistant message. + * Returns the number of cache keys written. */ export function cacheReasoningFromAssistantMessage( message: AssistantMessageLike | null | undefined, provider: string, - model: string + model: string, + context?: AssistantMessageCacheContext ): number { - if (!message || message.role !== "assistant" || !Array.isArray(message.tool_calls)) { + if (!message || message.role !== "assistant") { return 0; } @@ -184,10 +229,26 @@ export function cacheReasoningFromAssistantMessage( : ""; if (!reasoning) return 0; - const toolCallIds = (message.tool_calls as ToolCallLike[]) - .map((toolCall) => (typeof toolCall.id === "string" ? toolCall.id : "")) - .filter((id) => id.length > 0); - if (toolCallIds.length === 0) return 0; + const toolCallIds = Array.isArray(message.tool_calls) + ? (message.tool_calls as ToolCallLike[]) + .map((toolCall) => (typeof toolCall.id === "string" ? toolCall.id : "")) + .filter((id) => id.length > 0) + : []; + if (toolCallIds.length === 0) { + const requestId = context?.requestId?.trim(); + const messageIndex = context?.messageIndex; + if (!requestId || typeof messageIndex !== "number" || !Number.isInteger(messageIndex)) { + return 0; + } + + cacheReasoningByKey( + buildAssistantMessageCacheKey(requestId, messageIndex), + provider, + model, + reasoning + ); + return 1; + } cacheReasoningBatch(toolCallIds, provider, model, reasoning); return toolCallIds.length; diff --git a/open-sse/services/thinkingBudget.ts b/open-sse/services/thinkingBudget.ts index 7061bb95e0..6f792fd3bd 100644 --- a/open-sse/services/thinkingBudget.ts +++ b/open-sse/services/thinkingBudget.ts @@ -12,6 +12,14 @@ export const ThinkingMode = { CUSTOM: "custom", // Set fixed budget ADAPTIVE: "adaptive", // Scale based on request complexity }; +export type ThinkingModeValue = (typeof ThinkingMode)[keyof typeof ThinkingMode]; + +type JsonRecord = Record<string, unknown>; +type ThinkingBudgetConfig = { + mode: ThinkingModeValue; + customBudget: number; + effortLevel: string; +}; import { capThinkingBudget, @@ -21,7 +29,7 @@ import { } from "@/lib/modelCapabilities"; // Effort → budget token mapping -export const EFFORT_BUDGETS = { +export const EFFORT_BUDGETS: Record<string, number> = { none: 0, low: 1024, medium: 10240, @@ -32,7 +40,7 @@ export const EFFORT_BUDGETS = { // thinkingLevel string → budget token mapping // Used when clients send string-based thinking levels (e.g., VS Code Copilot) -export const THINKING_LEVEL_MAP = { +export const THINKING_LEVEL_MAP: Record<string, number> = { none: 0, low: 4096, medium: 8192, @@ -46,15 +54,24 @@ export const DEFAULT_THINKING_CONFIG = { mode: ThinkingMode.PASSTHROUGH, customBudget: 10240, effortLevel: "medium", -}; +} satisfies ThinkingBudgetConfig; // In-memory config (loaded from DB on startup, or default) -let _config = { ...DEFAULT_THINKING_CONFIG }; +let _config: ThinkingBudgetConfig = { ...DEFAULT_THINKING_CONFIG }; + +function toRecord(value: unknown): JsonRecord { + return value && typeof value === "object" && !Array.isArray(value) ? (value as JsonRecord) : {}; +} + +function getStringField(record: JsonRecord, key: string): string { + const value = record[key]; + return typeof value === "string" ? value : ""; +} /** * Set the thinking budget config (called from settings API or startup) */ -export function setThinkingBudgetConfig(config) { +export function setThinkingBudgetConfig(config: Partial<ThinkingBudgetConfig>) { _config = { ...DEFAULT_THINKING_CONFIG, ...config }; } @@ -73,15 +90,15 @@ export function getThinkingBudgetConfig() { * @param {object} body - Request body * @returns {object} Body with string thinkingLevel converted to numeric budget */ -export function normalizeThinkingLevel(body) { +export function normalizeThinkingLevel(body: unknown) { if (!body || typeof body !== "object") return body; - const result = { ...body }; + const result: JsonRecord = { ...(body as JsonRecord) }; // Handle top-level thinkingLevel or thinking_level string fields const levelStr = result.thinkingLevel || result.thinking_level; if (typeof levelStr === "string" && THINKING_LEVEL_MAP[levelStr.toLowerCase()] !== undefined) { const rawBudget = THINKING_LEVEL_MAP[levelStr.toLowerCase()]; - const budget = capThinkingBudget(result.model || "", rawBudget); + const budget = capThinkingBudget(getStringField(result, "model"), rawBudget); // Convert to Claude thinking format as canonical representation result.thinking = { type: budget > 0 ? "enabled" : "disabled", @@ -92,25 +109,29 @@ export function normalizeThinkingLevel(body) { } // Handle Gemini's generationConfig.thinkingConfig.thinkingLevel - const geminiLevel = - result.generationConfig?.thinkingConfig?.thinkingLevel || - result.generationConfig?.thinking_config?.thinkingLevel; + const generationConfig = toRecord(result.generationConfig); + const thinkingConfig = toRecord(generationConfig.thinkingConfig); + const thinkingConfigSnake = toRecord(generationConfig.thinking_config); + const geminiLevel = thinkingConfig.thinkingLevel || thinkingConfigSnake.thinkingLevel; if ( typeof geminiLevel === "string" && THINKING_LEVEL_MAP[geminiLevel.toLowerCase()] !== undefined ) { const rawBudget = THINKING_LEVEL_MAP[geminiLevel.toLowerCase()]; - const budget = capThinkingBudget(result.model || "", rawBudget); + const budget = capThinkingBudget(getStringField(result, "model"), rawBudget); result.generationConfig = { - ...result.generationConfig, - thinkingConfig: { ...result.generationConfig.thinkingConfig, thinkingBudget: budget }, + ...generationConfig, + thinkingConfig: { ...thinkingConfig, thinkingBudget: budget }, }; // Clean up string variants - if (result.generationConfig.thinkingConfig) { - delete result.generationConfig.thinkingConfig.thinkingLevel; + const nextGenerationConfig = result.generationConfig as JsonRecord; + const nextThinkingConfig = toRecord(nextGenerationConfig.thinkingConfig); + if (Object.keys(nextThinkingConfig).length > 0) { + delete nextThinkingConfig.thinkingLevel; + nextGenerationConfig.thinkingConfig = nextThinkingConfig; } - if (result.generationConfig.thinking_config) { - delete result.generationConfig.thinking_config; + if ("thinking_config" in nextGenerationConfig) { + delete nextGenerationConfig.thinking_config; } } @@ -124,17 +145,18 @@ export function normalizeThinkingLevel(body) { * @param {object} body - Request body * @returns {object} Body with thinking config auto-injected if needed */ -export function ensureThinkingConfig(body) { +export function ensureThinkingConfig(body: unknown) { if (!body || typeof body !== "object") return body; - const model = body.model || ""; + const bodyRecord = body as JsonRecord; + const model = getStringField(bodyRecord, "model"); // Only auto-inject for models with -thinking suffix if (!model.endsWith("-thinking")) return body; // If thinking config already present, don't override - if (body.thinking) return body; + if (bodyRecord.thinking) return body; - const result = { ...body }; + const result: JsonRecord = { ...bodyRecord }; result.thinking = { type: "enabled", budget_tokens: getDefaultThinkingBudget(model) || EFFORT_BUDGETS.medium, @@ -152,13 +174,17 @@ export function ensureThinkingConfig(body) { * @param {object} [config] - Override config (defaults to stored config) * @returns {object} Modified body */ -export function applyThinkingBudget(body, config = null) { +export function applyThinkingBudget( + body: unknown, + config: Partial<ThinkingBudgetConfig> | null = null +) { const cfg = config || _config; if (!body || typeof body !== "object") return body; // Early exit: strip ALL reasoning/thinking params for models that don't support them. // Provider-specific Cloud Code restrictions should be handled at the executor boundary. - const modelStr = typeof body.model === "string" ? body.model : ""; + const bodyRecord = body as JsonRecord; + const modelStr = typeof bodyRecord.model === "string" ? bodyRecord.model : ""; if (modelStr && !supportsReasoning(modelStr)) { return stripThinkingConfig(body); } @@ -177,7 +203,7 @@ export function applyThinkingBudget(body, config = null) { return processed; case ThinkingMode.CUSTOM: - return setCustomBudget(processed, cfg.customBudget); + return setCustomBudget(processed, cfg.customBudget ?? DEFAULT_THINKING_CONFIG.customBudget); case ThinkingMode.ADAPTIVE: return applyAdaptiveBudget(processed, cfg); @@ -190,8 +216,8 @@ export function applyThinkingBudget(body, config = null) { /** * AUTO mode: strip all thinking configuration, let provider decide */ -function stripThinkingConfig(body) { - const result = { ...body }; +function stripThinkingConfig(body: unknown) { + const result: JsonRecord = { ...toRecord(body) }; // Claude format delete result.thinking; @@ -202,9 +228,10 @@ function stripThinkingConfig(body) { // Gemini format if (result.generationConfig) { - result.generationConfig = { ...result.generationConfig }; - delete result.generationConfig.thinking_config; - delete result.generationConfig.thinkingConfig; + const generationConfig = { ...toRecord(result.generationConfig) }; + delete generationConfig.thinking_config; + delete generationConfig.thinkingConfig; + result.generationConfig = generationConfig; } return result; @@ -213,8 +240,8 @@ function stripThinkingConfig(body) { /** * CUSTOM mode: set exact budget tokens */ -function setCustomBudget(body, budget) { - const result = { ...body }; +function setCustomBudget(body: unknown, budget: number) { + const result: JsonRecord = { ...toRecord(body) }; // If body already has thinking config in Claude format, update it if (result.thinking || hasThinkingCapableModel(result)) { @@ -242,9 +269,10 @@ function setCustomBudget(body, budget) { } // Gemini thinking_config - if (result.generationConfig?.thinking_config || result.generationConfig?.thinkingConfig) { + const generationConfig = toRecord(result.generationConfig); + if (generationConfig.thinking_config || generationConfig.thinkingConfig) { result.generationConfig = { - ...result.generationConfig, + ...generationConfig, thinking_config: { thinking_budget: budget }, }; } @@ -255,21 +283,27 @@ function setCustomBudget(body, budget) { /** * ADAPTIVE mode: scale budget based on request complexity */ -function applyAdaptiveBudget(body, cfg) { - const messages = body.messages || body.input || []; +function applyAdaptiveBudget(body: unknown, cfg: Partial<ThinkingBudgetConfig>) { + const bodyRecord = toRecord(body); + const messages = Array.isArray(bodyRecord.messages) + ? bodyRecord.messages + : Array.isArray(bodyRecord.input) + ? bodyRecord.input + : []; const messageCount = messages.length; - const tools = body.tools || []; + const tools = Array.isArray(bodyRecord.tools) ? bodyRecord.tools : []; const toolCount = tools.length; // Get last user message length let lastMsgLength = 0; for (let i = messages.length - 1; i >= 0; i--) { const msg = messages[i]; - if (msg.role === "user") { + const msgRecord = toRecord(msg); + if (msgRecord.role === "user") { lastMsgLength = - typeof msg.content === "string" - ? msg.content.length - : JSON.stringify(msg.content || "").length; + typeof msgRecord.content === "string" + ? msgRecord.content.length + : JSON.stringify(msgRecord.content || "").length; break; } } @@ -281,10 +315,13 @@ function applyAdaptiveBudget(body, cfg) { if (lastMsgLength > 2000) multiplier += 0.3; const baseBudget = - EFFORT_BUDGETS[cfg.effortLevel] || - getDefaultThinkingBudget(body.model || "") || + EFFORT_BUDGETS[typeof cfg.effortLevel === "string" ? cfg.effortLevel : "medium"] || + getDefaultThinkingBudget(getStringField(bodyRecord, "model")) || EFFORT_BUDGETS.medium; - const budget = capThinkingBudget(body.model || "", Math.ceil(baseBudget * multiplier)); + const budget = capThinkingBudget( + getStringField(bodyRecord, "model"), + Math.ceil(baseBudget * multiplier) + ); return setCustomBudget(body, budget); } @@ -292,8 +329,8 @@ function applyAdaptiveBudget(body, cfg) { /** * Check if model name suggests thinking capability */ -export function hasThinkingCapableModel(body) { - const model = body.model || ""; +export function hasThinkingCapableModel(body: unknown) { + const model = getStringField(toRecord(body), "model"); const resolved = getResolvedModelCapabilities(model); if (resolved.supportsThinking === true) return true; if (resolved.supportsThinking === false) return false; diff --git a/open-sse/services/tokenRefresh.ts b/open-sse/services/tokenRefresh.ts index 5001730875..33f0848756 100755 --- a/open-sse/services/tokenRefresh.ts +++ b/open-sse/services/tokenRefresh.ts @@ -116,6 +116,86 @@ export async function refreshAccessToken( * Specialized refresh for Cline OAuth tokens. * Cline refresh endpoint expects JSON body and returns camelCase fields. */ +/** + * Refresh Windsurf (Devin CLI / Codeium) tokens. + * + * Windsurf uses Firebase Secure Token Service (STS) for token refresh. + * If the token is a long-lived Codeium API key (import flow), it never + * expires and refresh is a no-op returning the same token. + * If the token is a Firebase ID token (device-code flow), it expires after + * ~1 hour and can be refreshed with the stored Firebase refresh token. + */ +export async function refreshWindsurfToken( + refreshToken: string, + providerSpecificData: Record<string, unknown> | null | undefined, + log: RefreshLogger, + proxyConfig: unknown = null +) { + if (!refreshToken) { + log?.warn?.( + "TOKEN_REFRESH", + "No refresh token stored for Windsurf — token may be a long-lived API key" + ); + return null; + } + + const authMethod = (providerSpecificData?.authMethod as string) || "import"; + + // Long-lived Codeium API keys (import flow) have no expiry — nothing to refresh. + if (authMethod === "import") { + log?.debug?.("TOKEN_REFRESH", "Windsurf import token is long-lived — no refresh needed"); + return null; + } + + // Firebase STS refresh for browser-flow tokens. + // Key is read from WINDSURF_FIREBASE_API_KEY env var (set in .env.example). + const firebaseApiKey = process.env.WINDSURF_FIREBASE_API_KEY || ""; + if (!firebaseApiKey) { + log?.warn?.( + "TOKEN_REFRESH", + "WINDSURF_FIREBASE_API_KEY not set — skipping Windsurf Firebase token refresh" + ); + return null; + } + const tokenUrl = `https://securetoken.googleapis.com/v1/token?key=${firebaseApiKey}`; + + try { + const response = await runWithProxyContext(proxyConfig, () => + fetch(tokenUrl, { + method: "POST", + headers: { "Content-Type": "application/x-www-form-urlencoded" }, + body: buildFormParams({ grant_type: "refresh_token", refresh_token: refreshToken }), + }) + ); + + if (!response.ok) { + const errorText = await response.text(); + log?.error?.("TOKEN_REFRESH", "Failed to refresh Windsurf Firebase token", { + status: response.status, + error: errorText.slice(0, 200), + }); + return null; + } + + const data = await response.json(); + const expiresIn = parseInt(data.expires_in ?? "3600", 10); + + log?.info?.("TOKEN_REFRESH", "Successfully refreshed Windsurf Firebase token", { + expiresIn, + hasNewIdToken: !!data.id_token, + }); + + return { + accessToken: data.id_token, + refreshToken: data.refresh_token || refreshToken, + expiresIn, + }; + } catch (error) { + log?.error?.("TOKEN_REFRESH", `Network error refreshing Windsurf token: ${error.message}`); + return null; + } +} + export async function refreshClineToken(refreshToken, log, proxyConfig: unknown = null) { const endpoint = PROVIDERS.cline?.refreshUrl; if (!endpoint) { @@ -789,6 +869,15 @@ async function _getAccessTokenInternal(provider, credentials, log, proxyConfig: case "kimi-coding": return await refreshKimiCodingToken(credentials.refreshToken, log, proxyConfig); + case "windsurf": + case "devin-cli": + return await refreshWindsurfToken( + credentials.refreshToken, + credentials.providerSpecificData, + log, + proxyConfig + ); + default: // Fallback to generic OAuth refresh for unknown providers return refreshAccessToken(provider, credentials.refreshToken, credentials, log, proxyConfig); @@ -812,6 +901,8 @@ export function supportsTokenRefresh(provider) { "amazon-q", "cline", "kimi-coding", + "windsurf", + "devin-cli", ]); if (explicitlySupported.has(provider)) return true; const config = PROVIDERS[provider]; diff --git a/open-sse/services/usage.ts b/open-sse/services/usage.ts index 8424b89af2..21d85889f6 100644 --- a/open-sse/services/usage.ts +++ b/open-sse/services/usage.ts @@ -3,17 +3,21 @@ */ import { PROVIDERS } from "../config/constants.ts"; + +// Quota / usage upstream URLs (overridable for testing or relays). +const CROF_USAGE_URL = process.env.OMNIROUTE_CROF_USAGE_URL ?? "https://crof.ai/usage_api/"; +const GEMINI_CLI_USAGE_URL = + process.env.OMNIROUTE_GEMINI_CLI_USAGE_URL ?? + "https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist"; +const CODEWHISPERER_BASE_URL = + process.env.OMNIROUTE_CODEWHISPERER_BASE_URL ?? "https://codewhisperer.us-east-1.amazonaws.com"; import { getAntigravityFetchAvailableModelsUrls, ANTIGRAVITY_BASE_URLS, } from "../config/antigravityUpstream.ts"; import { isUserCallableAntigravityModelId } from "../config/antigravityModelAliases.ts"; import { getGlmQuotaUrl } from "../config/glmProvider.ts"; -import { - CURSOR_REGISTRY_VERSION, - getCursorUsageHeaders, - getGitHubCopilotInternalUserHeaders, -} from "../config/providerHeaderProfiles.ts"; +import { getGitHubCopilotInternalUserHeaders } from "../config/providerHeaderProfiles.ts"; import { safePercentage } from "@/shared/utils/formatting"; import { fetchBailianQuota, type BailianTripleWindowQuota } from "./bailianQuotaFetcher.ts"; import { fetchDeepseekQuota, type DeepseekQuota } from "./deepseekQuotaFetcher.ts"; @@ -72,17 +76,22 @@ const KIMI_CONFIG = { apiVersion: "2023-06-01", }; -const CURSOR_USAGE_CONFIG = { - usageUrl: "https://www.cursor.com/api/usage", - userMetaUrl: "https://www.cursor.com/api/auth/me", - subscriptionUrl: "https://www.cursor.com/api/subscription", - clientVersion: CURSOR_REGISTRY_VERSION, -}; - const NANOGPT_CONFIG = { usageUrl: "https://nano-gpt.com/api/subscription/v1/usage", }; +// Cursor dashboard usage API config +// The endpoint that powers https://cursor.com/dashboard/spending. Validates the WorkOS +// session via the WorkosCursorSessionToken cookie (format: `${userId}::${jwt}`) and +// rejects requests without a matching Origin/Referer (Invalid origin for state-changing request). +const CURSOR_USAGE_CONFIG = { + usageUrl: "https://cursor.com/api/dashboard/get-current-period-usage", + origin: "https://cursor.com", + referer: "https://cursor.com/dashboard/spending", + userAgent: + "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36", +}; + const MINIMAX_USAGE_CONFIG = { minimax: { usageUrls: [ @@ -115,6 +124,19 @@ type UsageQuota = { grantedBalance?: number; toppedUpBalance?: number; }; +type UsageProviderConnection = JsonRecord & { + id?: string; + provider?: string; + accessToken?: string; + apiKey?: string; + providerSpecificData?: JsonRecord; + projectId?: string; + email?: string; +}; +type SubscriptionCacheEntry = { + data: unknown; + fetchedAt: number; +}; function toRecord(value: unknown): JsonRecord { return value && typeof value === "object" && !Array.isArray(value) ? (value as JsonRecord) : {}; @@ -156,6 +178,12 @@ function getGlmTokenQuotaName( return existingQuotas.session ? "weekly" : "session"; } +function getGlmQuotaDisplayName(quotaName: string): string { + if (quotaName === "session") return "5 Hours Quota"; + if (quotaName === "weekly") return "Weekly Quota"; + return quotaName; +} + function getFieldValue(source: unknown, snakeKey: string, camelKey: string): unknown { const obj = toRecord(source); return obj[snakeKey] ?? obj[camelKey] ?? null; @@ -462,7 +490,7 @@ async function getCrofUsage(apiKey: string) { let response: Response; try { - response = await fetch("https://crof.ai/usage_api/", { + response = await fetch(CROF_USAGE_URL, { method: "GET", headers: { Authorization: `Bearer ${apiKey}`, @@ -635,6 +663,16 @@ async function getGlmUsage(apiKey: string, providerSpecificData?: Record<string, remaining, remainingPercentage: remaining, resetAt, + displayName: getGlmQuotaDisplayName(quotaName), + details: Array.isArray(src.models) + ? (src.models as unknown[]).map((m) => { + const modelInfo = toRecord(m); + return { + name: String(modelInfo.model || ""), + used: toNumber(modelInfo.percentage, 0), + }; + }) + : [], unlimited: false, }; continue; @@ -846,12 +884,152 @@ async function getNanoGptUsage(apiKey: string) { } } +/** + * Decode the `sub` claim of a Cursor JWT (the WorkOS user id). + * Returns null if the token is not a parseable JWT. + */ +function decodeCursorJwtSub(token: string): string | null { + if (!token || typeof token !== "string") return null; + const parts = token.split("."); + if (parts.length !== 3) return null; + try { + let payload = parts[1].replace(/-/g, "+").replace(/_/g, "/"); + while (payload.length % 4 !== 0) payload += "="; + const decoded = JSON.parse(Buffer.from(payload, "base64").toString("utf8")); + const sub = decoded?.sub; + return typeof sub === "string" && sub.length > 0 ? sub : null; + } catch { + return null; + } +} + +/** + * Cursor Pro Plan Usage + * Fetches current-billing-cycle spend from the cursor.com dashboard API and exposes three + * windows that mirror the cursor.com/dashboard/spending UI: Total / Auto + Composer / API. + */ +async function getCursorUsage(accessToken: string, providerSpecificData?: unknown) { + if (!accessToken) { + return { message: "Cursor access token missing. Re-import the connection from Cursor IDE." }; + } + + const storedUserId = (() => { + const raw = toRecord(providerSpecificData).userId; + return typeof raw === "string" && raw.length > 0 ? raw : null; + })(); + const userId = storedUserId || decodeCursorJwtSub(accessToken); + + if (!userId) { + return { + message: "Cursor token missing user id. Re-import the connection from Cursor IDE.", + }; + } + + try { + const response = await fetch(CURSOR_USAGE_CONFIG.usageUrl, { + method: "POST", + redirect: "manual", + headers: { + Cookie: `WorkosCursorSessionToken=${userId}::${accessToken}`, + Origin: CURSOR_USAGE_CONFIG.origin, + Referer: CURSOR_USAGE_CONFIG.referer, + "Content-Type": "application/json", + Accept: "application/json", + "User-Agent": CURSOR_USAGE_CONFIG.userAgent, + }, + body: "{}", + }); + + // 3xx redirect to WorkOS authkit means the session cookie was rejected. + if (response.status >= 300 && response.status < 400) { + return { + plan: "Cursor", + message: "Cursor session expired. Re-import the token from Cursor IDE.", + }; + } + + if (!response.ok) { + const errorText = (await response.text()).slice(0, 200); + if (response.status === 401 || response.status === 403) { + return { + plan: "Cursor", + message: "Cursor session unauthorized. Re-import the token from Cursor IDE.", + }; + } + return { + plan: "Cursor", + message: `Cursor usage endpoint error (${response.status}): ${errorText}`, + }; + } + + const data = toRecord(await response.json()); + const planUsage = toRecord(data.planUsage); + + if (Object.keys(planUsage).length === 0) { + return { + plan: "Cursor", + message: "Cursor connected. No active plan usage returned.", + }; + } + + const limitCents = Math.max(0, toNumber(planUsage.limit, 0)); + const totalSpendCents = Math.max(0, toNumber(planUsage.totalSpend, 0)); + const autoPercentUsed = clampPercentage(toNumber(planUsage.autoPercentUsed, 0)); + const apiPercentUsed = clampPercentage(toNumber(planUsage.apiPercentUsed, 0)); + const totalPercentUsed = clampPercentage(toNumber(planUsage.totalPercentUsed, 0)); + + // billingCycleEnd is a numeric-string in ms; coerce so parseResetTime sees a number. + const billingCycleEndMs = toNumber(data.billingCycleEnd, 0); + const resetAt = billingCycleEndMs > 0 ? parseResetTime(billingCycleEndMs) : null; + + // Convert cents → dollars rounded to 2 decimal places. + const toDollars = (cents: number) => Math.round(cents) / 100; + + const limitDollars = toDollars(limitCents); + const buildWindow = (percentUsed: number, usedCentsOverride?: number): UsageQuota => { + const usedCents = + typeof usedCentsOverride === "number" + ? usedCentsOverride + : Math.round((limitCents * percentUsed) / 100); + const used = toDollars(Math.min(usedCents, limitCents)); + const remaining = toDollars(Math.max(limitCents - Math.min(usedCents, limitCents), 0)); + return { + used, + total: limitDollars, + remaining, + remainingPercentage: clampPercentage(100 - percentUsed), + resetAt, + unlimited: false, + }; + }; + + const quotas: Record<string, UsageQuota> = { + Total: buildWindow(totalPercentUsed, totalSpendCents), + "Auto + Composer": buildWindow(autoPercentUsed), + API: buildWindow(apiPercentUsed), + }; + + return { + plan: "Cursor Pro", + quotas, + }; + } catch (error) { + return { + plan: "Cursor", + message: `Cursor connected. Unable to fetch usage: ${(error as Error).message}`, + }; + } +} + /** * Get usage data for a provider connection * @param {Object} connection - Provider connection with accessToken * @returns {Promise<unknown>} Usage data with quotas */ -export async function getUsageForProvider(connection, options: { forceRefresh?: boolean } = {}) { +export async function getUsageForProvider( + connection: UsageProviderConnection, + options: { forceRefresh?: boolean } = {} +) { const { id, provider, accessToken, apiKey, providerSpecificData, projectId, email } = connection; switch (provider) { @@ -865,6 +1043,8 @@ export async function getUsageForProvider(connection, options: { forceRefresh?: return await getClaudeUsage(accessToken); case "codex": return await getCodexUsage(accessToken, providerSpecificData); + case "cursor": + return await getCursorUsage(accessToken || "", providerSpecificData); case "kiro": case "amazon-q": return await getKiroUsage(accessToken, providerSpecificData); @@ -876,24 +1056,23 @@ export async function getUsageForProvider(connection, options: { forceRefresh?: return await getQoderUsage(accessToken); case "glm": case "glm-cn": + case "zai": case "glmt": - return await getGlmUsage(apiKey, { + return await getGlmUsage(apiKey || "", { ...(providerSpecificData || {}), ...(provider === "glm-cn" ? { apiRegion: "china" } : {}), }); case "minimax": case "minimax-cn": - return await getMiniMaxUsage(apiKey, provider); + return await getMiniMaxUsage(apiKey || "", provider); case "crof": - return await getCrofUsage(apiKey); - case "cursor": - return await getCursorUsage(accessToken); + return await getCrofUsage(apiKey || ""); case "bailian-coding-plan": - return await getBailianCodingPlanUsage(id, apiKey, providerSpecificData); + return await getBailianCodingPlanUsage(id || "", apiKey || "", providerSpecificData); case "nanogpt": - return await getNanoGptUsage(apiKey); + return await getNanoGptUsage(apiKey || ""); case "deepseek": - return await getDeepseekUsage(id, apiKey); + return await getDeepseekUsage(id || "", apiKey || ""); default: return { message: `Usage API not implemented for ${provider}` }; } @@ -903,11 +1082,11 @@ export async function getUsageForProvider(connection, options: { forceRefresh?: * Parse reset date/time to ISO string * Handles multiple formats: Unix timestamp (ms), ISO date string, etc. */ -function parseResetTime(resetValue) { +function parseResetTime(resetValue: unknown): string | null { if (!resetValue) return null; try { - let date; + let date: Date; if (resetValue instanceof Date) { date = resetValue; } else if (typeof resetValue === "number") { @@ -931,7 +1110,7 @@ function parseResetTime(resetValue) { * GitHub Copilot Usage * Uses GitHub accessToken (not copilotToken) to call copilot_internal/user API */ -async function getGitHubUsage(accessToken, providerSpecificData) { +async function getGitHubUsage(accessToken?: string, providerSpecificData?: JsonRecord) { try { if (!accessToken) { throw new Error("No GitHub access token available. Please re-authorize the connection."); @@ -1027,7 +1206,10 @@ async function getGitHubUsage(accessToken, providerSpecificData) { } } -function formatGitHubQuotaSnapshot(quota, resetAt: string | null = null): UsageQuota | null { +function formatGitHubQuotaSnapshot( + quota: unknown, + resetAt: string | null = null +): UsageQuota | null { const source = toRecord(quota); if (Object.keys(source).length === 0) return null; @@ -1120,176 +1302,10 @@ function inferGitHubPlanName(data: JsonRecord, premiumQuota: UsageQuota | null): return "GitHub Copilot"; } -function buildCursorUsageHeaders(accessToken: string): Record<string, string> { - return getCursorUsageHeaders(accessToken, CURSOR_USAGE_CONFIG.clientVersion); -} - -function getFirstPositiveNumber(...values: unknown[]): number { - for (const value of values) { - const parsed = toNumber(value, Number.NaN); - if (Number.isFinite(parsed) && parsed > 0) { - return parsed; - } - } - return 0; -} - -function getCursorMonthlyRequestLimit(usageData: JsonRecord, subscriptionData: JsonRecord): number { - return getFirstPositiveNumber( - getFieldValue(subscriptionData, "team_max_monthly_requests", "teamMaxMonthlyRequests"), - getFieldValue(usageData, "team_max_request_usage", "teamMaxRequestUsage"), - getFieldValue(subscriptionData, "team_max_request_usage", "teamMaxRequestUsage"), - getFieldValue(usageData, "hard_limit", "hardLimit"), - getFieldValue(subscriptionData, "max_monthly_requests", "maxMonthlyRequests") - ); -} - -function getCursorOnDemandLimit(usageData: JsonRecord, subscriptionData: JsonRecord): number { - const onDemand = toRecord(getFieldValue(usageData, "on_demand", "onDemand")); - return getFirstPositiveNumber( - getFieldValue(onDemand, "max_requests", "maxRequests"), - getCursorMonthlyRequestLimit(usageData, subscriptionData) - ); -} - -function formatCursorQuota( - usedValue: unknown, - totalValue: unknown, - resetValue: unknown -): UsageQuota { - const total = Math.max(0, toNumber(totalValue, 0)); - const rawUsed = Math.max(0, toNumber(usedValue, 0)); - const used = total > 0 ? Math.min(rawUsed, total) : rawUsed; - const remaining = total > 0 ? Math.max(total - used, 0) : 0; - - return { - used, - total, - remaining, - remainingPercentage: total > 0 ? clampPercentage((remaining / total) * 100) : 0, - resetAt: parseResetTime(resetValue), - unlimited: false, - }; -} - -function inferCursorPlanName(userMeta: JsonRecord, subscriptionData: JsonRecord): string { - const teamInfo = toRecord(getFieldValue(userMeta, "team_info", "teamInfo")); - const candidates = [ - getFieldValue(userMeta, "plan", "plan"), - getFieldValue(userMeta, "subscription_type", "subscriptionType"), - getFieldValue(subscriptionData, "subscription_type", "subscriptionType"), - getFieldValue(subscriptionData, "plan", "plan"), - ]; - const planText = candidates.find((value) => typeof value === "string" && value.trim().length > 0); - const normalized = typeof planText === "string" ? planText.trim().toLowerCase() : ""; - - if (Object.keys(teamInfo).length > 0 || normalized.includes("team")) return "Cursor Team"; - if (normalized.includes("enterprise")) return "Cursor Enterprise"; - if (normalized.includes("pro")) return "Cursor Pro"; - if (normalized.includes("free")) return "Cursor Free"; - return "Cursor"; -} - -async function fetchCursorUsageDocument(url: string, accessToken: string) { - const response = await fetch(url, { - method: "GET", - headers: buildCursorUsageHeaders(accessToken), - }); - - const text = await response.text(); - if (!response.ok) { - return { - ok: false, - status: response.status, - data: {} as JsonRecord, - text, - }; - } - - try { - const parsed = text ? JSON.parse(text) : {}; - return { - ok: true, - status: response.status, - data: toRecord(parsed), - text, - }; - } catch { - return { - ok: false, - status: response.status, - data: {} as JsonRecord, - text, - }; - } -} - -async function getCursorUsage(accessToken: string) { - try { - if (!accessToken) { - return { - message: "Cursor token expired or unavailable. Please re-authenticate the connection.", - }; - } - - const [usageSummary, userMeta, subscription] = await Promise.all([ - fetchCursorUsageDocument(CURSOR_USAGE_CONFIG.usageUrl, accessToken), - fetchCursorUsageDocument(CURSOR_USAGE_CONFIG.userMetaUrl, accessToken), - fetchCursorUsageDocument(CURSOR_USAGE_CONFIG.subscriptionUrl, accessToken), - ]); - - const authDenied = [usageSummary, userMeta, subscription].some( - (result) => result.status === 401 || result.status === 403 - ); - if (authDenied) { - return { - message: - "Cursor token expired or permission denied. Please re-authenticate the connection.", - }; - } - - const usageData = usageSummary.data; - const userMetaData = userMeta.data; - const subscriptionData = subscription.data; - const plan = inferCursorPlanName(userMetaData, subscriptionData); - - const quotas: Record<string, UsageQuota> = {}; - const totalUsed = getFieldValue(usageData, "num_requests_total", "numRequestsTotal"); - const totalLimit = getCursorMonthlyRequestLimit(usageData, subscriptionData); - const totalReset = - getFieldValue(usageData, "reset_date", "resetDate") || - getFieldValue(subscriptionData, "reset_date", "resetDate"); - - if (toNumber(totalUsed, 0) > 0 || totalLimit > 0) { - quotas.requests = formatCursorQuota(totalUsed, totalLimit, totalReset); - } - - const onDemand = toRecord(getFieldValue(usageData, "on_demand", "onDemand")); - const onDemandUsed = getFieldValue(onDemand, "num_requests", "numRequests"); - const onDemandLimit = getCursorOnDemandLimit(usageData, subscriptionData); - const onDemandReset = - getFieldValue(onDemand, "reset_date", "resetDate") || - getFieldValue(usageData, "reset_date", "resetDate") || - getFieldValue(subscriptionData, "reset_date", "resetDate"); - - if (toNumber(onDemandUsed, 0) > 0 || onDemandLimit > 0) { - quotas.on_demand = formatCursorQuota(onDemandUsed, onDemandLimit, onDemandReset); - } - - if (Object.keys(quotas).length > 0) { - return { plan, quotas }; - } - - return { plan, message: "Cursor connected. Unable to parse quota data." }; - } catch (error) { - return { message: `Unable to fetch Cursor usage: ${(error as Error).message}` }; - } -} - // ── Gemini CLI subscription info cache ────────────────────────────────────── // Prevents duplicate loadCodeAssist calls within the same quota cycle. // Key: accessToken → { data, fetchedAt } -const _geminiCliSubCache = new Map(); +const _geminiCliSubCache = new Map<string, SubscriptionCacheEntry>(); const GEMINI_CLI_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes /** @@ -1297,7 +1313,11 @@ const GEMINI_CLI_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes * Gemini CLI and Antigravity share the same upstream (cloudcode-pa.googleapis.com), * so this follows the same pattern as getAntigravityUsage(). */ -async function getGeminiUsage(accessToken, providerSpecificData?, connectionProjectId?) { +async function getGeminiUsage( + accessToken?: string, + providerSpecificData?: JsonRecord, + connectionProjectId?: string +) { if (!accessToken) { return { plan: "Free", message: "Gemini CLI access token not available." }; } @@ -1307,7 +1327,7 @@ async function getGeminiUsage(accessToken, providerSpecificData?, connectionProj const projectId = connectionProjectId || providerSpecificData?.projectId || - subscriptionInfo?.cloudaicompanionProject || + toRecord(subscriptionInfo).cloudaicompanionProject || null; const plan = getGeminiCliPlanLabel(subscriptionInfo); @@ -1338,8 +1358,10 @@ async function getGeminiUsage(accessToken, providerSpecificData?, connectionProj const data = await response.json(); const quotas: Record<string, UsageQuota> = {}; - if (Array.isArray(data.buckets)) { - for (const bucket of data.buckets) { + const dataRecord = toRecord(data); + if (Array.isArray(dataRecord.buckets)) { + for (const bucketValue of dataRecord.buckets) { + const bucket = toRecord(bucketValue); if (!bucket.modelId || bucket.remainingFraction == null) continue; const remainingFraction = toNumber(bucket.remainingFraction, 0); @@ -1349,7 +1371,7 @@ async function getGeminiUsage(accessToken, providerSpecificData?, connectionProj const remaining = Math.round(total * remainingFraction); const used = Math.max(0, total - remaining); - quotas[bucket.modelId] = { + quotas[String(bucket.modelId)] = { used, total, resetAt: parseResetTime(bucket.resetTime), @@ -1368,7 +1390,7 @@ async function getGeminiUsage(accessToken, providerSpecificData?, connectionProj /** * Get Gemini CLI subscription info (cached, 5 min TTL) */ -async function getGeminiCliSubscriptionInfoCached(accessToken) { +async function getGeminiCliSubscriptionInfoCached(accessToken: string): Promise<unknown> { const cacheKey = accessToken; const cached = _geminiCliSubCache.get(cacheKey); @@ -1384,9 +1406,9 @@ async function getGeminiCliSubscriptionInfoCached(accessToken) { /** * Get Gemini CLI subscription info using correct headers. */ -async function getGeminiCliSubscriptionInfo(accessToken) { +async function getGeminiCliSubscriptionInfo(accessToken: string): Promise<unknown | null> { try { - const response = await fetch("https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist", { + const response = await fetch(GEMINI_CLI_USAGE_URL, { method: "POST", headers: { Authorization: `Bearer ${accessToken}`, @@ -1412,13 +1434,15 @@ async function getGeminiCliSubscriptionInfo(accessToken) { /** * Map Gemini CLI subscription tier to display label (same tiers as Antigravity). */ -function getGeminiCliPlanLabel(subscriptionInfo) { - if (!subscriptionInfo || Object.keys(subscriptionInfo).length === 0) return "Free"; +function getGeminiCliPlanLabel(subscriptionInfo: unknown): string { + const subscription = toRecord(subscriptionInfo); + if (Object.keys(subscription).length === 0) return "Free"; let tierId = ""; - if (Array.isArray(subscriptionInfo.allowedTiers)) { - for (const tier of subscriptionInfo.allowedTiers) { - if (tier.isDefault && tier.id) { + if (Array.isArray(subscription.allowedTiers)) { + for (const tierValue of subscription.allowedTiers) { + const tier = toRecord(tierValue); + if (tier.isDefault && typeof tier.id === "string") { tierId = tier.id.trim().toUpperCase(); break; } @@ -1426,7 +1450,8 @@ function getGeminiCliPlanLabel(subscriptionInfo) { } if (!tierId) { - tierId = (subscriptionInfo.currentTier?.id || "").toUpperCase(); + const currentTier = toRecord(subscription.currentTier); + tierId = typeof currentTier.id === "string" ? currentTier.id.toUpperCase() : ""; } if (tierId) { @@ -1438,12 +1463,12 @@ function getGeminiCliPlanLabel(subscriptionInfo) { return "Free"; } - const tierName = - subscriptionInfo.currentTier?.name || - subscriptionInfo.currentTier?.displayName || - subscriptionInfo.subscriptionType || - subscriptionInfo.tier || - ""; + const tierName = String( + getFieldValue(toRecord(subscription.currentTier), "name", "displayName") || + subscription.subscriptionType || + subscription.tier || + "" + ); const upper = tierName.toUpperCase(); if (upper.includes("ULTRA")) return "Ultra"; @@ -1452,7 +1477,7 @@ function getGeminiCliPlanLabel(subscriptionInfo) { if (upper.includes("STANDARD") || upper.includes("BUSINESS")) return "Business"; if (upper.includes("INDIVIDUAL") || upper.includes("FREE")) return "Free"; - if (subscriptionInfo.currentTier?.upgradeSubscriptionType) return "Free"; + if (toRecord(subscription.currentTier).upgradeSubscriptionType) return "Free"; if (tierName) { return tierName.charAt(0).toUpperCase() + tierName.slice(1).toLowerCase(); } @@ -1463,7 +1488,7 @@ function getGeminiCliPlanLabel(subscriptionInfo) { // ── Antigravity subscription info cache ────────────────────────────────────── // Prevents duplicate loadCodeAssist calls within the same quota cycle. // Key: truncated accessToken → { data, fetchedAt } -const _antigravitySubCache = new Map(); +const _antigravitySubCache = new Map<string, SubscriptionCacheEntry>(); const ANTIGRAVITY_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes const ANTIGRAVITY_MODELS_CACHE_TTL_MS = 60 * 1000; const ANTIGRAVITY_CREDIT_PROBE_TTL_MS = 5 * 60 * 1000; @@ -1549,14 +1574,16 @@ async function fetchAntigravityAvailableModelsCached( * Extracts tier from allowedTiers[].isDefault (same logic as providers.js postExchange). * Falls back to currentTier.id → currentTier.name → "Free". */ -function getAntigravityPlanLabel(subscriptionInfo) { - if (!subscriptionInfo || Object.keys(subscriptionInfo).length === 0) return "Free"; +function getAntigravityPlanLabel(subscriptionInfo: unknown): string { + const subscription = toRecord(subscriptionInfo); + if (Object.keys(subscription).length === 0) return "Free"; // 1. Extract tier from allowedTiers (primary source — same as providers.js) let tierId = ""; - if (Array.isArray(subscriptionInfo.allowedTiers)) { - for (const tier of subscriptionInfo.allowedTiers) { - if (tier.isDefault && tier.id) { + if (Array.isArray(subscription.allowedTiers)) { + for (const tierValue of subscription.allowedTiers) { + const tier = toRecord(tierValue); + if (tier.isDefault && typeof tier.id === "string") { tierId = tier.id.trim().toUpperCase(); break; } @@ -1565,7 +1592,8 @@ function getAntigravityPlanLabel(subscriptionInfo) { // 2. Fall back to currentTier.id if (!tierId) { - tierId = (subscriptionInfo.currentTier?.id || "").toUpperCase(); + const currentTier = toRecord(subscription.currentTier); + tierId = typeof currentTier.id === "string" ? currentTier.id.toUpperCase() : ""; } // 3. Map tier ID to display label @@ -1579,12 +1607,12 @@ function getAntigravityPlanLabel(subscriptionInfo) { } // 4. Try tier name fields as last resort - const tierName = - subscriptionInfo.currentTier?.name || - subscriptionInfo.currentTier?.displayName || - subscriptionInfo.subscriptionType || - subscriptionInfo.tier || - ""; + const tierName = String( + getFieldValue(toRecord(subscription.currentTier), "name", "displayName") || + subscription.subscriptionType || + subscription.tier || + "" + ); const upper = tierName.toUpperCase(); if (upper.includes("ULTRA")) return "Ultra"; @@ -1594,7 +1622,7 @@ function getAntigravityPlanLabel(subscriptionInfo) { if (upper.includes("INDIVIDUAL") || upper.includes("FREE")) return "Free"; // 5. If upgradeSubscriptionType exists, account is on free tier - if (subscriptionInfo.currentTier?.upgradeSubscriptionType) return "Free"; + if (toRecord(subscription.currentTier).upgradeSubscriptionType) return "Free"; // 6. If we have a tier name that didn't match known patterns, return it title-cased if (tierName) { @@ -1750,19 +1778,21 @@ async function probeAntigravityCreditBalanceUncached( * retrieveUserQuota only returns Gemini models — not suitable for Antigravity. */ async function getAntigravityUsage( - accessToken, - providerSpecificData, - connectionProjectId?, - connectionId?, + accessToken?: string, + providerSpecificData?: JsonRecord, + connectionProjectId?: string, + connectionId?: string, options: AntigravityUsageOptions = {} ) { + void providerSpecificData; if (!accessToken) { return { plan: "Free", message: "Antigravity access token not available." }; } try { const subscriptionInfo = await getAntigravitySubscriptionInfoCached(accessToken); - const projectId = connectionProjectId || subscriptionInfo?.cloudaicompanionProject || null; + const projectId = + connectionProjectId || toRecord(subscriptionInfo).cloudaicompanionProject?.toString() || null; // Derive accountId for credit balance cache. // Must match executor key: credentials.connectionId @@ -1850,7 +1880,7 @@ async function getAntigravityUsage( * Get Antigravity subscription info (cached, 5 min TTL) * Prevents duplicate loadCodeAssist calls within the same quota cycle. */ -async function getAntigravitySubscriptionInfoCached(accessToken) { +async function getAntigravitySubscriptionInfoCached(accessToken: string): Promise<unknown> { const cacheKey = accessToken.substring(0, 16); const cached = _antigravitySubCache.get(cacheKey); @@ -1867,7 +1897,7 @@ async function getAntigravitySubscriptionInfoCached(accessToken) { * Get Antigravity subscription info using correct Antigravity headers. * Must match the headers used in providers.js postExchange (not CLI headers). */ -async function getAntigravitySubscriptionInfo(accessToken) { +async function getAntigravitySubscriptionInfo(accessToken: string): Promise<unknown | null> { try { const response = await fetch(ANTIGRAVITY_CONFIG.loadProjectApiUrl, { method: "POST", @@ -1886,7 +1916,11 @@ async function getAntigravitySubscriptionInfo(accessToken) { /** * Claude Usage - Try to fetch from Anthropic API */ -async function getClaudeUsage(accessToken) { +async function getClaudeUsage(accessToken?: string) { + if (!accessToken) { + return { message: "Claude connected. Access token not available.", bootstrap: null }; + } + // Refresh bootstrap in parallel; best-effort, failure non-fatal. const bootstrapPromise = fetchClaudeBootstrap(accessToken).catch(() => null); try { @@ -1913,7 +1947,7 @@ async function getClaudeUsage(accessToken) { } if (oauthResponse.ok) { - const data = await oauthResponse.json(); + const data = toRecord(await oauthResponse.json()); const quotas: Record<string, UsageQuota> = {}; // utilization = percentage USED (e.g., 90 means 90% used, 10% remaining) @@ -1934,12 +1968,14 @@ async function getClaudeUsage(accessToken) { }; }; - if (hasUtilization(data.five_hour)) { - quotas["session (5h)"] = createQuotaObject(data.five_hour); + const fiveHour = toRecord(data.five_hour); + if (hasUtilization(fiveHour)) { + quotas["session (5h)"] = createQuotaObject(fiveHour); } - if (hasUtilization(data.seven_day)) { - quotas["weekly (7d)"] = createQuotaObject(data.seven_day); + const sevenDay = toRecord(data.seven_day); + if (hasUtilization(sevenDay)) { + quotas["weekly (7d)"] = createQuotaObject(sevenDay); } // Map Anthropic's internal codenames (e.g., omelette → Designer) for display. @@ -1991,7 +2027,7 @@ async function getClaudeUsage(accessToken) { * Legacy Claude usage fetcher for API key / org admin users. * Uses /v1/settings + /v1/organizations/{org_id}/usage endpoints. */ -async function getClaudeUsageLegacy(accessToken) { +async function getClaudeUsageLegacy(accessToken?: string) { try { const settingsResponse = await fetch(CLAUDE_CONFIG.settingsUrl, { method: "GET", @@ -2002,11 +2038,13 @@ async function getClaudeUsageLegacy(accessToken) { }); if (settingsResponse.ok) { - const settings = await settingsResponse.json(); + const settings = toRecord(await settingsResponse.json()); - if (settings.organization_id) { + const organizationId = + typeof settings.organization_id === "string" ? settings.organization_id : ""; + if (organizationId) { const usageResponse = await fetch( - CLAUDE_CONFIG.usageUrl.replace("{org_id}", settings.organization_id), + CLAUDE_CONFIG.usageUrl.replace("{org_id}", organizationId), { method: "GET", headers: { @@ -2044,7 +2082,10 @@ async function getClaudeUsageLegacy(accessToken) { * IMPORTANT: Uses persisted workspaceId from OAuth to ensure correct workspace binding. * No fallback to other workspaces - strict binding to user's selected workspace. */ -async function getCodexUsage(accessToken, providerSpecificData: Record<string, unknown> = {}) { +async function getCodexUsage( + accessToken?: string, + providerSpecificData: Record<string, unknown> = {} +) { try { // Use persisted workspace ID from OAuth - NO FALLBACK const accountId = @@ -2165,7 +2206,7 @@ async function getCodexUsage(accessToken, providerSpecificData: Record<string, u /** * Kiro (AWS CodeWhisperer) Usage */ -async function getKiroUsage(accessToken, providerSpecificData) { +async function getKiroUsage(accessToken?: string, providerSpecificData?: JsonRecord) { try { const profileArn = providerSpecificData?.profileArn; if (!profileArn) { @@ -2179,7 +2220,7 @@ async function getKiroUsage(accessToken, providerSpecificData) { resourceType: "AGENTIC_REQUEST", }; - const response = await fetch("https://codewhisperer.us-east-1.amazonaws.com", { + const response = await fetch(CODEWHISPERER_BASE_URL, { method: "POST", headers: { Authorization: `Bearer ${accessToken}`, @@ -2195,19 +2236,23 @@ async function getKiroUsage(accessToken, providerSpecificData) { throw new Error(`Kiro API error (${response.status}): ${errorText}`); } - const data = await response.json(); + const data = toRecord(await response.json()); // Parse usage data from usageBreakdownList - const usageList = data.usageBreakdownList || []; - const quotaInfo = {}; + const usageList = Array.isArray(data.usageBreakdownList) ? data.usageBreakdownList : []; + const quotaInfo: Record<string, UsageQuota> = {}; // Parse reset time - supports multiple formats (nextDateReset, resetDate, etc.) const resetAt = parseResetTime(data.nextDateReset || data.resetDate); - usageList.forEach((breakdown) => { - const resourceType = breakdown.resourceType?.toLowerCase() || "unknown"; - const used = breakdown.currentUsageWithPrecision || 0; - const total = breakdown.usageLimitWithPrecision || 0; + usageList.forEach((breakdownValue: unknown) => { + const breakdown = toRecord(breakdownValue); + const resourceType = + typeof breakdown.resourceType === "string" + ? breakdown.resourceType.toLowerCase() + : "unknown"; + const used = toNumber(breakdown.currentUsageWithPrecision, 0); + const total = toNumber(breakdown.usageLimitWithPrecision, 0); quotaInfo[resourceType] = { used, @@ -2218,9 +2263,10 @@ async function getKiroUsage(accessToken, providerSpecificData) { }; // Add free trial if available - if (breakdown.freeTrialInfo) { - const freeUsed = breakdown.freeTrialInfo.currentUsageWithPrecision || 0; - const freeTotal = breakdown.freeTrialInfo.usageLimitWithPrecision || 0; + const freeTrialInfo = toRecord(breakdown.freeTrialInfo); + if (Object.keys(freeTrialInfo).length > 0) { + const freeUsed = toNumber(freeTrialInfo.currentUsageWithPrecision, 0); + const freeTotal = toNumber(freeTrialInfo.usageLimitWithPrecision, 0); quotaInfo[`${resourceType}_freetrial`] = { used: freeUsed, @@ -2233,7 +2279,7 @@ async function getKiroUsage(accessToken, providerSpecificData) { }); return { - plan: data.subscriptionInfo?.subscriptionTitle || "Kiro", + plan: String(toRecord(data.subscriptionInfo).subscriptionTitle || "").trim() || "Kiro", quotas: quotaInfo, }; } catch (error) { @@ -2246,8 +2292,9 @@ async function getKiroUsage(accessToken, providerSpecificData) { * LEVEL_BASIC = Moderato, LEVEL_INTERMEDIATE = Allegretto, * LEVEL_ADVANCED = Allegro, LEVEL_STANDARD = Vivace */ -function getKimiPlanName(level) { +function getKimiPlanName(level: unknown): string { if (!level) return ""; + const normalizedLevel = String(level); const levelMap = { LEVEL_BASIC: "Moderato", @@ -2256,14 +2303,17 @@ function getKimiPlanName(level) { LEVEL_STANDARD: "Vivace", }; - return levelMap[level] || level.replace("LEVEL_", "").toLowerCase(); + return ( + levelMap[normalizedLevel as keyof typeof levelMap] || + normalizedLevel.replace("LEVEL_", "").toLowerCase() + ); } /** * Kimi Coding Usage - Fetch quota from Kimi API * Uses the official /v1/usages endpoint with custom X-Msh-* headers */ -async function getKimiUsage(accessToken) { +async function getKimiUsage(accessToken?: string) { // Generate device info for headers (same as OAuth flow) const deviceId = "kimi-usage-" + Date.now(); const platform = "omniroute"; @@ -2415,7 +2465,8 @@ async function getKimiUsage(accessToken) { /** * Qwen Usage */ -async function getQwenUsage(accessToken, providerSpecificData) { +async function getQwenUsage(accessToken?: string, providerSpecificData?: JsonRecord) { + void accessToken; try { const resourceUrl = providerSpecificData?.resourceUrl; if (!resourceUrl) { @@ -2432,7 +2483,8 @@ async function getQwenUsage(accessToken, providerSpecificData) { /** * Qoder Usage */ -async function getQoderUsage(accessToken) { +async function getQoderUsage(accessToken?: string) { + void accessToken; try { // Qoder may have usage endpoint return { message: "Qoder connected. Usage tracked per request." }; @@ -2445,11 +2497,6 @@ export const __testing = { parseResetTime, formatGitHubQuotaSnapshot, inferGitHubPlanName, - buildCursorUsageHeaders, - formatCursorQuota, - getCursorMonthlyRequestLimit, - getCursorOnDemandLimit, - inferCursorPlanName, getGeminiCliPlanLabel, getAntigravityPlanLabel, }; diff --git a/open-sse/translator/helpers/claudeHelper.ts b/open-sse/translator/helpers/claudeHelper.ts index d42c86dc08..6f9bc3d6e4 100644 --- a/open-sse/translator/helpers/claudeHelper.ts +++ b/open-sse/translator/helpers/claudeHelper.ts @@ -1,5 +1,15 @@ // Claude helper functions for translator import { DEFAULT_THINKING_CLAUDE_SIGNATURE } from "../../config/defaultThinkingSignature.ts"; +import { lookupReasoning, recordReplay } from "../../services/reasoningCache.ts"; + +// Placeholder thinking text used as last-resort fallback when: +// - Target upstream is a non-Anthropic Claude-shape provider +// (kimi-coding, glmt, zai, …) that rejects redacted_thinking blobs +// - Client (e.g. Capy) sent only redacted_thinking on replay +// - reasoningCache has no entry for the corresponding tool_use.id +// Must be non-empty: kimi-coding treats empty `thinking.thinking` as +// `reasoning_content missing` and 400s. +export const NON_ANTHROPIC_THINKING_PLACEHOLDER = "(prior reasoning summary unavailable)"; type ClaudeContentBlock = { type?: string; @@ -151,6 +161,17 @@ export function prepareClaudeRequest( const supportsPromptCaching = provider === "claude" || provider?.startsWith?.("anthropic-compatible-"); + // Non-Anthropic Claude-shape providers (kimi-coding, glmt, zai, …) cannot + // validate the synthetic redacted_thinking.data blob — they're not Anthropic + // and don't speak its signature scheme. They expect plain `thinking { text }` + // blocks with the original reasoning text, or fail with: + // "thinking is enabled but reasoning_content is missing in assistant + // tool call message at index N" + // We use the same allowlist as prompt-caching: only Anthropic-native + // upstreams get redacted_thinking. Everything else gets plain thinking blocks + // backed by reasoningCache (real text) or a placeholder (cache miss). + const supportsRedactedThinking = supportsPromptCaching; + const systemBlocks = body.system; if (systemBlocks && Array.isArray(systemBlocks) && !preserveCacheControl) { body.system = systemBlocks.map((block, i) => { @@ -233,6 +254,19 @@ export function prepareClaudeRequest( } // Pass 2 (reverse): add cache_control to last assistant + handle thinking for Anthropic + + // Index of the LAST assistant message in the filtered array. Anthropic + // enforces the latest assistant message's thinking blocks cannot be + // modified — preserve them verbatim. Older assistant messages can be + // rewritten to redacted_thinking { data } as before. + let latestAssistantIndex = -1; + for (let k = filtered.length - 1; k >= 0; k--) { + if (filtered[k]?.role === "assistant") { + latestAssistantIndex = k; + break; + } + } + let lastAssistantProcessed = false; for (let i = filtered.length - 1; i >= 0; i--) { const msg = filtered[i]; @@ -250,32 +284,144 @@ export function prepareClaudeRequest( lastAssistantProcessed = true; } - // Handle thinking blocks for Anthropic endpoints (native + compatible) - if (provider === "claude" || provider?.startsWith?.("anthropic-compatible-")) { - let hasToolUse = false; - let hasThinking = false; + // Handle thinking blocks for Anthropic-shape endpoints. + // prepareClaudeRequest is only invoked when targetFormat === claude + // (translator/index.ts:165-168), so any provider that lands here has + // a Claude-format upstream: claude native, anthropic-compatible-*, + // kimi-coding (api.kimi.com/coding/v1/messages), glmt, zai, etc. + // All of these enforce the same body-shape contract for thinking mode: + // when body.thinking.type === "enabled" and an assistant turn contains + // a tool_use, the same content[] must include a thinking (or + // redacted_thinking) block emitted before the tool_use. Without it, + // the upstream rejects with errors like: + // "thinking is enabled but reasoning_content is missing in + // assistant tool call message at index N" (kimi-coding) + // "Invalid signature in thinking block" (claude native, on + // cross-provider replay) + // Guard: never modify EXISTING thinking blocks in the latest assistant + // message when sending to an Anthropic-native upstream. Anthropic returns + // 400 "blocks in the latest assistant message cannot be modified" if any + // field changes. Injecting a NEW thinking block (when none exists) is fine. + // Older assistant messages can still be rewritten. + // For non-Anthropic providers: only the text replacement is skipped + // for the latest assistant (if it already has non-empty thinking text); + // field cleanup (signature strip, type normalization) still runs. + const isLatestAssistant = i === latestAssistantIndex; + const latestHasExistingThinking = + isLatestAssistant && + content.some((b: any) => b.type === "thinking" || b.type === "redacted_thinking"); + if (latestHasExistingThinking && supportsRedactedThinking) { + // Anthropic: skip all thinking-block rewrites entirely — the + // blocks must remain verbatim (type, thinking, signature, data). + continue; + } - // Convert thinking blocks to redacted_thinking and replace signature. - // When requests cross provider boundaries (e.g., combo fallback), the - // original thinking signature is invalid for the new provider, causing - // "Invalid signature in thinking block" 400 errors. redacted_thinking - // blocks are accepted without signature validation. + let hasToolUse = false; + let hasThinking = false; + + // Pre-collect tool_use ids in this content[] for reasoningCache + // lookups when the upstream is a non-Anthropic Claude-shape provider. + // The cache is keyed by tool_call_id which equals tool_use.id for + // Anthropic-shape (the same value is reused across formats — see + // claude-to-openai.ts:63 where openai tool_call.id = claude tool_use.id). + const toolUseIds: string[] = []; + if (!supportsRedactedThinking) { for (const block of content) { - if (block.type === "thinking" || block.type === "redacted_thinking") { - block.type = "redacted_thinking"; - block.signature = DEFAULT_THINKING_CLAUDE_SIGNATURE; - delete block.thinking; - hasThinking = true; + if (block.type === "tool_use" && typeof block.id === "string") { + toolUseIds.push(block.id); } - if (block.type === "tool_use") hasToolUse = true; } + } - // Add thinking block if thinking enabled + has tool_use but no thinking - if (thinkingEnabled && !hasThinking && hasToolUse) { + // Convert thinking blocks per provider type: + // + // Anthropic-native (claude, anthropic-compatible-*): + // Emit redacted_thinking { data } with synthetic blob. Anthropic + // accepts this as a valid placeholder for replay context without + // re-validating the original signature. Previous behavior — keep. + // + // When requests cross provider boundaries (e.g., combo fallback) or + // when client-stored signatures (Capy) replay back to Anthropic, the + // original `thinking.signature` no longer validates: "Invalid + // signature in thinking block" 400. redacted_thinking accepts without + // signature validation — but Anthropic REQUIRES a `data` field. + // Field rules: redacted_thinking={type,data} ; thinking={type,thinking,signature}. + // + // Non-Anthropic Claude-shape (kimi-coding, glmt, zai, …): + // Emit plain thinking { thinking: <text> } using the real reasoning + // text from reasoningCache (captured on the prior assistant + // response). Falls back to NON_ANTHROPIC_THINKING_PLACEHOLDER if the + // cache misses (rare but possible after a process restart or TTL + // eviction). Empty text is treated as "missing" by kimi-coding so + // never emit an empty thinking field. + let thinkingBlockIdx = 0; + for (const block of content) { + if (block.type === "thinking" || block.type === "redacted_thinking") { + if (supportsRedactedThinking) { + block.type = "redacted_thinking"; + block.data = DEFAULT_THINKING_CLAUDE_SIGNATURE; + delete block.thinking; + delete block.signature; + } else { + const existing = + typeof block.thinking === "string" && block.thinking.length > 0 + ? block.thinking + : ""; + let text = existing; + // For the latest assistant message on non-Anthropic upstreams, + // preserve the thinking text verbatim when it is already present. + // Cache lookups and the placeholder fallback only apply to older + // messages (or to the latest if the client sent empty text). + if (!text || !latestHasExistingThinking) { + if (!text) { + const pairedToolUseId = toolUseIds[thinkingBlockIdx]; + if (pairedToolUseId) { + const cached = lookupReasoning(pairedToolUseId); + if (cached) { + text = cached; + recordReplay(); + } + } + } + block.type = "thinking"; + block.thinking = text || NON_ANTHROPIC_THINKING_PLACEHOLDER; + } else { + // latestHasExistingThinking + non-empty text: preserve text, still clean up fields + block.type = "thinking"; + } + delete block.data; + delete block.signature; + } + hasThinking = true; + thinkingBlockIdx++; + } + if (block.type === "tool_use") hasToolUse = true; + } + + // Add precursor thinking block if thinking enabled + has tool_use but + // no existing thinking-ish block. Required for Anthropic-shape + // thinking-mode upstreams (claude, kimi-coding, glm, …) when the + // assistant turn's content[] needs a thinking block in front of any + // tool_use. Use the same provider-aware shape selection as above. + if (thinkingEnabled && !hasThinking && hasToolUse) { + if (supportsRedactedThinking) { + content.unshift({ + type: "redacted_thinking", + data: DEFAULT_THINKING_CLAUDE_SIGNATURE, + }); + } else { + let text = ""; + const firstToolUseId = toolUseIds[0]; + if (firstToolUseId) { + const cached = lookupReasoning(firstToolUseId); + if (cached) { + text = cached; + recordReplay(); + } + } content.unshift({ type: "thinking", - thinking: ".", - signature: DEFAULT_THINKING_CLAUDE_SIGNATURE, + thinking: text || NON_ANTHROPIC_THINKING_PLACEHOLDER, }); } } diff --git a/open-sse/translator/helpers/geminiHelper.ts b/open-sse/translator/helpers/geminiHelper.ts index 5a2c1f825f..0ee9591150 100644 --- a/open-sse/translator/helpers/geminiHelper.ts +++ b/open-sse/translator/helpers/geminiHelper.ts @@ -1,5 +1,7 @@ // Gemini helper functions for translator +type JsonRecord = Record<string, unknown>; + // Unsupported JSON Schema constraints that should be removed for Antigravity. // `additionalProperties` is handled separately so `true` can be preserved. export const GEMINI_UNSUPPORTED_SCHEMA_KEYS = new Set([ @@ -89,52 +91,58 @@ export const DEFAULT_SAFETY_SETTINGS = [ ]; // Convert OpenAI content to Gemini parts -export function convertOpenAIContentToParts(content: any) { - const parts: any[] = []; +export function convertOpenAIContentToParts(content: unknown): JsonRecord[] { + const parts: JsonRecord[] = []; if (typeof content === "string") { parts.push({ text: content }); } else if (Array.isArray(content)) { for (const item of content) { - if (item.type === "text") { - parts.push({ text: item.text }); + const rec = toRecord(item); + if (rec.type === "text") { + parts.push({ text: rec.text }); } else { // 1. Handle Gemini native inline_data injected into OpenAI arrays (e.g. Cherry Studio) - const geminiInline = item.inline_data || item.inlineData; + const geminiInline = toRecord(rec.inline_data || rec.inlineData); if (geminiInline?.data) { parts.push({ inlineData: { - mimeType: geminiInline.mime_type || geminiInline.mimeType || "application/pdf", - data: geminiInline.data.replace(/^data:[a-zA-Z0-9/+-]+;base64,/, ""), + mimeType: String( + geminiInline.mime_type || geminiInline.mimeType || "application/pdf" + ), + data: String(geminiInline.data).replace(/^data:[a-zA-Z0-9/+-]+;base64,/, ""), }, }); continue; } // 2. Handle Claude-style source blocks commonly used by AI clients - if (item.source?.type === "base64" && item.source?.data) { + const source = toRecord(rec.source); + if (source?.type === "base64" && source?.data) { parts.push({ inlineData: { - mimeType: item.source.media_type || "application/pdf", - data: item.source.data.replace(/^data:[a-zA-Z0-9/+-]+;base64,/, ""), + mimeType: String(source.media_type || "application/pdf"), + data: String(source.data).replace(/^data:[a-zA-Z0-9/+-]+;base64,/, ""), }, }); continue; } // 3. Handle raw data strings (e.g. {"type": "file", "data": "JVBER...", "mime_type": "..."}) - const rawDataStr = item.data || item.file?.data || item.document?.data; + const file = toRecord(rec.file); + const doc = toRecord(rec.document); + const rawDataStr = rec.data || file?.data || doc?.data; const mimeTypeFallback = - item.mime_type || - item.media_type || - item.file?.mime_type || - item.document?.mime_type || + rec.mime_type || + rec.media_type || + file?.mime_type || + doc?.mime_type || "application/octet-stream"; if (typeof rawDataStr === "string" && !rawDataStr.startsWith("http")) { const rawData = rawDataStr.replace(/^data:[a-zA-Z0-9/+-]+;base64,/, ""); parts.push({ inlineData: { - mimeType: mimeTypeFallback, + mimeType: String(mimeTypeFallback), data: rawData, }, }); @@ -142,8 +150,11 @@ export function convertOpenAIContentToParts(content: any) { } // 4. Standard OpenAI Data URIs - const fileData = - item.image_url?.url || item.file_url?.url || item.file?.url || item.document?.url; + const imageUrl = toRecord(rec.image_url); + const fileUrl = toRecord(rec.file_url); + const fileObj = toRecord(rec.file); + const docObj = toRecord(rec.document); + const fileData = imageUrl?.url || fileUrl?.url || fileObj?.url || docObj?.url; if (typeof fileData === "string" && fileData.startsWith("data:")) { const commaIndex = fileData.indexOf(","); if (commaIndex !== -1) { @@ -164,19 +175,20 @@ export function convertOpenAIContentToParts(content: any) { } // Extract text content from OpenAI content -export function extractTextContent(content) { +export function extractTextContent(content: unknown): string { if (typeof content === "string") return content; if (Array.isArray(content)) { return content + .map((item) => toRecord(item)) .filter((c) => c.type === "text") - .map((c) => c.text) + .map((c) => (typeof c.text === "string" ? c.text : "")) .join(""); } return ""; } // Try parse JSON safely -export function tryParseJSON(str) { +export function tryParseJSON(str: unknown): unknown { if (typeof str !== "string") return str; try { return JSON.parse(str); @@ -198,7 +210,7 @@ export function generateSessionId() { return `-${num.toString()}`; } -function cloneSchemaValue(value) { +function cloneSchemaValue(value: unknown): unknown { if (Array.isArray(value)) { return value.map((item) => cloneSchemaValue(item)); } @@ -210,18 +222,18 @@ function cloneSchemaValue(value) { return value; } -function toRecord(value) { - return value && typeof value === "object" && !Array.isArray(value) ? value : {}; +function toRecord(value: unknown): JsonRecord { + return value && typeof value === "object" && !Array.isArray(value) ? (value as JsonRecord) : {}; } -function decodeJsonPointerSegment(segment) { +function decodeJsonPointerSegment(segment: unknown): string { return String(segment).replace(/~1/g, "/").replace(/~0/g, "~"); } -function resolveLocalReference(root, ref) { +function resolveLocalReference(root: unknown, ref: unknown): unknown | null { if (typeof ref !== "string" || !ref.startsWith("#/")) return null; - let current = root; + let current: unknown = root; const segments = ref .slice(2) .split("/") @@ -229,16 +241,21 @@ function resolveLocalReference(root, ref) { .map((segment) => decodeJsonPointerSegment(segment)); for (const segment of segments) { - if (!current || typeof current !== "object" || !(segment in current)) { + const currentRecord = toRecord(current); + if (!(segment in currentRecord)) { return null; } - current = current[segment]; + current = currentRecord[segment]; } return current; } -function inlineLocalSchemaRefs(node, root, activeRefs = new Set()) { +function inlineLocalSchemaRefs( + node: unknown, + root: unknown, + activeRefs: Set<string> = new Set<string>() +): unknown { if (Array.isArray(node)) { return node.map((item) => inlineLocalSchemaRefs(item, root, activeRefs)); } @@ -247,7 +264,7 @@ function inlineLocalSchemaRefs(node, root, activeRefs = new Set()) { return node; } - const record = { ...node }; + const record: JsonRecord = { ...toRecord(node) }; const ref = typeof record.$ref === "string" ? record.$ref : ""; if (ref.startsWith("#/$defs/") || ref.startsWith("#/definitions/")) { const rest = { ...record }; @@ -280,7 +297,7 @@ function inlineLocalSchemaRefs(node, root, activeRefs = new Set()) { } // Helper: Remove unsupported keywords recursively from object/array -function removeUnsupportedKeywords(obj, keywords) { +function removeUnsupportedKeywords(obj: unknown, keywords: Set<string>): void { if (!obj || typeof obj !== "object") return; if (Array.isArray(obj)) { @@ -288,14 +305,15 @@ function removeUnsupportedKeywords(obj, keywords) { removeUnsupportedKeywords(item, keywords); } } else { + const record = obj as JsonRecord; // Delete unsupported keys at current level - for (const key of Object.keys(obj)) { + for (const key of Object.keys(record)) { if (keywords.has(key) || key.startsWith("x-")) { - delete obj[key]; + delete record[key]; } } // Recurse into remaining values - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { removeUnsupportedKeywords(value, keywords); } @@ -303,7 +321,7 @@ function removeUnsupportedKeywords(obj, keywords) { } } -function normalizeAdditionalProperties(obj) { +function normalizeAdditionalProperties(obj: unknown): void { if (!obj || typeof obj !== "object") return; if (Array.isArray(obj)) { @@ -313,14 +331,16 @@ function normalizeAdditionalProperties(obj) { return; } + const record = obj as JsonRecord; + // Gemini API does not support `additionalProperties` at all in function_declarations // schemas (returns 400 "Unknown name"). Since Gemini defaults to allowing additional // properties anyway, stripping it unconditionally is safe and prevents errors (#1421). - if ("additionalProperties" in obj) { - delete obj.additionalProperties; + if ("additionalProperties" in record) { + delete record.additionalProperties; } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { normalizeAdditionalProperties(value); } @@ -328,15 +348,16 @@ function normalizeAdditionalProperties(obj) { } // Convert const to enum -function convertConstToEnum(obj) { +function convertConstToEnum(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.const !== undefined && !obj.enum) { - obj.enum = [obj.const]; - delete obj.const; + const record = obj as JsonRecord; + if (record.const !== undefined && !record.enum) { + record.enum = [record.const]; + delete record.const; } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { convertConstToEnum(value); } @@ -345,22 +366,23 @@ function convertConstToEnum(obj) { // Convert enum values to strings (Gemini requires string enum values) // For integer types, remove enum entirely as Gemini doesn't support it -function convertEnumValuesToStrings(obj) { +function convertEnumValuesToStrings(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.enum && Array.isArray(obj.enum)) { + const record = obj as JsonRecord; + if (record.enum && Array.isArray(record.enum)) { // Gemini only supports enum for string types, not integer - if (obj.type === "integer" || obj.type === "number") { - delete obj.enum; + if (record.type === "integer" || record.type === "number") { + delete record.enum; } else { - obj.enum = obj.enum.map((v) => String(v)); - if (!obj.type) { - obj.type = "string"; + record.enum = record.enum.map((v: unknown) => String(v)); + if (!record.type) { + record.type = "string"; } } } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { convertEnumValuesToStrings(value); } @@ -368,33 +390,42 @@ function convertEnumValuesToStrings(obj) { } // Merge allOf schemas -function mergeAllOf(obj) { +function mergeAllOf(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.allOf && Array.isArray(obj.allOf)) { - const merged: { properties?: Record<string, unknown>; required?: string[] } = {}; + const record = obj as JsonRecord; + if (record.allOf && Array.isArray(record.allOf)) { + const merged: { properties?: JsonRecord; required?: string[] } = {}; - for (const item of obj.allOf) { - if (item.properties) { + for (const item of record.allOf) { + const itemRecord = toRecord(item); + const itemProperties = toRecord(itemRecord.properties); + if (Object.keys(itemProperties).length > 0) { if (!merged.properties) merged.properties = {}; - Object.assign(merged.properties, item.properties); + Object.assign(merged.properties, itemProperties); } - if (item.required && Array.isArray(item.required)) { + if (itemRecord.required && Array.isArray(itemRecord.required)) { if (!merged.required) merged.required = []; - for (const req of item.required) { - if (!merged.required.includes(req)) { + for (const req of itemRecord.required) { + if (typeof req === "string" && !merged.required.includes(req)) { merged.required.push(req); } } } } - delete obj.allOf; - if (merged.properties) obj.properties = { ...obj.properties, ...merged.properties }; - if (merged.required) obj.required = [...(obj.required || []), ...merged.required]; + delete record.allOf; + if (merged.properties) + record.properties = { ...toRecord(record.properties), ...merged.properties }; + if (merged.required) { + const required = Array.isArray(record.required) + ? record.required.filter((item): item is string => typeof item === "string") + : []; + record.required = [...required, ...merged.required]; + } } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { mergeAllOf(value); } @@ -402,12 +433,12 @@ function mergeAllOf(obj) { } // Select best schema from anyOf/oneOf -function selectBest(items) { +function selectBest(items: unknown[]): number { let bestIdx = 0; let bestScore = -1; for (let i = 0; i < items.length; i++) { - const item = items[i]; + const item = toRecord(items[i]); let score = 0; const type = item.type; @@ -429,30 +460,31 @@ function selectBest(items) { } // Flatten anyOf/oneOf -function flattenAnyOfOneOf(obj) { +function flattenAnyOfOneOf(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.anyOf && Array.isArray(obj.anyOf) && obj.anyOf.length > 0) { - const nonNullSchemas = obj.anyOf.filter((s) => s && s.type !== "null"); + const record = obj as JsonRecord; + if (record.anyOf && Array.isArray(record.anyOf) && record.anyOf.length > 0) { + const nonNullSchemas = record.anyOf.filter((s) => s && toRecord(s).type !== "null"); if (nonNullSchemas.length > 0) { const bestIdx = selectBest(nonNullSchemas); const selected = nonNullSchemas[bestIdx]; - delete obj.anyOf; - Object.assign(obj, selected); + delete record.anyOf; + Object.assign(record, toRecord(selected)); } } - if (obj.oneOf && Array.isArray(obj.oneOf) && obj.oneOf.length > 0) { - const nonNullSchemas = obj.oneOf.filter((s) => s && s.type !== "null"); + if (record.oneOf && Array.isArray(record.oneOf) && record.oneOf.length > 0) { + const nonNullSchemas = record.oneOf.filter((s) => s && toRecord(s).type !== "null"); if (nonNullSchemas.length > 0) { const bestIdx = selectBest(nonNullSchemas); const selected = nonNullSchemas[bestIdx]; - delete obj.oneOf; - Object.assign(obj, selected); + delete record.oneOf; + Object.assign(record, toRecord(selected)); } } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { flattenAnyOfOneOf(value); } @@ -460,15 +492,16 @@ function flattenAnyOfOneOf(obj) { } // Flatten type arrays -function flattenTypeArrays(obj) { +function flattenTypeArrays(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.type && Array.isArray(obj.type)) { - const nonNullTypes = obj.type.filter((t) => t !== "null"); - obj.type = nonNullTypes.length > 0 ? nonNullTypes[0] : "string"; + const record = obj as JsonRecord; + if (record.type && Array.isArray(record.type)) { + const nonNullTypes = record.type.filter((t) => t !== "null"); + record.type = nonNullTypes.length > 0 ? nonNullTypes[0] : "string"; } - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { flattenTypeArrays(value); } @@ -477,7 +510,7 @@ function flattenTypeArrays(obj) { // Clean JSON Schema for Antigravity API compatibility - removes unsupported keywords recursively // Reference: CLIProxyAPI/internal/util/gemini_schema.go -export function cleanJSONSchemaForAntigravity(schema) { +export function cleanJSONSchemaForAntigravity(schema: unknown): unknown { if (!schema || typeof schema !== "object") return schema; const root = cloneSchemaValue(schema); @@ -499,22 +532,25 @@ export function cleanJSONSchemaForAntigravity(schema) { removeUnsupportedKeywords(cleaned, GEMINI_UNSUPPORTED_SCHEMA_KEYS); // Phase 5: Cleanup required fields recursively. - function cleanupRequired(obj) { + function cleanupRequired(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.required && Array.isArray(obj.required) && obj.properties) { - const validRequired = obj.required.filter((field) => - Object.prototype.hasOwnProperty.call(obj.properties, field) + const record = obj as JsonRecord; + if (record.required && Array.isArray(record.required) && record.properties) { + const properties = toRecord(record.properties); + const validRequired = record.required.filter( + (field) => + typeof field === "string" && Object.prototype.hasOwnProperty.call(properties, field) ); if (validRequired.length === 0) { - delete obj.required; + delete record.required; } else { - obj.required = validRequired; + record.required = validRequired; } } // Recurse into nested objects - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { cleanupRequired(value); } @@ -524,23 +560,24 @@ export function cleanJSONSchemaForAntigravity(schema) { cleanupRequired(cleaned); // Phase 6: Add placeholder for empty object schemas (Antigravity requirement). - function addPlaceholders(obj) { + function addPlaceholders(obj: unknown): void { if (!obj || typeof obj !== "object") return; - if (obj.type === "object") { - if (!obj.properties || Object.keys(obj.properties).length === 0) { - obj.properties = { + const record = obj as JsonRecord; + if (record.type === "object") { + if (!record.properties || Object.keys(toRecord(record.properties)).length === 0) { + record.properties = { reason: { type: "string", description: "Brief explanation of why you are calling this tool", }, }; - obj.required = ["reason"]; + record.required = ["reason"]; } } // Recurse into nested objects - for (const value of Object.values(obj)) { + for (const value of Object.values(record)) { if (value && typeof value === "object") { addPlaceholders(value); } diff --git a/open-sse/translator/helpers/geminiToolsSanitizer.ts b/open-sse/translator/helpers/geminiToolsSanitizer.ts index d76f23cf7c..3ed55b880a 100644 --- a/open-sse/translator/helpers/geminiToolsSanitizer.ts +++ b/open-sse/translator/helpers/geminiToolsSanitizer.ts @@ -209,19 +209,15 @@ export function buildGeminiTools( } } - if (googleSearchTool && functionDeclarations.length > 0) { - console.warn( - `[GeminiTools] Removing ${functionDeclarations.length} functionDeclarations because googleSearch cannot be mixed with Gemini function tools` - ); - } + const result: GeminiTool[] = []; if (googleSearchTool) { return [googleSearchTool]; } if (functionDeclarations.length > 0) { - return [{ functionDeclarations }]; + result.push({ functionDeclarations }); } - return undefined; + return result.length > 0 ? result : undefined; } diff --git a/open-sse/translator/helpers/schemaCoercion.ts b/open-sse/translator/helpers/schemaCoercion.ts index 17030c1703..aa503c1d76 100644 --- a/open-sse/translator/helpers/schemaCoercion.ts +++ b/open-sse/translator/helpers/schemaCoercion.ts @@ -1,3 +1,5 @@ +import { isDeepSeekReasoningModel } from "../../services/reasoningCache.ts"; + /** * Shared sanitizers for tool payloads that arrive from IDEs/SDKs with * JSON Schema numeric constraints encoded as strings or invalid descriptions. @@ -196,9 +198,17 @@ export function sanitizeToolId(id: string | undefined): string { export function injectEmptyReasoningContentForToolCalls( messages: unknown, - provider: unknown + provider: unknown, + model: unknown ): unknown { - if (!Array.isArray(messages) || String(provider || "").toLowerCase() !== "deepseek") { + if ( + !Array.isArray(messages) || + !isDeepSeekReasoningModel({ + provider: String(provider ?? ""), + model: String(model ?? ""), + thinkingEnabled: true, + }) + ) { return messages; } diff --git a/open-sse/translator/helpers/toolCallShim.ts b/open-sse/translator/helpers/toolCallShim.ts new file mode 100644 index 0000000000..94ebfece01 --- /dev/null +++ b/open-sse/translator/helpers/toolCallShim.ts @@ -0,0 +1,67 @@ +// Defensive shims for tool calls whose strict-schema fields can be malformed +// by upstream models (e.g. MiMo emitting empty objects/strings instead of +// arrays for Capy's submit_pr_review). +// +// Applied on the assembled OpenAI tool-call arguments after streaming, just +// before they are re-emitted as a single Claude input_json_delta. +// +// To add a new shim: register a (input) => input transformer in TOOL_SHIMS +// keyed by the tool name. The transformer must accept arbitrary input and +// return a JSON-safe value. + +type ShimFn = (input: unknown) => unknown; + +function coerceToArray(v: unknown): unknown[] { + if (Array.isArray(v)) return v; + if (v == null) return []; + if (typeof v === "string") { + if (v === "") return []; + try { + const parsed = JSON.parse(v); + return Array.isArray(parsed) ? parsed : []; + } catch { + return []; + } + } + // Plain object or other non-array → empty + return []; +} + +const TOOL_SHIMS: Record<string, ShimFn> = { + submit_pr_review: (input) => { + if (typeof input !== "object" || input === null || Array.isArray(input)) return input; + const patched = { ...(input as Record<string, unknown>) }; + for (const key of ["functionalChanges", "findings"]) { + patched[key] = coerceToArray(patched[key]); + } + return patched; + }, +}; + +export function hasToolCallShim(name: string | undefined | null): boolean { + return typeof name === "string" && Object.prototype.hasOwnProperty.call(TOOL_SHIMS, name); +} + +/** + * Apply the registered shim for a tool call's raw assembled arguments string. + * Returns a stringified JSON value safe to emit as input_json_delta.partial_json. + * If the buffer is unparseable, returns the empty-object JSON `{}` after applying + * the shim with `{}` as input (so required arrays still get injected). + */ +export function applyToolCallShimToBuffer(name: string, raw: string): string { + const shim = TOOL_SHIMS[name]; + if (!shim) return raw; + + let parsed: unknown; + try { + parsed = raw && raw.length > 0 ? JSON.parse(raw) : {}; + } catch { + parsed = {}; + } + + const patched = shim(parsed); + return JSON.stringify(patched); +} + +// Exposed for unit tests only. +export const __test = { coerceToArray, TOOL_SHIMS }; diff --git a/open-sse/translator/index.ts b/open-sse/translator/index.ts index 41f434fa06..49fb8add0e 100644 --- a/open-sse/translator/index.ts +++ b/open-sse/translator/index.ts @@ -9,8 +9,9 @@ import { } from "./helpers/schemaCoercion.ts"; import { getRequestTranslator, getResponseTranslator } from "./registry.ts"; import { bootstrapTranslatorRegistry } from "./bootstrap.ts"; -import { normalizeThinkingConfig } from "../services/provider.ts"; +import { hasThinkingConfig, normalizeThinkingConfig } from "../services/provider.ts"; import { applyThinkingBudget } from "../services/thinkingBudget.ts"; +import { supportsReasoning } from "../services/modelCapabilities.ts"; import { normalizeRoles } from "../services/roleNormalizer.ts"; import { lookupReasoning, @@ -76,6 +77,43 @@ function normalizeOpenAIResponsesRequest(body) { return normalized; } +function getReasoningCacheRequestId(body: Record<string, unknown> | null | undefined): string { + if (!body || typeof body !== "object") return ""; + + const requestId = + body._reasoningCacheRequestId ?? + body.reasoningCacheRequestId ?? + body.request_id ?? + body.requestId; + return typeof requestId === "string" ? requestId.trim() : ""; +} + +function getAssistantMessageCacheKey( + body: Record<string, unknown> | null | undefined, + messageIndex: number +): string { + const requestId = getReasoningCacheRequestId(body); + return requestId ? `request:${requestId}:message:${messageIndex}` : ""; +} + +function hasNonEmptyReasoningContent(message: Record<string, unknown>): boolean { + return typeof message.reasoning_content === "string" && message.reasoning_content.length > 0; +} + +function hasReasoningContentField(message: Record<string, unknown>): boolean { + return Object.prototype.hasOwnProperty.call(message, "reasoning_content"); +} + +function isDeepSeekReplayTarget(provider: unknown, model: unknown): boolean { + const normalizedProvider = String(provider ?? "") + .trim() + .toLowerCase(); + const normalizedModel = String(model ?? "") + .trim() + .toLowerCase(); + return normalizedProvider === "deepseek" || normalizedModel.includes("deepseek"); +} + /** @param options.normalizeToolCallId - When true, use 9-char tool call ids (e.g. Mistral); when false, leave ids as-is */ /** @param options.preserveDeveloperRole - undefined/true: keep developer for OpenAI format (default); false: map to system */ /** @param options.preserveCacheControl - When true, preserve client-side cache_control markers (for Claude Code, etc.) */ @@ -197,7 +235,7 @@ export function translateRequest( } if (targetFormat === FORMATS.OPENAI && result.messages && Array.isArray(result.messages)) { - result.messages = injectEmptyReasoningContentForToolCalls(result.messages, provider); + result.messages = injectEmptyReasoningContentForToolCalls(result.messages, provider, model); } // Ensure unique tool_call ids on final payload (translators may have introduced duplicates) @@ -214,30 +252,46 @@ export function translateRequest( // clients omit it from the conversation history. Without this, DeepSeek V4 // returns 400: "The reasoning_content in the thinking mode must be passed // back to the API." - const isReasoner = requiresReasoningReplay(String(provider ?? ""), String(model ?? "")); + const normalizedProvider = String(provider ?? ""); + const normalizedModel = String(model ?? ""); + const isReasoner = requiresReasoningReplay({ + provider: normalizedProvider, + model: normalizedModel, + thinkingEnabled: hasThinkingConfig(result), + supportsReasoning: supportsReasoning({ provider: normalizedProvider, model: normalizedModel }), + }); if (isReasoner && result.messages && Array.isArray(result.messages)) { - for (const msg of result.messages) { - if (msg.role === "assistant" && Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0) { - // Skip if client already provided real reasoning_content - if (typeof msg.reasoning_content === "string" && msg.reasoning_content.length > 0) { + const canReplayReasoningOnly = isDeepSeekReplayTarget(normalizedProvider, normalizedModel); + + for (const [messageIndex, msg] of result.messages.entries()) { + if (msg.role !== "assistant") continue; + + const hasToolCalls = Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0; + const shouldReplayReasoningOnly = + !hasToolCalls && canReplayReasoningOnly && hasReasoningContentField(msg); + + if (!hasToolCalls && !shouldReplayReasoningOnly) continue; + + // Skip if client already provided real reasoning_content + if (hasNonEmptyReasoningContent(msg)) { + continue; + } + + const cacheKey = hasToolCalls + ? msg.tool_calls[0]?.id + : getAssistantMessageCacheKey(result, 0); + if (cacheKey) { + const cached = lookupReasoning(cacheKey); + if (cached) { + msg.reasoning_content = cached; + recordReplay(); continue; } + } - // Try cache lookup using first tool_call ID - const firstToolId = msg.tool_calls[0]?.id; - if (firstToolId) { - const cached = lookupReasoning(firstToolId); - if (cached) { - msg.reasoning_content = cached; - recordReplay(); - continue; - } - } - - // Legacy fallback — empty string (works for older DeepSeek versions) - if (msg.reasoning_content === undefined) { - msg.reasoning_content = ""; - } + // Legacy fallback — empty string (works for older DeepSeek versions) + if (hasToolCalls && msg.reasoning_content === undefined) { + msg.reasoning_content = ""; } } } else if ( diff --git a/open-sse/translator/request/openai-responses.ts b/open-sse/translator/request/openai-responses.ts index aa9a981a5a..6d72f1f5f0 100644 --- a/open-sse/translator/request/openai-responses.ts +++ b/open-sse/translator/request/openai-responses.ts @@ -77,13 +77,28 @@ export function openaiResponsesToOpenAIRequest( } } - if (root.background) { - throw unsupportedFeature( - "Unsupported Responses API feature: background mode is not supported by omniroute" + const result: JsonRecord = { ...root }; + + // background: true requests a deferred Responses API run (the upstream + // returns 202 with response_id and the client polls GET /responses/<id>). + // OmniRoute is a forward proxy that streams responses synchronously — + // implementing the queue/poll contract would require persistence and a + // separate retrieval surface. Degrade: log a marker when true was + // actually requested (operators can observe clients that should be + // reconfigured) and strip the flag. Clients that set background=true + // opportunistically (Capy Captain Pro, Codex agents) work unchanged. + // Clients that strictly require the async contract still observe a + // completed response on the first poll and can adapt. + if (result.background === true) { + const providerStr = toString(credentialRecord.provider); + const modelStr = toString(model); + console.warn( + `BACKGROUND_DEGRADE provider=${providerStr || "unknown"} model=${modelStr || "unknown"}` ); } - - const result: JsonRecord = { ...root }; + if (result.background !== undefined) { + delete result.background; + } const messages: JsonRecord[] = []; result.messages = messages; @@ -568,6 +583,14 @@ export function openaiToOpenAIResponsesRequest( result.reasoning = { effort }; } } + + // Propagate Responses-API-only fields when a chat client sent them. + // Without this, e.g. `include: ["reasoning.encrypted_content"]` is lost on + // the way upstream and Codex returns an empty reasoning summary, so clients + // (OpenCode, Cursor, etc.) see no thinking stream. + if (Array.isArray(root.include) && root.include.length > 0) { + result.include = root.include; + } if (storeEnabled) { if (root[RESPONSES_STORE_MARKER] !== undefined) { result.store = root[RESPONSES_STORE_MARKER]; diff --git a/open-sse/translator/request/openai-to-claude.ts b/open-sse/translator/request/openai-to-claude.ts index 14bccca754..50f2973bb7 100644 --- a/open-sse/translator/request/openai-to-claude.ts +++ b/open-sse/translator/request/openai-to-claude.ts @@ -1,6 +1,6 @@ import { register } from "../registry.ts"; import { FORMATS } from "../formats.ts"; -import { CLAUDE_SYSTEM_PROMPT } from "../../config/constants.ts"; +// CLAUDE_SYSTEM_PROMPT import removed — no longer injected unconditionally (#1966/#2130) import { supportsXHighEffort } from "../../config/providerModels.ts"; import { adjustMaxTokens } from "../helpers/maxTokensHelper.ts"; import { sanitizeToolId } from "../helpers/schemaCoercion.ts"; @@ -313,11 +313,29 @@ export function openaiToClaudeRequest(model, body, stream) { } // System messages and cache_control + // Fix #2130: Preserve body.system when present (Claude Code sends system as native + // Anthropic array through the /chat/completions endpoint). Without this, the system + // prompt is silently dropped when no role="system" messages exist in body.messages. if (systemParts.length > 0) { const systemText = systemParts.join("\n"); - result.system = [ - { type: "text", text: systemText, cache_control: { type: "ephemeral", ttl: "1h" } }, - ]; + const systemBlock = { + type: "text", + text: systemText, + cache_control: { type: "ephemeral", ttl: "1h" }, + }; + // Merge with existing body.system if present + if (Array.isArray(body.system)) { + result.system = [...body.system, systemBlock]; + } else if (typeof body.system === "string" && body.system.length > 0) { + result.system = [{ type: "text", text: body.system }, systemBlock]; + } else { + result.system = [systemBlock]; + } + } else if (body.system) { + // No role="system" messages, but body.system exists — pass through as-is + result.system = Array.isArray(body.system) + ? body.system + : [{ type: "text", text: String(body.system) }]; } // Thinking configuration diff --git a/open-sse/translator/request/openai-to-gemini.ts b/open-sse/translator/request/openai-to-gemini.ts index abdd49d133..1d4d016826 100644 --- a/open-sse/translator/request/openai-to-gemini.ts +++ b/open-sse/translator/request/openai-to-gemini.ts @@ -547,6 +547,10 @@ export function openaiToAntigravityRequest(model, body, stream, credentials = nu // Match real Antigravity client: don't send maxOutputTokens when the user // hasn't explicitly specified max_tokens / max_completion_tokens. // The Cloud Code server decides the output limit on its own. + // Note: read hasThinking BEFORE stripping thinkingConfig below — for Claude + // models the Cloud Code envelope still carries a thinkingBudget set upstream + // by applyAntigravityGenerationDefaults, which we must consult here so we + // do not accidentally drop the maxOutputTokens it bumped for us. const clientRequestedMaxTokens = body.max_tokens ?? body.max_completion_tokens; const hasThinking = !!envelope.request?.generationConfig?.thinkingConfig?.thinkingBudget; if ( @@ -557,6 +561,16 @@ export function openaiToAntigravityRequest(model, body, stream, credentials = nu delete envelope.request.generationConfig.maxOutputTokens; } + // Claude models on Antigravity use their own native thinking — Gemini's thinkingConfig + // is not understood by the Cloud Code Claude endpoint and must be stripped. + // applyAntigravityGenerationDefaults (inside wrapInCloudCodeEnvelope) already bumped + // maxOutputTokens to thinkingBudget+1 before we get here, so the budget is preserved. + // Must run AFTER the hasThinking-derived maxOutputTokens decision above so the + // budget is accounted for before the field is removed. + if (isClaude && envelope.request?.generationConfig) { + delete envelope.request.generationConfig.thinkingConfig; + } + return envelope; } diff --git a/open-sse/translator/request/openai-to-kiro.ts b/open-sse/translator/request/openai-to-kiro.ts index 1eb87198dc..a558579f33 100644 --- a/open-sse/translator/request/openai-to-kiro.ts +++ b/open-sse/translator/request/openai-to-kiro.ts @@ -53,7 +53,9 @@ function convertMessages(messages, tools, model) { let pendingUserContent = []; let pendingAssistantContent = []; let pendingToolResults = []; + let pendingImages: Array<{ format: string; source: { bytes: string } }> = []; let currentRole = null; + let toolsAttached = false; const flushPending = () => { if (currentRole === "user") { @@ -62,11 +64,13 @@ function convertMessages(messages, tools, model) { userInputMessage: { content: string; modelId: string; + images?: Array<{ format: string; source: { bytes: string } }>; userInputMessageContext?: { toolResults?: Array<Record<string, unknown>>; tools?: Array<Record<string, unknown>>; }; }; + _toolDocs?: string; } = { userInputMessage: { content: content, @@ -80,11 +84,24 @@ function convertMessages(messages, tools, model) { }; } - // Add tools to first user message - if (tools && tools.length > 0 && history.length === 0) { + // Attach images to userInputMessage (NOT userInputMessageContext) + if (pendingImages.length > 0) { + userMsg.userInputMessage.images = pendingImages; + } + + // Add tools to the first emitted user turn. We track a flag instead of + // relying on `history.length === 0` because the first few messages may + // be assistant turns (e.g. when role=undefined collapses to a prior + // assistant turn), in which case the first user flush would already see + // a non-empty history and lose the tools schema. + if (tools && tools.length > 0 && !toolsAttached) { if (!userMsg.userInputMessage.userInputMessageContext) { userMsg.userInputMessage.userInputMessageContext = {}; } + // Kiro API rejects requests with tool descriptions > ~10000 chars. + // Move long descriptions to system prompt (same approach as kiro-gateway). + const TOOL_DESC_MAX = 10000; + const toolDocs: string[] = []; userMsg.userInputMessage.userInputMessageContext.tools = tools.map((t) => { const name = t.function?.name || t.name; let description = t.function?.description || t.description || ""; @@ -93,6 +110,11 @@ function convertMessages(messages, tools, model) { description = `Tool: ${name}`; } + if (description.length > TOOL_DESC_MAX) { + toolDocs.push(`## Tool: ${name}\n\n${description}`); + description = `[Full documentation in system prompt under '## Tool: ${name}']`; + } + return { toolSpecification: { name, @@ -105,12 +127,18 @@ function convertMessages(messages, tools, model) { }, }; }); + // Attach tool docs to message so buildKiroPayload can prepend to content + if (toolDocs.length > 0) { + userMsg._toolDocs = toolDocs.join("\n\n---\n\n"); + } + toolsAttached = true; } history.push(userMsg); currentMessage = userMsg; pendingUserContent = []; pendingToolResults = []; + pendingImages = []; } else if (currentRole === "assistant") { const content = pendingAssistantContent.join("\n\n").trim() || "..."; const assistantMsg = { @@ -149,6 +177,24 @@ function convertMessages(messages, tools, model) { .map((c) => c.text || ""); content = textParts.join("\n"); + // Extract images (OpenAI image_url and Anthropic image formats) + for (const block of msg.content) { + if (block.type === "image_url") { + const url: string = block.image_url?.url || ""; + if (url.startsWith("data:")) { + // data:image/jpeg;base64,<data> + const [header, bytes] = url.split(",", 2); + const mediaType = header.split(";")[0].replace("data:", ""); // e.g. "image/jpeg" + const format = mediaType.split("/")[1] || "jpeg"; + if (bytes) pendingImages.push({ format, source: { bytes } }); + } + } else if (block.type === "image" && block.source?.type === "base64") { + const format = (block.source.media_type || "image/jpeg").split("/")[1] || "jpeg"; + if (block.source.data) + pendingImages.push({ format, source: { bytes: block.source.data } }); + } + } + // Check for tool_result blocks const toolResultBlocks = msg.content.filter((c) => c.type === "tool_result"); if (toolResultBlocks.length > 0) { @@ -258,16 +304,51 @@ function convertMessages(messages, tools, model) { }; } - const firstHistoryItem = history[0]; + // Promote the tools schema to currentMessage. Tools may have been attached + // to any user turn in history (e.g. when the first message was assistant or + // had an undefined role, the first user flush lands further down). Scan the + // whole history so we never lose the schema. + if (!currentMessage?.userInputMessage?.userInputMessageContext?.tools) { + const carrier = history.find((item) => item?.userInputMessage?.userInputMessageContext?.tools); + if (carrier?.userInputMessage?.userInputMessageContext?.tools) { + if (!currentMessage.userInputMessage.userInputMessageContext) { + currentMessage.userInputMessage.userInputMessageContext = {}; + } + currentMessage.userInputMessage.userInputMessageContext.tools = + carrier.userInputMessage.userInputMessageContext.tools; + } + } + + // Fallback: if the schema was never attached to any user turn (e.g. the + // input contained no user messages and currentMessage is a synthesized + // "Continue" turn), attach the provided tools directly to currentMessage so + // Kiro still sees the schema it needs to validate assistant.toolUses in + // history. if ( - firstHistoryItem?.userInputMessage?.userInputMessageContext?.tools && + !toolsAttached && + tools && + tools.length > 0 && !currentMessage?.userInputMessage?.userInputMessageContext?.tools ) { if (!currentMessage.userInputMessage.userInputMessageContext) { currentMessage.userInputMessage.userInputMessageContext = {}; } - currentMessage.userInputMessage.userInputMessageContext.tools = - firstHistoryItem.userInputMessage.userInputMessageContext.tools; + currentMessage.userInputMessage.userInputMessageContext.tools = tools.map((t) => { + const name = t.function?.name || t.name; + const description = t.function?.description || t.description || `Tool: ${name}`; + return { + toolSpecification: { + name, + description, + inputSchema: { + json: normalizeKiroToolSchema( + t.function?.parameters || t.parameters || t.input_schema || {} + ), + }, + }, + }; + }); + toolsAttached = true; } // Clean up history for Kiro API compatibility @@ -331,20 +412,74 @@ function convertMessages(messages, tools, model) { } } - return { history: mergedHistory, currentMessage }; + return { history: mergedHistory, currentMessage, toolsAttached }; } /** * Build Kiro payload from OpenAI format */ export function buildKiroPayload(model, body, stream, credentials) { + // Normalize model name: Claude Code sends dashes (claude-sonnet-4-6), + // Kiro API expects dots (claude-sonnet-4.6). Convert trailing version segment. + const normalizedModel = model.replace( + /^(claude-(?:opus|sonnet|haiku|3-\d+)-\d+)-(\d+)$/, + "$1.$2" + ); const messages = body.messages || []; - const tools = body.tools || []; + let tools = body.tools || []; const maxTokens = body.max_tokens ?? body.max_completion_tokens ?? 32000; const temperature = body.temperature; const topP = body.top_p; - const { history, currentMessage } = convertMessages(messages, tools, model); + // Kiro rejects history that references toolUses/toolResults without a tools + // schema in userInputMessageContext. When callers omit body.tools but the + // message history still contains assistant.tool_calls / role=tool turns, + // synthesize a minimal tool schema from the tool names present in history + // so Kiro accepts the request instead of returning `Improperly formed + // request`. This preserves tool-call history and is a no-op when body.tools + // is already populated. + if (tools.length === 0) { + const seen = new Set<string>(); + const synthesized: Array<Record<string, unknown>> = []; + const pushName = (name: unknown) => { + if (typeof name === "string" && name && !seen.has(name)) { + seen.add(name); + synthesized.push({ + type: "function", + function: { + name, + description: `Tool: ${name}`, + parameters: { type: "object", properties: {}, required: [] }, + }, + }); + } + }; + for (const msg of messages) { + if (msg?.role !== "assistant") continue; + if (Array.isArray(msg.tool_calls)) { + for (const tc of msg.tool_calls) { + pushName(tc?.function?.name || tc?.name); + } + } + // Anthropic-style assistant blocks: content:[{type:"tool_use", name, ...}] + if (Array.isArray(msg.content)) { + for (const block of msg.content) { + if (block?.type === "tool_use") { + pushName(block.name); + } + } + } + } + if (synthesized.length > 0) { + tools = synthesized; + } + } + + const { history, currentMessage, toolsAttached } = convertMessages( + messages, + tools, + normalizedModel + ); const profileArn = credentials?.providerSpecificData?.profileArn || ""; @@ -352,6 +487,12 @@ export function buildKiroPayload(model, body, stream, credentials) { const timestamp = new Date().toISOString(); finalContent = `[Context: Current time is ${timestamp}]\n\n${finalContent}`; + // Prepend tool documentation for tools with long descriptions (moved from toolSpecification) + const toolDocs = (currentMessage as { _toolDocs?: string } | null)?._toolDocs; + if (toolDocs) { + finalContent = `# Tool Documentation\n\n${toolDocs}\n\n---\n\n${finalContent}`; + } + const payload: { conversationState: { chatTriggerType: string; @@ -361,6 +502,7 @@ export function buildKiroPayload(model, body, stream, credentials) { content: string; modelId: string; origin: string; + images?: Array<{ format: string; source: { bytes: string } }>; userInputMessageContext?: Record<string, unknown>; }; }; @@ -379,8 +521,11 @@ export function buildKiroPayload(model, body, stream, credentials) { currentMessage: { userInputMessage: { content: finalContent, - modelId: model, + modelId: normalizedModel, origin: "AI_EDITOR", + ...(currentMessage?.userInputMessage?.images?.length && { + images: currentMessage.userInputMessage.images, + }), ...(currentMessage?.userInputMessage?.userInputMessageContext && { userInputMessageContext: currentMessage.userInputMessage.userInputMessageContext, }), diff --git a/open-sse/translator/response/openai-responses.ts b/open-sse/translator/response/openai-responses.ts index 07ff889385..a5b5ceafdf 100644 --- a/open-sse/translator/response/openai-responses.ts +++ b/open-sse/translator/response/openai-responses.ts @@ -823,13 +823,18 @@ export function openaiResponsesToOpenAIResponse(chunk, state) { }; } - // Handle true reasoning summary ("Thought for 15s") + // Handle true reasoning summary ("Thought for 15s"). + // Emit as `delta.reasoning_content` — matches the shape used by the + // `reasoning_content_text.delta` branch above and is what Chat clients + // (OpenCode, Claude Code, Cursor, etc.) actually render in their thinking + // panel. A nested `delta.reasoning.summary` object is swallowed by most + // stream mergers and never reaches the user. if (eventType === "response.reasoning_summary_text.delta") { const reasoningDelta = data.delta || ""; if (!reasoningDelta) return null; const reasoningDeltaShape = state.copilotCompatibleReasoning ? { reasoning_text: reasoningDelta } - : { reasoning: { summary: reasoningDelta } }; + : { reasoning_content: reasoningDelta }; return { id: state.chatId, object: "chat.completion.chunk", diff --git a/open-sse/translator/response/openai-to-claude.ts b/open-sse/translator/response/openai-to-claude.ts index 801594f01e..2dfa246d2d 100644 --- a/open-sse/translator/response/openai-to-claude.ts +++ b/open-sse/translator/response/openai-to-claude.ts @@ -1,6 +1,7 @@ import { register } from "../registry.ts"; import { FORMATS } from "../formats.ts"; import { CLAUDE_OAUTH_TOOL_PREFIX } from "../request/openai-to-claude.ts"; +import { hasToolCallShim, applyToolCallShimToBuffer } from "../helpers/toolCallShim.ts"; // Helper: stop thinking block if started function stopThinkingBlock(state, results) { @@ -157,11 +158,6 @@ export function openaiToClaudeResponse(chunk, state) { stopTextBlock(state, results); const toolBlockIndex = state.nextBlockIndex++; - state.toolCalls.set(idx, { - id: tc.id, - name: tc.function?.name || "", - blockIndex: toolBlockIndex, - }); // Strip prefix from tool name for response let toolName = tc.function?.name || ""; @@ -169,6 +165,16 @@ export function openaiToClaudeResponse(chunk, state) { toolName = toolName.slice(CLAUDE_OAUTH_TOOL_PREFIX.length); } + state.toolCalls.set(idx, { + id: tc.id, + name: toolName, + blockIndex: toolBlockIndex, + // Shimmed tools buffer their raw args and emit a single corrected + // input_json_delta at content_block_stop time (see finish handler). + shimmed: hasToolCallShim(toolName), + argBuffer: "", + }); + results.push({ type: "content_block_start", index: toolBlockIndex, @@ -184,6 +190,15 @@ export function openaiToClaudeResponse(chunk, state) { if (tc.function?.arguments) { const toolInfo = state.toolCalls.get(idx); if (toolInfo) { + // Always buffer the raw stream so shimmed tools can re-emit a + // corrected JSON at stop time. + toolInfo.argBuffer = (toolInfo.argBuffer || "") + tc.function.arguments; + + if (toolInfo.shimmed) { + // Suppress passthrough; we emit one corrective delta at finish. + continue; + } + let deltaStr = tc.function.arguments; // Fix #1852: Strip empty string and array placeholders from streaming tool arguments @@ -211,6 +226,17 @@ export function openaiToClaudeResponse(chunk, state) { stopTextBlock(state, results); for (const [, toolInfo] of state.toolCalls) { + // For shimmed tools, emit one corrective input_json_delta with the + // fully patched JSON before closing the block. + if (toolInfo.shimmed) { + const patched = applyToolCallShimToBuffer(toolInfo.name, toolInfo.argBuffer || ""); + results.push({ + type: "content_block_delta", + index: toolInfo.blockIndex, + delta: { type: "input_json_delta", partial_json: patched }, + }); + } + results.push({ type: "content_block_stop", index: toolInfo.blockIndex, diff --git a/open-sse/utils/error.ts b/open-sse/utils/error.ts index 410b876ef6..9ad0bd3965 100644 --- a/open-sse/utils/error.ts +++ b/open-sse/utils/error.ts @@ -8,6 +8,14 @@ import type { ModelCooldownErrorPayload } from "@/types"; * Strips stack traces and internal file paths from error messages before they * reach the client. */ +interface ErrorResponseBody { + error: { + message: string; + type?: string; + code?: string; + }; +} + function sanitizeErrorMessage(message: unknown): string { const str = typeof message === "string" ? message : String(message ?? ""); // If the message contains a stack trace (lines starting with " at "), @@ -22,7 +30,7 @@ function sanitizeErrorMessage(message: unknown): string { * @param {string} message - Error message * @returns {object} Error response object */ -export function buildErrorBody(statusCode, message) { +export function buildErrorBody(statusCode: number, message: string): ErrorResponseBody { const errorInfo = getErrorInfo(statusCode); return { @@ -56,7 +64,7 @@ export function errorResponse(statusCode, message) { * @param {string} message - Error message */ export async function writeStreamError(writer, statusCode, message) { - const errorBody = buildErrorBody(statusCode, message); + const errorBody = buildErrorBody(statusCode, sanitizeErrorMessage(message)); const encoder = new TextEncoder(); await writer.write(encoder.encode(`data: ${JSON.stringify(errorBody)}\n\n`)); } @@ -129,6 +137,8 @@ export async function parseUpstreamError(response, provider = null) { let message = ""; let retryAfterMs = null; let responseBody = null; + let errorCode = undefined; + let errorType = undefined; try { const text = await response.text(); @@ -138,6 +148,8 @@ export async function parseUpstreamError(response, provider = null) { try { const json = JSON.parse(text); message = json.error?.message || json.message || json.error || text; + errorCode = json.error?.code || json.code; + errorType = json.error?.type || json.type; } catch { message = text; } @@ -192,6 +204,8 @@ export async function parseUpstreamError(response, provider = null) { return { statusCode: response.status, message: messageStr, + errorCode, + errorType, retryAfterMs, responseBody, responseHeaders, @@ -208,19 +222,34 @@ export async function parseUpstreamError(response, provider = null) { export function createErrorResult( statusCode: number, message: string, - retryAfterMs: number | null = null + retryAfterMs: number | null = null, + errorCode?: string, + errorType?: string ) { + const body = buildErrorBody(statusCode, message); + if (errorCode) { + body.error.code = errorCode; + } + if (errorType) { + body.error.type = errorType; + } + const result: { success: false; status: number; error: string; + errorType?: string; response: Response; retryAfterMs?: number; } = { success: false, status: statusCode, error: message, - response: errorResponse(statusCode, message), + errorType, + response: new Response(JSON.stringify(body), { + status: statusCode, + headers: { "Content-Type": "application/json" }, + }), }; // Add retryAfterMs if available (for Antigravity quota errors) diff --git a/open-sse/utils/logger.ts b/open-sse/utils/logger.ts index cb2528b12e..0b56430d31 100644 --- a/open-sse/utils/logger.ts +++ b/open-sse/utils/logger.ts @@ -185,5 +185,6 @@ export function createLogger(requestId: string | null = null): RequestScopedLogg * Module-level default logger (no requestId — for startup/config messages). */ export const defaultLogger = createLogger(); +export const log = defaultLogger; export default logger; diff --git a/open-sse/utils/proxyFetch.ts b/open-sse/utils/proxyFetch.ts index 96c581eae3..ddb4e59d20 100644 --- a/open-sse/utils/proxyFetch.ts +++ b/open-sse/utils/proxyFetch.ts @@ -25,6 +25,12 @@ type FetchWithDispatcher = ( init?: FetchWithDispatcherOptions ) => Promise<Response>; +/** Injectable dependencies for testability (Approach B DI). */ +export type ProxyFetchDeps = { + undiciFetch?: FetchWithDispatcher; + nativeFetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>; +}; + type PatchState = { originalFetch: typeof globalThis.fetch; proxyContext: AsyncLocalStorage<unknown>; @@ -133,7 +139,7 @@ function resolveEnvProxyUrl(targetUrl) { return normalizeProxyUrl(proxyUrl, "environment proxy"); } -function resolveProxyForRequest(targetUrl) { +export function resolveProxyForRequest(targetUrl) { let target; try { target = new URL(targetUrl); @@ -202,12 +208,18 @@ export async function runWithProxyContext(proxyConfig, fn) { }); } -async function patchedFetch(input: RequestInfo | URL, options: FetchWithDispatcherOptions = {}) { +async function patchedFetch( + input: RequestInfo | URL, + options: FetchWithDispatcherOptions = {}, + deps: ProxyFetchDeps = {} +) { if (options?.dispatcher) { // When a dispatcher is present, we MUST use the undici library fetch // to ensure version compatibility. Node 22 built-in fetch (undici v6) // is incompatible with undici v8 dispatchers (missing onRequestStart, etc.) - return (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>)(input, options); + const _undiciDispatcher = + deps.undiciFetch ?? (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>); + return _undiciDispatcher(input, options); } const targetUrl = getTargetUrl(input); @@ -243,34 +255,78 @@ async function patchedFetch(input: RequestInfo | URL, options: FetchWithDispatch } // Direct connection (no proxy) — use undici with custom dispatcher for timeout control. // Falls back to original native fetch if dispatcher initialization fails (#1054). - try { - return await (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>)(input, { - ...options, - dispatcher: getDefaultDispatcher(), - }); - } catch (dispatcherError) { - const msg = - dispatcherError instanceof Error ? dispatcherError.message : String(dispatcherError); - // CAUTION: Do NOT fallback to native fetch if the error is a version mismatch (invalid onRequestStart) - // because the native fetch will definitely fail with the undici v8 dispatcher. - if (msg.includes("onRequestStart")) { - console.error( - `[ProxyFetch] Fatal version mismatch: Dispatcher (v8) vs Fetch (v6/native). Hardware upgrade or SOCKS5 config isolation required. Error: ${msg}` - ); + // Retries once on transient dispatcher errors before falling back (fix: proxyfetch-undici-retry). + // + // ReadableStream/Blob body guard: if the body is non-replayable, skip the retry because + // the first attempt drains the stream; a second attempt would silently send an empty body. + // ReadableStream check: cast through unknown to avoid explicit-any budget (T11). + const _bodyUnknown = options.body as unknown; + const bodyIsStream = + _bodyUnknown !== null && + _bodyUnknown !== undefined && + typeof _bodyUnknown === "object" && + (typeof (_bodyUnknown as Record<string, unknown>).getReader === "function" || // ReadableStream + typeof (_bodyUnknown as Record<string, unknown>).stream === "function"); // Blob + const maxAttempts = bodyIsStream ? 1 : 2; + const _undiciDirect = + deps.undiciFetch ?? (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>); + const _nativeFallback = + (deps.nativeFetch as FetchWithDispatcher | undefined) ?? originalFetchWithDispatcher; + let lastDispatcherError: unknown = null; + for (let attempt = 0; attempt < maxAttempts; attempt++) { + try { + return await _undiciDirect(input, { + ...options, + dispatcher: getDefaultDispatcher(), + }); + } catch (dispatcherError) { + const msg = + dispatcherError instanceof Error ? dispatcherError.message : String(dispatcherError); + // CAUTION: Do NOT fallback to native fetch if the error is a version mismatch (invalid onRequestStart) + // because the native fetch will definitely fail with the undici v8 dispatcher. + if (msg.includes("onRequestStart")) { + console.error( + `[ProxyFetch] Fatal version mismatch: Dispatcher (v8) vs Fetch (v6/native). Hardware upgrade or SOCKS5 config isolation required. Error: ${msg}` + ); + throw dispatcherError; + } + // Only retry/fallback for connection/dispatcher errors, not HTTP errors. + // Prefer the .code property when available (more stable across undici + // versions than message-string matching); fall back to substring match + // for errors that lack a structured code. + const errCode = (dispatcherError as { code?: string })?.code; + if ( + msg.includes("fetch failed") || + errCode === "ECONNREFUSED" || + msg.includes("ECONNREFUSED") || + (errCode !== undefined && errCode.startsWith("UND_ERR")) || + msg.includes("UND_ERR") + ) { + if (attempt === 0 && maxAttempts > 1) { + // First failure — retry once with a short jittered delay before giving up. + lastDispatcherError = dispatcherError; + await new Promise((r) => setTimeout(r, 25 + Math.random() * 50)); + continue; + } + // All attempts exhausted — fall back to native fetch. + // Preserve original phrase intact for monitoring: "Undici dispatcher failed, falling back to native fetch" + console.warn( + `[ProxyFetch] Undici dispatcher failed, falling back to native fetch (after retry): ${msg}` + ); + return _nativeFallback(input, options); + } throw dispatcherError; } - // Only fallback for connection/dispatcher errors, not HTTP errors - if (msg.includes("fetch failed") || msg.includes("ECONNREFUSED") || msg.includes("UND_ERR")) { - console.warn(`[ProxyFetch] Undici dispatcher failed, falling back to native fetch: ${msg}`); - return originalFetchWithDispatcher(input, options); - } - throw dispatcherError; } + // Should not be reached, but satisfy TypeScript control-flow. + throw lastDispatcherError; } try { const dispatcher = createProxyDispatcher(proxyUrl); - return await (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>)(input, { + const _undiciProxy = + deps.undiciFetch ?? (undiciFetch as unknown as (...args: unknown[]) => Promise<Response>); + return await _undiciProxy(input, { ...options, dispatcher, }); @@ -281,6 +337,19 @@ async function patchedFetch(input: RequestInfo | URL, options: FetchWithDispatch } } +/** + * Named export for proxyFetch — identical to the patched globalThis.fetch but + * accepts an optional ProxyFetchDeps for unit test dependency injection. + * Production code should use globalThis.fetch (or the default export) instead. + */ +export async function proxyFetch( + input: RequestInfo | URL, + options: RequestInit = {}, + deps: ProxyFetchDeps = {} +): Promise<Response> { + return patchedFetch(input, options as FetchWithDispatcherOptions, deps); +} + if (!isCloud && !patchState.isPatched) { globalThis.fetch = patchedFetch; patchState.isPatched = true; diff --git a/open-sse/utils/requestLogger.ts b/open-sse/utils/requestLogger.ts index 6e17e101b8..5845d87213 100644 --- a/open-sse/utils/requestLogger.ts +++ b/open-sse/utils/requestLogger.ts @@ -50,7 +50,7 @@ type RequestLoggerOptions = { const DEFAULT_MAX_STREAM_CHUNK_BYTES = 128 * 1024; const DEFAULT_MAX_STREAM_CHUNK_ITEMS = 512; const MAX_LOG_STRING_LENGTH = 64 * 1024; -const MAX_LOG_ARRAY_ITEMS = 24; +export const MAX_LOG_ARRAY_ITEMS = 24; const MAX_LOG_OBJECT_KEYS = 80; function maskSensitiveHeaders(headers: HeaderInput): Record<string, unknown> { @@ -98,16 +98,31 @@ function truncateLogString(value: string, maxLength = MAX_LOG_STRING_LENGTH): st return `${value.slice(0, Math.floor(maxLength / 2))}\n[...truncated ${value.length - maxLength} chars...]\n${value.slice(-Math.ceil(maxLength / 2))}`; } -function cloneBoundedForLog(value: unknown, depth = 0): unknown { +/** + * Recursively clone `value` for logging, with size bounds applied: + * - Arrays longer than MAX_LOG_ARRAY_ITEMS are truncated to the tail with a + * sentinel marker prepended. + * - The `tools` field is exempt from array truncation: the full tool inventory + * is debug-critical for understanding which tools the model had access to, + * and individual tool descriptions are independently bounded by + * truncateLogString, so the total size remains naturally capped. + * + * The optional `key` parameter carries the parent object's field name when + * recursing into an object's values, enabling the per-field exemption above. + * Top-level arrays (no key context) remain subject to truncation. + */ +export function cloneBoundedForLog(value: unknown, depth = 0, key: string | null = null): unknown { if (value === null || value === undefined) return value; if (typeof value === "string") return truncateLogString(value); if (typeof value !== "object") return value; if (depth >= 6) return "[MaxDepth]"; if (Array.isArray(value)) { - const source = value.length > MAX_LOG_ARRAY_ITEMS ? value.slice(-MAX_LOG_ARRAY_ITEMS) : value; + const exempt = key === "tools"; + const shouldTruncate = !exempt && value.length > MAX_LOG_ARRAY_ITEMS; + const source = shouldTruncate ? value.slice(-MAX_LOG_ARRAY_ITEMS) : value; const mapped = source.map((item) => cloneBoundedForLog(item, depth + 1)); - if (value.length > MAX_LOG_ARRAY_ITEMS) { + if (shouldTruncate) { return [ { _omniroute_truncated_array: true, @@ -122,8 +137,8 @@ function cloneBoundedForLog(value: unknown, depth = 0): unknown { const result: JsonRecord = {}; const entries = Object.entries(value as JsonRecord); - for (const [key, item] of entries.slice(0, MAX_LOG_OBJECT_KEYS)) { - result[key] = cloneBoundedForLog(item, depth + 1); + for (const [k, item] of entries.slice(0, MAX_LOG_OBJECT_KEYS)) { + result[k] = cloneBoundedForLog(item, depth + 1, k); } if (entries.length > MAX_LOG_OBJECT_KEYS) { result._omniroute_truncated_keys = entries.length - MAX_LOG_OBJECT_KEYS; diff --git a/open-sse/utils/sseHeartbeat.ts b/open-sse/utils/sseHeartbeat.ts index ee5c8a0c95..f0ef75a26f 100644 --- a/open-sse/utils/sseHeartbeat.ts +++ b/open-sse/utils/sseHeartbeat.ts @@ -1,16 +1,78 @@ export const DEFAULT_SSE_HEARTBEAT_INTERVAL_MS = 15_000; +export const HEARTBEAT_SHAPES = { + COMMENT: "comment", + ANTHROPIC_PING: "anthropic-ping", + OPENAI_CHUNK: "openai-chunk", + OPENAI_RESPONSES_IN_PROGRESS: "openai-responses-in-progress", +} as const; + +export type HeartbeatShape = (typeof HEARTBEAT_SHAPES)[keyof typeof HEARTBEAT_SHAPES]; + +export const DEFAULT_SSE_HEARTBEAT_SHAPE: HeartbeatShape = HEARTBEAT_SHAPES.COMMENT; + +export function shapeForClientFormat( + clientResponseFormat: string | undefined | null +): HeartbeatShape { + switch (clientResponseFormat) { + case "claude": + return HEARTBEAT_SHAPES.ANTHROPIC_PING; + case "openai": + return HEARTBEAT_SHAPES.OPENAI_CHUNK; + case "openai-responses": + return HEARTBEAT_SHAPES.OPENAI_RESPONSES_IN_PROGRESS; + default: + return HEARTBEAT_SHAPES.COMMENT; + } +} + +function buildHeartbeatPayload( + shape: HeartbeatShape, + opts: { chunkId?: string; chunkModel?: string } = {} +): string { + switch (shape) { + case HEARTBEAT_SHAPES.ANTHROPIC_PING: + return "event: ping\ndata: {}\n\n"; + case HEARTBEAT_SHAPES.OPENAI_RESPONSES_IN_PROGRESS: + return 'data: {"type":"response.in_progress"}\n\n'; + case HEARTBEAT_SHAPES.OPENAI_CHUNK: { + const payload = { + id: opts.chunkId ?? "omniroute-keepalive", + object: "chat.completion.chunk", + created: Math.floor(Date.now() / 1000), + model: opts.chunkModel ?? "omniroute", + choices: [{ index: 0, delta: {}, finish_reason: null }], + }; + return `data: ${JSON.stringify(payload)}\n\n`; + } + case HEARTBEAT_SHAPES.COMMENT: + default: + return `: keepalive ${new Date().toISOString()}\n\n`; + } +} + type SseHeartbeatTransformOptions = { intervalMs?: number; signal?: AbortSignal; + shape?: HeartbeatShape; + chunkId?: string; + chunkModel?: string; }; +const HEARTBEAT_ENCODER = new TextEncoder(); + export function createSseHeartbeatTransform({ intervalMs = DEFAULT_SSE_HEARTBEAT_INTERVAL_MS, signal, -}: SseHeartbeatTransformOptions = {}) { + shape = DEFAULT_SSE_HEARTBEAT_SHAPE, + chunkId, + chunkModel, +}: SseHeartbeatTransformOptions = {}): TransformStream<Uint8Array, Uint8Array> { + if (!Number.isFinite(intervalMs) || intervalMs <= 0) { + return new TransformStream<Uint8Array, Uint8Array>(); + } + let intervalId: ReturnType<typeof setInterval> | undefined; - const encoder = new TextEncoder(); const stop = () => { if (!intervalId) return; @@ -27,7 +89,9 @@ export function createSseHeartbeatTransform({ } try { - controller.enqueue(encoder.encode(`: keepalive ${new Date().toISOString()}\n\n`)); + controller.enqueue( + HEARTBEAT_ENCODER.encode(buildHeartbeatPayload(shape, { chunkId, chunkModel })) + ); } catch { stop(); } diff --git a/open-sse/utils/stream.ts b/open-sse/utils/stream.ts index b75acecf51..a34d836173 100644 --- a/open-sse/utils/stream.ts +++ b/open-sse/utils/stream.ts @@ -550,6 +550,23 @@ export function createSSEStream(options: StreamOptions = {}) { ? clientResponseFormat === FORMATS.OPENAI_RESPONSES : sourceFormat === FORMATS.OPENAI_RESPONSES) === true; + // Clients whose SSE protocol terminates naturally on the last + // provider-shape event (not on a `data: [DONE]` line). Emitting + // `[DONE]` to these clients produces a parser error in the SDK and + // breaks follow-up turns (Capy/Anthropic SDK: text gets stuck in the + // "Thought" area; subsequent /v1/messages calls retry into a corrupt + // state). Skip the `[DONE]` for these formats. + const clientExpectsClaudeStream = + (mode === STREAM_MODE.PASSTHROUGH + ? clientResponseFormat === FORMATS.CLAUDE + : sourceFormat === FORMATS.CLAUDE) === true; + + // Single source of truth for the [DONE] decision, used at both emission + // sites below. Only OpenAI Chat Completions clients expect [DONE]; + // Responses API and Anthropic SSE terminate on their own protocol events + // (response.completed / message_stop respectively). + const shouldEmitDoneTerminator = !clientExpectsResponsesStream && !clientExpectsClaudeStream; + let buffer = ""; let usage: UsageTokenRecord | null = null; /** Passthrough (OpenAI CC shape): saw tool_calls in stream before finish_reason */ @@ -1604,7 +1621,7 @@ export function createSSEStream(options: StreamOptions = {}) { if (!doneSent) { await emitFinalSseMetadata(controller, usage); doneSent = true; - if (!clientExpectsResponsesStream) { + if (shouldEmitDoneTerminator) { clientPayloadCollector.push({ done: true }); const doneOutput = "data: [DONE]\n\n"; reqLogger?.appendConvertedChunk?.(doneOutput); @@ -1800,7 +1817,7 @@ export function createSSEStream(options: StreamOptions = {}) { if (!doneSent) { await emitFinalSseMetadata(controller, state?.usage as Record<string, unknown> | null); doneSent = true; - if (!clientExpectsResponsesStream) { + if (shouldEmitDoneTerminator) { clientPayloadCollector.push({ done: true }); const doneOutput = "data: [DONE]\n\n"; reqLogger?.appendConvertedChunk?.(doneOutput); diff --git a/open-sse/utils/streamReadiness.ts b/open-sse/utils/streamReadiness.ts index 5899d27106..ef6cb71918 100644 --- a/open-sse/utils/streamReadiness.ts +++ b/open-sse/utils/streamReadiness.ts @@ -66,6 +66,20 @@ function hasUsefulJsonPayload(payload: unknown): boolean { return hasUsefulValue(payload); } +function hasAcceptedStreamStartPayload(payload: unknown, eventType = ""): boolean { + if (!isRecord(payload)) return false; + + // Anthropic/Claude streams can legitimately start with lifecycle frames and + // then spend a long time thinking before the first text/tool delta arrives. + // Treating the start frame as readiness prevents false 504s while ping-only + // zombie streams still fail below. + const type = typeof payload.type === "string" ? payload.type : eventType; + if (type === "message_start" && isRecord(payload.message)) return true; + if (type === "content_block_start" && isRecord(payload.content_block)) return true; + + return false; +} + export function hasUsefulStreamContent(text: string): boolean { const lines = text.split(/\r?\n/); @@ -88,6 +102,60 @@ export function hasUsefulStreamContent(text: string): boolean { return false; } +type StreamReadinessSignalState = { + currentEvent: string; + pendingLine: string; +}; + +function processStreamReadinessLine(state: StreamReadinessSignalState, line: string): boolean { + const trimmed = line.trim(); + if (!trimmed || trimmed.startsWith(":")) { + if (!trimmed) state.currentEvent = ""; + return false; + } + + if (trimmed.startsWith("event:")) { + state.currentEvent = trimmed.slice(6).trim(); + return false; + } + + if (/^(?:ping|keepalive)$/i.test(state.currentEvent)) return false; + if (!trimmed.startsWith("data:")) return false; + + const data = trimmed.slice(5).trim(); + if (!data || data === "[DONE]") return false; + + try { + const parsed = JSON.parse(data); + return ( + hasUsefulJsonPayload(parsed) || hasAcceptedStreamStartPayload(parsed, state.currentEvent) + ); + } catch { + return data.length > 0; + } +} + +function appendStreamReadinessSignal(state: StreamReadinessSignalState, chunk: string): boolean { + const lines = `${state.pendingLine}${chunk}`.split(/\r?\n/); + state.pendingLine = lines.pop() ?? ""; + + for (const line of lines) { + if (processStreamReadinessLine(state, line)) return true; + } + + return false; +} + +export function hasStreamReadinessSignal(text: string): boolean { + const state: StreamReadinessSignalState = { + currentEvent: "", + pendingLine: "", + }; + if (appendStreamReadinessSignal(state, text)) return true; + if (state.pendingLine) return processStreamReadinessLine(state, state.pendingLine); + return false; +} + function createErrorResponse( status: number, message: string, @@ -170,7 +238,10 @@ export async function ensureStreamReadiness( const reader = response.body.getReader(); const chunks: Uint8Array[] = []; const decoder = new TextDecoder(); - let bufferedText = ""; + const readinessState: StreamReadinessSignalState = { + currentEvent: "", + pendingLine: "", + }; const startedAt = Date.now(); const deadline = startedAt + options.timeoutMs; let handedOffReader = false; @@ -245,9 +316,9 @@ export async function ensureStreamReadiness( if (!readResult.value) continue; chunks.push(readResult.value); - bufferedText += decoder.decode(readResult.value, { stream: true }); + const decodedChunk = decoder.decode(readResult.value, { stream: true }); - if (hasUsefulStreamContent(bufferedText)) { + if (appendStreamReadinessSignal(readinessState, decodedChunk)) { options.log?.debug?.( "STREAM", `Stream readiness confirmed in ${Date.now() - startedAt}ms (${options.provider || "provider"}/${options.model || "unknown"})` diff --git a/package-lock.json b/package-lock.json index d057e9fcbf..4c6fbde29d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -25,7 +25,8 @@ "express": "^5.2.1", "fetch-socks": "^1.3.3", "fuse.js": "^7.3.0", - "http-proxy-middleware": "^3.0.5", + "gray-matter": "^4.0.3", + "http-proxy-middleware": "^4.0.0", "https-proxy-agent": "^9.0.0", "ioredis": "^5.10.1", "isomorphic-dompurify": "^3.12.0", @@ -83,10 +84,9 @@ "eslint": "^9.39.4", "eslint-config-next": "16.2.6", "glob": "^13.0.6", - "gray-matter": "^4.0.3", "husky": "^9.1.7", "jsdom": "^29.1.1", - "lint-staged": "^16.4.0", + "lint-staged": "^17.0.4", "node-loader": "^2.1.0", "prettier": "^3.8.3", "tailwindcss": "^4.3.0", @@ -97,7 +97,7 @@ "wtfnode": "^0.10.1" }, "engines": { - "node": ">=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27" + "node": ">=22.22.2 <23 || >=24.0.0 <27" }, "optionalDependencies": { "keytar": "^7.9.0" @@ -3128,13 +3128,13 @@ "license": "MIT" }, "node_modules/@playwright/test": { - "version": "1.59.1", - "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.59.1.tgz", - "integrity": "sha512-PG6q63nQg5c9rIi4/Z5lR5IVF7yU5MqmKaPOe0HSc0O2cX1fPi96sUQu5j7eo4gKCkB2AnNGoWt7y4/Xx3Kcqg==", + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.60.0.tgz", + "integrity": "sha512-O71yZIbAh/PxDMNGns37GHBIfrVkEVyn+AXyIa5dOTfb4/xNvRWV+Vv/NMbNCtODB/pO7vLlF2OTmMVLhmr7Ag==", "dev": true, "license": "Apache-2.0", "dependencies": { - "playwright": "1.59.1" + "playwright": "1.60.0" }, "bin": { "playwright": "cli.js" @@ -4400,15 +4400,6 @@ "@types/unist": "*" } }, - "node_modules/@types/http-proxy": { - "version": "1.17.17", - "resolved": "https://registry.npmjs.org/@types/http-proxy/-/http-proxy-1.17.17.tgz", - "integrity": "sha512-ED6LB+Z1AVylNTu7hdzuBqOgMnvG/ld6wGCG8wFnAzKX5uyW2K3WD52v0gnLCTK/VLpXtKckgWuyScYK6cSPaw==", - "license": "MIT", - "dependencies": { - "@types/node": "*" - } - }, "node_modules/@types/istanbul-lib-coverage": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz", @@ -4457,12 +4448,13 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "25.6.2", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.6.2.tgz", - "integrity": "sha512-sokuT28dxf9JT5Kady1fsXOvI4HVpjZa95NKT5y9PNTIrs2AsobR4GFAA90ZG8M+nxVRLysCXsVj6eGC7Vbrlw==", + "version": "25.7.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.7.0.tgz", + "integrity": "sha512-z+pdZyxE+RTQE9AcboAZCb4otwcrvgHD+GlBpPgn0emDVt0ohrTMhAwlr2Wd9nZ+nihhYFxO2pThz3C5qSu2Eg==", + "dev": true, "license": "MIT", "dependencies": { - "undici-types": "~7.19.0" + "undici-types": "~7.21.0" } }, "node_modules/@types/parse-json": { @@ -4511,17 +4503,17 @@ "license": "MIT" }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.2.tgz", - "integrity": "sha512-j/bwmkBvHUtPNxzuWe5z6BEk3q54YRyGlBXkSsmfoih7zNrBvl5A9A98anlp/7JbyZcWIJ8KXo/3Tq/DjFLtuQ==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz", + "integrity": "sha512-PwFvSKsXGShKGW6n5bZOhGHEcCZXM8HofLK9fNsEwZXzFRjoY+XT1Vsf1zgyXdwTr0ZYz1/2tkZ0DBTT9jZjhw==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/regexpp": "^4.12.2", - "@typescript-eslint/scope-manager": "8.59.2", - "@typescript-eslint/type-utils": "8.59.2", - "@typescript-eslint/utils": "8.59.2", - "@typescript-eslint/visitor-keys": "8.59.2", + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/type-utils": "8.59.3", + "@typescript-eslint/utils": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", "ignore": "^7.0.5", "natural-compare": "^1.4.0", "ts-api-utils": "^2.5.0" @@ -4534,7 +4526,7 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.59.2", + "@typescript-eslint/parser": "^8.59.3", "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", "typescript": ">=4.8.4 <6.1.0" } @@ -4550,16 +4542,16 @@ } }, "node_modules/@typescript-eslint/parser": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.59.2.tgz", - "integrity": "sha512-plR3pp6D+SSUn1HM7xvSkx12/DhoHInI2YF35KAcVFNZvlC0gtrWqx7Qq1oH2Ssgi0vlFRCTbP+DZc7B9+TtsQ==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.59.3.tgz", + "integrity": "sha512-HPwA+hVkfcriajbNvTmZv4VRauibay+cWArYUYq7u7W7PmGShMxbPxLvrwDme55a6d5alG3nrYfhyJ/G28XlLg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/scope-manager": "8.59.2", - "@typescript-eslint/types": "8.59.2", - "@typescript-eslint/typescript-estree": "8.59.2", - "@typescript-eslint/visitor-keys": "8.59.2", + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", "debug": "^4.4.3" }, "engines": { @@ -4575,14 +4567,14 @@ } }, "node_modules/@typescript-eslint/project-service": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.59.2.tgz", - "integrity": "sha512-+2hqvEkeyf/0FBor67duF0Ll7Ot8jyKzDQOSrxazF/danillRq2DwR9dLptsXpoZQqxE1UisSmoZewrlPas9Vw==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.59.3.tgz", + "integrity": "sha512-ECiUWa/KYRGDFUqTNehaRgzDshnJfkTABJxVemHk4ko22gcr0ukloKjWvyQ64g8YCV/UI47kN1dbmjf/GaQYng==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/tsconfig-utils": "^8.59.2", - "@typescript-eslint/types": "^8.59.2", + "@typescript-eslint/tsconfig-utils": "^8.59.3", + "@typescript-eslint/types": "^8.59.3", "debug": "^4.4.3" }, "engines": { @@ -4597,14 +4589,14 @@ } }, "node_modules/@typescript-eslint/scope-manager": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.59.2.tgz", - "integrity": "sha512-JzfyEpEtOU89CcFSwyNS3mu4MLvLSXqnmX05+aKBDM+TdR5jzcGOEBwxwGNxrEQ7p/z6kK2WyioCGBf2zZBnvg==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.59.3.tgz", + "integrity": "sha512-t2LvZnoEfzKtnPjgeEu41xw5gxq9mQVfYy4OoZ4Vlt0sk3JwxmhCca/AR7DwOiHrjWgjAj6as4AhRLKSDfvZIA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.59.2", - "@typescript-eslint/visitor-keys": "8.59.2" + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -4615,9 +4607,9 @@ } }, "node_modules/@typescript-eslint/tsconfig-utils": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.59.2.tgz", - "integrity": "sha512-BKK4alN7oi4C/zv4VqHQ+uRU+lTa6JGIZ7s1juw7b3RHo9OfKB+bKX3u0iVZetdsUCBBkSbdWbarJbmN0fTeSw==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.59.3.tgz", + "integrity": "sha512-PcIJHjmaREXLgIAIzLnSY9VucEzz8FKXsRgFa1DmdGCK/5tJpW03TKJF01Q6VZd1lLdz2sIKPWaDUZN9dp//dw==", "dev": true, "license": "MIT", "engines": { @@ -4632,15 +4624,15 @@ } }, "node_modules/@typescript-eslint/type-utils": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.59.2.tgz", - "integrity": "sha512-nhqaj1nmTdVVl/BP5omXNRGO38jn5iosis2vbdmupF2txCf8ylWT8lx+JlvMYYVqzGVKtjojUFoQ3JRWK+mfzQ==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.59.3.tgz", + "integrity": "sha512-g71d8QD8UaiHGvrJwyIS1hCX5r63w6Jll+4VEYhEAHXTDIqX1JgxhTAbEHtKntL9kuc4jRo7/GWw5xfCepSccQ==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.59.2", - "@typescript-eslint/typescript-estree": "8.59.2", - "@typescript-eslint/utils": "8.59.2", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/utils": "8.59.3", "debug": "^4.4.3", "ts-api-utils": "^2.5.0" }, @@ -4657,9 +4649,9 @@ } }, "node_modules/@typescript-eslint/types": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.59.2.tgz", - "integrity": "sha512-e82GVOE8Ps3E++Egvb6Y3Dw0S10u8NkQ9KXmtRhCWJJ8kDhOJTvtMAWnFL16kB1583goCWXsr0NieKCZMs2/0Q==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.59.3.tgz", + "integrity": "sha512-ePFoH0g4ludssdRFqqDxQePCxU4WQyRa9+XVwjm7yLn0FKhMeoetC+qBEEI1Eyb1pGSDveTIT09Bvw2WhlGayg==", "dev": true, "license": "MIT", "engines": { @@ -4671,16 +4663,16 @@ } }, "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.59.2.tgz", - "integrity": "sha512-o0XPGNwcWw+FIwStOWn+BwBuEmL6QXP0rsvAFg7ET1dey1Nr6Wb1ac8p5HEsK0ygO/6mUxlk+YWQD9xcb/nnXg==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.59.3.tgz", + "integrity": "sha512-CbRjVRAf7Lr9Kr8RopKcbY45p2VfmmHrm0ygOCYFi7oU8q19m0Fs/6iHS7kNOmwpp+ob07ZVcAqlxUod9lYdmg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/project-service": "8.59.2", - "@typescript-eslint/tsconfig-utils": "8.59.2", - "@typescript-eslint/types": "8.59.2", - "@typescript-eslint/visitor-keys": "8.59.2", + "@typescript-eslint/project-service": "8.59.3", + "@typescript-eslint/tsconfig-utils": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", "debug": "^4.4.3", "minimatch": "^10.2.2", "semver": "^7.7.3", @@ -4709,9 +4701,9 @@ } }, "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": { - "version": "5.0.5", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz", - "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==", + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz", + "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==", "dev": true, "license": "MIT", "dependencies": { @@ -4738,9 +4730,9 @@ } }, "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { - "version": "7.7.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", - "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", "dev": true, "license": "ISC", "bin": { @@ -4751,16 +4743,16 @@ } }, "node_modules/@typescript-eslint/utils": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.59.2.tgz", - "integrity": "sha512-Juw3EinkXqjaffxz6roowvV7GZT/kET5vSKKZT6upl5TXdWkLkYmNPXwDDL2Vkt2DPn0nODIS4egC/0AGxKo/Q==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.59.3.tgz", + "integrity": "sha512-JAvT14goBzRzzzZyqq3P9BLArIxTtQURUtFgQ/V7FO+eU+Gg6ES+5ymOPP1wRxXcxAYeivCk4uS3jCKWI1K8Zg==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/eslint-utils": "^4.9.1", - "@typescript-eslint/scope-manager": "8.59.2", - "@typescript-eslint/types": "8.59.2", - "@typescript-eslint/typescript-estree": "8.59.2" + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -4775,13 +4767,13 @@ } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.59.2.tgz", - "integrity": "sha512-NwjLUnGy8/Zfx23fl50tRC8rYaYnM52xNRYFAXvmiil9yh1+K6aRVQMnzW6gQB/1DLgWt977lYQn7C+wtgXZiA==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.59.3.tgz", + "integrity": "sha512-f1UQF7ggd42YiwI5wGrRaPsa+P0CINBlrkLPmGfpq/u/I/oVtecoEIfFR9ag/oa1sLOsRNZ6xehf6qMZhQGBDg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.59.2", + "@typescript-eslint/types": "8.59.3", "eslint-visitor-keys": "^5.0.0" }, "engines": { @@ -5117,16 +5109,16 @@ } }, "node_modules/@vitest/expect": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.5.tgz", - "integrity": "sha512-PWBaRY5JoKuRnHlUHfpV/KohFylaDZTupcXN1H9vYryNLOnitSw60Mw9IAE2r67NbwwzBw/Cc/8q9BK3kIX8Kw==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.6.tgz", + "integrity": "sha512-7EHDquPthALSV0jhhjgEW8FXaviMx7rSqu8W6oqCoAuOhKov814P99QDV1pxMA3QPv21YudvJngIhjrNI4opLg==", "dev": true, "license": "MIT", "dependencies": { "@standard-schema/spec": "^1.1.0", "@types/chai": "^5.2.2", - "@vitest/spy": "4.1.5", - "@vitest/utils": "4.1.5", + "@vitest/spy": "4.1.6", + "@vitest/utils": "4.1.6", "chai": "^6.2.2", "tinyrainbow": "^3.1.0" }, @@ -5135,13 +5127,13 @@ } }, "node_modules/@vitest/mocker": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.5.tgz", - "integrity": "sha512-/x2EmFC4mT4NNzqvC3fmesuV97w5FC903KPmey4gsnJiMQ3Be1IlDKVaDaG8iqaLFHqJ2FVEkxZk5VmeLjIItw==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.6.tgz", + "integrity": "sha512-MCFc63czMjEInOlcY2cpQCvCN+KgbAn+60xu9cMgP4sKaLC5JNAKw7JH8QdAnoAC88hW1IiSNZ+GgVXlN1UcMQ==", "dev": true, "license": "MIT", "dependencies": { - "@vitest/spy": "4.1.5", + "@vitest/spy": "4.1.6", "estree-walker": "^3.0.3", "magic-string": "^0.30.21" }, @@ -5162,9 +5154,9 @@ } }, "node_modules/@vitest/pretty-format": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.5.tgz", - "integrity": "sha512-7I3q6l5qr03dVfMX2wCo9FxwSJbPdwKjy2uu/YPpU3wfHvIL4QHwVRp57OfGrDFeUJ8/8QdfBKIV12FTtLn00g==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.6.tgz", + "integrity": "sha512-h5SxD/IzNhZYnrSZRsUZQIC+vD0GY8cUvq0iwsmkFKixRCKLLWqCXa/FIQ4S1R+sI+PGoojkHsdNrbZiM9Qpgw==", "dev": true, "license": "MIT", "dependencies": { @@ -5175,13 +5167,13 @@ } }, "node_modules/@vitest/runner": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.5.tgz", - "integrity": "sha512-2D+o7Pr82IEO46YPpoA/YU0neeyr6FTerQb5Ro7BUnBuv6NQtT/kmVnczngiMEBhzgqz2UZYl5gArejsyERDSQ==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.6.tgz", + "integrity": "sha512-nOPCmn2+yD0ZNmKdsXGv/UxMMWbMuKeD6GyYncNwdkYDxpQvrPSKYj2rWuDjC2Y4b6w6hjip5dBKFzEUuZe3vA==", "dev": true, "license": "MIT", "dependencies": { - "@vitest/utils": "4.1.5", + "@vitest/utils": "4.1.6", "pathe": "^2.0.3" }, "funding": { @@ -5189,14 +5181,14 @@ } }, "node_modules/@vitest/snapshot": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.5.tgz", - "integrity": "sha512-zypXEt4KH/XgKGPUz4eC2AvErYx0My5hfL8oDb1HzGFpEk1P62bxSohdyOmvz+d9UJwanI68MKwr2EquOaOgMQ==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.6.tgz", + "integrity": "sha512-YhsdE6xAVfTDmzjxL2ZDUvjj+ZsgyOKe+TdQzqkD72wIOmHka8NuGQ6NpTNZv9D2Z63fbwWKJPeVpEw4EQgYxw==", "dev": true, "license": "MIT", "dependencies": { - "@vitest/pretty-format": "4.1.5", - "@vitest/utils": "4.1.5", + "@vitest/pretty-format": "4.1.6", + "@vitest/utils": "4.1.6", "magic-string": "^0.30.21", "pathe": "^2.0.3" }, @@ -5205,9 +5197,9 @@ } }, "node_modules/@vitest/spy": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.5.tgz", - "integrity": "sha512-2lNOsh6+R2Idnf1TCZqSwYlKN2E/iDlD8sgU59kYVl+OMDmvldO1VDk39smRfpUNwYpNRVn3w4YfuC7KfbBnkQ==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.6.tgz", + "integrity": "sha512-JFKxMx6udhwKh/Ldo270e17QX710vgunMkuPAvXjHSvC6oqLWAHhVhjg/I71q0u0CBSErIODV1Kjv0FQNSWjdg==", "dev": true, "license": "MIT", "funding": { @@ -5215,13 +5207,13 @@ } }, "node_modules/@vitest/utils": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.5.tgz", - "integrity": "sha512-76wdkrmfXfqGjueGgnb45ITPyUi1ycZ4IHgC2bhPDUfWHklY/q3MdLOAB+TF1e6xfl8NxNY0ZYaPCFNWSsw3Ug==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.6.tgz", + "integrity": "sha512-FxIY+U81R3LGKCxaHHFRQ5+g6/iRgGLmeHWdp2Amj4ljQRrEIWHmZyDfDYBRZlpyqA7qKxtS9DD1dhk8RnRIVQ==", "dev": true, "license": "MIT", "dependencies": { - "@vitest/pretty-format": "4.1.5", + "@vitest/pretty-format": "4.1.6", "convert-source-map": "^2.0.0", "tinyrainbow": "^3.1.0" }, @@ -8199,7 +8191,6 @@ "version": "4.0.1", "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", - "dev": true, "license": "BSD-2-Clause", "bin": { "esparse": "bin/esparse.js", @@ -8401,7 +8392,6 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", - "dev": true, "license": "MIT", "dependencies": { "is-extendable": "^0.1.0" @@ -9042,7 +9032,6 @@ "version": "4.0.3", "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz", "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==", - "dev": true, "license": "MIT", "dependencies": { "js-yaml": "^3.13.1", @@ -9058,7 +9047,6 @@ "version": "1.0.10", "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", - "dev": true, "license": "MIT", "dependencies": { "sprintf-js": "~1.0.2" @@ -9068,7 +9056,6 @@ "version": "3.14.2", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz", "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==", - "dev": true, "license": "MIT", "dependencies": { "argparse": "^1.0.7", @@ -9311,43 +9298,22 @@ "url": "https://opencollective.com/express" } }, - "node_modules/http-proxy": { - "version": "1.18.1", - "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz", - "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==", - "license": "MIT", - "dependencies": { - "eventemitter3": "^4.0.0", - "follow-redirects": "^1.0.0", - "requires-port": "^1.0.0" - }, - "engines": { - "node": ">=8.0.0" - } - }, "node_modules/http-proxy-middleware": { - "version": "3.0.5", - "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-3.0.5.tgz", - "integrity": "sha512-GLZZm1X38BPY4lkXA01jhwxvDoOkkXqjgVyUzVxiEK4iuRu03PZoYHhHRwxnfhQMDuaxi3vVri0YgSro/1oWqg==", + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-4.0.0.tgz", + "integrity": "sha512-wuHwaUtmC0XzJNHqRp41zXtt5ojpHbusXGhq6781VvnjWUYPu7opmOF3eomGNujT07kEOnHWZyV9UZzKimVCKA==", "license": "MIT", "dependencies": { - "@types/http-proxy": "^1.17.15", - "debug": "^4.3.6", - "http-proxy": "^1.18.1", + "debug": "^4.4.3", + "httpxy": "^0.5.1", "is-glob": "^4.0.3", - "is-plain-object": "^5.0.0", + "is-plain-obj": "^4.1.0", "micromatch": "^4.0.8" }, "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + "node": "^22.15.0 || ^24.0.0 || >=26.0.0" } }, - "node_modules/http-proxy/node_modules/eventemitter3": { - "version": "4.0.7", - "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz", - "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==", - "license": "MIT" - }, "node_modules/https-proxy-agent": { "version": "9.0.0", "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-9.0.0.tgz", @@ -9361,6 +9327,12 @@ "node": ">= 20" } }, + "node_modules/httpxy": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/httpxy/-/httpxy-0.5.1.tgz", + "integrity": "sha512-JPhqYiixe1A1I+MXDewWDZqeudBGU8Q9jCHYN8ML+779RQzLjTi78HBvWz4jMxUD6h2/vUL12g4q/mFM0OUw1A==", + "license": "MIT" + }, "node_modules/husky": { "version": "9.1.7", "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz", @@ -9800,7 +9772,6 @@ "version": "0.1.1", "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", - "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -10001,15 +9972,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/is-plain-object": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-5.0.0.tgz", - "integrity": "sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/is-potential-custom-element-name": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz", @@ -10301,9 +10263,9 @@ } }, "node_modules/joi": { - "version": "18.1.2", - "resolved": "https://registry.npmjs.org/joi/-/joi-18.1.2.tgz", - "integrity": "sha512-rF5MAmps5esSlhCA+N1b6IYHDw9j/btzGaqfgie522jS02Ju/HXBxamlXVlKEHAxoMKQL77HWI8jlqWsFuekZA==", + "version": "18.2.1", + "resolved": "https://registry.npmjs.org/joi/-/joi-18.2.1.tgz", + "integrity": "sha512-2/OKlogiESf2Nh3TFCrRjrr9z1DRHeW0I+KReF67+4J0Ns+8hBtHRmoWAZ2OFU6I5+TWLEe6sVlSdXPjHm5UbQ==", "dev": true, "license": "BSD-3-Clause", "dependencies": { @@ -10548,7 +10510,6 @@ "version": "6.0.3", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz", "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==", - "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -10872,55 +10833,45 @@ "license": "MIT" }, "node_modules/lint-staged": { - "version": "16.4.0", - "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-16.4.0.tgz", - "integrity": "sha512-lBWt8hujh/Cjysw5GYVmZpFHXDCgZzhrOm8vbcUdobADZNOK/bRshr2kM3DfgrrtR1DQhfupW9gnIXOfiFi+bw==", + "version": "17.0.4", + "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-17.0.4.tgz", + "integrity": "sha512-+rU9lSUyVOZ/hDUmRLVGzyS2v73cDdQjX+XQz1AaOdIE4RysLq0HoPW2HrrgeNCLklkhi904VBU1bmgWLHVnkA==", "dev": true, "license": "MIT", "dependencies": { - "commander": "^14.0.3", - "listr2": "^9.0.5", - "picomatch": "^4.0.3", + "listr2": "^10.2.1", + "picomatch": "^4.0.4", "string-argv": "^0.3.2", - "tinyexec": "^1.0.4", - "yaml": "^2.8.2" + "tinyexec": "^1.1.2" }, "bin": { "lint-staged": "bin/lint-staged.js" }, "engines": { - "node": ">=20.17" + "node": ">=22.22.1" }, "funding": { "url": "https://opencollective.com/lint-staged" - } - }, - "node_modules/lint-staged/node_modules/commander": { - "version": "14.0.3", - "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz", - "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=20" + }, + "optionalDependencies": { + "yaml": "^2.8.4" } }, "node_modules/listr2": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/listr2/-/listr2-9.0.5.tgz", - "integrity": "sha512-ME4Fb83LgEgwNw96RKNvKV4VTLuXfoKudAmm2lP8Kk87KaMK0/Xrx/aAkMWmT8mDb+3MlFDspfbCs7adjRxA2g==", + "version": "10.2.1", + "resolved": "https://registry.npmjs.org/listr2/-/listr2-10.2.1.tgz", + "integrity": "sha512-7I5knELsJKTUjXG+A6BkKAiGkW1i25fNa/xlUl9hFtk15WbE9jndA89xu5FzQKrY5llajE1hfZZFMILXkDHk/Q==", "dev": true, "license": "MIT", "dependencies": { - "cli-truncate": "^5.0.0", - "colorette": "^2.0.20", - "eventemitter3": "^5.0.1", + "cli-truncate": "^5.2.0", + "eventemitter3": "^5.0.4", "log-update": "^6.1.0", "rfdc": "^1.4.1", - "wrap-ansi": "^9.0.0" + "wrap-ansi": "^10.0.0" }, "engines": { - "node": ">=20.0.0" + "node": ">=22.13.0" } }, "node_modules/loader-utils": { @@ -11052,6 +11003,42 @@ "url": "https://github.com/chalk/slice-ansi?sponsor=1" } }, + "node_modules/log-update/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, "node_modules/longest-streak": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", @@ -12847,13 +12834,13 @@ } }, "node_modules/playwright": { - "version": "1.59.1", - "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.59.1.tgz", - "integrity": "sha512-C8oWjPR3F81yljW9o5OxcWzfh6avkVwDD2VYdwIGqTkl+OGFISgypqzfu7dOe4QNLL2aqcWBmI3PMtLIK233lw==", + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.60.0.tgz", + "integrity": "sha512-hheHdokM8cdqCb0lcE3s+zT4t4W+vvjpGxsZlDnikarzx8tSzMebh3UiFtgqwFwnTnjYQcsyMF8ei2mCO/tpeA==", "dev": true, "license": "Apache-2.0", "dependencies": { - "playwright-core": "1.59.1" + "playwright-core": "1.60.0" }, "bin": { "playwright": "cli.js" @@ -12866,9 +12853,9 @@ } }, "node_modules/playwright-core": { - "version": "1.59.1", - "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.59.1.tgz", - "integrity": "sha512-HBV/RJg81z5BiiZ9yPzIiClYV/QMsDCKUyogwH9p3MCP6IYjUFu/MActgYAvK0oWyV9NlwM3GLBjADyWgydVyg==", + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0.tgz", + "integrity": "sha512-9bW6zvX/m0lEbgTKJ6YppOKx8H3VOPBMOCFh2irXFOT4BbHgrx5hPjwJYLT40Lu+4qtD36qKc/Hn56StUW57IA==", "dev": true, "license": "Apache-2.0", "bin": { @@ -13501,12 +13488,6 @@ "node": ">=0.10.0" } }, - "node_modules/requires-port": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", - "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", - "license": "MIT" - }, "node_modules/reselect": { "version": "5.1.1", "resolved": "https://registry.npmjs.org/reselect/-/reselect-5.1.1.tgz", @@ -13824,7 +13805,6 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz", "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==", - "dev": true, "license": "MIT", "dependencies": { "extend-shallow": "^2.0.1", @@ -14296,7 +14276,6 @@ "version": "1.0.3", "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", - "dev": true, "license": "BSD-3-Clause" }, "node_modules/stable-hash": { @@ -14582,7 +14561,6 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz", "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==", - "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -15207,16 +15185,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.59.2", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.59.2.tgz", - "integrity": "sha512-pJw051uomb3ZeCzGTpRb8RbEqB5Y4WWet8gl/GcTlU35BSx0PVdZ86/bqkQCyKKuraVQEK7r6kBHQXF+fBhkoQ==", + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.59.3.tgz", + "integrity": "sha512-KgusgyDgG4LI8Ih/sWaCtZ06tckLAS5CvT5A4D1Q7bYVoAAyzwiZvE4BmwDHkhRVkvhRBepKeASoFzQetha7Fg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.59.2", - "@typescript-eslint/parser": "8.59.2", - "@typescript-eslint/typescript-estree": "8.59.2", - "@typescript-eslint/utils": "8.59.2" + "@typescript-eslint/eslint-plugin": "8.59.3", + "@typescript-eslint/parser": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/utils": "8.59.3" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -15265,9 +15243,10 @@ } }, "node_modules/undici-types": { - "version": "7.19.2", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.19.2.tgz", - "integrity": "sha512-qYVnV5OEm2AW8cJMCpdV20CDyaN3g0AjDlOGf1OW4iaDEx8MwdtChUp4zu4H0VP3nDRF/8RKWH+IPp9uW0YGZg==", + "version": "7.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.21.0.tgz", + "integrity": "sha512-w9IMgQrz4O0YN1LtB7K5P63vhlIOvC7opSmouCJ+ZywlPAlO9gIkJ+otk6LvGpAs2wg4econaCz3TvQ9xPoyuQ==", + "dev": true, "license": "MIT" }, "node_modules/unified": { @@ -15675,19 +15654,19 @@ } }, "node_modules/vitest": { - "version": "4.1.5", - "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.5.tgz", - "integrity": "sha512-9Xx1v3/ih3m9hN+SbfkUyy0JAs72ap3r7joc87XL6jwF0jGg6mFBvQ1SrwaX+h8BlkX6Hz9shdd1uo6AF+ZGpg==", + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.6.tgz", + "integrity": "sha512-6lvjbS3p9b4CrdCmguzbh2/4uoXhGE2q71R4OX5sqF9R1bo9Xd6fGrMAfvp5wnCzlBnFVdCOp6onuTQVbo8iUQ==", "dev": true, "license": "MIT", "dependencies": { - "@vitest/expect": "4.1.5", - "@vitest/mocker": "4.1.5", - "@vitest/pretty-format": "4.1.5", - "@vitest/runner": "4.1.5", - "@vitest/snapshot": "4.1.5", - "@vitest/spy": "4.1.5", - "@vitest/utils": "4.1.5", + "@vitest/expect": "4.1.6", + "@vitest/mocker": "4.1.6", + "@vitest/pretty-format": "4.1.6", + "@vitest/runner": "4.1.6", + "@vitest/snapshot": "4.1.6", + "@vitest/spy": "4.1.6", + "@vitest/utils": "4.1.6", "es-module-lexer": "^2.0.0", "expect-type": "^1.3.0", "magic-string": "^0.30.21", @@ -15715,12 +15694,12 @@ "@edge-runtime/vm": "*", "@opentelemetry/api": "^1.9.0", "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0", - "@vitest/browser-playwright": "4.1.5", - "@vitest/browser-preview": "4.1.5", - "@vitest/browser-webdriverio": "4.1.5", - "@vitest/coverage-istanbul": "4.1.5", - "@vitest/coverage-v8": "4.1.5", - "@vitest/ui": "4.1.5", + "@vitest/browser-playwright": "4.1.6", + "@vitest/browser-preview": "4.1.6", + "@vitest/browser-webdriverio": "4.1.6", + "@vitest/coverage-istanbul": "4.1.6", + "@vitest/coverage-v8": "4.1.6", + "@vitest/ui": "4.1.6", "happy-dom": "*", "jsdom": "*", "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" @@ -15777,14 +15756,14 @@ } }, "node_modules/wait-on": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/wait-on/-/wait-on-9.0.5.tgz", - "integrity": "sha512-qgnbHDfDTRIp73ANEJNRW/7kn8CrDUcvZz18xotJQku/P4saTGkbIzvnMZebPmVvVNUiRq1qWAPyqCH+W4H8KA==", + "version": "9.0.10", + "resolved": "https://registry.npmjs.org/wait-on/-/wait-on-9.0.10.tgz", + "integrity": "sha512-rCoJEhvMr0X6alHmwc9abbrA5ZrLZFKpFQVKPNFwl2h7DapXOGdmimIHDtLOWhT4PjhZhxFEtZoQgEXbkDWdZw==", "dev": true, "license": "MIT", "dependencies": { - "axios": "^1.15.0", - "joi": "^18.1.2", + "axios": "^1.16.0", + "joi": "^18.2.1", "lodash": "^4.18.1", "minimist": "^1.2.8", "rxjs": "^7.8.2" @@ -15960,18 +15939,18 @@ } }, "node_modules/wrap-ansi": { - "version": "9.0.2", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", - "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-10.0.0.tgz", + "integrity": "sha512-SGcvg80f0wUy2/fXES19feHMz8E0JoXv2uNgHOu4Dgi2OrCy1lqwFYEJz1BLbDI0exjPMe/ZdzZ/YpGECBG/aQ==", "dev": true, "license": "MIT", "dependencies": { - "ansi-styles": "^6.2.1", - "string-width": "^7.0.0", - "strip-ansi": "^7.1.0" + "ansi-styles": "^6.2.3", + "string-width": "^8.2.0", + "strip-ansi": "^7.1.2" }, "engines": { - "node": ">=18" + "node": ">=20" }, "funding": { "url": "https://github.com/chalk/wrap-ansi?sponsor=1" @@ -15990,24 +15969,6 @@ "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, - "node_modules/wrap-ansi/node_modules/string-width": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", - "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "emoji-regex": "^10.3.0", - "get-east-asian-width": "^1.0.0", - "strip-ansi": "^7.1.0" - }, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", @@ -16102,6 +16063,7 @@ "integrity": "sha512-ml/JPOj9fOQK8RNnWojA67GbZ0ApXAUlN2UQclwv2eVgTgn7O9gg9o7paZWKMp4g0H3nTLtS9LVzhkpOFIKzog==", "dev": true, "license": "ISC", + "optional": true, "bin": { "yaml": "bin.mjs" }, diff --git a/package.json b/package.json index f389317ebe..1b19818227 100644 --- a/package.json +++ b/package.json @@ -10,6 +10,8 @@ "files": [ "bin/", "app/", + "src/lib/cli-helper/", + "@omniroute/", "open-sse/mcp-server/index.ts", "open-sse/mcp-server/server.ts", "open-sse/mcp-server/httpTransport.ts", @@ -22,13 +24,13 @@ "src/shared/contracts/", "src/shared/utils/nodeRuntimeSupport.ts", ".env.example", - "scripts/postinstall.mjs", - "scripts/postinstallSupport.mjs", - "scripts/responses-ws-proxy.mjs", - "scripts/check-supported-node-runtime.ts", - "scripts/sync-env.mjs", - "scripts/native-binary-compat.mjs", - "scripts/build-next-isolated.mjs", + "scripts/build/postinstall.mjs", + "scripts/build/postinstallSupport.mjs", + "scripts/dev/responses-ws-proxy.mjs", + "scripts/check/check-supported-node-runtime.ts", + "scripts/dev/sync-env.mjs", + "scripts/build/native-binary-compat.mjs", + "scripts/build/build-next-isolated.mjs", "README.md", "LICENSE" ], @@ -36,7 +38,7 @@ "open-sse" ], "engines": { - "node": ">=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27" + "node": ">=22.22.2 <23 || >=24.0.0 <27" }, "keywords": [ "ai", @@ -61,54 +63,67 @@ }, "homepage": "https://omniroute.online", "scripts": { - "dev": "node scripts/run-next.mjs dev", - "prebuild:docs": "node scripts/generate-docs-index.mjs", - "build": "node scripts/build-next-isolated.mjs", - "build:cli": "node --import tsx/esm scripts/prepublish.ts", - "start": "node scripts/run-next.mjs start", + "dev": "node scripts/dev/run-next.mjs dev", + "prebuild:docs": "node scripts/docs/generate-docs-index.mjs && node scripts/docs/gen-openapi-module.mjs", + "gen:provider-reference": "node --import tsx/esm scripts/docs/gen-provider-reference.ts", + "build": "node scripts/build/build-next-isolated.mjs", + "build:cli": "node --import tsx/esm scripts/build/prepublish.ts", + "start": "node scripts/dev/run-next.mjs start", "lint": "eslint .", "electron:dev": "concurrently \"npm run dev\" \"wait-on http://localhost:20128 && cd electron && npm run dev\"", "electron:build": "npm run build && cd electron && npm run build", "electron:build:win": "npm run build && cd electron && npm run build:win", "electron:build:mac": "npm run build && cd electron && npm run build:mac", "electron:build:linux": "npm run build && cd electron && npm run build:linux", - "electron:smoke:packaged": "node scripts/smoke-electron-packaged.mjs", + "electron:smoke:packaged": "node scripts/dev/smoke-electron-packaged.mjs", "test": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test --test-concurrency=10 tests/unit/*.test.ts", "test:unit": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test --test-concurrency=10 tests/unit/*.test.ts", "test:plan3": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test tests/unit/plan3-p0.test.ts", "test:fixes": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test tests/unit/fixes-p1.test.ts", "test:security": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test tests/unit/security-fase01.test.ts", - "check:cycles": "node scripts/check-cycles.mjs", - "check:route-validation:t06": "node scripts/check-route-validation.mjs", - "check:any-budget:t11": "node scripts/check-t11-any-budget.mjs", - "check:docs-sync": "node scripts/check-docs-sync.mjs", - "check:node-runtime": "node --import tsx/esm scripts/check-supported-node-runtime.ts", - "check:pack-artifact": "node --import tsx/esm scripts/validate-pack-artifact.ts", + "check:cycles": "node scripts/check/check-cycles.mjs", + "check:route-validation:t06": "node scripts/check/check-route-validation.mjs", + "check:any-budget:t11": "node scripts/check/check-t11-any-budget.mjs", + "check:docs-sync": "node scripts/check/check-docs-sync.mjs", + "check:env-doc-sync": "node scripts/check/check-env-doc-sync.mjs", + "check:docs-counts": "node scripts/check/check-docs-counts-sync.mjs", + "check:deprecated-versions": "node scripts/check/check-deprecated-versions.mjs", + "check:doc-links": "node scripts/check/check-doc-links.mjs", + "check:docs-all": "npm run check:docs-sync && npm run check:docs-counts && npm run check:env-doc-sync && npm run check:deprecated-versions && npm run check:doc-links", + "docs:render-diagrams": "node scripts/docs/render-diagrams.mjs", + "i18n:run": "node scripts/i18n/run-translation.mjs", + "i18n:run:dry": "node scripts/i18n/run-translation.mjs --dry-run", + "i18n:check": "node scripts/i18n/check-translation-drift.mjs", + "i18n:sync-ui": "node scripts/i18n/sync-ui-keys.mjs", + "i18n:sync-ui:dry": "node scripts/i18n/sync-ui-keys.mjs --dry-run", + "i18n:check-ui-coverage": "node scripts/i18n/check-ui-keys-coverage.mjs", + "check:node-runtime": "node --import tsx/esm scripts/check/check-supported-node-runtime.ts", + "check:pack-artifact": "node --import tsx/esm scripts/build/validate-pack-artifact.ts", "audit:deps": "npm audit --audit-level=moderate && npm run audit:electron", "audit:electron": "npm --prefix electron audit --audit-level=moderate", "typecheck:core": "tsc --pretty false -p tsconfig.typecheck-core.json", "typecheck:noimplicit:core": "tsc --pretty false -p tsconfig.typecheck-noimplicit-core.json", "backfill-aggregation": "node --import tsx/esm src/scripts/backfillAggregation.ts", - "env:sync": "node scripts/sync-env.mjs", - "test:integration": "node --import tsx/esm --test tests/integration/*.test.ts", - "test:e2e": "node scripts/run-playwright-tests.mjs test tests/e2e/*.spec.ts", - "test:protocols:e2e": "node scripts/run-protocol-clients-tests.mjs", + "env:sync": "node scripts/dev/sync-env.mjs", + "test:integration": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true node --import tsx/esm --test --test-force-exit --test-concurrency=1 tests/integration/*.test.ts", + "test:e2e": "node scripts/dev/run-playwright-tests.mjs test tests/e2e/*.spec.ts", + "test:protocols:e2e": "node scripts/dev/run-protocol-clients-tests.mjs", "test:vitest": "vitest run --config vitest.mcp.config.ts", - "test:ecosystem": "node scripts/run-ecosystem-tests.mjs", - "test:coverage": "c8 --output-dir coverage --exclude=tests/** --exclude=**/*.test.* --reporter=text-summary --reporter=html --reporter=json-summary --reporter=lcov --check-coverage --statements 60 --lines 60 --functions 60 --branches 60 node --import tsx/esm --test --test-concurrency=10 tests/unit/*.test.ts", + "test:ecosystem": "node scripts/dev/run-ecosystem-tests.mjs", + "test:coverage": "cross-env DISABLE_SQLITE_AUTO_BACKUP=true c8 --output-dir coverage --exclude=tests/** --exclude=**/*.test.* --reporter=text-summary --reporter=html --reporter=json-summary --reporter=lcov --check-coverage --statements 75 --lines 75 --functions 75 --branches 70 node --import tsx/esm --test --test-concurrency=1 tests/unit/*.test.ts", "test:coverage:legacy": "c8 --output-dir coverage --exclude=open-sse --check-coverage --lines 50 --functions 50 --branches 50 node --import tsx/esm --test tests/unit/*.test.ts", "coverage:report": "c8 report --output-dir coverage --exclude=tests/** --exclude=**/*.test.* --reporter=text --reporter=text-summary --reporter=html --reporter=json-summary --reporter=lcov", - "coverage:summary": "node scripts/test-report-summary.mjs --input coverage/coverage-summary.json --output coverage/coverage-report.md --threshold 60", - "check:pr-test-policy": "node scripts/check-pr-test-policy.mjs", + "coverage:summary": "node scripts/check/test-report-summary.mjs --input coverage/coverage-summary.json --output coverage/coverage-report.md --threshold 60", + "check:pr-test-policy": "node scripts/check/check-pr-test-policy.mjs", "coverage:report:legacy": "c8 report --output-dir coverage --exclude=open-sse --reporter=text --reporter=text-summary", "test:all": "npm run test:unit && npm run test:vitest && npm run test:ecosystem && npm run test:e2e", "check": "npm run lint && npm run test", "prepublishOnly": "npm run build:cli && npm run check:pack-artifact", - "postinstall": "node scripts/postinstall.mjs", - "uninstall": "node scripts/uninstall.mjs", - "uninstall:full": "node scripts/uninstall.mjs --full", + "postinstall": "node scripts/build/postinstall.mjs", + "uninstall": "node scripts/build/uninstall.mjs", + "uninstall:full": "node scripts/build/uninstall.mjs --full", "prepare": "husky", - "system-info": "node scripts/system-info.mjs" + "system-info": "node scripts/dev/system-info.mjs" }, "dependencies": { "@lobehub/icons": "^5.8.0", @@ -123,7 +138,8 @@ "express": "^5.2.1", "fetch-socks": "^1.3.3", "fuse.js": "^7.3.0", - "http-proxy-middleware": "^3.0.5", + "gray-matter": "^4.0.3", + "http-proxy-middleware": "^4.0.0", "https-proxy-agent": "^9.0.0", "ioredis": "^5.10.1", "isomorphic-dompurify": "^3.12.0", @@ -180,10 +196,9 @@ "eslint": "^9.39.4", "eslint-config-next": "16.2.6", "glob": "^13.0.6", - "gray-matter": "^4.0.3", "husky": "^9.1.7", "jsdom": "^29.1.1", - "lint-staged": "^16.4.0", + "lint-staged": "^17.0.4", "node-loader": "^2.1.0", "prettier": "^3.8.3", "tailwindcss": "^4.3.0", diff --git a/playwright.config.ts b/playwright.config.ts index 624fc5a6b1..8e6b6f893e 100644 --- a/playwright.config.ts +++ b/playwright.config.ts @@ -34,7 +34,7 @@ export default defineConfig({ }, ], webServer: { - command: `${JSON.stringify(process.execPath)} scripts/run-next-playwright.mjs ${playwrightServerMode}`, + command: `${JSON.stringify(process.execPath)} scripts/dev/run-next-playwright.mjs ${playwrightServerMode}`, url: webServerReadyUrl, reuseExistingServer: !process.env.CI, timeout: Number.isFinite(playwrightWebServerTimeout) ? playwrightWebServerTimeout : 900_000, diff --git a/pr_metadata.json b/pr_metadata.json deleted file mode 100644 index 37ad0c69a5..0000000000 --- a/pr_metadata.json +++ /dev/null @@ -1,2102 +0,0 @@ -[ - { - "additions": 149, - "author": { - "id": "MDQ6VXNlcjM1NzM4Ng==", - "is_bot": false, - "login": "andrewmunsell", - "name": "Andrew Munsell" - }, - "baseRefName": "main", - "body": "## Summary\r\n\r\n- Add tokens_compressed INTEGER column to call_logs (migration 041)\r\n- Capture compression savings from both legacy compressContext() and modular applyCompression() pipelines in chatCore.ts\r\n- Display inline ↓N purple badge in log list view tokens cell\r\n- Show \"Compressed: FROM → TO (-X%)\" badge in detail modal Input section\r\n- Bump CallLogArtifact schemaVersion from 4 to 5\r\n\r\n<img width=\"1840\" height=\"844\" alt=\"CleanShot 2026-05-03 at 20 17 14@2x\" src=\"https://github.com/user-attachments/assets/b8f9b623-0615-4bd3-b71a-1810eb6e41c4\" />\r\n<img width=\"2620\" height=\"1010\" alt=\"CleanShot 2026-05-03 at 20 17 18@2x\" src=\"https://github.com/user-attachments/assets/58ebb33b-e7cb-417a-909e-99d9d58375b2\" />\r\n\r\n## Tests Added Or Updated\r\n\r\n- Add compression tokens unit tests\r\n", - "createdAt": "2026-05-04T03:48:16Z", - "deletions": 7, - "files": [ - { - "path": "open-sse/handlers/chatCore.ts", - "additions": 7, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "src/i18n/messages/en.json", - "additions": 1, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/db/core.ts", - "additions": 4, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/db/migrationRunner.ts", - "additions": 2, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/db/migrations/041_compression_tokens.sql", - "additions": 4, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/lib/usage/callLogArtifacts.ts", - "additions": 2, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/usage/callLogs.ts", - "additions": 8, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/usage/migrations.ts", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "src/shared/components/RequestLoggerDetail.tsx", - "additions": 10, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "src/shared/components/RequestLoggerV2.tsx", - "additions": 11, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "tests/unit/call-log-cap.test.ts", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "tests/unit/compression-tokens.test.ts", - "additions": 98, - "deletions": 0, - "changeType": "ADDED" - } - ], - "headRefName": "emdash/indicate-compression-in-logs-use9w", - "number": 1923, - "title": "feat(logs): show compression tokens in request log UI" - }, - { - "additions": 1698, - "author": { - "id": "MDQ6VXNlcjE0OTIxOTgz", - "is_bot": false, - "login": "oyi77", - "name": "Paijo" - }, - "baseRefName": "release/v3.7.9", - "body": "Adds automated model assessment, categorization, and self-healing system for omniroute combos.\n\n## The Problem\nWhen providers fail (rate limits, auth errors, model deprecation), combos silently degrade. Our production experience: 2+ hours manually testing models and updating 44 combos because most returned errors.\n\n## The Solution\nThree new domain modules:\n1. **Assessor** - Probes every provider/model pair (quick/standard/deep tiers)\n2. **Categorizer** - Classifies models by capability with fitness scores\n3. **SelfHealer** - Auto-fixes combos: removes dead models, reduces weights for rate-limited, emergency-adds working alternatives\n\n## New Files\n- src/domain/assessment/assessor.ts\n- src/domain/assessment/categorizer.ts\n- src/domain/assessment/selfHealer.ts\n- src/domain/assessment/types.ts\n- src/domain/assessment/migration.ts\n- src/domain/assessment/index.ts\n- src/app/api/assess/route.ts\n- docs/RFC-AUTO-ASSESSMENT.md (full RFC)\n\n## New DB Tables\n- model_assessments, assessment_runs, combo_health, heal_actions\n\n## API\nPOST /api/assess/models - Run assessment\nGET /api/assess/models?action=working - Get working models\nGET /api/assess/models?action=combo-health - Get combo health\n\n> [!NOTE]\n> **OmniRoute Maintainer Note:** This PR has been deferred and will be accepted and redirected for the `v4.0.0` (or greater) release cycle. Please skip this PR during `v3.x` stabilization reviews.", - "createdAt": "2026-05-03T20:53:04Z", - "deletions": 0, - "files": [ - { - "path": "docs/RFC-AUTO-ASSESSMENT.md", - "additions": 518, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/app/api/assess/route.ts", - "additions": 110, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/assessor.ts", - "additions": 206, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/categorizer.ts", - "additions": 118, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/index.ts", - "additions": 24, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/migration.ts", - "additions": 109, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/selfHealer.ts", - "additions": 261, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/domain/assessment/types.ts", - "additions": 352, - "deletions": 0, - "changeType": "ADDED" - } - ], - "headRefName": "feat/auto-assessment-engine", - "number": 1918, - "title": "feat: Auto-Assessment and Self-Healing Combo Engine" - }, - { - "additions": 22666, - "author": { - "id": "MDQ6VXNlcjgwMTY4NDE=", - "is_bot": false, - "login": "diegosouzapw", - "name": "Diego Rodrigues de Sa e Souza" - }, - "baseRefName": "main", - "body": "### ✨ New Features\n\n- **feat(compression):** major upgrade to Caveman and RTK compression pipelines (#1876, #1889):\n - Add RTK tool-output compression, stacked Caveman + RTK pipelines, compression combo assignments, dashboard context pages, MCP management tools, and language-aware Caveman rule packs.\n - Expand RTK parity with a 39-filter catalog, RTK-style JSON DSL stages, inline verify/benchmark coverage, trust-gated custom filters, expanded command detection, and redacted raw-output recovery.\n - Expose rule intensities, track USD savings, unify config validation, and persist MCP savings.\n - Expand Caveman parity and MCP metadata compression.\n- **feat(provider):** update Jina AI model catalog to support Embeddings and Rerank natively (#1874 — thanks @backryun)\n- **feat(provider):** add NanoGPT image generation provider (#1899 — thanks @Aculeasis)\n- **feat(ui):** move proxy configuration to dedicated System → Proxy page (#1907 — thanks @oyi77)\n- **feat(ui):** add K/M/B/T cost shortener utility (#1902 — thanks @oyi77)\n- **feat(providers):** implement bulk paste for extra API keys (#1916 — thanks @0xtbug)\n- **feat(analytics):** usage history API key backfill + dark mode pricing (#1896 — thanks @Gi99lin)\n\n### 🐛 Bug Fixes\n\n- **fix(providers):** allow local OpenAI-compatible endpoints (like Ollama) to be added without an API key (fixes #1893)\n- **fix(copilot):** emit compatible reasoning text deltas (#1919 — thanks @ivan-mezentsev)\n- **fix(api-manager):** show validation errors inline in modals, not behind (#1920 — thanks @andrewmunsell)\n- **fix(compression):** align seeded standard savings combo with stacked default, preserve stacked defaults, and secure metadata routes.\n- **fix(gemini-cli):** separate Cloud Code transport from Antigravity (#1869 — thanks @dhaern)\n- **fix(codex):** map prompt field to input array for Cursor compatibility (fixes #1872)\n- **fix(core):** align stream parameter default to false per strict OpenAI spec (fixes #1873)\n- **fix(ui):** restore Next.js CSP `unsafe-eval` in production `script-src` to fix unresponsive Onboarding button (fixes #1883)\n- **fix(proxy):** globally strip `prompt_cache_retention` in `BaseExecutor` to prevent upstream 400 errors from strict endpoints like droid/gemini-2-pro (fixes #1884)\n- **fix(ui):** include `isOpen` dependency in `EditConnectionModal` state sync to ensure `maxConcurrent` is properly hydrated when reopening the modal (fixes #1859)\n- **fix(security):** remediate 4 polynomial-redos CodeQL alerts in compression regexes by bounding repetitions and removing overlapping quantifiers\n- **fix(codex):** flatten Chat Completions tool format to Codex Responses format in `normalizeCodexTools` — prevents `Missing required parameter: tools[0].name` upstream errors (#1914 — thanks @tranduykhanh030)\n- **fix(proxy):** add proxy-aware execution context to image generation route — proxy settings are now correctly applied for image providers behind restricted networks (#1904 — thanks @Aculeasis)\n- **fix(translator):** inject `properties: {}` into zero-argument MCP tool schemas during Anthropic→OpenAI translation — prevents 400 errors from OpenAI strict schema validation (#1898 — thanks @bryceIT)\n- **fix(codex):** sanitize raw responses input (#1895 — thanks @dhaern)\n- **fix(combos):** align strategy contracts (#1892 — thanks @dhaern)\n- **fix(combos):** fix combo provider breaker profile handling (#1891 — thanks @rdself)\n- **fix(migrations):** duplicate-column no-op fix (#1886 — thanks @smartenok-ops)\n- **fix(auth):** per-connection OAuth refresh mutex (#1885 — thanks @smartenok-ops)\n- **fix(auth):** require dashboard management auth for compression preview\n\n### 📝 Documentation\n\n- **docs(compression):** document RTK+Caveman stacked savings ranges\n\n### 🏆 Release Attribution & Retroactive Credits\n\n- **@payne0420** (PR #1828 / #1839) — Implementation of the **Rate Limit Watchdog** and environment overrides. (This feature was manually backported to v3.7.8, causing the automatic GitHub Release notes to omit the author's credit).\n", - "createdAt": "2026-05-03T20:35:53Z", - "deletions": 1470, - "files": [ - { - "path": ".agents/workflows/deploy-vps-akamai.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/deploy-vps-both.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/deploy-vps-local.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/generate-release.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/version-bump.md", - "additions": 9, - "deletions": 9, - "changeType": "MODIFIED" - }, - { - "path": "AGENTS.md", - "additions": 25, - "deletions": 9, - "changeType": "MODIFIED" - }, - { - "path": "CHANGELOG.md", - "additions": 47, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "README.md", - "additions": 71, - "deletions": 29, - "changeType": "MODIFIED" - }, - { - "path": "docs/API_REFERENCE.md", - "additions": 32, - "deletions": 13, - "changeType": "MODIFIED" - }, - { - "path": "docs/ARCHITECTURE.md", - "additions": 16, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/COMPRESSION_ENGINES.md", - "additions": 143, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "docs/COMPRESSION_GUIDE.md", - "additions": 105, - "deletions": 12, - "changeType": "MODIFIED" - }, - { - "path": "docs/COMPRESSION_LANGUAGE_PACKS.md", - "additions": 96, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "docs/COMPRESSION_RULES_FORMAT.md", - "additions": 186, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "docs/ENVIRONMENT.md", - "additions": 6, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "docs/FEATURES.md", - "additions": 16, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/MCP-SERVER.md", - "additions": 55, - "deletions": 19, - "changeType": "MODIFIED" - }, - { - "path": "docs/RTK_COMPRESSION.md", - "additions": 234, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "docs/SETUP_GUIDE.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/openapi.yaml", - "additions": 199, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "electron/package-lock.json", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "electron/package.json", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "llm.txt", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "next.config.mjs", - "additions": 8, - "deletions": 95, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/config/embeddingRegistry.ts", - "additions": 62, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/config/imageRegistry.ts", - "additions": 14, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/config/rerankRegistry.ts", - "additions": 44, - "deletions": 8, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/executors/base.ts", - "additions": 3, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/executors/codex.ts", - "additions": 75, - "deletions": 5, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/handlers/chatCore.ts", - "additions": 338, - "deletions": 68, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/handlers/imageGeneration.ts", - "additions": 1, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/handlers/responseSanitizer.ts", - "additions": 3, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/mcp-server/README.md", - "additions": 17, - "deletions": 9, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/mcp-server/descriptionCompressor.ts", - "additions": 243, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/mcp-server/schemas/tools.ts", - "additions": 121, - "deletions": 32, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/mcp-server/server.ts", - "additions": 41, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/mcp-server/tools/advancedTools.ts", - "additions": 15, - "deletions": 16, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/mcp-server/tools/compressionTools.ts", - "additions": 157, - "deletions": 11, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/package.json", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/AGENTS.md", - "additions": 5, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/accountFallback.ts", - "additions": 21, - "deletions": 5, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/autoCombo/index.ts", - "additions": 1, - "deletions": 10, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/combo.ts", - "additions": 56, - "deletions": 7, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/compression/aggressive.ts", - "additions": 19, - "deletions": 29, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/compression/caveman.ts", - "additions": 310, - "deletions": 31, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/compression/cavemanRules.ts", - "additions": 189, - "deletions": 15, - "changeType": "MODIFIED" - }, - { - "path": "open-sse/services/compression/diffHelper.ts", - "additions": 117, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/cavemanAdapter.ts", - "additions": 408, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/index.ts", - "additions": 14, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/registry.ts", - "additions": 87, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/codeStripper.ts", - "additions": 128, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/commandDetector.ts", - "additions": 465, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/deduplicator.ts", - "additions": 37, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filterLoader.ts", - "additions": 220, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filterSchema.ts", - "additions": 182, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/aws.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/biome.json", - "additions": 35, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/build-eslint.json", - "additions": 37, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/build-typescript.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/build-vite.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/build-webpack.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/bundle-install.json", - "additions": 35, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/curl.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/df.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/docker-logs.json", - "additions": 42, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/docker-ps.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/du.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/error-stacktrace.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/gcloud.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/generic-output.json", - "additions": 32, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/git-branch.json", - "additions": 45, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/git-diff.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/git-log.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/git-status.json", - "additions": 40, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/golangci-lint.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/json-output.json", - "additions": 40, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/make.json", - "additions": 38, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/mypy.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/npm-audit.json", - "additions": 43, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/npm-install.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/nx.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/pip.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/playwright.json", - "additions": 42, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/poetry-install.json", - "additions": 35, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/prettier.json", - "additions": 40, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/ps.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/rsync.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/rubocop.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/ruff.json", - "additions": 40, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/shell-find.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/shell-grep.json", - "additions": 37, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/shell-ls.json", - "additions": 33, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/ssh.json", - "additions": 43, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/systemctl-status.json", - "additions": 43, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/terraform-plan.json", - "additions": 34, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/test-cargo.json", - "additions": 42, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/test-go.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/test-jest.json", - "additions": 43, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/test-pytest.json", - "additions": 41, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "open-sse/services/compression/engines/rtk/filters/test-vitest.json", - "additions": 43, - "deletions": 0, - "changeType": "ADDED" - } - ], - "headRefName": "release/v3.7.9", - "number": 1917, - "title": "Release v3.7.9" - }, - { - "additions": 788, - "author": { - "id": "MDQ6VXNlcjI0MTk4NDIy", - "is_bot": false, - "login": "backryun", - "name": "backryun" - }, - "baseRefName": "release/v3.7.9", - "body": "## Summary\r\n\r\ncompletely removing support for Node.js 20.\r\nNode.js 20 has reached EOL.\r\n<img width=\"334\" height=\"327\" alt=\"image\" src=\"https://github.com/user-attachments/assets/f88758e4-fd6e-478e-88e4-8819d0c5e8e0\" />\r\n\r\n## Validation\r\n\r\n- [x] `npm run lint`\r\n- [x] `npm run test:unit`\r\n- [ ] `npm run test:coverage`\r\n- [ ] Coverage is still `>= 60%` for statements, lines, functions, and branches\r\n\r\n## Tests Added Or Updated\r\n\r\nUpdated automated test files:\r\n\r\n- `tests/unit/node-runtime-support.test.ts`\r\n- `tests/unit/chatcore-sanitization.test.ts`\r\n- `tests/unit/codex-stream-false.test.ts`\r\n- `tests/unit/t26-ai-sdk-accept-header-compat.test.ts`\r\n- `tests/integration/chat-pipeline.test.ts`\r\n- `tests/e2e/protocol-clients.test.ts`\r\n\r\nProduction code changed: Node runtime support logic was updated in `src/shared/utils/nodeRuntimeSupport.ts` and `bin/nodeRuntimeSupport.mjs`.\r\n\r\n## Coverage Notes\r\n\r\nThis PR changes `src/` and `bin/`.\r\n\r\nCoverage for the runtime support change is primarily provided by:\r\n\r\n- `tests/unit/node-runtime-support.test.ts`\r\n- `npm run check:node-runtime`\r\n\r\nAdditional regression coverage was run through:\r\n\r\n- `npm run test:unit`\r\n- `npm run test:integration`\r\n- `npm run test:e2e`\r\n- `npm run test:protocols:e2e`\r\n\r\n`npm run test:coverage` was not run, so coverage movement for touched files has not been measured yet. Follow-up before merge: run `npm run test:coverage` and confirm statements, lines, functions, and branches remain `>= 60%`.\r\n\r\n## Reviewer Notes\r\n\r\n- Node.js 20 support is removed from runtime policy, package engines, CI, docs, and runtime warning copy.\r\n- Supported runtime policy is now Node.js `>=22.22.2 <23 || >=24.0.0 <25`.\r\n- CI matrix and local version files now target Node 22/24 support.\r\n- Docs and i18n runtime wording were updated broadly; reviewers should expect many documentation-only diffs.\r\n- `tests/e2e/protocol-clients.test.ts` now explicitly enables A2A before validating the A2A flow, matching the current default where A2A starts disabled.\r\n- Manual validation was performed on Node `v22.22.2`.\n\n> [!NOTE]\n> **OmniRoute Maintainer Note:** This PR has been deferred and will be accepted and redirected for the `v4.0.0` (or greater) release cycle. Please skip this PR during `v3.x` stabilization reviews.", - "createdAt": "2026-05-03T14:11:25Z", - "deletions": 776, - "files": [ - { - "path": ".dockerignore", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".env.example", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".github/workflows/ci.yml", - "additions": 8, - "deletions": 5, - "changeType": "MODIFIED" - }, - { - "path": ".npmignore", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "AGENTS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "CLAUDE.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "Dockerfile", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "README.md", - "additions": 10, - "deletions": 10, - "changeType": "MODIFIED" - }, - { - "path": "bin/nodeRuntimeSupport.mjs", - "additions": 3, - "deletions": 5, - "changeType": "MODIFIED" - }, - { - "path": "compose.prod.yaml", - "additions": 3, - "deletions": 3, - "changeType": "RENAMED" - }, - { - "path": "compose.yaml", - "additions": 0, - "deletions": 0, - "changeType": "RENAMED" - }, - { - "path": "docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bg/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/bn/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/da/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/de/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/es/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fa/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fi/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/docs/RELEASE_CHECKLIST.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/docs/TROUBLESHOOTING.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/fr/llm.txt", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/gu/CONTRIBUTING.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/gu/README.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/gu/docs/CLI-TOOLS.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/gu/docs/ENVIRONMENT.md", - "additions": 3, - "deletions": 3, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/gu/docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - } - ], - "headRefName": "release/v3.7.9", - "number": 1915, - "title": "[will be merge 4.0 update] (Security Fix): Drop node.js 20 support + Update docker files to lastest docker standards" - }, - { - "additions": 1119, - "author": { - "id": "U_kgDODPQT-Q", - "is_bot": false, - "login": "vrdons", - "name": "" - }, - "baseRefName": "release/v3.7.9", - "body": "## Summary\r\n\r\nTo allow using on bun interface, faster typescript checks\r\n\r\n## Related Issues\r\nNone\r\n\r\n## Validation\r\n\r\n- [x] `npm run lint`\r\n- [ ] `npm run test:unit`\r\nNo, because last tests stucks\r\n- [x] `npm run test:coverage`\r\n- [ ] Coverage is still `>= 60%` for statements, lines, functions, and branches\r\n- [ ] SonarQube PR analysis is green or any remaining issues are explicitly documented below\r\n\r\n## Tests Added Or Updated\r\n\r\n- List every changed or added automated test file.\r\n- If no production code changed, state that here.\r\n\r\n## Coverage Notes\r\n\r\n- If this PR changes `src/`, `open-sse/`, `electron/`, or `bin/`, explain which tests cover the change.\r\n- If coverage moved down in any touched file, explain why and what follow-up task will recover it.\r\n\r\n## Reviewer Notes\r\n\r\n- Call out any risky areas, migrations, feature flags, or manual validation that reviewers should know about.\r\n\n> [!NOTE]\n> **OmniRoute Maintainer Note:** This PR has been deferred and will be accepted and redirected for the `v4.0.0` (or greater) release cycle. Please skip this PR during `v3.x` stabilization reviews.", - "createdAt": "2026-05-02T17:57:46Z", - "deletions": 231022, - "files": [ - { - "path": ".agents/workflows/deploy-vps-akamai.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/deploy-vps-both.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/deploy-vps-local.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": ".agents/workflows/generate-release.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "AGENTS.md", - "additions": 4, - "deletions": 4, - "changeType": "MODIFIED" - }, - { - "path": "CLAUDE.md", - "additions": 1, - "deletions": 218, - "changeType": "MODIFIED" - }, - { - "path": "GEMINI.md", - "additions": 1, - "deletions": 21, - "changeType": "MODIFIED" - }, - { - "path": "README.md", - "additions": 63, - "deletions": 36, - "changeType": "MODIFIED" - }, - { - "path": "docs/API_REFERENCE.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/ARCHITECTURE.md", - "additions": 2, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "docs/CODEBASE_DOCUMENTATION.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/ENVIRONMENT.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/FEATURES.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/I18N.md", - "additions": 82, - "deletions": 52, - "changeType": "MODIFIED" - }, - { - "path": "docs/SETUP_GUIDE.md", - "additions": 9, - "deletions": 8, - "changeType": "MODIFIED" - }, - { - "path": "docs/TERMUX_GUIDE.md", - "additions": 2, - "deletions": 10, - "changeType": "MODIFIED" - }, - { - "path": "docs/TROUBLESHOOTING.md", - "additions": 17, - "deletions": 41, - "changeType": "MODIFIED" - }, - { - "path": "docs/UNINSTALL.md", - "additions": 12, - "deletions": 12, - "changeType": "MODIFIED" - }, - { - "path": "docs/USER_GUIDE.md", - "additions": 2, - "deletions": 10, - "changeType": "MODIFIED" - }, - { - "path": "docs/VM_DEPLOYMENT_GUIDE.md", - "additions": 1, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/ar/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/ar/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/ar/README.md", - "additions": 2, - "deletions": 13, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/ar/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bg/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bg/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bg/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bg/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bn/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bn/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/bn/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/cs/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/cs/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/cs/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/cs/README.md", - "additions": 0, - "deletions": 2379, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/A2A-SERVER.md", - "additions": 0, - "deletions": 200, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/API_REFERENCE.md", - "additions": 0, - "deletions": 469, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/ARCHITECTURE.md", - "additions": 0, - "deletions": 891, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/AUTO-COMBO.md", - "additions": 0, - "deletions": 67, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/CLI-TOOLS.md", - "additions": 0, - "deletions": 398, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/CODEBASE_DOCUMENTATION.md", - "additions": 0, - "deletions": 591, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/COVERAGE_PLAN.md", - "additions": 0, - "deletions": 170, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/ENVIRONMENT.md", - "additions": 0, - "deletions": 669, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/FEATURES.md", - "additions": 0, - "deletions": 270, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/FLY_IO_DEPLOYMENT_GUIDE.md", - "additions": 0, - "deletions": 455, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/I18N.md", - "additions": 0, - "deletions": 441, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/MCP-SERVER.md", - "additions": 0, - "deletions": 87, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/RELEASE_CHECKLIST.md", - "additions": 0, - "deletions": 44, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/TROUBLESHOOTING.md", - "additions": 0, - "deletions": 341, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/UNINSTALL.md", - "additions": 0, - "deletions": 157, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/USER_GUIDE.md", - "additions": 0, - "deletions": 966, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/VM_DEPLOYMENT_GUIDE.md", - "additions": 0, - "deletions": 407, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/cloudflare-zero-trust-guide.md", - "additions": 0, - "deletions": 106, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/docs/features/context-relay.md", - "additions": 0, - "deletions": 130, - "changeType": "MODIFIED" - }, - { - "path": "docs/i18n/cs/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/da/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/da/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/da/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/da/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/de/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/de/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/de/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/de/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/es/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/es/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/es/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/es/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fa/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fa/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fa/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fi/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fi/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fi/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fi/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fr/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fr/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fr/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/fr/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/gu/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/gu/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/gu/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/he/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/he/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/he/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/he/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hi/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hi/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hi/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hi/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hu/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hu/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hu/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/hu/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/id/CHANGELOG.md", - "additions": 0, - "deletions": 4921, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/id/CLAUDE.md", - "additions": 0, - "deletions": 233, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/id/GEMINI.md", - "additions": 0, - "deletions": 25, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/id/llm.txt", - "additions": 0, - "deletions": 476, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/in/CHANGELOG.md", - "additions": 0, - "deletions": 3232, - "changeType": "DELETED" - }, - { - "path": "docs/i18n/in/CLAUDE.md", - "additions": 0, - "deletions": 229, - "changeType": "DELETED" - } - ], - "headRefName": "main", - "number": 1894, - "title": "refactor(db): migrate from better-sqlite3 to node:sqlite, use tsgo" - }, - { - "additions": 276, - "author": { - "id": "U_kgDOD9eSjQ", - "is_bot": false, - "login": "smartenok-ops", - "name": "" - }, - "baseRefName": "release/v3.7.9", - "body": "When a codex SSE stream hits 429 mid-task, OmniRoute previously gave up (maxAttempts=1, no rotation). Add retry with account rotation when session affinity allows.\r\n\r\nDepends on: per-session sticky routing PR (extractSessionAffinityKey, deleteSessionAccountAffinity).\r\n\r\n## Summary\r\n\r\n- Describe the user-facing or operational change.\r\n\r\n## Related Issues\r\n\r\n- Closes #\r\n- Related to #\r\n\r\n## Validation\r\n\r\n- [ ] `npm run lint`\r\n- [ ] `npm run test:unit`\r\n- [ ] `npm run test:coverage`\r\n- [ ] Coverage is still `>= 60%` for statements, lines, functions, and branches\r\n- [ ] SonarQube PR analysis is green or any remaining issues are explicitly documented below\r\n\r\n## Tests Added Or Updated\r\n\r\n- List every changed or added automated test file.\r\n- If no production code changed, state that here.\r\n\r\n## Coverage Notes\r\n\r\n- If this PR changes `src/`, `open-sse/`, `electron/`, or `bin/`, explain which tests cover the change.\r\n- If coverage moved down in any touched file, explain why and what follow-up task will recover it.\r\n\r\n## Reviewer Notes\r\n\r\n- Call out any risky areas, migrations, feature flags, or manual validation that reviewers should know about.\r\n\n> [!NOTE]\n> **OmniRoute Maintainer Note:** This PR has been deferred and will be accepted and redirected for the `v4.0.0` (or greater) release cycle. Please skip this PR during `v3.x` stabilization reviews.", - "createdAt": "2026-05-02T16:06:11Z", - "deletions": 2, - "files": [ - { - "path": "open-sse/handlers/chatCore.ts", - "additions": 84, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "tests/unit/codex-failover.test.ts", - "additions": 192, - "deletions": 0, - "changeType": "ADDED" - } - ], - "headRefName": "feat/codex-429-mid-task-failover", - "number": 1888, - "title": "feat(sse): codex 429 mid-task failover with account rotation" - }, - { - "additions": 461, - "author": { - "id": "U_kgDOD9eSjQ", - "is_bot": false, - "login": "smartenok-ops", - "name": "" - }, - "baseRefName": "release/v3.7.9", - "body": "When concurrent SSE clients use a shared OmniRoute key, randomized account selection causes per-session inconsistencies (one stream hits account A, next request from same logical session hits B). Adds session_account_affinity table + extractSessionAffinityKey helper so a session_key (e.g. SHA of input headers) deterministically pins to one account for its lifetime.\r\n\r\nMigration: 041_session_account_affinity.sql (renumbered from local 026 — please confirm next available slot).\r\n\r\n## Summary\r\n\r\n- Describe the user-facing or operational change.\r\n\r\n## Related Issues\r\n\r\n- Closes #\r\n- Related to #\r\n\r\n## Validation\r\n\r\n- [ ] `npm run lint`\r\n- [ ] `npm run test:unit`\r\n- [ ] `npm run test:coverage`\r\n- [ ] Coverage is still `>= 60%` for statements, lines, functions, and branches\r\n- [ ] SonarQube PR analysis is green or any remaining issues are explicitly documented below\r\n\r\n## Tests Added Or Updated\r\n\r\n- List every changed or added automated test file.\r\n- If no production code changed, state that here.\r\n\r\n## Coverage Notes\r\n\r\n- If this PR changes `src/`, `open-sse/`, `electron/`, or `bin/`, explain which tests cover the change.\r\n- If coverage moved down in any touched file, explain why and what follow-up task will recover it.\r\n\r\n## Reviewer Notes\r\n\r\n- Call out any risky areas, migrations, feature flags, or manual validation that reviewers should know about.\r\n\n> [!NOTE]\n> **OmniRoute Maintainer Note:** This PR has been deferred and will be accepted and redirected for the `v4.0.0` (or greater) release cycle. Please skip this PR during `v3.x` stabilization reviews.", - "createdAt": "2026-05-02T16:05:53Z", - "deletions": 122, - "files": [ - { - "path": "src/instrumentation-node.ts", - "additions": 10, - "deletions": 5, - "changeType": "MODIFIED" - }, - { - "path": "src/lib/db/migrations/041_session_account_affinity.sql", - "additions": 11, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/lib/db/sessionAccountAffinity.ts", - "additions": 122, - "deletions": 0, - "changeType": "ADDED" - }, - { - "path": "src/lib/localDb.ts", - "additions": 10, - "deletions": 0, - "changeType": "MODIFIED" - }, - { - "path": "src/sse/handlers/chat.ts", - "additions": 14, - "deletions": 1, - "changeType": "MODIFIED" - }, - { - "path": "src/sse/services/auth.ts", - "additions": 177, - "deletions": 2, - "changeType": "MODIFIED" - }, - { - "path": "tests/unit/sse-auth.test.ts", - "additions": 117, - "deletions": 114, - "changeType": "MODIFIED" - } - ], - "headRefName": "feat/per-session-sticky-routing", - "number": 1887, - "title": "feat(auth): per-session sticky routing for codex" - } -] diff --git a/public/providers/bazaarlink.svg b/public/providers/bazaarlink.svg new file mode 100644 index 0000000000..3cf817478f --- /dev/null +++ b/public/providers/bazaarlink.svg @@ -0,0 +1,7 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- Generator: visioncortex VTracer 0.6.12 --> +<svg version="1.1" viewBox="0 0 880 980" xmlns="http://www.w3.org/2000/svg"> + <path transform="translate(461 121)" d="m0 0c5.54 1.02 10.5 3.1 15.5 5.66 1.9 0.964 3.82 1.81 5.79 2.62 3.64 1.53 7.09 3.35 10.6 5.23 0.652 0.351 1.3 0.702 1.96 1.05 1.35 0.725 2.69 1.45 4.04 2.18 2.85 1.54 5.71 3.06 8.57 4.59 1.56 0.831 3.12 1.66 4.68 2.49 0.625 0.333 1.25 0.667 1.88 1 1.25 0.667 2.5 1.33 3.75 2 0.155 0.0825 0.155 0.0825 0.938 0.5 0.625 0.333 1.25 0.667 1.87 1 1.56 0.834 3.13 1.67 4.69 2.5 3.1 1.65 6.2 3.31 9.3 4.96 2.79 1.49 5.59 2.98 8.38 4.47 1.67 0.892 3.35 1.78 5.02 2.68 2.16 1.15 4.32 2.3 6.48 3.45 0.355 0.189 0.711 0.378 1.08 0.573 3.74 1.99 7.49 3.95 11.3 5.81 0.312 0.153 0.624 0.305 0.945 0.462 0.613 0.3 1.23 0.6 1.84 0.899 4.14 2.03 8.02 4.02 11.7 6.86 2.89 2.18 6.11 3.68 9.36 5.25 4.47 2.17 8.87 4.47 13.3 6.8 6.41 3.4 12.8 6.74 19.3 9.96 5.21 2.58 10.4 5.25 15.5 8.03 11.7 6.34 23.4 12.5 35.3 18.4 3.01 1.48 6.01 2.97 9.01 4.47 0.345 0.172 0.691 0.344 1.05 0.521 4.34 2.16 8.65 4.36 12.9 6.78 1.89 1.09 3.81 2.08 5.77 3.04 2.09 1.03 4.12 2.13 6.12 3.32 0.254 0.15 0.508 0.301 0.769 0.456 0.26 0.154 0.52 0.308 0.788 0.467 5.68 3.37 11.5 6.35 17.5 9.11 26.5 12.2 26.5 12.2 34.7 20.2 7.54 7.67 12.7 17.9 17.2 27.5 2.81 6.18 4.54 12.7 5.1 19.5 0.193 4.07 0.183 8.14 0.201 12.2 0.00811 1.66 0.0218 3.32 0.0347 4.98 0.0245 3.26 0.044 6.52 0.0617 9.78 0.0212 3.85 0.0478 7.71 0.0744 11.6 0.0541 7.85 0.101 15.7 0.146 23.5 0.032 5.59 0.0653 11.2 0.0998 16.8 0.5 81.1 0.5 81.1-0.00797 201-0.0262 2.79-0.0521 5.57-0.0771 8.36-0.0519 5.79-0.106 11.6-0.169 17.4-0.0261 2.4-0.051 4.81-0.0724 7.21-0.0778 8.6-0.185 17.2-0.705 25.8-0.0162 0.297-0.0323 0.593-0.049 0.899-0.372 6.59-2.1 12.6-4.54 18.8-0.101 0.256-0.202 0.512-0.305 0.776-2.4 6.05-5.45 11.4-9.75 16.3-4.72 5.25-9.97 9.07-16.1 12.4-0.875 0.48-1.75 0.965-2.62 1.45-6.07 3.37-12.2 6.66-18.6 9.35-4.44 1.92-8.67 4.27-12.9 6.55-4.82 2.58-9.66 5.11-14.6 7.53-14.6 7.21-28.9 15-43.2 22.8-9.48 5.19-19 10.4-28.7 15.1-4.35 2.15-8.63 4.41-12.9 6.71-4.02 2.16-8.03 4.3-12.1 6.31-12.6 6.2-24.9 12.9-37.2 19.6-0.119 0.0645-0.119 0.0645-0.719 0.391-2.76 1.5-5.51 3-8.26 4.51-1.61 0.88-3.22 1.76-4.83 2.64-0.704 0.383-1.41 0.766-2.11 1.15-0.468 0.255-0.936 0.51-1.4 0.764-2.28 1.24-4.55 2.48-6.8 3.76-5.22 2.97-10.6 5.65-15.9 8.32-4.39 2.18-8.73 4.4-13 6.82-3.24 1.84-6.56 3.5-9.9 5.14-1.45 0.715-2.9 1.44-4.35 2.17-0.807 0.404-1.61 0.807-2.42 1.21-2.37 1.18-4.73 2.37-7.08 3.58-13 6.7-13 6.7-19.1 8.93-0.379 0.143-0.758 0.286-1.15 0.434-7.85 2.73-16 3.58-24.2 3.5-0.455-0.00249-0.91-0.00498-1.38-0.00754-8.41-0.0706-16.3-0.739-24.3-3.63-4.76-1.79-9.35-3.94-13.9-6.12-1.24-0.585-2.48-1.16-3.71-1.74-9.25-4.3-18.5-8.67-27.4-13.6-2.87-1.58-5.73-3.07-8.8-4.23-1.86-0.714-3.5-1.69-5.19-2.72-2.76-1.68-5.6-3.22-8.44-4.75-0.144-0.0777-0.144-0.0777-0.873-0.471-3.31-1.78-6.59-3.5-10.1-4.9-4.2-1.71-8.22-3.86-12.3-5.91-1.42-0.719-2.84-1.43-4.27-2.14-3.52-1.74-7.01-3.52-10.5-5.37-0.359-0.192-0.718-0.384-1.09-0.581-1.46-0.783-2.93-1.57-4.39-2.35-3.64-1.96-7.2-3.85-11.1-5.3-1.69-0.718-3.2-1.7-4.76-2.67-2.35-1.43-4.86-2.59-7.33-3.8-8.87-4.35-8.87-4.35-12.7-6.68-1.62-0.971-3.28-1.83-4.97-2.66-2.47-1.22-4.92-2.49-7.36-3.79-0.353-0.188-0.707-0.376-1.07-0.569-1.46-0.775-2.91-1.55-4.37-2.33-4.85-2.58-9.72-5.1-14.6-7.54-1.33-0.658-2.65-1.32-3.97-1.99-1.8-0.9-3.6-1.8-5.4-2.69-1.45-0.715-2.89-1.43-4.34-2.15-0.152-0.0756-0.152-0.0756-0.923-0.458-3.77-1.88-7.49-3.81-11.1-5.92-3.04-1.75-6.07-3.07-9.38-4.23-2.37-0.838-4.36-1.85-6.44-3.28-1.21-0.692-2.35-1.17-3.64-1.67-2.63-1.02-5.02-2.31-7.47-3.7-4.5-2.51-9.07-4.84-13.7-7.12-6.59-3.26-13.1-6.65-19.6-10.1-4.44-2.35-8.88-4.69-13.4-6.91-16.6-8.22-16.6-8.22-22.5-14.2-0.267-0.269-0.533-0.539-0.808-0.816-3.45-3.56-6.15-7.3-8.18-11.8-0.339-0.788-0.675-1.58-1.01-2.37-0.102-0.239-0.204-0.478-0.309-0.724-0.698-1.64-1.38-3.28-2.04-4.94-0.22-0.547-0.442-1.09-0.667-1.64-2.46-6-2.96-12-3.23-18.5-0.113-2.87-0.2-5.74-0.281-8.61-0.0303-1.07-0.0617-2.14-0.0932-3.21-0.516-17.7-0.53-35.4-0.517-53.1 0.00226-3.34 0.00214-6.69 6.2e-4 -10-2.2e-4 -0.488-4.41e-4 -0.977-6.68e-4 -1.48-4.58e-4 -0.995-9.21e-4 -1.99-0.00139-2.99-0.00505-11.2 3.23e-4 -22.4 0.00793-33.6 0.00274-4.03 0.0049-8.07 0.00659-12.1 1.13e-4 -0.267 2.25e-4 -0.534 3.41e-4 -0.809 2.28e-4 -0.54 4.55e-4 -1.08 6.82e-4 -1.62 1.13e-4 -0.267 2.26e-4 -0.535 3.42e-4 -0.81 1.12e-4 -0.267 2.25e-4 -0.535 3.4e-4 -0.81 0.0112-26.4 0.0389-52.9 0.391-156 0.0312-4.81 0.0552-9.62 0.075-14.4 0.0222-5.36 0.055-10.7 0.103-16.1 0.0234-2.66 0.0429-5.31 0.0491-7.97 0.031-11.1 0.136-21.8 3.95-32.4 0.775-2.02 1.63-3.98 2.6-5.92 0.462-0.921 0.903-1.85 1.34-2.78 1.42-2.95 2.9-5.66 4.95-8.23 0.9-1.13 1.61-2.32 2.34-3.57 0.13-0.22 0.259-0.441 0.393-0.668 0.309-0.526 0.615-1.05 0.92-1.58 0.99-0.33 1.98-0.66 3-1 0.0965-0.251 0.193-0.502 0.292-0.761 0.498-1.15 1.03-2.18 1.71-3.24 1.25-1.27 2.65-2.25 4.12-3.25 0.211-0.146 0.422-0.291 0.639-0.441 5.7-3.91 12-6.78 18.2-9.79 3.21-1.57 6.35-3.26 9.49-4.97 6.93-3.77 14-7.19 21.2-10.5 3.44-1.6 6.8-3.18 10-5.19 3.24-2.01 6.62-3.79 9.96-5.63 0.889-0.491 1.78-0.983 2.66-1.48 4.35-2.42 8.67-4.82 13.3-6.71 3.51-1.44 6.88-3.16 10.3-4.86 0.348-0.175 0.697-0.349 1.06-0.529 4.76-2.39 9.46-4.85 14.1-7.44 3.94-2.18 7.96-4.17 12-6.17 4.18-2.07 8.31-4.22 12.4-6.49 3.52-1.95 7.1-3.78 10.7-5.57 4.18-2.06 8.29-4.22 12.4-6.47 3-1.65 6.02-3.26 9.05-4.85 0.395-0.206 0.789-0.412 1.2-0.625 0.817-0.427 1.63-0.854 2.45-1.28 6.27-3.28 12.5-6.6 18.6-10.1 4.34-2.51 8.7-4.92 13.2-7.1 2.35-1.14 4.69-2.3 7.03-3.46 0.261-0.13 0.522-0.26 0.791-0.393 3.22-1.6 6.39-3.26 9.52-5.04 4.07-2.31 8.24-4.41 12.4-6.5 0.346-0.172 0.691-0.344 1.05-0.521 3.03-1.51 6.05-3 9.08-4.5 1.71-0.844 3.41-1.69 5.12-2.54 0.277-0.138 0.555-0.276 0.84-0.418 5.84-2.91 11.6-5.96 17.4-9.04 0.341-0.182 0.683-0.364 1.03-0.552 0.669-0.357 1.34-0.715 2.01-1.07 1.49-0.795 2.99-1.57 4.51-2.31 0.265-0.128 0.529-0.257 0.802-0.389 0.693-0.333 1.39-0.659 2.08-0.985 1.22-0.627 2.24-1.42 3.32-2.27 2.04-1.56 4.06-2.49 6.46-3.35 0.417-0.152 0.835-0.303 1.26-0.459 1.37-0.485 2.75-0.949 4.13-1.4 0.237-0.0784 0.474-0.157 0.719-0.238 11.9-3.9 24.3-4.82 36.7-2.9zm-33.5 27.1c-7.04 3.04-13.8 6.63-20.3 10.7-2.45 1.53-4.9 2.77-7.56 3.88-3.97 1.65-7.61 3.71-11.3 5.88-5.02 2.93-10.1 5.64-15.3 8.19-5.59 2.74-11 5.65-16.4 8.75-4.75 2.72-9.46 5.25-14.5 7.44-4.07 1.78-8.05 3.71-12 5.69-0.339 0.169-0.679 0.338-1.03 0.512-5.59 2.8-11 5.81-16.4 8.95-3.23 1.88-6.47 3.67-9.84 5.29-2.49 1.21-4.91 2.52-7.33 3.86-4.37 2.42-8.78 4.72-13.3 6.94-0.289 0.144-0.578 0.288-0.876 0.436-2.82 1.4-5.64 2.8-8.46 4.18-13.9 6.83-13.9 6.83-20.4 10.9-3.29 2.03-6.68 3.76-10.1 5.45-3.75 1.84-7.44 3.75-11.1 5.74-7.66 4.17-15.4 8.14-23.3 11.8-0.349 0.162-0.698 0.325-1.06 0.492-0.354 0.165-0.708 0.329-1.07 0.498-6.87 3.19-13.6 6.53-20.3 10.1-4.13 2.24-8.31 4.37-12.5 6.44-3.03 1.5-6.05 3.02-9.07 4.56-0.35 0.177-0.7 0.354-1.06 0.537-14 7.12-14 7.12-18.3 11.7-1.67 1.84-3.17 3.78-4.62 5.79l-1 9c1.76 2.6 3.43 4.64 5.95 6.53 4.72 3.33 9.63 5.78 14.9 8 1.88 0.807 3.71 1.7 5.55 2.6 0.165 0.0794 0.165 0.0794 1 0.481 1.42 0.706 2.45 1.28 3.56 2.43 1 0.965 1 0.965 1.78 1.32 0.946 0.337 1.9 0.648 2.85 0.954 3.42 1.18 6.34 2.74 9.32 4.8 2.02 1.36 4.06 2.36 6.3 3.28 3.68 1.53 7.18 3.33 10.7 5.22 1.09 0.588 2.19 1.17 3.29 1.76 3.32 1.77 6.64 3.55 9.95 5.34 1.33 0.719 2.67 1.44 4.01 2.15 0.913 0.492 1.82 0.988 2.74 1.48 3.17 1.71 6.36 3.24 9.69 4.63 2.08 0.871 4.04 1.85 5.96 3.02 2.24 1.35 4.54 2.56 6.89 3.73 3.34 1.66 6.64 3.39 9.94 5.13 0.742 0.39 1.48 0.779 2.23 1.17 3.58 1.87 7.12 3.72 10.4 6.03 3.01 2.08 6.2 3.68 9.49 5.27 1.77 0.858 3.53 1.73 5.3 2.61 0.355 0.175 0.709 0.351 1.07 0.532 3.25 1.61 6.46 3.31 9.64 5.04 0.26 0.141 0.519 0.282 0.787 0.427 1.06 0.576 2.12 1.15 3.18 1.73 3.59 1.95 7.19 3.87 10.8 5.78 0.953 0.507 1.91 1.01 2.86 1.52 0.316 0.168 0.632 0.336 0.957 0.509 2.2 1.17 4.39 2.35 6.58 3.53 9.01 4.85 18.1 9.46 27.3 14 8.44 4.18 16.9 8.4 25.1 12.9 0.625 0.337 1.25 0.673 1.88 1.01 0.315 0.17 0.631 0.339 0.956 0.514 2.53 1.36 5.08 2.7 7.62 4.02 39.3 20.5 39.3 20.5 49.4 31.6 4.02 4.71 7.74 10.2 10 16 0.638 2.14 0.906 4.35 1.17 6.56 0.0395 0.301 0.0789 0.602 0.12 0.911 0.816 6.23 0.992 12.4 0.955 18.7-0.0068 1.53-0.00163 3.06 0.0018 4.59 0.00493 3-6.48e-4 5.99-0.00991 8.99-0.0105 3.56-0.00964 7.12-0.00861 10.7 0.00164 7.28-0.0105 14.6-0.0272 21.9-0.0127 5.58-0.021 11.2-0.0266 16.8-0.0357 34.6-0.125 69.3-0.598 118-0.0152 1.42-0.0301 2.84-0.045 4.26-0.214 20.3-0.563 40.6-1.09 60.9-0.407 15.7-0.631 31.4-0.628 47.1-3.64e-4 2.52-0.0123 5.04-0.0259 7.56-0.0131 2.51-0.0184 5.02-0.0178 7.53 2.51e-4 1.46-0.00234 2.93-0.0132 4.39-0.00972 1.34-0.00974 2.69-0.00248 4.03 0.00152 0.713-0.00673 1.43-0.0154 2.14 0.0178 1.85 0.109 3.53 0.721 5.28 0.478 1.2 1 2.39 1.54 3.56l5 3 11-1 5-4c0.114-20.9 0.0873-41.8-0.212-62.7-0.0106-0.744-0.0212-1.49-0.0317-2.23-0.0217-1.53-0.0435-3.05-0.0653-4.58-0.00551-0.386-0.011-0.772-0.0167-1.17-0.0113-0.789-0.0226-1.58-0.0339-2.37-0.465-32.5-0.748-65.1-0.981-145-0.0029-2.43-0.0059-4.85-0.00896-7.28-7.65e-4 -0.608-0.00152-1.22-0.00228-1.82-0.0124-9.93-0.0438-19.9-0.0848-29.8-0.0429-10.4-0.0694-20.8-0.0746-31.2-7.4e-4 -1.47-0.00165-2.94-0.00266-4.41-1.91e-4 -0.289-3.81e-4 -0.577-5.78e-4 -0.874-0.00346-4.58-0.0235-9.15-0.0502-13.7-0.0263-4.57-0.0338-9.13-0.0229-13.7 0.00539-2.46 0.00262-4.91-0.0225-7.37-0.157-16.3-0.157-16.3 2.27-23.5 2.22-6.21 5.23-11.7 9.42-16.8 4.12-4.83 8.45-8.83 13.9-12.1 0.385-0.241 0.771-0.482 1.17-0.73 3-1.85 6.09-3.52 9.18-5.22 2.11-1.17 4.19-2.36 6.25-3.6 0.217-0.131 0.434-0.262 0.657-0.397 1.04-0.632 2.08-1.27 3.12-1.91 2.32-1.41 4.67-2.7 7.11-3.89 3.9-1.92 7.73-3.97 11.6-6 0.209-0.11 0.209-0.11 1.27-0.667 8.24-4.34 16.5-8.72 24.6-13.2 0.718-0.394 1.44-0.788 2.16-1.18 0.463-0.254 0.925-0.508 1.39-0.762 3.25-1.78 6.54-3.48 9.86-5.11 2.18-1.08 4.24-2.27 6.31-3.55 1.64-0.984 3.36-1.81 5.08-2.65 3.68-1.81 7.26-3.77 10.8-5.77 2.63-1.47 5.27-2.91 7.92-4.35 3.34-1.82 6.68-3.65 10-5.5 4.68-2.61 9.39-5.17 14.1-7.73 1.85-1.01 3.69-2.01 5.54-3.02 0.912-0.498 1.83-0.995 2.74-1.49 2.09-1.14 4.18-2.28 6.27-3.43 4.52-2.49 9.04-4.95 13.7-7.22 2.02-0.999 4.02-2.04 6-3.12 0.254-0.138 0.507-0.276 0.769-0.418 1.08-0.586 2.15-1.17 3.23-1.76 3.41-1.86 6.84-3.65 10.3-5.36 0.176-0.0864 0.176-0.0864 1.07-0.524 1.71-0.84 3.42-1.67 5.14-2.49 3.66-1.77 6.99-3.73 10.2-6.21 2.38-1.8 4.86-2.91 7.65-3.95 1.68-0.672 3.16-1.59 4.69-2.54 2.57-1.57 5.28-2.85 7.98-4.17 6.34-3.09 12.6-6.25 18.2-10.7 1.57-1.23 3.14-1.91 4.97-2.64 4.67-1.93 9.01-4.44 13.4-6.93 0.835-0.468 1.67-0.937 2.51-1.4 2.02-1.13 4.04-2.27 6.06-3.41 1.92-3.52 1.92-3.52 2.23-5.28-0.00524-0.178-0.00524-0.178-0.0317-1.08-0.00322-0.197-0.00322-0.197-0.0195-1.19-0.0168-0.396-0.0335-0.791-0.0508-1.2-0.00451-0.206-0.00451-0.206-0.0273-1.25-0.0233-1-0.056-2-0.0977-3-1.77-3.36-3.74-6.93-6.57-9.52-5.34-4.39-12-7.37-18.1-10.4-4.61-2.24-9.13-4.65-13.7-7.05-9.16-4.86-9.16-4.86-13.7-7.12-0.318-0.157-0.637-0.315-0.964-0.477-1.46-0.718-2.91-1.43-4.37-2.13-2.6-1.26-5-2.61-7.36-4.28-2.72-1.91-5.6-3.2-8.65-4.51-4.3-1.85-8.4-4.03-12.5-6.23-0.828-0.44-1.66-0.879-2.49-1.32-1.69-0.895-3.38-1.79-5.06-2.69-2.29-1.22-4.57-2.43-6.86-3.64-2.79-1.47-5.57-2.95-8.36-4.43-2.57-1.36-5.14-2.72-7.71-4.07-1.55-0.816-3.1-1.63-4.65-2.45-0.733-0.386-1.47-0.772-2.2-1.16-3.58-1.88-7.11-3.79-10.6-5.9-1.8-1.07-3.67-1.99-5.55-2.91-0.64-0.318-1.28-0.636-1.92-0.954-2.09-1.04-4.2-2.06-6.3-3.08-1.25-0.604-2.49-1.21-3.73-1.82-0.606-0.296-1.21-0.589-1.82-0.88-3.32-1.59-6.21-3.23-9.01-5.62-1.67-1.39-3.33-2.18-5.36-2.91-0.404-0.138-0.808-0.276-1.22-0.418-3.73-1.38-6.97-3.02-10.3-5.2-3.17-2.08-6.49-3.73-9.9-5.37-1.68-0.811-3.34-1.65-5-2.48-1.94-0.972-3.88-1.94-5.82-2.89-4.34-2.13-8.61-4.38-12.9-6.67-0.138-0.0739-0.138-0.0739-0.837-0.448-2.62-1.41-5.23-2.82-7.78-4.38-3.77-2.29-7.66-4.38-11.5-6.5-0.672-0.369-1.34-0.737-2.02-1.11-7.05-3.87-14.1-7.73-21.2-11.5-1.05-0.561-2.1-1.12-3.16-1.69-5.24-2.8-10.5-5.56-15.8-8.29-0.907-0.472-1.81-0.949-2.71-1.43-5.16-2.74-10.1-4.45-15.9-5.28-10.1-1.38-20.3-0.433-29.8 3.47zm-230 287-2 2c-0.776 2.67-1.14 5.1-1.12 7.88-0.00115 0.371-0.00231 0.742-0.0035 1.12-0.00264 1.24 0.00183 2.48 0.00629 3.71-4.36e-4 0.899-0.00131 1.8-0.00259 2.7-0.00177 1.95-4.42e-4 3.9 0.00364 5.85 0.00605 2.9 0.00634 5.8 0.00546 8.7-0.00131 4.88 0.00202 9.76 0.00802 14.6 0.00592 4.83 0.00977 9.66 0.0109 14.5 6.9e-5 0.301 1.38e-4 0.601 2.09e-4 0.911 3.38e-4 1.53 6.39e-4 3.05 9.27e-4 4.58 0.0021 10.8 0.00883 21.6 0.0183 32.4 0.00919 10.5 0.0163 21 0.0205 31.5 1.31e-4 0.324 2.63e-4 0.647 3.99e-4 0.981 0.00132 3.25 0.00259 6.5 0.00384 9.75 0.00254 6.62 0.00536 13.2 0.00835 19.9 1.38e-4 0.304 2.75e-4 0.609 4.16e-4 0.923 0.0092 20.3 0.0251 40.6 0.0419 61 0.627 0.81 1.26 1.62 1.89 2.42 0.176 0.228 0.352 0.456 0.533 0.692 0.795 1.01 1.52 1.84 2.54 2.63 0.841 0.499 1.69 0.917 2.58 1.32 0.323 0.157 0.645 0.314 0.978 0.476 1.03 0.499 2.07 0.98 3.11 1.46 0.72 0.345 1.44 0.691 2.16 1.04 1.42 0.684 2.84 1.36 4.26 2.03 2.55 1.21 5.06 2.47 7.58 3.74 0.721 0.361 1.44 0.722 2.16 1.08 0.351 0.176 0.702 0.351 1.06 0.532 0.836 0.417 1.67 0.832 2.51 1.25 3.57 1.77 7.08 3.62 10.6 5.52 5.72 3.08 11.5 6.06 17.3 8.94 6.58 3.26 13 6.68 19.4 10.3 8.73 4.88 17.5 9.34 27.1 12.2 0.917 0.282 1.82 0.582 2.72 0.9 4.68 1.57 9.17 1.82 14.1 1.8 1.29-0.00315 2.57 0.0204 3.86 0.0457 4.3 0.0344 8.25-0.294 12.4-1.63 2.57-0.914 4.95-1.98 7.12-3.64 0.827-0.687 1.61-1.41 2.39-2.15 0.104-0.0956 0.104-0.0956 0.632-0.579 1.85-1.71 3.6-3.47 4.85-5.67 1.2-2.42 2.07-4.91 2.83-7.5 0.394-1.24 0.888-2.41 1.41-3.6 1.4-3.48 1.91-6.93 2.08-10.7 0.0758-2.37 0.0863-4.74 0.0806-7.11-2.72e-4 -0.419-5.44e-4 -0.838-8.24e-4 -1.27-0.0196-6.57-0.0688-13.3-2.19-19.5-0.592-1.33-1.38-2.48-2.23-3.66-0.934-1.44-1.23-2.99-1.64-4.64-1.19-4.76-2.97-8.59-5.69-12.6-3.39-5.02-7.35-9.45-11.5-13.9-6.97-7.45-6.97-7.45-8.96-11.2-0.725-1.97-0.984-3.9-1-6 0.364-0.11 0.727-0.219 1.1-0.332 1.36-0.422 2.71-0.886 4.06-1.37 0.532-0.189 1.07-0.371 1.6-0.543 1.94-0.642 3.63-1.48 5.24-2.76 2.79-2.61 5.17-5.65 7-9 2.52-5.14 4.1-11 4.75-16.6 0.0878-1.1 0.152-2.19 0.199-3.29 0.0515-1.09 0.146-2.18 0.243-3.27 0.37-5.69-0.688-11-1.94-16.5-0.0785-0.36-0.157-0.72-0.238-1.09-0.967-4.36-2.27-8.02-4.6-11.8-1.35-2.21-2.15-4.31-2.79-6.82-0.85-2.86-1.9-5.22-3.67-7.64-1.02-1.32-2.07-2.62-3.13-3.91-1.46-1.8-2.82-3.66-4.2-5.52-0.507-0.677-1.02-1.35-1.52-2.03-0.367-0.49-0.734-0.979-1.1-1.47h-2c-0.0864-0.231-0.173-0.461-0.262-0.699-0.712-1.65-1.51-3.11-2.74-4.43-1.06-1.07-2.16-2.1-3.25-3.14-0.784-0.764-1.53-1.55-2.28-2.36-9-9.58-21-16.1-32.6-22-1.23-0.611-2.47-1.2-3.71-1.8-1.48-0.726-2.95-1.48-4.42-2.23-0.909-0.463-1.82-0.925-2.73-1.39-0.584-0.298-1.17-0.596-1.75-0.897-3.6-1.85-7.22-3.45-11-4.91-5.61-2.18-10.9-4.93-16.2-7.76-1.97-1.05-3.95-2.09-5.93-3.14-0.722-0.381-1.44-0.763-2.16-1.15-3.03-1.6-6.08-3.15-9.15-4.67-2.43-1.21-4.82-2.48-7.2-3.77-0.36-0.194-0.719-0.389-1.09-0.589-1.46-0.792-2.93-1.58-4.39-2.39-6.94-3.81-6.94-3.81-10.2-4.47-0.658-0.0912-1.32-0.175-1.98-0.23z"/> + <path transform="translate(234,488)" d="m0 0c3.06-0.136 6.06 0.0986 9 1 4.83 1.83 9.38 4.45 13.9 6.89 1.97 1.06 3.96 2.08 5.95 3.1 11.3 5.82 22.9 12.1 32.1 21l1 4 3 1c1.36 2.65 2.69 5.32 4 8 0.187 0.379 0.374 0.759 0.566 1.15 3.83 7.86 3.83 7.86 4.27 12 0.0721 0.958 0.117 1.92 0.163 2.87 0.0155 0.224 0.0155 0.224 0.0942 1.36 0.553 8.18 0.553 8.18-0.395 11.8-0.728 1.92-1.73 3.56-3.04 5.13-1.98 2.16-4.14 4.22-6.66 5.73-1.25 0.595-2.47 0.923-3.84 1.12-3.13 0.285-6.27 0.148-9.33-0.583-4.73-1.34-8.84-3.52-12.9-6.21-3.68-2.38-7.61-4.04-11.6-5.78-3.33-1.46-6.62-2.99-9.91-4.54-1.14-0.535-2.28-1.07-3.43-1.59-5.29-2.42-10.1-4.85-14.4-8.82-0.677-0.82-1.08-1.63-1.5-2.61-0.123-1.04-0.123-1.04-0.12-2.18-0.00137-0.432-0.00275-0.864-0.00416-1.31 0.0036-0.47 0.00719-0.939 0.0109-1.42 2.82e-4 -0.503 1.23e-4 -1.01-4.43e-4 -1.51-2.86e-4 -1.36 0.00559-2.72 0.0126-4.08 0.00626-1.42 0.00684-2.85 0.00802-4.27 0.00311-2.7 0.0113-5.39 0.0214-8.09 0.0112-3.07 0.0167-6.14 0.0217-9.21 0.0104-6.31 0.0282-12.6 0.0503-18.9 0.99-1.65 1.98-3.3 3-5z"/> + <path transform="translate(233,581)" d="m0 0c3.34-0.349 6.67-0.485 10 0 2.78 0.841 5.27 2.33 7.79 3.76 2.91 1.66 5.93 3.11 8.93 4.6 1.38 0.685 2.76 1.38 4.14 2.07 2.98 1.5 5.97 2.97 8.97 4.43 9.69 4.71 18.3 9.87 26.2 17.3 0.912 0.839 1.85 1.64 2.79 2.45 2.56 2.27 4.75 4.58 6.43 7.58 5.91 10.9 5.91 10.9 7.14 16.4 0.821 5.7 1.2 11.7 0.586 17.4-0.655 3.12-1.74 6.08-3 9-1.26 1.15-2.54 2.3-3.81 3.44-0.356 0.325-0.713 0.651-1.08 0.986-0.351 0.313-0.703 0.625-1.06 0.947-0.16 0.144-0.16 0.144-0.968 0.873-1.04 0.731-1.99 1.2-3.21 1.56-3.09 0.697-6.23 0.743-9.37 0.456-4.82-0.711-9.4-3.44-13.7-5.59-1.41-0.698-2.82-1.37-4.24-2.05-1.66-0.796-3.32-1.59-4.97-2.4-3.03-1.48-6.07-2.89-9.17-4.22-4.94-2.14-9.66-4.68-14.4-7.25-1.24-0.675-2.48-1.34-3.73-2-0.975-0.521-1.95-1.05-2.92-1.58-0.458-0.248-0.916-0.494-1.38-0.738-1.68-0.889-3.3-1.78-4.72-3.06-0.622-0.776-0.96-1.42-1.29-2.36-0.387-1.91-0.513-3.8-0.617-5.74-0.0184-0.294-0.0369-0.588-0.0559-0.89-0.586-9.4-0.478-18.8-0.456-28.3 0.00438-2.07 0.00122-4.14-0.00363-6.22-0.00509-2.27-0.00455-4.54-0.00162-6.81 6.64e-4 -0.955-1.4e-4 -1.91-0.00248-2.86-0.00254-1.32 0.00133-2.65 0.0069-3.97-0.00202-0.388-0.00405-0.776-0.00613-1.18 0.0133-1.71 0.103-3.21 0.644-4.84 0.162-0.407 0.325-0.815 0.492-1.23z"/> +</svg> diff --git a/public/providers/command-code.svg b/public/providers/command-code.svg new file mode 100644 index 0000000000..8bb660108c --- /dev/null +++ b/public/providers/command-code.svg @@ -0,0 +1,42 @@ +<?xml version="1.0" standalone="no"?> +<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN" + "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"> +<svg version="1.0" xmlns="http://www.w3.org/2000/svg" + width="700.000000pt" height="700.000000pt" viewBox="0 0 700.000000 700.000000" + preserveAspectRatio="xMidYMid meet"> +<metadata> +Created by potrace 1.14, written by Peter Selinger 2001-2017 +</metadata> +<g transform="translate(0.000000,700.000000) scale(0.100000,-0.100000)" +fill="#000000" stroke="none"> +<path d="M2305 6994 c-371 -13 -682 -39 -893 -74 -598 -103 -963 -350 -1172 +-795 -126 -267 -186 -576 -222 -1130 -19 -287 -18 -2669 0 -2950 53 -794 172 +-1175 464 -1481 286 -298 672 -437 1367 -489 616 -47 2694 -46 3267 0 685 56 +1056 186 1339 470 289 289 424 685 475 1395 22 310 32 1055 27 1915 -6 868 +-13 1102 -42 1417 -55 589 -188 950 -448 1216 -305 311 -678 435 -1487 493 +-141 10 -2428 21 -2675 13z m33 -1350 c322 -66 580 -324 646 -646 12 -57 16 +-136 16 -303 l0 -225 474 0 474 0 5 243 c4 201 8 255 25 318 67 248 222 437 +447 545 138 67 195 79 370 79 143 -1 154 -2 245 -33 279 -96 476 -307 552 +-587 29 -111 29 -297 -1 -410 -69 -261 -263 -478 -511 -572 -113 -43 -194 -53 +-431 -53 l-219 0 0 -474 0 -474 238 -5 c253 -5 310 -14 432 -64 243 -99 438 +-327 495 -576 47 -209 17 -419 -88 -607 -57 -102 -205 -250 -307 -307 -433 +-242 -960 -71 -1169 379 -63 134 -74 200 -79 466 l-4 232 -474 0 -474 0 0 +-219 c0 -149 -5 -243 -14 -294 -60 -312 -299 -565 -611 -649 -112 -30 -298 +-30 -410 0 -519 139 -776 708 -534 1185 106 210 301 365 538 429 63 17 117 21 +319 25 l242 5 0 474 0 474 -225 0 c-252 0 -329 11 -452 62 -485 201 -664 796 +-372 1232 116 174 310 306 514 349 93 20 248 21 343 1z"/> +<path d="M2080 5174 c-187 -50 -302 -241 -256 -425 31 -119 118 -216 231 -256 +42 -15 84 -18 260 -18 l210 0 0 210 c0 176 -3 218 -18 260 -39 111 -136 200 +-252 230 -72 18 -103 18 -175 -1z"/> +<path d="M4705 5176 c-75 -19 -125 -49 -178 -105 -86 -92 -91 -112 -95 -373 +l-3 -228 185 0 c264 0 337 20 429 119 74 79 92 127 92 241 0 83 -3 102 -27 +150 -74 150 -249 236 -403 196z"/> +<path d="M3000 3525 l0 -475 475 0 475 0 0 475 0 475 -475 0 -475 0 0 -475z"/> +<path d="M2051 2550 c-59 -22 -68 -27 -129 -84 -178 -167 -127 -463 98 -574 +48 -24 67 -27 150 -27 114 0 162 18 241 92 99 92 119 165 119 428 l0 185 -212 +0 c-184 -1 -220 -3 -267 -20z"/> +<path d="M4432 2348 l3 -224 33 -66 c38 -77 92 -130 171 -167 48 -22 70 -26 +146 -26 82 0 97 3 157 33 77 38 130 92 167 171 22 47 26 70 26 146 0 76 -4 99 +-26 146 -37 79 -90 133 -167 171 l-66 33 -224 3 -223 3 3 -223z"/> +</g> +</svg> diff --git a/scripts/cursor-tap.cjs b/scripts/ad-hoc/cursor-tap.cjs similarity index 97% rename from scripts/cursor-tap.cjs rename to scripts/ad-hoc/cursor-tap.cjs index 1c0e548699..5f0304aa67 100644 --- a/scripts/cursor-tap.cjs +++ b/scripts/ad-hoc/cursor-tap.cjs @@ -142,7 +142,7 @@ req.on("data", (chunk) => { }); req.on("end", () => { const raw = Buffer.concat(collected); - const outDir = path.join(__dirname, "..", "tests", "fixtures", "cursor"); + const outDir = path.join(__dirname, "..", "..", "tests", "fixtures", "cursor"); fs.mkdirSync(outDir, { recursive: true }); const outFile = path.join(outDir, `${fixtureName}.bin`); fs.writeFileSync(outFile, raw); @@ -168,7 +168,7 @@ setTimeout(() => { } catch {} const raw = Buffer.concat(collected); if (raw.length > 0) { - const outDir = path.join(__dirname, "..", "tests", "fixtures", "cursor"); + const outDir = path.join(__dirname, "..", "..", "tests", "fixtures", "cursor"); fs.mkdirSync(outDir, { recursive: true }); fs.writeFileSync(path.join(outDir, `${fixtureName}.bin`), raw); } diff --git a/scripts/dbsetup.js b/scripts/ad-hoc/dbsetup.js similarity index 100% rename from scripts/dbsetup.js rename to scripts/ad-hoc/dbsetup.js diff --git a/scripts/migrate-env.mjs b/scripts/ad-hoc/migrate-env.mjs similarity index 100% rename from scripts/migrate-env.mjs rename to scripts/ad-hoc/migrate-env.mjs diff --git a/scripts/sync-cursor-models.mjs b/scripts/ad-hoc/sync-cursor-models.mjs similarity index 93% rename from scripts/sync-cursor-models.mjs rename to scripts/ad-hoc/sync-cursor-models.mjs index 7aa29a88e8..48698d016a 100644 --- a/scripts/sync-cursor-models.mjs +++ b/scripts/ad-hoc/sync-cursor-models.mjs @@ -4,9 +4,9 @@ // invocation so cursor-agent prints "Available models: ..." on stderr. // // Usage: -// node scripts/sync-cursor-models.mjs # spawn cursor-agent and apply -// node scripts/sync-cursor-models.mjs --dry-run # print proposed block, don't write -// node scripts/sync-cursor-models.mjs --from-stdin # read the error message from stdin +// node scripts/ad-hoc/sync-cursor-models.mjs # spawn cursor-agent and apply +// node scripts/ad-hoc/sync-cursor-models.mjs --dry-run # print proposed block, don't write +// node scripts/ad-hoc/sync-cursor-models.mjs --from-stdin # read the error message from stdin import { spawnSync } from "node:child_process"; import { readFileSync, writeFileSync } from "node:fs"; diff --git a/scripts/bootstrap-env.mjs b/scripts/build/bootstrap-env.mjs similarity index 99% rename from scripts/bootstrap-env.mjs rename to scripts/build/bootstrap-env.mjs index 06e5deaad2..c39e9b9107 100644 --- a/scripts/bootstrap-env.mjs +++ b/scripts/build/bootstrap-env.mjs @@ -312,7 +312,7 @@ export function bootstrapEnv({ dataDirOverride, quiet = false } = {}) { return merged; } -// ── CLI usage: node scripts/bootstrap-env.mjs ────────────────────────────── +// ── CLI usage: node scripts/build/bootstrap-env.mjs ────────────────────────────── if (process.argv[1] && process.argv[1].endsWith("bootstrap-env.mjs")) { const env = bootstrapEnv(); process.stderr.write(`[bootstrap] Done. DATA_DIR resolved to: ${resolveDataDir()}\n`); diff --git a/scripts/build-next-isolated.mjs b/scripts/build/build-next-isolated.mjs similarity index 98% rename from scripts/build-next-isolated.mjs rename to scripts/build/build-next-isolated.mjs index 88e1ffacab..e9969c3a06 100644 --- a/scripts/build-next-isolated.mjs +++ b/scripts/build/build-next-isolated.mjs @@ -187,7 +187,7 @@ export async function main() { console.log("[build-next-isolated] Generating docs index..."); try { const { execSync } = await import("node:child_process"); - execSync("node scripts/generate-docs-index.mjs", { cwd: projectRoot, stdio: "inherit" }); + execSync("node scripts/docs/generate-docs-index.mjs", { cwd: projectRoot, stdio: "inherit" }); } catch (docGenErr) { console.warn( "[build-next-isolated] Docs index generation failed (non-fatal):", diff --git a/scripts/native-binary-compat.mjs b/scripts/build/native-binary-compat.mjs similarity index 100% rename from scripts/native-binary-compat.mjs rename to scripts/build/native-binary-compat.mjs diff --git a/scripts/pack-artifact-policy.ts b/scripts/build/pack-artifact-policy.ts similarity index 87% rename from scripts/pack-artifact-policy.ts rename to scripts/build/pack-artifact-policy.ts index 06793c10c6..f06a00e90e 100644 --- a/scripts/pack-artifact-policy.ts +++ b/scripts/build/pack-artifact-policy.ts @@ -29,11 +29,11 @@ export const APP_STAGING_REMOVAL_PATHS: string[] = [ export const APP_STAGING_ALLOWED_EXACT_PATHS: string[] = [ ".env.example", - "docs/openapi.yaml", + "docs/reference/openapi.yaml", "open-sse/mcp-server/server.js", "package.json", "responses-ws-proxy.mjs", - "scripts/sync-env.mjs", + "scripts/dev/sync-env.mjs", "server.js", "server-ws.mjs", ]; @@ -61,6 +61,7 @@ export const PACK_ARTIFACT_ROOT_ALLOWED_EXACT_PATHS: string[] = [ ".env.example", "LICENSE", "README.md", + "bin/cli-commands.mjs", "bin/mcp-server.mjs", "bin/nodeRuntimeSupport.mjs", "bin/omniroute.mjs", @@ -73,17 +74,18 @@ export const PACK_ARTIFACT_ROOT_ALLOWED_EXACT_PATHS: string[] = [ "open-sse/mcp-server/scopeEnforcement.ts", "open-sse/mcp-server/server.ts", "package.json", - "scripts/build-next-isolated.mjs", - "scripts/check-supported-node-runtime.ts", - "scripts/native-binary-compat.mjs", - "scripts/postinstall.mjs", - "scripts/postinstallSupport.mjs", - "scripts/responses-ws-proxy.mjs", - "scripts/sync-env.mjs", + "scripts/build/build-next-isolated.mjs", + "scripts/check/check-supported-node-runtime.ts", + "scripts/build/native-binary-compat.mjs", + "scripts/build/postinstall.mjs", + "scripts/build/postinstallSupport.mjs", + "scripts/dev/responses-ws-proxy.mjs", + "scripts/dev/sync-env.mjs", "src/shared/utils/nodeRuntimeSupport.ts", ]; export const PACK_ARTIFACT_ROOT_ALLOWED_PATH_PREFIXES: string[] = [ + "bin/cli/", "open-sse/mcp-server/schemas/", "open-sse/mcp-server/tools/", "src/shared/contracts/", @@ -95,13 +97,15 @@ export const PACK_ARTIFACT_REQUIRED_PATHS: string[] = [ "app/server.js", "app/server-ws.mjs", "app/responses-ws-proxy.mjs", + "bin/cli-commands.mjs", + "bin/cli/index.mjs", "bin/mcp-server.mjs", "bin/nodeRuntimeSupport.mjs", "bin/omniroute.mjs", "package.json", - "scripts/native-binary-compat.mjs", - "scripts/postinstall.mjs", - "scripts/postinstallSupport.mjs", + "scripts/build/native-binary-compat.mjs", + "scripts/build/postinstall.mjs", + "scripts/build/postinstallSupport.mjs", "src/shared/utils/nodeRuntimeSupport.ts", ]; diff --git a/scripts/postinstall.mjs b/scripts/build/postinstall.mjs similarity index 99% rename from scripts/postinstall.mjs rename to scripts/build/postinstall.mjs index a9ef2689df..210b18388f 100644 --- a/scripts/postinstall.mjs +++ b/scripts/build/postinstall.mjs @@ -31,7 +31,7 @@ import { hasStandaloneAppBundle } from "./postinstallSupport.mjs"; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); -const ROOT = join(__dirname, ".."); +const ROOT = join(__dirname, "..", ".."); const appBinary = join( ROOT, diff --git a/scripts/postinstallSupport.mjs b/scripts/build/postinstallSupport.mjs similarity index 100% rename from scripts/postinstallSupport.mjs rename to scripts/build/postinstallSupport.mjs diff --git a/scripts/prepare-electron-standalone.mjs b/scripts/build/prepare-electron-standalone.mjs similarity index 99% rename from scripts/prepare-electron-standalone.mjs rename to scripts/build/prepare-electron-standalone.mjs index 30647e2b03..a91eac08ac 100644 --- a/scripts/prepare-electron-standalone.mjs +++ b/scripts/build/prepare-electron-standalone.mjs @@ -15,7 +15,7 @@ import { fileURLToPath } from "node:url"; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); -const ROOT = join(__dirname, ".."); +const ROOT = join(__dirname, "..", ".."); const STANDALONE_DIR = join(ROOT, ".next", "standalone"); const ELECTRON_STANDALONE_DIR = join(ROOT, ".next", "electron-standalone"); diff --git a/scripts/prepublish.ts b/scripts/build/prepublish.ts similarity index 98% rename from scripts/prepublish.ts rename to scripts/build/prepublish.ts index 819e1dd2b1..c784076e3c 100644 --- a/scripts/prepublish.ts +++ b/scripts/build/prepublish.ts @@ -6,7 +6,7 @@ * Builds the Next.js app in standalone mode and copies output * into the `app/` directory that gets published to npm. * - * Run with: node scripts/prepublish.mjs + * Run with: node scripts/build/prepublish.ts */ import { execFileSync } from "node:child_process"; @@ -33,7 +33,7 @@ import { const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); -const ROOT = join(__dirname, ".."); +const ROOT = join(__dirname, "..", ".."); const NPM_BIN = process.platform === "win32" ? "npm.cmd" : "npm"; const NPX_BIN = process.platform === "win32" ? "npx.cmd" : "npx"; @@ -200,14 +200,14 @@ console.log(" 📋 Copying standalone build to app/..."); mkdirSync(APP_DIR, { recursive: true }); cpSync(standaloneDir, APP_DIR, { recursive: true }); -const standaloneWsSrc = join(ROOT, "scripts", "standalone-server-ws.mjs"); -const responsesWsProxySrc = join(ROOT, "scripts", "responses-ws-proxy.mjs"); +const standaloneWsSrc = join(ROOT, "scripts", "dev", "standalone-server-ws.mjs"); +const responsesWsProxySrc = join(ROOT, "scripts", "dev", "responses-ws-proxy.mjs"); if (existsSync(standaloneWsSrc) && existsSync(responsesWsProxySrc)) { console.log(" 📋 Adding Responses WebSocket standalone wrapper..."); cpSync(standaloneWsSrc, join(APP_DIR, "server-ws.mjs")); writeFileSync( join(APP_DIR, "responses-ws-proxy.mjs"), - 'export * from "../scripts/responses-ws-proxy.mjs";\n' + 'export * from "../scripts/dev/responses-ws-proxy.mjs";\n' ); } diff --git a/scripts/runtime-env.mjs b/scripts/build/runtime-env.mjs similarity index 100% rename from scripts/runtime-env.mjs rename to scripts/build/runtime-env.mjs diff --git a/scripts/uninstall.mjs b/scripts/build/uninstall.mjs similarity index 100% rename from scripts/uninstall.mjs rename to scripts/build/uninstall.mjs diff --git a/scripts/validate-pack-artifact.ts b/scripts/build/validate-pack-artifact.ts similarity index 98% rename from scripts/validate-pack-artifact.ts rename to scripts/build/validate-pack-artifact.ts index afaaa20761..2053fd69b1 100644 --- a/scripts/validate-pack-artifact.ts +++ b/scripts/build/validate-pack-artifact.ts @@ -14,7 +14,7 @@ import { const __filename: string = fileURLToPath(import.meta.url); const __dirname: string = dirname(__filename); -const ROOT: string = join(__dirname, ".."); +const ROOT: string = join(__dirname, "..", ".."); const npmCommand: string = process.platform === "win32" ? "npm.cmd" : "npm"; function runPackDryRun(): any { diff --git a/scripts/check-cycles.mjs b/scripts/check/check-cycles.mjs similarity index 100% rename from scripts/check-cycles.mjs rename to scripts/check/check-cycles.mjs diff --git a/scripts/check/check-deprecated-versions.mjs b/scripts/check/check-deprecated-versions.mjs new file mode 100644 index 0000000000..fda48e663b --- /dev/null +++ b/scripts/check/check-deprecated-versions.mjs @@ -0,0 +1,130 @@ +#!/usr/bin/env node +// Detects hardcoded old versions / stale dates in docs that should follow the current release. +// Uses hardcoded regexes to avoid dynamic RegExp() (ReDoS concern flagged by semgrep). +// Exits 0 if clean, 1 (in --strict mode) if drift detected. +// +// Run: node scripts/check/check-deprecated-versions.mjs +// Strict: node scripts/check/check-deprecated-versions.mjs --strict + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, "..", ".."); +const DOCS_DIR = path.join(ROOT, "docs"); +const PKG_JSON = path.join(ROOT, "package.json"); +const STRICT = process.argv.includes("--strict"); + +function currentVersion() { + try { + return JSON.parse(fs.readFileSync(PKG_JSON, "utf8")).version || "0.0.0"; + } catch { + return "0.0.0"; + } +} + +// Hardcoded set of obviously-stale version patterns. Update when bumping major/minor. +// These match any version <= v3.6.x or any pre-3 major. +const STALE_VERSION_PATTERNS = [ + /\bv?[12]\.\d+\.\d+\b/, // 1.x.x / 2.x.x + /\bv?3\.[0-6]\.\d+\b/, // 3.0.x..3.6.x +]; + +const SAFE_CONTEXTS = + /(historical|archive|legacy|previously|deprecated|since|introduced|was|originally|fix|fixed)/i; + +// Dates older than 60 days are considered stale for "Last updated" / "Last consolidated". +const STALE_DATE_DAYS = 60; +const today = new Date(); + +const LAST_UPDATED_RE = /Last (?:updated|consolidated|generated)[^\d]{0,30}(\d{4}-\d{2}-\d{2})/i; + +function isStaleDate(yyyy_mm_dd) { + const d = new Date(yyyy_mm_dd); + if (Number.isNaN(d.getTime())) return false; + const ageDays = (today - d) / (1000 * 60 * 60 * 24); + return ageDays > STALE_DATE_DAYS; +} + +const IGNORED_DIRS = new Set(["archive", "i18n", "superpowers"]); +const IGNORED_BASENAMES = new Set(["CHANGELOG.md", "RFC-AUTO-ASSESSMENT-DRAFT.md"]); + +function walkDocs(dir) { + const out = []; + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + if (IGNORED_DIRS.has(entry.name)) continue; + const full = path.join(dir, entry.name); + if (entry.isDirectory()) { + out.push(...walkDocs(full)); + } else if (entry.isFile() && entry.name.endsWith(".md")) { + if (IGNORED_BASENAMES.has(entry.name)) continue; + out.push(full); + } + } + return out; +} + +function main() { + const cur = currentVersion(); + console.log(`Version drift report (current: v${cur})`); + console.log("=".repeat(40)); + + const files = walkDocs(DOCS_DIR); + let drift = 0; + + for (const file of files) { + const rel = path.relative(ROOT, file); + const txt = fs.readFileSync(file, "utf8"); + const lines = txt.split("\n"); + const issues = []; + + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + if (line.length > 500) continue; // skip very long lines (likely code blocks / data) + + // 1. Stale version refs + for (const re of STALE_VERSION_PATTERNS) { + const m = re.exec(line); + if (m && !SAFE_CONTEXTS.test(line)) { + issues.push({ + line: i + 1, + type: "stale-version", + match: m[0], + text: line.trim().slice(0, 100), + }); + break; + } + } + // 2. Stale "Last updated/consolidated/generated" dates + const dateMatch = LAST_UPDATED_RE.exec(line); + if (dateMatch && isStaleDate(dateMatch[1])) { + issues.push({ + line: i + 1, + type: "stale-date", + match: dateMatch[1], + text: line.trim().slice(0, 100), + }); + } + } + + if (issues.length > 0) { + console.log(`\n ${rel}`); + for (const iss of issues.slice(0, 5)) { + console.log(` L${iss.line} [${iss.type}] ${iss.match}: ${iss.text}`); + } + if (issues.length > 5) console.log(` ... and ${issues.length - 5} more`); + drift += issues.length; + } + } + + console.log(); + if (drift > 0) { + console.warn(`⚠ ${drift} potential drift(s) detected across ${files.length} doc files.`); + if (STRICT) process.exit(1); + } else { + console.log(`✓ No drift detected across ${files.length} doc files.`); + } +} + +main(); diff --git a/scripts/check/check-doc-links.mjs b/scripts/check/check-doc-links.mjs new file mode 100644 index 0000000000..c25583266d --- /dev/null +++ b/scripts/check/check-doc-links.mjs @@ -0,0 +1,223 @@ +#!/usr/bin/env node +/** + * OmniRoute — internal documentation link checker. + * + * Scans every Markdown file under `docs/` (excluding mirrored translations, + * screenshots, exported diagrams, and superpowers plans) for relative or + * project-rooted internal links and verifies the referenced files exist on + * disk. External URLs (http/https/mailto), telephone links, and pure + * anchor-only links (#section) are ignored. + * + * Supported syntaxes: + * - Markdown links: [label](path "optional title") + * - Reference links: [label]: path "optional title" + * - HTML anchors: <a href="path"> + * - HTML image refs: <img src="path"> + * + * Usage: + * node scripts/check/check-doc-links.mjs # strict (CI gate) + * node scripts/check/check-doc-links.mjs --report # human report, exit 0 + * node scripts/check/check-doc-links.mjs --json # JSON to stdout + * + * Exit codes: + * 0 ok (or --report mode) + * 1 one or more broken internal links detected + */ + +import fs from "node:fs"; +import path from "node:path"; +import process from "node:process"; +import { fileURLToPath } from "node:url"; + +const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url)); +const REPO_ROOT = path.resolve(SCRIPT_DIR, "..", ".."); +const DOCS_ROOT = path.join(REPO_ROOT, "docs"); + +const EXCLUDE_PREFIXES = [ + path.join(DOCS_ROOT, "i18n") + path.sep, + path.join(DOCS_ROOT, "screenshots") + path.sep, + path.join(DOCS_ROOT, "superpowers") + path.sep, + path.join(DOCS_ROOT, "diagrams", "exported") + path.sep, +]; + +function parseArgs(argv) { + const opts = { report: false, json: false }; + for (const arg of argv.slice(2)) { + if (arg === "--report") opts.report = true; + else if (arg === "--json") opts.json = true; + else if (arg === "--help" || arg === "-h") { + console.log( + [ + "Usage: node scripts/check/check-doc-links.mjs [options]", + "", + " --report Print findings and exit 0 regardless", + " --json Emit JSON report to stdout", + ].join("\n") + ); + process.exit(0); + } + } + return opts; +} + +function walkDocs(dir, out) { + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) { + const prefixed = full + path.sep; + if (EXCLUDE_PREFIXES.some((p) => prefixed.startsWith(p))) continue; + walkDocs(full, out); + } else if (entry.isFile() && full.endsWith(".md")) { + if (EXCLUDE_PREFIXES.some((p) => full.startsWith(p))) continue; + out.push(full); + } + } +} + +function isExternal(target) { + return ( + /^[a-z][a-z0-9+.-]*:/i.test(target) || // http:, https:, mailto:, tel:, data:, ftp: ... + target.startsWith("//") + ); +} + +function stripFragmentAndQuery(target) { + let value = target; + const hashAt = value.indexOf("#"); + if (hashAt !== -1) value = value.slice(0, hashAt); + const queryAt = value.indexOf("?"); + if (queryAt !== -1) value = value.slice(0, queryAt); + return value; +} + +function extractLinks(content) { + const links = []; + // Strip fenced code blocks to avoid false positives. + const sanitized = content.replace(/```[\s\S]*?```/g, (m) => " ".repeat(m.length)); + const lines = sanitized.split(/\r?\n/); + + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + const lineNumber = i + 1; + + // Markdown inline links: [text](target) — supports nested parens minimally. + const inlineRe = /(!?)\[(?:[^\]]*)\]\(([^)\s]+(?:\s+"[^"]*")?)\)/g; + let match; + while ((match = inlineRe.exec(line)) !== null) { + const raw = match[2].replace(/\s+"[^"]*"$/, "").trim(); + if (raw) links.push({ target: raw, line: lineNumber }); + } + + // Reference-style links: [label]: target ("optional title") + const refRe = /^\s{0,3}\[[^\]]+\]:\s+([^\s]+)(?:\s+"[^"]*")?\s*$/; + const refMatch = line.match(refRe); + if (refMatch) links.push({ target: refMatch[1], line: lineNumber }); + + // HTML href / src + const htmlRe = /\b(?:href|src)\s*=\s*"([^"]+)"/g; + while ((match = htmlRe.exec(line)) !== null) { + links.push({ target: match[1], line: lineNumber }); + } + } + + return links; +} + +function resolveTarget(sourceFile, target) { + // /docs/foo.md, /foo, /reference/ENVIRONMENT.md → project-rooted. + if (target.startsWith("/")) { + return path.join(REPO_ROOT, target.replace(/^\/+/, "")); + } + // Otherwise resolve against the source file's directory. + return path.resolve(path.dirname(sourceFile), target); +} + +function probeExists(absPath) { + if (fs.existsSync(absPath)) return true; + // Allow links omitting `.md` (some doc viewers do this). + if (!path.extname(absPath) && fs.existsSync(`${absPath}.md`)) return true; + // Allow directory links resolving to an index/README. + if (fs.existsSync(path.join(absPath, "README.md"))) return true; + if (fs.existsSync(path.join(absPath, "index.md"))) return true; + return false; +} + +function main() { + const opts = parseArgs(process.argv); + + if (!fs.existsSync(DOCS_ROOT)) { + console.error("[doc-links] FAIL — docs/ directory not found"); + process.exit(1); + } + + const files = []; + walkDocs(DOCS_ROOT, files); + + /** @type {Array<{source:string, line:number, target:string, reason:string}>} */ + const broken = []; + let checkedLinks = 0; + + for (const file of files) { + const content = fs.readFileSync(file, "utf8"); + const links = extractLinks(content); + for (const { target, line } of links) { + if (!target) continue; + if (target.startsWith("#")) continue; // anchor-only + if (isExternal(target)) continue; + const clean = stripFragmentAndQuery(target); + if (!clean) continue; // e.g. "?query" alone — ignore + checkedLinks++; + const abs = resolveTarget(file, clean); + if (!probeExists(abs)) { + broken.push({ + source: path.relative(REPO_ROOT, file), + line, + target, + reason: "missing", + }); + } + } + } + + if (opts.json) { + process.stdout.write( + JSON.stringify( + { + ok: broken.length === 0, + scannedFiles: files.length, + checkedLinks, + broken, + }, + null, + 2 + ) + "\n" + ); + process.exit(broken.length && !opts.report ? 1 : 0); + } + + console.log(`[doc-links] scanned ${files.length} docs, checked ${checkedLinks} internal links`); + + if (broken.length === 0) { + console.log("[doc-links] PASS — no broken internal links"); + process.exit(0); + } + + // Group by source for readability. + const bySource = new Map(); + for (const entry of broken) { + if (!bySource.has(entry.source)) bySource.set(entry.source, []); + bySource.get(entry.source).push(entry); + } + + console.log(`[doc-links] FAIL — ${broken.length} broken link(s) in ${bySource.size} file(s):`); + for (const [source, entries] of bySource) { + console.log(`\n ${source}`); + for (const entry of entries) { + console.log(` line ${entry.line}: ${entry.target}`); + } + } + + process.exit(opts.report ? 0 : 1); +} + +main(); diff --git a/scripts/check/check-docs-counts-sync.mjs b/scripts/check/check-docs-counts-sync.mjs new file mode 100644 index 0000000000..c3e6e95f63 --- /dev/null +++ b/scripts/check/check-docs-counts-sync.mjs @@ -0,0 +1,115 @@ +#!/usr/bin/env node +// Validates that count-based assertions in docs match the actual code state. +// Examples checked: +// - executors count in open-sse/executors/ +// - routing strategies in src/shared/constants/routingStrategies.ts +// - OAuth providers in src/lib/oauth/providers/ +// - A2A skills in src/lib/a2a/skills/ +// - Cloud agents in src/lib/cloudAgent/agents/ +// +// Exits 0 on success, 1 on detected drift. +// Run: node scripts/check/check-docs-counts-sync.mjs + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, "..", ".."); + +const COMMON_NON_IMPL_BASENAMES = new Set([ + "index.ts", + "index.mts", + "types.ts", + "base.ts", + "constants.ts", +]); + +function countFiles(dir, suffix = ".ts") { + const abs = path.join(ROOT, dir); + if (!fs.existsSync(abs)) return 0; + return fs + .readdirSync(abs) + .filter( + (f) => + f.endsWith(suffix) && + !f.endsWith(".test.ts") && + !f.startsWith("__") && + !COMMON_NON_IMPL_BASENAMES.has(f) + ).length; +} + +function countRoutingStrategies() { + const file = path.join(ROOT, "src", "shared", "constants", "routingStrategies.ts"); + if (!fs.existsSync(file)) return 0; + const txt = fs.readFileSync(file, "utf8"); + const m = txt.match(/ROUTING_STRATEGY_VALUES\s*=\s*\[([^\]]*)\]/); + if (!m) return 0; + return (m[1].match(/"[^"]+"/g) || []).length; +} + +function docContains(docPath, needle) { + const abs = path.join(ROOT, "docs", docPath); + if (!fs.existsSync(abs)) return false; + return fs.readFileSync(abs, "utf8").includes(needle); +} + +const checks = [ + { + label: "Executors count", + actual: countFiles("open-sse/executors"), + docKey: "executors", + docs: ["architecture/ARCHITECTURE.md", "architecture/CODEBASE_DOCUMENTATION.md"], + }, + { + label: "Routing strategies count", + actual: countRoutingStrategies(), + docKey: "strategies", + docs: ["routing/AUTO-COMBO.md", "architecture/RESILIENCE_GUIDE.md"], + }, + { + label: "OAuth providers count", + actual: countFiles("src/lib/oauth/providers"), + docKey: "OAuth providers", + docs: ["architecture/ARCHITECTURE.md"], + }, + { + label: "A2A skills count", + actual: countFiles("src/lib/a2a/skills"), + docKey: "A2A skills", + docs: ["frameworks/A2A-SERVER.md"], + }, + { + label: "Cloud agents count", + actual: countFiles("src/lib/cloudAgent/agents"), + docKey: "cloud agents", + docs: ["frameworks/CLOUD_AGENT.md", "frameworks/AGENT_PROTOCOLS_GUIDE.md"], + }, +]; + +let drift = 0; +console.log("Docs counts sync report"); +console.log("======================="); + +for (const c of checks) { + console.log(`\n• ${c.label}: ${c.actual} (real)`); + for (const doc of c.docs) { + const found = docContains(doc, String(c.actual)); + if (found) { + console.log(` ✓ docs/${doc} mentions "${c.actual}"`); + } else { + console.log(` ⚠ docs/${doc} does NOT mention "${c.actual}" for ${c.docKey}`); + drift++; + } + } +} + +console.log(); +if (drift > 0) { + console.warn(`⚠ ${drift} potential drift(s) detected. Review the docs above.`); + // Soft-fail by default (count-based heuristic can false-positive). + // To enforce, pass --strict. + if (process.argv.includes("--strict")) process.exit(1); +} else { + console.log("✓ All checks pass."); +} diff --git a/scripts/check-docs-sync.mjs b/scripts/check/check-docs-sync.mjs similarity index 59% rename from scripts/check-docs-sync.mjs rename to scripts/check/check-docs-sync.mjs index 7b7aab5860..05c1bbbb09 100644 --- a/scripts/check-docs-sync.mjs +++ b/scripts/check/check-docs-sync.mjs @@ -5,7 +5,7 @@ import path from "node:path"; const cwd = process.cwd(); const packageJsonPath = path.resolve(cwd, "package.json"); -const openApiPath = path.resolve(cwd, "docs/openapi.yaml"); +const openApiPath = path.resolve(cwd, "docs/reference/openapi.yaml"); const changelogPath = path.resolve(cwd, "CHANGELOG.md"); const llmPath = path.resolve(cwd, "llm.txt"); const i18nDocsPath = path.resolve(cwd, "docs/i18n"); @@ -118,6 +118,85 @@ function checkI18nMirrorFile(fileName, sourcePath) { } } +/** + * Check i18n CHANGELOG mirrors by verifying that all version sections from the + * root CHANGELOG exist in each translation. Unlike strict mirror files (llm.txt), + * CHANGELOG translations have translated section headings (e.g. "Security" → + * "Segurança"), so byte-for-byte comparison is intentionally skipped. + * + * Validates: + * 1. File exists in each locale + * 2. Has the i18n mirror separator (---) + * 3. Contains all version sections (## [X.Y.Z]) from root, in the same order + * 4. Body is non-empty and within a reasonable size tolerance of the source + */ +function checkI18nChangelogFile(sourcePath) { + const fileName = "CHANGELOG.md"; + if (!fs.existsSync(i18nDocsPath)) { + fail("docs/i18n directory is missing"); + return; + } + + const sourceContent = readText(sourcePath); + const sourceBody = normalizeMirrorBody(stripTopHeading(sourceContent)); + const sourceVersions = extractChangelogSections(sourceContent); + const locales = fs + .readdirSync(i18nDocsPath, { withFileTypes: true }) + .filter((entry) => entry.isDirectory()) + .map((entry) => entry.name) + .sort(); + + let checked = 0; + for (const locale of locales) { + const targetPath = path.join(i18nDocsPath, locale, fileName); + if (!fs.existsSync(targetPath)) { + fail(`docs/i18n/${locale}/${fileName} is missing`); + continue; + } + + const targetContent = readText(targetPath); + const body = extractI18nMirrorBody(targetContent); + if (body === null) { + fail(`docs/i18n/${locale}/${fileName} is missing the i18n mirror separator`); + continue; + } + + const normalizedBody = normalizeMirrorBody(body); + if (normalizedBody.length === 0) { + fail(`docs/i18n/${locale}/${fileName} has empty body after separator`); + continue; + } + + // Verify all version sections from root exist in the translation + const targetVersions = extractChangelogSections(targetContent); + const missingVersions = sourceVersions.filter((v) => !targetVersions.includes(v)); + if (missingVersions.length > 0) { + fail( + `docs/i18n/${locale}/${fileName} is missing version sections: ${missingVersions.slice(0, 3).join(", ")}${missingVersions.length > 3 ? ` (+${missingVersions.length - 3} more)` : ""}` + ); + continue; + } + + // Verify body size is within 25% tolerance of source (translations may + // expand or shrink, but drastic size differences indicate stale content) + const sizeDiff = Math.abs(normalizedBody.length - sourceBody.length) / sourceBody.length; + if (sizeDiff > 0.25) { + fail( + `docs/i18n/${locale}/${fileName} body size differs by ${(sizeDiff * 100).toFixed(0)}% from root (expected within 25%)` + ); + continue; + } + + checked += 1; + } + + if (checked > 0) { + console.log( + `[docs-sync] ${fileName} i18n translations validated: ${checked} locales (version sections + size check)` + ); + } +} + try { const packageJson = JSON.parse(readText(packageJsonPath)); const packageVersion = packageJson.version; @@ -130,7 +209,7 @@ try { const openApiVersion = extractOpenApiVersion(readText(openApiPath)); if (!openApiVersion) { - fail("could not extract docs/openapi.yaml info.version"); + fail("could not extract docs/reference/openapi.yaml info.version"); } else if (openApiVersion !== packageVersion) { fail(`OpenAPI version (${openApiVersion}) differs from package.json (${packageVersion})`); } else { @@ -161,8 +240,10 @@ try { } } + // llm.txt mirrors must be exact copies (no translation) checkI18nMirrorFile("llm.txt", llmPath); - checkI18nMirrorFile("CHANGELOG.md", changelogPath); + // CHANGELOG.md mirrors are translations — check version sections and size, not exact content + checkI18nChangelogFile(changelogPath); } catch (error) { fail(error instanceof Error ? error.message : String(error)); } diff --git a/scripts/check/check-env-doc-sync.mjs b/scripts/check/check-env-doc-sync.mjs new file mode 100644 index 0000000000..a69d0f94ef --- /dev/null +++ b/scripts/check/check-env-doc-sync.mjs @@ -0,0 +1,279 @@ +#!/usr/bin/env node +/** + * Strict environment variable contract checker. + * + * Enforces that every env var referenced in OmniRoute source code appears in + * both `.env.example` and `docs/reference/ENVIRONMENT.md`, and that the two files agree + * on the documented var set. Falls back to a small allowlist for variables + * that are intentionally documented but not literally referenced (legacy + * aliases, future-supported hooks) or vice versa. + * + * Usage: + * node scripts/check/check-env-doc-sync.mjs # strict (CI mode) + * node scripts/check/check-env-doc-sync.mjs --lenient # legacy report-only mode + * + * Strict mode exits non-zero if any of these are non-empty: + * - vars in code but missing from .env.example + * - vars in .env.example but missing from ENVIRONMENT.md + * - vars in ENVIRONMENT.md but missing from .env.example + * + * Programmatic API: + * Other Node tests can `import { runEnvDocSync } from "./check-env-doc-sync.mjs"` + * and pass `{ root, envExample, envDoc, codeVars, ignore, docOnlyAllowlist, + * envOnlyAllowlist }` to drive the checker against fixtures. + */ + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; +import { execSync } from "node:child_process"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const REPO_ROOT = path.resolve(__dirname, "..", ".."); + +// ─── Allowlists ──────────────────────────────────────────────────────────── +// Env vars referenced in code that should NOT trigger documentation drift. +// These are usually system/process vars or harness-only knobs. +const IGNORE_FROM_CODE = new Set([ + "NODE_ENV", + "PATH", + "HOME", + "USER", + "PWD", + "SHELL", + "TERM", + "TZ", + "LANG", + "LC_ALL", + "CI", + "GITHUB_ACTIONS", + "RUNNER_OS", + // OS / Node internals frequently surfaced by indirect dependencies. + "APPDATA", + "LOCALAPPDATA", + "XDG_CONFIG_HOME", + "USERPROFILE", + "PREFIX", + // Next.js / Node test runners — these are framework-managed. + "NEXT_DIST_DIR", + "NEXT_PHASE", + "NEXT_RUNTIME", + "VITEST", + // CI providers (set by the runner). + "GITHUB_BASE_REF", + "GITHUB_BASE_SHA", + // Aliases for documented vars handled via fallback ordering. + "API_KEY", + "APP_URL", + "PUBLIC_URL", + "ANTHROPIC_API_URL", + "OPENAI_API_URL", + "LOG_LEVEL", + // Internal QA helpers used only by scripts/ and Playwright. + "QA_BASE_URL", + "QA_LOCALES", + "QA_REPORT_SUFFIX", + "QA_ROUTES", + // Doctor diagnostic flags (no runtime behavior yet — placeholders). + "OMNIROUTE_DOCTOR_HOST", + "OMNIROUTE_DOCTOR_LIVENESS_URL", + "OMNIROUTE_PROVIDER_CATALOG_PATH", + "OMNIROUTE_PROVIDER_TEST_MODEL", + // Source typo / placeholder. + "OMNIROUT", + // Static config alias path (the canonical var is OMNIROUTE_PAYLOAD_RULES_PATH). + "PAYLOAD_RULES_PATH", +]); + +// Vars documented in ENVIRONMENT.md but intentionally absent from .env.example. +// Used for past-tense documentation (Audit / Dead vars section), legacy aliases +// with no runtime hook, and section anchors that look like vars to the regex. +const DOC_ONLY_ALLOWLIST = new Set([ + // Audit history (Removed / Dead Variables section). + "CEREBRAS_API_KEY", + "COHERE_API_KEY", + "FIREWORKS_API_KEY", + "GROQ_API_KEY", + "MISTRAL_API_KEY", + "NEBIUS_API_KEY", + "PERPLEXITY_API_KEY", + "TOGETHER_API_KEY", + "XAI_API_KEY", + "QIANFAN_API_KEY", + "CURSOR_PROTOBUF_DEBUG", + "CLI_COMPAT_KIRO", + "CLI_KIMI_CODING_BIN", + "CLI_ROO_BIN", + "IFLOW_OAUTH_CLIENT_ID", + "IFLOW_OAUTH_CLIENT_SECRET", + // Source-code constants accidentally captured by the doc regex. + "CLI_COMPAT_OMITTED_PROVIDER_IDS", + // Sample default values that look like SHOUTY_NAMES (not env vars). + "CHANGEME", + // Legacy aliases — present in docs as "would be aliases" but read-only + // through their canonical names today. + "OMNIROUTE_CRYPT_KEY", + "OMNIROUTE_API_KEY_BASE64", + // Future-supported hooks: documented but currently hardcoded constants. + "MAX_RETRY_INTERVAL_SEC", + "REQUEST_RETRY", + "SKILLS_EXECUTION_TIMEOUT_MS", + "SKILLS_SANDBOX_DOCKER_IMAGE", +]); + +// Vars present in .env.example but intentionally absent from ENVIRONMENT.md. +// Empty today — kept for forward compatibility / explicit exemption. +const ENV_ONLY_ALLOWLIST = new Set([]); + +// ─── Parsing helpers ─────────────────────────────────────────────────────── + +/** + * Extract VAR= entries from a `.env`-style file (handles commented examples). + */ +export function parseEnvExampleVars(text) { + const vars = new Set(); + for (const line of String(text ?? "").split("\n")) { + const m = line.match(/^#?\s*([A-Z][A-Z0-9_]+)\s*=/); + if (m) vars.add(m[1]); + } + return vars; +} + +/** + * Extract `VARNAME` tokens from a markdown doc — matches anything in backticks + * that looks like an env var (uppercase + digit + underscore). + */ +export function parseEnvDocVars(text) { + const vars = new Set(); + for (const m of String(text ?? "").matchAll(/`([A-Z][A-Z0-9_]{2,})`/g)) { + vars.add(m[1]); + } + return vars; +} + +/** + * Collect environment variable references in source code via grep against + * the `process.env` member access pattern. + */ +function scanCodeVars({ cwd } = {}) { + const repoRoot = cwd ?? REPO_ROOT; + const stdout = execSync( + "grep -rhoE 'process\\.env\\.[A-Z][A-Z0-9_]+' " + + "src/ open-sse/ bin/ scripts/ electron/main.js electron/preload.js 2>/dev/null || true", + { cwd: repoRoot, encoding: "utf8", maxBuffer: 20 * 1024 * 1024 } + ); + const vars = new Set(); + for (const line of stdout.split("\n")) { + const m = line.match(/^process\.env\.([A-Z][A-Z0-9_]+)$/); + if (m) vars.add(m[1]); + } + return vars; +} + +/** + * Diff helper. + */ +function diff(set, against) { + return [...set].filter((v) => !against.has(v)).sort(); +} + +// ─── Programmatic entry point ────────────────────────────────────────────── + +/** + * Run the contract checker. All inputs are overridable for tests. + * + * Returns `{ ok: boolean, summary, problems: { codeMissingEnv, envMissingDoc, + * docMissingEnv } }`. + */ +export function runEnvDocSync(options = {}) { + const ignore = options.ignore ?? IGNORE_FROM_CODE; + const docOnly = options.docOnlyAllowlist ?? DOC_ONLY_ALLOWLIST; + const envOnly = options.envOnlyAllowlist ?? ENV_ONLY_ALLOWLIST; + + const envExampleText = + options.envExampleText ?? + (options.envExamplePath + ? fs.readFileSync(options.envExamplePath, "utf8") + : fs.readFileSync(path.join(REPO_ROOT, ".env.example"), "utf8")); + const envDocText = + options.envDocText ?? + (options.envDocPath + ? fs.readFileSync(options.envDocPath, "utf8") + : fs.readFileSync(path.join(REPO_ROOT, "docs", "reference", "ENVIRONMENT.md"), "utf8")); + + const envVars = parseEnvExampleVars(envExampleText); + const docVars = parseEnvDocVars(envDocText); + + const codeVars = new Set( + [...(options.codeVars ?? scanCodeVars({ cwd: options.root }))].filter((v) => !ignore.has(v)) + ); + + const codeMissingEnv = diff(codeVars, envVars); + const envMissingDoc = diff(envVars, docVars).filter((v) => !envOnly.has(v)); + const docMissingEnv = diff(docVars, envVars).filter((v) => !docOnly.has(v)); + + const ok = + codeMissingEnv.length === 0 && envMissingDoc.length === 0 && docMissingEnv.length === 0; + + return { + ok, + summary: { + code: codeVars.size, + envExample: envVars.size, + doc: docVars.size, + }, + problems: { + codeMissingEnv, + envMissingDoc, + docMissingEnv, + }, + }; +} + +// ─── CLI ─────────────────────────────────────────────────────────────────── + +function printList(label, list, marker) { + if (list.length === 0) { + console.log(` ${marker || "✓"} ${label}: none`); + return; + } + console.log(` ✗ ${label}: ${list.length}`); + for (const v of list.slice(0, 50)) console.log(` - ${v}`); + if (list.length > 50) console.log(` ... and ${list.length - 50} more`); +} + +function main() { + const lenient = process.argv.includes("--lenient"); + const result = runEnvDocSync(); + + console.log("Env var contract sync report"); + console.log("============================"); + console.log(`Code references: ${result.summary.code} unique vars`); + console.log(`In .env.example: ${result.summary.envExample} unique vars`); + console.log(`In docs/reference/ENVIRONMENT.md: ${result.summary.doc} unique vars`); + console.log(); + + printList("In code but missing from .env.example", result.problems.codeMissingEnv); + printList("In .env.example but missing from ENVIRONMENT.md", result.problems.envMissingDoc); + printList("In ENVIRONMENT.md but missing from .env.example", result.problems.docMissingEnv); + + if (result.ok) { + console.log("\n✓ Env / docs contract is in sync."); + process.exit(0); + } + + if (lenient) { + console.log("\n⚠ Drift detected (lenient mode — exit 0)."); + process.exit(0); + } + + console.log( + "\n✗ Env / docs contract is out of sync. Update .env.example, docs/reference/ENVIRONMENT.md," + ); + console.log(" or the allowlists in scripts/check/check-env-doc-sync.mjs and try again."); + process.exit(1); +} + +if (import.meta.url === `file://${process.argv[1]}`) { + main(); +} diff --git a/scripts/check-pr-test-policy.mjs b/scripts/check/check-pr-test-policy.mjs similarity index 90% rename from scripts/check-pr-test-policy.mjs rename to scripts/check/check-pr-test-policy.mjs index ae7160f2e9..de33e8babf 100644 --- a/scripts/check-pr-test-policy.mjs +++ b/scripts/check/check-pr-test-policy.mjs @@ -6,14 +6,17 @@ const SOURCE_ROOTS = ["src/", "open-sse/", "electron/", "bin/"]; const TEST_PATTERNS = [/^tests\//, /(?:^|\/)__tests__\//, /\.(?:test|spec)\.[cm]?[jt]sx?$/]; // Test files for specific source types (e.g., Python validation scripts for i18n) const TEST_FILE_PATTERNS = { - "src/i18n/messages/": [/\/scripts\/validate_translation\.py$/, /\/scripts\/check_translations\.py$/], + "src/i18n/messages/": [ + /\/scripts\/validate_translation\.py$/, + /\/scripts\/check_translations\.py$/, + ], }; // Exclude directories that don't require tests (i18n has Python validation, docs, config) const EXCLUDED_PATTERNS = [ - /\/i18n\/messages\//, // i18n files have their own Python test scripts - /\.md$/, // Documentation - /\.yaml$/, // Config files - /\.yml$/, // Config files + /\/i18n\/messages\//, // i18n files have their own Python test scripts + /\.md$/, // Documentation + /\.yaml$/, // Config files + /\.yml$/, // Config files ]; function getArg(name, fallbackValue = "") { @@ -30,7 +33,7 @@ function runGit(args) { function isSourceFile(filePath) { // Exclude patterns that don't require tests - if (EXCLUDED_PATTERNS.some(pattern => pattern.test(filePath))) { + if (EXCLUDED_PATTERNS.some((pattern) => pattern.test(filePath))) { return false; } return SOURCE_ROOTS.some((root) => filePath.startsWith(root)); diff --git a/scripts/check-route-validation.mjs b/scripts/check/check-route-validation.mjs similarity index 100% rename from scripts/check-route-validation.mjs rename to scripts/check/check-route-validation.mjs diff --git a/scripts/check-supported-node-runtime.ts b/scripts/check/check-supported-node-runtime.ts similarity index 91% rename from scripts/check-supported-node-runtime.ts rename to scripts/check/check-supported-node-runtime.ts index 977a84a5ab..197966822e 100644 --- a/scripts/check-supported-node-runtime.ts +++ b/scripts/check/check-supported-node-runtime.ts @@ -3,7 +3,7 @@ import { getNodeRuntimeSupport, getNodeRuntimeWarning, -} from "../src/shared/utils/nodeRuntimeSupport.ts"; +} from "../../src/shared/utils/nodeRuntimeSupport.ts"; const support = getNodeRuntimeSupport(); diff --git a/scripts/check-t11-any-budget.mjs b/scripts/check/check-t11-any-budget.mjs similarity index 100% rename from scripts/check-t11-any-budget.mjs rename to scripts/check/check-t11-any-budget.mjs diff --git a/scripts/test-report-summary.mjs b/scripts/check/test-report-summary.mjs similarity index 100% rename from scripts/test-report-summary.mjs rename to scripts/check/test-report-summary.mjs diff --git a/scripts/healthcheck.mjs b/scripts/dev/healthcheck.mjs similarity index 100% rename from scripts/healthcheck.mjs rename to scripts/dev/healthcheck.mjs diff --git a/scripts/responses-ws-proxy.mjs b/scripts/dev/responses-ws-proxy.mjs similarity index 100% rename from scripts/responses-ws-proxy.mjs rename to scripts/dev/responses-ws-proxy.mjs diff --git a/scripts/run-ecosystem-tests.mjs b/scripts/dev/run-ecosystem-tests.mjs similarity index 97% rename from scripts/run-ecosystem-tests.mjs rename to scripts/dev/run-ecosystem-tests.mjs index 93db56ea31..8294d8ca1e 100644 --- a/scripts/run-ecosystem-tests.mjs +++ b/scripts/dev/run-ecosystem-tests.mjs @@ -3,7 +3,7 @@ import { spawn } from "node:child_process"; import { join } from "node:path"; import { setTimeout as delay } from "node:timers/promises"; -import { sanitizeColorEnv } from "./runtime-env.mjs"; +import { sanitizeColorEnv } from "../build/runtime-env.mjs"; function parsePort(value, fallback) { const parsed = Number.parseInt(String(value), 10); diff --git a/scripts/run-next-playwright.mjs b/scripts/dev/run-next-playwright.mjs similarity index 98% rename from scripts/run-next-playwright.mjs rename to scripts/dev/run-next-playwright.mjs index fad1ae20a5..84673696ef 100644 --- a/scripts/run-next-playwright.mjs +++ b/scripts/dev/run-next-playwright.mjs @@ -9,8 +9,8 @@ import { sanitizeColorEnv, spawnWithForwardedSignals, withRuntimePortEnv, -} from "./runtime-env.mjs"; -import { bootstrapEnv } from "./bootstrap-env.mjs"; +} from "../build/runtime-env.mjs"; +import { bootstrapEnv } from "../build/bootstrap-env.mjs"; const mode = process.argv[2] === "start" ? "start" : "dev"; const cwd = process.cwd(); diff --git a/scripts/run-next.mjs b/scripts/dev/run-next.mjs similarity index 96% rename from scripts/run-next.mjs rename to scripts/dev/run-next.mjs index 293a38f165..1a108d40d2 100644 --- a/scripts/run-next.mjs +++ b/scripts/dev/run-next.mjs @@ -4,8 +4,8 @@ import fs from "node:fs"; import http from "node:http"; import path from "node:path"; import next from "next"; -import { bootstrapEnv } from "./bootstrap-env.mjs"; -import { resolveRuntimePorts, withRuntimePortEnv } from "./runtime-env.mjs"; +import { bootstrapEnv } from "../build/bootstrap-env.mjs"; +import { resolveRuntimePorts, withRuntimePortEnv } from "../build/runtime-env.mjs"; import { createOmnirouteWsBridge } from "./v1-ws-bridge.mjs"; import { createResponsesWsProxy } from "./responses-ws-proxy.mjs"; import { randomUUID } from "node:crypto"; diff --git a/scripts/run-playwright-tests.mjs b/scripts/dev/run-playwright-tests.mjs similarity index 91% rename from scripts/run-playwright-tests.mjs rename to scripts/dev/run-playwright-tests.mjs index a4585354f6..3d775445d4 100644 --- a/scripts/run-playwright-tests.mjs +++ b/scripts/dev/run-playwright-tests.mjs @@ -1,7 +1,7 @@ #!/usr/bin/env node import { spawn } from "node:child_process"; -import { sanitizeColorEnv } from "./runtime-env.mjs"; +import { sanitizeColorEnv } from "../build/runtime-env.mjs"; const defaultArgs = ["test", "tests/e2e/*.spec.ts"]; const forwardedArgs = process.argv.slice(2); diff --git a/scripts/run-protocol-clients-tests.mjs b/scripts/dev/run-protocol-clients-tests.mjs similarity index 97% rename from scripts/run-protocol-clients-tests.mjs rename to scripts/dev/run-protocol-clients-tests.mjs index f0945eb924..83e4c13ded 100644 --- a/scripts/run-protocol-clients-tests.mjs +++ b/scripts/dev/run-protocol-clients-tests.mjs @@ -3,7 +3,7 @@ import { spawn } from "node:child_process"; import { join } from "node:path"; import { setTimeout as delay } from "node:timers/promises"; -import { sanitizeColorEnv } from "./runtime-env.mjs"; +import { sanitizeColorEnv } from "../build/runtime-env.mjs"; function parsePort(value, fallback) { const parsed = Number.parseInt(String(value), 10); diff --git a/scripts/run-standalone.mjs b/scripts/dev/run-standalone.mjs similarity index 76% rename from scripts/run-standalone.mjs rename to scripts/dev/run-standalone.mjs index 095f89b482..9a91b9aa92 100644 --- a/scripts/run-standalone.mjs +++ b/scripts/dev/run-standalone.mjs @@ -4,8 +4,8 @@ import { resolveRuntimePorts, withRuntimePortEnv, spawnWithForwardedSignals, -} from "./runtime-env.mjs"; -import { bootstrapEnv } from "./bootstrap-env.mjs"; +} from "../build/runtime-env.mjs"; +import { bootstrapEnv } from "../build/bootstrap-env.mjs"; const env = bootstrapEnv(); const runtimePorts = resolveRuntimePorts(env); diff --git a/scripts/smoke-electron-packaged.mjs b/scripts/dev/smoke-electron-packaged.mjs similarity index 99% rename from scripts/smoke-electron-packaged.mjs rename to scripts/dev/smoke-electron-packaged.mjs index f7baa136c7..473cbf6303 100644 --- a/scripts/smoke-electron-packaged.mjs +++ b/scripts/dev/smoke-electron-packaged.mjs @@ -9,7 +9,7 @@ import { fileURLToPath, pathToFileURL } from "node:url"; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); -const ROOT = join(__dirname, ".."); +const ROOT = join(__dirname, "..", ".."); const DEFAULT_TIMEOUT_MS = 45_000; const DEFAULT_SETTLE_MS = 2_000; diff --git a/scripts/standalone-server-ws.mjs b/scripts/dev/standalone-server-ws.mjs similarity index 100% rename from scripts/standalone-server-ws.mjs rename to scripts/dev/standalone-server-ws.mjs diff --git a/scripts/sync-env.mjs b/scripts/dev/sync-env.mjs similarity index 100% rename from scripts/sync-env.mjs rename to scripts/dev/sync-env.mjs diff --git a/scripts/system-info.mjs b/scripts/dev/system-info.mjs similarity index 98% rename from scripts/system-info.mjs rename to scripts/dev/system-info.mjs index 6dbc2949c7..6d112a11e9 100644 --- a/scripts/system-info.mjs +++ b/scripts/dev/system-info.mjs @@ -3,7 +3,7 @@ * system-info.mjs — OmniRoute System Information Reporter (#280) * * Collects system/environment info for bug reports. - * Usage: node scripts/system-info.mjs [--output system-info.txt] + * Usage: node scripts/dev/system-info.mjs [--output system-info.txt] * * Output includes: * - Node.js version @@ -21,7 +21,7 @@ import { fileURLToPath } from "url"; import os from "os"; const __dirname = dirname(fileURLToPath(import.meta.url)); -const ROOT = join(__dirname, ".."); +const ROOT = join(__dirname, "..", ".."); // ── Helpers ──────────────────────────────────────────────────────────────── diff --git a/scripts/v1-ws-bridge.mjs b/scripts/dev/v1-ws-bridge.mjs similarity index 100% rename from scripts/v1-ws-bridge.mjs rename to scripts/dev/v1-ws-bridge.mjs diff --git a/scripts/docs/add-frontmatter.mjs b/scripts/docs/add-frontmatter.mjs new file mode 100644 index 0000000000..d65e4211dd --- /dev/null +++ b/scripts/docs/add-frontmatter.mjs @@ -0,0 +1,148 @@ +#!/usr/bin/env node +/** + * add-frontmatter.mjs — one-shot helper that ensures every documentation + * file under docs/<sub>/*.md and docs/README.md has a YAML frontmatter + * header with `title`, `version`, and `lastUpdated`. + * + * Idempotent: docs that already have a `---` block at the top are skipped + * (the existing frontmatter is preserved as-is). Files without a leading + * `# Title` heading fall back to the basename humanized as a title. + * + * Excludes: docs/i18n/, docs/screenshots/, docs/superpowers/, + * docs/diagrams/exported/. Subfolder READMEs are included. + * + * Usage: node scripts/docs/add-frontmatter.mjs [--version X.Y.Z] [--date YYYY-MM-DD] + */ + +import { promises as fs } from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); +const ROOT = path.resolve(__dirname, "..", ".."); +const DOCS_DIR = path.join(ROOT, "docs"); + +const EXCLUDE_PREFIXES = [ + "docs/i18n/", + "docs/screenshots/", + "docs/superpowers/", + "docs/diagrams/exported/", +]; + +const args = process.argv.slice(2); +let version = "3.8.0"; +let lastUpdated = "2026-05-13"; +for (let i = 0; i < args.length; i += 1) { + if (args[i] === "--version" && args[i + 1]) { + version = args[i + 1]; + i += 1; + } else if (args[i] === "--date" && args[i + 1]) { + lastUpdated = args[i + 1]; + i += 1; + } +} + +async function walk(dir, files = []) { + const entries = await fs.readdir(dir, { withFileTypes: true }); + for (const entry of entries) { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) { + await walk(full, files); + } else if (entry.isFile() && entry.name.endsWith(".md")) { + files.push(full); + } + } + return files; +} + +function isExcluded(rel) { + return EXCLUDE_PREFIXES.some((p) => rel === p || rel.startsWith(p)); +} + +function hasFrontmatter(content) { + return /^---\r?\n/.test(content); +} + +function extractTopHeading(content) { + const lines = content.replace(/^/, "").split(/\r?\n/); + for (const line of lines) { + const m = line.match(/^#\s+(.+?)\s*$/); + if (m) return m[1].trim(); + // Allow blank/HTML-comment lines before the first heading + if (line.trim() === "" || /^<!--/.test(line.trim())) continue; + // Anything else (e.g. badge image, paragraph) — no usable heading + return null; + } + return null; +} + +function humanizeBasename(filePath) { + const base = path.basename(filePath, ".md"); + if (base.toLowerCase() === "readme") { + const parent = path.basename(path.dirname(filePath)); + if (parent && parent !== "." && parent !== "docs") { + const cap = parent.charAt(0).toUpperCase() + parent.slice(1); + return `${cap} Docs`; + } + return "Documentation"; + } + return base + .replace(/[-_]+/g, " ") + .replace(/\s+/g, " ") + .replace(/\b\w/g, (c) => c.toUpperCase()); +} + +function buildFrontmatter(title) { + // Quote title with double quotes; escape internal double quotes. + const safe = title.replace(/"/g, '\\"'); + return [ + `---`, + `title: "${safe}"`, + `version: ${version}`, + `lastUpdated: ${lastUpdated}`, + `---`, + ``, + ].join("\n"); +} + +async function main() { + const allFiles = await walk(DOCS_DIR); + const targets = allFiles + .map((abs) => ({ abs, rel: path.relative(ROOT, abs).replace(/\\/g, "/") })) + .filter(({ rel }) => !isExcluded(rel)); + + let added = 0; + let skipped = 0; + let noHeading = []; + + for (const { abs, rel } of targets) { + const content = await fs.readFile(abs, "utf8"); + if (hasFrontmatter(content)) { + skipped += 1; + continue; + } + let title = extractTopHeading(content); + if (!title) { + title = humanizeBasename(abs); + noHeading.push(rel); + } + const fm = buildFrontmatter(title); + const next = `${fm}\n${content.replace(/^/, "")}`; + await fs.writeFile(abs, next, "utf8"); + added += 1; + console.log(`[add-frontmatter] added → ${rel}`); + } + + console.log(`[add-frontmatter] done — added=${added} skipped=${skipped} total=${targets.length}`); + if (noHeading.length > 0) { + console.log( + `[add-frontmatter] fallback title used (no leading H1) for: ${noHeading.join(", ")}` + ); + } +} + +main().catch((err) => { + console.error(err); + process.exit(1); +}); diff --git a/scripts/docs/fix-internal-links.mjs b/scripts/docs/fix-internal-links.mjs new file mode 100644 index 0000000000..abe933f94b --- /dev/null +++ b/scripts/docs/fix-internal-links.mjs @@ -0,0 +1,274 @@ +#!/usr/bin/env node +// One-shot: FASE 3 helper, safe to delete after merge. +// +// Rewrites doc-file references after the docs/ flat -> subfolder restructure. +// +// Modes: +// --internal Rewrite relative links inside docs/<subfolder>/*.md to point at +// the new subfolder paths (e.g. ./AUTO-COMBO.md -> ../routing/AUTO-COMBO.md). +// --external Rewrite absolute-style `docs/<DOC>.md` references in files +// outside docs/ (README, CLAUDE.md, .agents, .claude, scripts, src, +// tests, etc.) to `docs/<subfolder>/<DOC>.md`. +// +// Usage: +// node scripts/docs/fix-internal-links.mjs --internal +// node scripts/docs/fix-internal-links.mjs --external +// node scripts/docs/fix-internal-links.mjs --internal --external --dry +// +// Notes: +// - Idempotent: rerunning does not double-rewrite (it only matches the old shape). +// - openapi.yaml lives under docs/reference/ — also handled. + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, "..", ".."); +const DOCS = path.join(ROOT, "docs"); + +const args = new Set(process.argv.slice(2)); +const RUN_INTERNAL = args.has("--internal"); +const RUN_EXTERNAL = args.has("--external"); +const DRY = args.has("--dry"); +if (!RUN_INTERNAL && !RUN_EXTERNAL) { + console.error("Pass --internal and/or --external (and optionally --dry)."); + process.exit(2); +} + +// ---------------------------------------------------------------------- +// Mapping: stem -> subfolder +// ---------------------------------------------------------------------- +const DOC_TO_SUBFOLDER = { + // architecture + "ARCHITECTURE.md": "architecture", + "CODEBASE_DOCUMENTATION.md": "architecture", + "REPOSITORY_MAP.md": "architecture", + "AUTHZ_GUIDE.md": "architecture", + "RESILIENCE_GUIDE.md": "architecture", + // guides + "SETUP_GUIDE.md": "guides", + "USER_GUIDE.md": "guides", + "DOCKER_GUIDE.md": "guides", + "ELECTRON_GUIDE.md": "guides", + "TERMUX_GUIDE.md": "guides", + "PWA_GUIDE.md": "guides", + "TROUBLESHOOTING.md": "guides", + "UNINSTALL.md": "guides", + "I18N.md": "guides", + "FEATURES.md": "guides", + // reference + "API_REFERENCE.md": "reference", + "PROVIDER_REFERENCE.md": "reference", + "openapi.yaml": "reference", + "ENVIRONMENT.md": "reference", + "CLI-TOOLS.md": "reference", + "FREE_TIERS.md": "reference", + // frameworks + "MCP-SERVER.md": "frameworks", + "A2A-SERVER.md": "frameworks", + "AGENT_PROTOCOLS_GUIDE.md": "frameworks", + "CLOUD_AGENT.md": "frameworks", + "SKILLS.md": "frameworks", + "MEMORY.md": "frameworks", + "WEBHOOKS.md": "frameworks", + "EVALS.md": "frameworks", + // routing + "AUTO-COMBO.md": "routing", + "REASONING_REPLAY.md": "routing", + // security + "GUARDRAILS.md": "security", + "COMPLIANCE.md": "security", + "STEALTH_GUIDE.md": "security", + // compression + "COMPRESSION_GUIDE.md": "compression", + "COMPRESSION_ENGINES.md": "compression", + "COMPRESSION_RULES_FORMAT.md": "compression", + "COMPRESSION_LANGUAGE_PACKS.md": "compression", + "RTK_COMPRESSION.md": "compression", + // ops + "RELEASE_CHECKLIST.md": "ops", + "COVERAGE_PLAN.md": "ops", + "FLY_IO_DEPLOYMENT_GUIDE.md": "ops", + "VM_DEPLOYMENT_GUIDE.md": "ops", + "PROXY_GUIDE.md": "ops", + "TUNNELS_GUIDE.md": "ops", +}; + +// Build alternation regex (longest-first) of file basenames we know about. +const FILES_ALT = Object.keys(DOC_TO_SUBFOLDER) + .sort((a, b) => b.length - a.length) + .map((s) => s.replace(/\./g, "\\.")) + .join("|"); + +// ---------------------------------------------------------------------- +// Internal rewriter (within docs/**) +// ---------------------------------------------------------------------- + +function listDocFiles() { + const out = []; + // walk subfolders we created + for (const sub of new Set(Object.values(DOC_TO_SUBFOLDER))) { + const dir = path.join(DOCS, sub); + if (!fs.existsSync(dir)) continue; + for (const f of fs.readdirSync(dir)) { + if (!f.endsWith(".md") && !f.endsWith(".yaml")) continue; + out.push(path.join(dir, f)); + } + } + // also rewrite the new README and diagrams README + out.push(path.join(DOCS, "README.md")); + return out; +} + +function relativeFromTo(fromAbsFile, targetSub, targetBasename) { + const fromDir = path.dirname(fromAbsFile); + const toAbs = path.join(DOCS, targetSub, targetBasename); + let rel = path.relative(fromDir, toAbs); + // posix-style + rel = rel.split(path.sep).join("/"); + if (!rel.startsWith(".")) rel = "./" + rel; + return rel; +} + +function rewriteInternal(filePath) { + const src = fs.readFileSync(filePath, "utf8"); + let out = src; + + // Pattern A: relative refs like ./FOO.md, ../FOO.md, or bare FOO.md inside (... ). + // We match `]( <optional ./ or ../+> <basename> )` and `]( <basename> )`. + // Captures: prefix (=./ or ../ chains, may be empty), basename. + const reA = new RegExp(`\\]\\(\\s*((?:\\.{1,2}/)*)(${FILES_ALT})((?:#[^\\s)]+)?)\\s*\\)`, "g"); + out = out.replace(reA, (full, prefix, basename, anchor) => { + const subFolder = DOC_TO_SUBFOLDER[basename]; + if (!subFolder) return full; + const newRel = relativeFromTo(filePath, subFolder, basename); + return `](${newRel}${anchor || ""})`; + }); + + // Pattern B: absolute-style `docs/FOO.md` inside markdown links — convert + // to `docs/<sub>/FOO.md`. We avoid double-rewriting if a subfolder is + // already present. + const reB = new RegExp(`docs/(${FILES_ALT})((?:#[^\\s)\"']+)?)`, "g"); + out = out.replace(reB, (full, basename, anchor) => { + const subFolder = DOC_TO_SUBFOLDER[basename]; + if (!subFolder) return full; + // If preceded by `<sub>/` already, skip — but the regex won't capture that + // because it only matches `docs/<basename>`. So this is safe. + return `docs/${subFolder}/${basename}${anchor || ""}`; + }); + + if (out !== src) { + if (!DRY) fs.writeFileSync(filePath, out, "utf8"); + return true; + } + return false; +} + +// ---------------------------------------------------------------------- +// External rewriter (files outside docs/) +// ---------------------------------------------------------------------- + +function listExternalFiles() { + // We rewrite a curated set of paths to avoid wandering into vendor / build dirs. + const candidates = []; + + // 1) Root-level documentation files + for (const f of fs.readdirSync(ROOT)) { + const full = path.join(ROOT, f); + if (!fs.statSync(full).isFile()) continue; + if (/\.(md|txt)$/i.test(f)) candidates.push(full); + } + + // 2) Specific directories we know contain doc references + const dirs = [ + ".agents", + ".claude", + ".github", + "bin", + "electron", + "open-sse", + "scripts", + "src", + "tests", + "vscode-extension", + // i18n mirrors — root-level locale files (llm.txt, CHANGELOG.md, etc.) reference + // the root /docs/ paths and must stay in sync after restructure. + "docs/i18n", + ]; + for (const d of dirs) { + const full = path.join(ROOT, d); + if (!fs.existsSync(full)) continue; + walk(full, candidates); + } + return candidates; +} + +function walk(dir, out) { + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + if (entry.name === "node_modules" || entry.name === ".next") continue; + if (entry.name.startsWith(".git")) continue; + const full = path.join(dir, entry.name); + if (entry.isDirectory()) { + walk(full, out); + } else if (entry.isFile()) { + // accept text-y file types + if (/\.(md|txt|ts|tsx|mjs|cjs|js|json|yaml|yml|sh)$/i.test(entry.name)) { + out.push(full); + } + } + } +} + +function rewriteExternal(filePath) { + const src = fs.readFileSync(filePath, "utf8"); + let out = src; + + // Rewrite any `docs/FOO.md` (only the bare-basename form, not already + // pointing into a subfolder) to `docs/<sub>/FOO.md`. + // Word-boundary lookbehind/lookahead-ish: use (?<![\w/-]) so we don't touch + // already-prefixed `docs/architecture/FOO.md`. + const re = new RegExp(`(?<![A-Za-z0-9_./-])docs/(${FILES_ALT})((?:#[^\\s)\"'\`]+)?)`, "g"); + out = out.replace(re, (full, basename, anchor) => { + const subFolder = DOC_TO_SUBFOLDER[basename]; + if (!subFolder) return full; + return `docs/${subFolder}/${basename}${anchor || ""}`; + }); + + if (out !== src) { + if (!DRY) fs.writeFileSync(filePath, out, "utf8"); + return true; + } + return false; +} + +// ---------------------------------------------------------------------- +// Run +// ---------------------------------------------------------------------- + +let internalChanged = 0; +let externalChanged = 0; +let internalScanned = 0; +let externalScanned = 0; + +if (RUN_INTERNAL) { + const files = listDocFiles(); + for (const f of files) { + internalScanned++; + if (rewriteInternal(f)) internalChanged++; + } + console.log( + `[internal] scanned=${internalScanned} changed=${internalChanged}${DRY ? " (dry-run)" : ""}` + ); +} + +if (RUN_EXTERNAL) { + const files = listExternalFiles(); + for (const f of files) { + externalScanned++; + if (rewriteExternal(f)) externalChanged++; + } + console.log( + `[external] scanned=${externalScanned} changed=${externalChanged}${DRY ? " (dry-run)" : ""}` + ); +} diff --git a/scripts/docs/gen-openapi-module.mjs b/scripts/docs/gen-openapi-module.mjs new file mode 100644 index 0000000000..9bccdfd635 --- /dev/null +++ b/scripts/docs/gen-openapi-module.mjs @@ -0,0 +1,160 @@ +#!/usr/bin/env node +/** + * gen-openapi-module.mjs — build helper that reads docs/reference/openapi.yaml, + * flattens the path/method matrix, and emits + * src/app/docs/lib/openapi.generated.ts so the Api Explorer client can + * iterate endpoints without parsing YAML at runtime. + * + * Runtime guarantees: + * - No `any`. Everything is typed via an explicit `OpenApiEndpoint`. + * - Endpoints are pre-sorted by (path, method) for stable output. + * - Internal management endpoints (those under /api/ but NOT /api/v1) are + * filtered out by default so the Api Explorer focuses on the public + * OpenAI-compatible surface. Override with --include-management. + * + * Wired into `prebuild:docs` so `next build` always sees a fresh module. + */ + +import { promises as fs } from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; +import yaml from "js-yaml"; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); +const ROOT = path.resolve(__dirname, "..", ".."); +const OPENAPI_PATH = path.join(ROOT, "docs", "reference", "openapi.yaml"); +const OUT_PATH = path.join(ROOT, "src", "app", "docs", "lib", "openapi.generated.ts"); + +const HTTP_METHODS = ["get", "post", "put", "delete", "patch", "options", "head"]; + +const args = process.argv.slice(2); +const includeManagement = args.includes("--include-management"); + +function summarizeEndpoint(rawPath, method, op) { + const tags = Array.isArray(op?.tags) && op.tags.length > 0 ? op.tags : ["Other"]; + return { + path: rawPath, + method: method.toUpperCase(), + summary: typeof op?.summary === "string" ? op.summary : "", + description: typeof op?.description === "string" ? op.description : "", + tag: typeof tags[0] === "string" ? tags[0] : "Other", + tags, + requiresAuth: Array.isArray(op?.security) && op.security.length > 0, + hasRequestBody: Boolean(op?.requestBody), + }; +} + +function isPublicV1(rawPath) { + // Anything starting with /api/v1 is the OpenAI-compatible surface; everything + // else under /api/* is internal management. Routes that don't start with /api + // (rare) are kept because they are typically root-level surfaces. + return rawPath.startsWith("/api/v1") || !rawPath.startsWith("/api/"); +} + +function quote(value) { + if (value === undefined || value === null) return "undefined"; + return JSON.stringify(value); +} + +function tsArray(values) { + if (!values || values.length === 0) return "[]"; + return `[${values.map((v) => quote(v)).join(", ")}]`; +} + +function renderEndpoint(ep) { + return ` { + path: ${quote(ep.path)}, + method: ${quote(ep.method)}, + summary: ${quote(ep.summary)}, + description: ${quote(ep.description)}, + tag: ${quote(ep.tag)}, + tags: ${tsArray(ep.tags)}, + requiresAuth: ${ep.requiresAuth ? "true" : "false"}, + hasRequestBody: ${ep.hasRequestBody ? "true" : "false"}, + }`; +} + +async function main() { + const yamlText = await fs.readFile(OPENAPI_PATH, "utf8"); + const spec = yaml.load(yamlText); + + if (!spec || typeof spec !== "object" || !spec.paths || typeof spec.paths !== "object") { + throw new Error("openapi.yaml has no `paths` map"); + } + + const version = spec.info && typeof spec.info.version === "string" ? spec.info.version : "0.0.0"; + const title = + spec.info && typeof spec.info.title === "string" ? spec.info.title : "OmniRoute API"; + + const endpoints = []; + for (const [rawPath, pathItem] of Object.entries(spec.paths)) { + if (!pathItem || typeof pathItem !== "object") continue; + if (!includeManagement && !isPublicV1(rawPath)) continue; + for (const method of HTTP_METHODS) { + const op = pathItem[method]; + if (!op) continue; + endpoints.push(summarizeEndpoint(rawPath, method, op)); + } + } + + endpoints.sort((a, b) => { + if (a.path !== b.path) return a.path.localeCompare(b.path); + return a.method.localeCompare(b.method); + }); + + const totalManagement = Object.entries(spec.paths).filter(([p]) => !isPublicV1(p)).length; + + const header = `// AUTO-GENERATED by scripts/docs/gen-openapi-module.mjs — DO NOT EDIT MANUALLY +// Regenerate with: node scripts/docs/gen-openapi-module.mjs +// +// Source of truth: docs/reference/openapi.yaml +// +// The Api Explorer consumes \`OPENAPI_ENDPOINTS\`; the spec metadata +// (\`OPENAPI_VERSION\`, \`OPENAPI_TITLE\`) is surfaced in the page header. +`; + + const body = ` +export interface OpenApiEndpoint { + /** Path template — may contain \`{param}\` placeholders. */ + path: string; + /** HTTP method in upper case (GET / POST / PUT / DELETE / PATCH / ...). */ + method: string; + /** Short one-line summary from the spec. */ + summary: string; + /** Long-form description (markdown is allowed). */ + description: string; + /** Primary tag — used for sidebar grouping in the Api Explorer. */ + tag: string; + /** All tags declared on the operation. */ + tags: string[]; + /** \`true\` when the operation declares a non-empty \`security\` array. */ + requiresAuth: boolean; + /** \`true\` when the operation declares a \`requestBody\`. */ + hasRequestBody: boolean; +} + +export const OPENAPI_VERSION = ${quote(version)}; +export const OPENAPI_TITLE = ${quote(title)}; + +export const OPENAPI_ENDPOINTS: OpenApiEndpoint[] = [ +${endpoints.map(renderEndpoint).join(",\n")}${endpoints.length > 0 ? "," : ""} +]; + +export const OPENAPI_TAGS: string[] = Array.from( + new Set(OPENAPI_ENDPOINTS.map((endpoint) => endpoint.tag)) +).sort(); +`; + + await fs.mkdir(path.dirname(OUT_PATH), { recursive: true }); + await fs.writeFile(OUT_PATH, `${header}${body}`, "utf8"); + + console.log( + `[gen-openapi-module] wrote ${path.relative(ROOT, OUT_PATH)} (${endpoints.length} endpoints, v${version}, skipped ${totalManagement} management paths)` + ); +} + +main().catch((err) => { + console.error(err); + process.exit(1); +}); diff --git a/scripts/docs/gen-provider-reference.ts b/scripts/docs/gen-provider-reference.ts new file mode 100644 index 0000000000..39bdc09558 --- /dev/null +++ b/scripts/docs/gen-provider-reference.ts @@ -0,0 +1,192 @@ +#!/usr/bin/env node +// Generates docs/reference/PROVIDER_REFERENCE.md from src/shared/constants/providers.ts. +// Run: node --import tsx/esm scripts/docs/gen-provider-reference.ts + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; +import { + FREE_PROVIDERS, + OAUTH_PROVIDERS, + WEB_COOKIE_PROVIDERS, + APIKEY_PROVIDERS, + LOCAL_PROVIDERS, + SEARCH_PROVIDERS, + AUDIO_ONLY_PROVIDERS, + UPSTREAM_PROXY_PROVIDERS, + CLOUD_AGENT_PROVIDERS, + SYSTEM_PROVIDERS, + IMAGE_ONLY_PROVIDER_IDS, + AGGREGATOR_PROVIDER_IDS, + ENTERPRISE_CLOUD_PROVIDER_IDS, + VIDEO_PROVIDER_IDS, + EMBEDDING_RERANK_PROVIDER_IDS, + SELF_HOSTED_CHAT_PROVIDER_IDS, +} from "../../src/shared/constants/providers.ts"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, "..", ".."); +const OUT_FILE = path.join(ROOT, "docs", "reference", "PROVIDER_REFERENCE.md"); + +type ProviderRecord = { + id: string; + alias?: string | undefined; + name: string; + icon?: string; + color?: string; + textIcon?: string; + website?: string; + authHint?: string; + freeNote?: string; + hasFree?: boolean; + deprecated?: boolean; + deprecationReason?: string; + [k: string]: unknown; +}; + +function asRecords(map: Record<string, ProviderRecord>): ProviderRecord[] { + return Object.values(map).map((p) => ({ ...p })); +} + +function escapeCell(value: string | undefined): string { + if (!value) return "—"; + return value.replace(/\|/g, "\\|").replace(/\n/g, " "); +} + +function row(p: ProviderRecord, category: string): string { + const alias = p.alias ? `\`${p.alias}\`` : "—"; + const hint = p.deprecated + ? `⚠️ **DEPRECATED.** ${escapeCell(p.deprecationReason)}` + : escapeCell(p.authHint || p.freeNote); + const link = p.website ? `[link](${p.website})` : "—"; + return `| \`${p.id}\` | ${alias} | ${escapeCell(p.name)} | ${category} | ${link} | ${hint} |`; +} + +function categoryTags(id: string): string[] { + const tags: string[] = []; + if (IMAGE_ONLY_PROVIDER_IDS.has(id)) tags.push("image"); + if (VIDEO_PROVIDER_IDS.has(id)) tags.push("video"); + if (AGGREGATOR_PROVIDER_IDS.has(id)) tags.push("aggregator"); + if (ENTERPRISE_CLOUD_PROVIDER_IDS.has(id)) tags.push("enterprise"); + if (EMBEDDING_RERANK_PROVIDER_IDS.has(id)) tags.push("embed/rerank"); + if (SELF_HOSTED_CHAT_PROVIDER_IDS.has(id)) tags.push("self-hosted"); + return tags; +} + +function sortById(rows: ProviderRecord[]): ProviderRecord[] { + return [...rows].sort((a, b) => a.id.localeCompare(b.id)); +} + +function buildSection(title: string, rows: ProviderRecord[], category: string): string { + if (rows.length === 0) return ""; + const lines: string[] = []; + lines.push(`## ${title} (${rows.length})\n`); + lines.push("| ID | Alias | Name | Tags | Website | Notes |"); + lines.push("|----|-------|------|------|---------|-------|"); + for (const p of sortById(rows)) { + const tags = [category, ...categoryTags(p.id)].join(", "); + lines.push(row(p, tags)); + } + lines.push(""); + return lines.join("\n"); +} + +function buildHeader(total: number): string { + const date = new Date().toISOString().slice(0, 10); + return [ + "# Provider Reference", + "", + `> **Auto-generated** from \`src/shared/constants/providers.ts\` — do not edit by hand.`, + `> Regenerate with: \`npm run gen:provider-reference\``, + `> **Last generated:** ${date}`, + "", + `Total providers: **${total}**. See category breakdown below.`, + "", + "## Categories", + "", + "- **Free** — free tier with API key (configured via dashboard)", + "- **OAuth** — sign-in flow handled by OmniRoute, no API key needed", + "- **Web cookie** — wraps the provider's web app via cookie auth", + "- **API key** — paid provider configured via API key (free credits may apply)", + "- **Local** — runs on the user's machine (Ollama, LM Studio, vLLM, etc.)", + "- **Search** — web search providers", + "- **Audio** — audio-only providers (TTS/STT)", + "- **Upstream proxy** — providers that proxy to other providers", + "- **Cloud agent** — long-running coding agents (Codex Cloud, Devin, Jules)", + "- **System** — OmniRoute-internal providers (loopback, etc.)", + "", + "Additional tags: `image`, `video`, `aggregator`, `enterprise`, `embed/rerank`, `self-hosted`.", + "", + "Use the dashboard at `/dashboard/providers` to enable, configure, and test each provider.", + "", + "---", + "", + ].join("\n"); +} + +function main() { + const free = asRecords(FREE_PROVIDERS); + const oauth = asRecords(OAUTH_PROVIDERS); + const webCookie = asRecords(WEB_COOKIE_PROVIDERS); + const apiKey = asRecords(APIKEY_PROVIDERS); + const local = asRecords(LOCAL_PROVIDERS); + const search = asRecords(SEARCH_PROVIDERS); + const audio = asRecords(AUDIO_ONLY_PROVIDERS); + const upstreamProxy = asRecords(UPSTREAM_PROXY_PROVIDERS); + const cloudAgent = asRecords(CLOUD_AGENT_PROVIDERS); + const system = asRecords(SYSTEM_PROVIDERS); + + const allIds = new Set<string>([ + ...free.map((p) => p.id), + ...oauth.map((p) => p.id), + ...webCookie.map((p) => p.id), + ...apiKey.map((p) => p.id), + ...local.map((p) => p.id), + ...search.map((p) => p.id), + ...audio.map((p) => p.id), + ...upstreamProxy.map((p) => p.id), + ...cloudAgent.map((p) => p.id), + ...system.map((p) => p.id), + ]); + + const sections = [ + buildSection("Free Tier (OAuth-first or no-key)", free, "Free"), + buildSection("OAuth Providers", oauth, "OAuth"), + buildSection("Web Cookie Providers", webCookie, "Web cookie"), + buildSection("API Key Providers (paid / paid-with-free-credits)", apiKey, "API key"), + buildSection("Local Providers", local, "Local"), + buildSection("Search Providers", search, "Search"), + buildSection("Audio-only Providers", audio, "Audio"), + buildSection("Upstream Proxy Providers", upstreamProxy, "Upstream proxy"), + buildSection("Cloud Agent Providers", cloudAgent, "Cloud agent"), + buildSection("System Providers", system, "System"), + ]; + + const footer = [ + "## Sources of truth", + "", + "- Catalog: [`src/shared/constants/providers.ts`](../src/shared/constants/providers.ts)", + "- Registry (per-model details): [`open-sse/config/providerRegistry.ts`](../open-sse/config/providerRegistry.ts)", + "- Executors: [`open-sse/executors/`](../open-sse/executors/) (31 files)", + "- Translators: [`open-sse/translator/`](../open-sse/translator/)", + "", + "## See Also", + "", + "- [FREE_TIERS.md](./FREE_TIERS.md) — curated free-tier guide", + "- [USER_GUIDE.md](./USER_GUIDE.md) — provider setup walkthrough", + "- [ARCHITECTURE.md](./ARCHITECTURE.md) — overall architecture", + "", + ].join("\n"); + + const content = buildHeader(allIds.size) + sections.join("\n") + "\n" + footer; + fs.writeFileSync(OUT_FILE, content); + console.log(`✓ Wrote ${OUT_FILE}`); + console.log(` Providers: ${allIds.size} unique IDs`); + console.log( + ` Sections: free=${free.length}, oauth=${oauth.length}, web=${webCookie.length}, ` + + `apikey=${apiKey.length}, local=${local.length}, search=${search.length}, ` + + `audio=${audio.length}, proxy=${upstreamProxy.length}, cloud=${cloudAgent.length}, system=${system.length}` + ); +} + +main(); diff --git a/scripts/generate-docs-index.mjs b/scripts/docs/generate-docs-index.mjs similarity index 58% rename from scripts/generate-docs-index.mjs rename to scripts/docs/generate-docs-index.mjs index 69c6babd88..24a83c1ef9 100644 --- a/scripts/generate-docs-index.mjs +++ b/scripts/docs/generate-docs-index.mjs @@ -1,12 +1,15 @@ #!/usr/bin/env node /** - * Build-time script: scans docs/*.md and generates + * Build-time script: scans docs/<subfolder>/*.md and generates * src/app/docs/lib/docs-auto-generated.ts with static navigation + search data. * * This file is imported by both client and server components — NO fs/path imports. - * Run via: node scripts/generate-docs-index.mjs + * Run via: node scripts/docs/generate-docs-index.mjs * Automatically runs as prebuild step. + * + * Sections come from the on-disk subfolder layout introduced in FASE 3 of the + * platform overhaul. Order is fixed by SECTION_ORDER below. */ import fs from "node:fs"; @@ -15,68 +18,23 @@ import matter from "gray-matter"; import { fileURLToPath } from "node:url"; const __dirname = path.dirname(fileURLToPath(import.meta.url)); -const ROOT = path.resolve(__dirname, ".."); +const ROOT = path.resolve(__dirname, "..", ".."); const DOCS_DIR = path.join(ROOT, "docs"); const OUT_FILE = path.join(ROOT, "src", "app", "docs", "lib", "docs-auto-generated.ts"); -const SECTION_CATEGORIES = { - "Getting Started": [ - "SETUP_GUIDE", - "USER_GUIDE", - "CLI_TOOLS", - "ARCHITECTURE", - "QUICK_START", - "GETTING_STARTED", - ], - Features: [ - "FEATURES", - "AUTO_COMBO", - "COMPRESSION_GUIDE", - "RTK_COMPRESSION", - "COMPRESSION_ENGINES", - "COMPRESSION_RULES_FORMAT", - "COMPRESSION_LANGUAGE_PACKS", - "FREE_TIERS", - ], - "API & Protocols": ["API_REFERENCE", "MCP_SERVER", "A2A_SERVER"], - Deployment: [ - "DOCKER_GUIDE", - "VM_DEPLOYMENT_GUIDE", - "FLY_IO_DEPLOYMENT_GUIDE", - "TERMUX_GUIDE", - "PWA_GUIDE", - ], - Operations: ["PROXY_GUIDE", "RESILIENCE_GUIDE", "ENVIRONMENT", "TROUBLESHOOTING"], - Development: [ - "CODEBASE_DOCUMENTATION", - "COVERAGE_PLAN", - "I18N", - "RELEASE_CHECKLIST", - "UNINSTALL", - "CONTRIBUTING", - "CHANGELOG", - "CODE_OF_CONDUCT", - ], -}; +// Subfolder -> nav section title, in the order they should appear in the sidebar. +const SECTION_ORDER = [ + { dir: "architecture", title: "Architecture" }, + { dir: "guides", title: "Guides" }, + { dir: "reference", title: "Reference" }, + { dir: "frameworks", title: "Frameworks" }, + { dir: "routing", title: "Routing" }, + { dir: "security", title: "Security" }, + { dir: "compression", title: "Compression" }, + { dir: "ops", title: "Ops" }, +]; -const SECTION_ORDER = { - "Getting Started": 1, - Features: 2, - "API & Protocols": 3, - Deployment: 4, - Operations: 5, - Development: 6, -}; - -function categorizeFile(fileName) { - const stem = fileName.replace(/\.md$/i, "").toUpperCase().replace(/-/g, "_"); - for (const [section, patterns] of Object.entries(SECTION_CATEGORIES)) { - if (patterns.some((p) => stem === p)) { - return section; - } - } - return "Other"; -} +const SECTION_INDEX = Object.fromEntries(SECTION_ORDER.map((s, i) => [s.title, i + 1])); function extractTitleFromContent(content) { const match = content.match(/^#\s+(.+)$/m); @@ -114,21 +72,12 @@ function extractContentPreview(content) { return stripped.slice(0, 300); } -// ---------- Main ---------- - -if (!fs.existsSync(DOCS_DIR)) { - if (fs.existsSync(OUT_FILE)) { - console.warn( - `[generate-docs-index] ${DOCS_DIR} not found; keeping existing generated docs index.` - ); - process.exit(0); - } - +function emitEmpty(reason) { fs.mkdirSync(path.dirname(OUT_FILE), { recursive: true }); fs.writeFileSync( OUT_FILE, - `// AUTO-GENERATED by scripts/generate-docs-index.mjs — DO NOT EDIT MANUALLY -// Regenerate with: node scripts/generate-docs-index.mjs + `// AUTO-GENERATED by scripts/docs/generate-docs-index.mjs — DO NOT EDIT MANUALLY +// Regenerate with: node scripts/docs/generate-docs-index.mjs export interface AutoGenDocItem { slug: string; @@ -158,51 +107,88 @@ export const autoAllSlugs: string[] = []; `, "utf8" ); - console.warn(`[generate-docs-index] ${DOCS_DIR} not found; generated empty docs index.`); + console.warn(`[generate-docs-index] ${reason}; generated empty docs index.`); +} + +// ---------- Main ---------- + +if (!fs.existsSync(DOCS_DIR)) { + if (fs.existsSync(OUT_FILE)) { + console.warn( + `[generate-docs-index] ${DOCS_DIR} not found; keeping existing generated docs index.` + ); + process.exit(0); + } + emitEmpty(`${DOCS_DIR} not found`); process.exit(0); } -const files = fs.readdirSync(DOCS_DIR).filter((f) => f.endsWith(".md") || f.endsWith(".mdx")); - const docs = []; -for (const fileName of files) { - const filePath = path.join(DOCS_DIR, fileName); - const fileContent = fs.readFileSync(filePath, "utf8"); - const { data: frontmatter, content } = matter(fileContent); - const slug = - frontmatter.slug || - fileName - .replace(/\.mdx?$/i, "") - .toLowerCase() - .replace(/_/g, "-"); - const title = frontmatter.title || extractTitleFromContent(content) || slug.replace(/-/g, " "); - const section = frontmatter.section || categorizeFile(fileName); - const order = frontmatter.order ?? 999; - const headings = extractHeadings(content); - const contentPreview = frontmatter.description || extractContentPreview(content); +for (const { dir, title } of SECTION_ORDER) { + const fullDir = path.join(DOCS_DIR, dir); + if (!fs.existsSync(fullDir)) continue; + const entries = fs.readdirSync(fullDir, { withFileTypes: true }); + for (const entry of entries) { + if (!entry.isFile()) continue; + if (!entry.name.endsWith(".md") && !entry.name.endsWith(".mdx")) continue; + if (entry.name === "README.md") continue; // section index, not a doc page - docs.push({ slug, title, fileName, section, order, content: contentPreview, headings }); + const absPath = path.join(fullDir, entry.name); + const fileContent = fs.readFileSync(absPath, "utf8"); + const { data: frontmatter, content } = matter(fileContent); + + const slug = + frontmatter.slug || + entry.name + .replace(/\.mdx?$/i, "") + .toLowerCase() + .replace(/_/g, "-"); + + // fileName is relative to docs/ — used by the slug page to read content. + const fileName = path.posix.join(dir, entry.name); + + const titleStr = + frontmatter.title || extractTitleFromContent(content) || slug.replace(/-/g, " "); + const section = frontmatter.section || title; + const order = frontmatter.order ?? 999; + const headings = extractHeadings(content); + const contentPreview = frontmatter.description || extractContentPreview(content); + + docs.push({ + slug, + title: titleStr, + fileName, + section, + order, + content: contentPreview, + headings, + }); + } +} + +if (docs.length === 0) { + emitEmpty("no docs discovered in subfolders"); + process.exit(0); } docs.sort((a, b) => { - const sectionA = SECTION_ORDER[a.section] ?? 99; - const sectionB = SECTION_ORDER[b.section] ?? 99; + const sectionA = SECTION_INDEX[a.section] ?? 99; + const sectionB = SECTION_INDEX[b.section] ?? 99; if (sectionA !== sectionB) return sectionA - sectionB; return a.order - b.order; }); -// Build navigation sections +// Build navigation sections in the configured order. const sectionMap = new Map(); for (const doc of docs) { const items = sectionMap.get(doc.section) || []; items.push(doc); sectionMap.set(doc.section, items); } -const orderedSections = [...new Set([...Object.keys(SECTION_ORDER), ...sectionMap.keys()])]; -const navSections = orderedSections - .filter((s) => sectionMap.has(s)) - .sort((a, b) => (SECTION_ORDER[a] ?? 99) - (SECTION_ORDER[b] ?? 99)) + +const navSections = SECTION_ORDER.map(({ title }) => title) + .filter((t) => sectionMap.has(t)) .map((title) => ({ title, items: sectionMap.get(title).map((doc) => ({ @@ -228,8 +214,8 @@ if (searchIndex.some((item) => item.slug === "api-reference")) { searchIndex.push({ slug: "api-explorer", title: "API Explorer", - fileName: "API_REFERENCE.md", - section: "API & Protocols", + fileName: "reference/API_REFERENCE.md", + section: "Reference", content: "interactive try it live api explorer endpoint test request response curl example", headings: ["Try It", "Endpoints"], }); @@ -238,8 +224,8 @@ if (searchIndex.some((item) => item.slug === "api-reference")) { // ---------- Write output ---------- -const output = `// AUTO-GENERATED by scripts/generate-docs-index.mjs — DO NOT EDIT MANUALLY -// Regenerate with: node scripts/generate-docs-index.mjs +const output = `// AUTO-GENERATED by scripts/docs/generate-docs-index.mjs — DO NOT EDIT MANUALLY +// Regenerate with: node scripts/docs/generate-docs-index.mjs export interface AutoGenDocItem { slug: string; diff --git a/scripts/docs/move-i18n-mirrors.mjs b/scripts/docs/move-i18n-mirrors.mjs new file mode 100644 index 0000000000..110f3dfda2 --- /dev/null +++ b/scripts/docs/move-i18n-mirrors.mjs @@ -0,0 +1,139 @@ +#!/usr/bin/env node +// One-shot: FASE 3 helper, safe to delete after merge. +// +// Moves existing i18n mirror docs from `docs/i18n/<lang>/docs/X.md` into the +// matching subfolder `docs/i18n/<lang>/docs/<sub>/X.md`, mirroring the new +// docs/ layout. Uses `git mv` to preserve history. +// +// Usage: +// node scripts/docs/move-i18n-mirrors.mjs [--dry] +// +// Notes: +// - Skips files that don't appear in DOC_TO_SUBFOLDER (e.g., the legacy +// `cloudflare-zero-trust-guide.md` or `features/` subfolder — those will be +// handled in FASE 5 when translations are regenerated). +// - Idempotent: if the target already lives under a subfolder, the entry is +// skipped. + +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; +import { execSync } from "node:child_process"; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, "..", ".."); +const I18N_DIR = path.join(ROOT, "docs", "i18n"); + +const DRY = process.argv.includes("--dry"); + +const DOC_TO_SUBFOLDER = { + // architecture + "ARCHITECTURE.md": "architecture", + "CODEBASE_DOCUMENTATION.md": "architecture", + "REPOSITORY_MAP.md": "architecture", + "AUTHZ_GUIDE.md": "architecture", + "RESILIENCE_GUIDE.md": "architecture", + // guides + "SETUP_GUIDE.md": "guides", + "USER_GUIDE.md": "guides", + "DOCKER_GUIDE.md": "guides", + "ELECTRON_GUIDE.md": "guides", + "TERMUX_GUIDE.md": "guides", + "PWA_GUIDE.md": "guides", + "TROUBLESHOOTING.md": "guides", + "UNINSTALL.md": "guides", + "I18N.md": "guides", + "FEATURES.md": "guides", + // reference + "API_REFERENCE.md": "reference", + "PROVIDER_REFERENCE.md": "reference", + "openapi.yaml": "reference", + "ENVIRONMENT.md": "reference", + "CLI-TOOLS.md": "reference", + "FREE_TIERS.md": "reference", + // frameworks + "MCP-SERVER.md": "frameworks", + "A2A-SERVER.md": "frameworks", + "AGENT_PROTOCOLS_GUIDE.md": "frameworks", + "CLOUD_AGENT.md": "frameworks", + "SKILLS.md": "frameworks", + "MEMORY.md": "frameworks", + "WEBHOOKS.md": "frameworks", + "EVALS.md": "frameworks", + // routing + "AUTO-COMBO.md": "routing", + "REASONING_REPLAY.md": "routing", + // security + "GUARDRAILS.md": "security", + "COMPLIANCE.md": "security", + "STEALTH_GUIDE.md": "security", + // compression + "COMPRESSION_GUIDE.md": "compression", + "COMPRESSION_ENGINES.md": "compression", + "COMPRESSION_RULES_FORMAT.md": "compression", + "COMPRESSION_LANGUAGE_PACKS.md": "compression", + "RTK_COMPRESSION.md": "compression", + // ops + "RELEASE_CHECKLIST.md": "ops", + "COVERAGE_PLAN.md": "ops", + "FLY_IO_DEPLOYMENT_GUIDE.md": "ops", + "VM_DEPLOYMENT_GUIDE.md": "ops", + "PROXY_GUIDE.md": "ops", + "TUNNELS_GUIDE.md": "ops", +}; + +let moved = 0; +let skipped = 0; +const seenLocales = []; + +for (const locale of fs.readdirSync(I18N_DIR)) { + const localeDir = path.join(I18N_DIR, locale); + const stat = fs.statSync(localeDir); + if (!stat.isDirectory()) continue; + const docsDir = path.join(localeDir, "docs"); + if (!fs.existsSync(docsDir)) continue; + seenLocales.push(locale); + + for (const fname of fs.readdirSync(docsDir)) { + const sub = DOC_TO_SUBFOLDER[fname]; + if (!sub) continue; // not in our mapping (e.g. features/, cloudflare-zero-trust-guide.md) + + const src = path.join(docsDir, fname); + if (!fs.statSync(src).isFile()) continue; + + const subDir = path.join(docsDir, sub); + const dst = path.join(subDir, fname); + + if (fs.existsSync(dst)) { + skipped++; + continue; + } + + if (DRY) { + console.log(`would move: ${path.relative(ROOT, src)} -> ${path.relative(ROOT, dst)}`); + moved++; + continue; + } + + if (!fs.existsSync(subDir)) fs.mkdirSync(subDir, { recursive: true }); + try { + execSync(`git mv -k -- "${path.relative(ROOT, src)}" "${path.relative(ROOT, dst)}"`, { + cwd: ROOT, + stdio: "pipe", + }); + moved++; + } catch (e) { + // fallback: copy + delete + fs.renameSync(src, dst); + execSync( + `git rm --cached -- "${path.relative(ROOT, src)}" 2>/dev/null || true; git add -- "${path.relative(ROOT, dst)}"`, + { cwd: ROOT, stdio: "pipe", shell: "/bin/bash" } + ); + moved++; + } + } +} + +console.log( + `[i18n-mirrors] locales=${seenLocales.length} moved=${moved} skipped=${skipped}${DRY ? " (dry-run)" : ""}` +); diff --git a/scripts/docs/render-diagrams.mjs b/scripts/docs/render-diagrams.mjs new file mode 100644 index 0000000000..01cd7c7377 --- /dev/null +++ b/scripts/docs/render-diagrams.mjs @@ -0,0 +1,85 @@ +#!/usr/bin/env node +/** + * Render every Mermaid source in docs/diagrams/*.mmd into docs/diagrams/exported/*.svg + * + * Usage: + * npm run docs:render-diagrams + * + * Requirements: + * - @mermaid-js/mermaid-cli (`mmdc`) on PATH or installed globally. + * `npm install -g @mermaid-js/mermaid-cli` if missing. + * + * Notes: + * - Puppeteer needs `--no-sandbox` on Ubuntu 23.10+ / WSL. A temp config file + * is written automatically. + * - Each diagram is rendered with `--backgroundColor white` so the SVG works + * against both light and dark themes. + * - The script exits non-zero on first failure so CI / pre-commit hooks can + * gate on it. + */ +import { spawnSync } from "node:child_process"; +import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs"; +import { dirname, join, resolve } from "node:path"; +import { fileURLToPath } from "node:url"; +import { tmpdir } from "node:os"; + +const __dirname = dirname(fileURLToPath(import.meta.url)); +const repoRoot = resolve(__dirname, "..", ".."); +const srcDir = resolve(repoRoot, "docs", "diagrams"); +const outDir = resolve(srcDir, "exported"); + +if (!existsSync(srcDir)) { + console.error(`[render-diagrams] missing source dir: ${srcDir}`); + process.exit(1); +} +if (!existsSync(outDir)) { + mkdirSync(outDir, { recursive: true }); +} + +// Puppeteer needs --no-sandbox on many Linux distros (Ubuntu 23.10+, WSL). +const puppeteerConfigPath = join(tmpdir(), "omniroute-mmdc-puppeteer.json"); +writeFileSync( + puppeteerConfigPath, + JSON.stringify({ args: ["--no-sandbox", "--disable-setuid-sandbox"] }, null, 2) +); + +const sources = readdirSync(srcDir) + .filter((f) => f.endsWith(".mmd")) + .sort(); + +if (sources.length === 0) { + console.error(`[render-diagrams] no .mmd files in ${srcDir}`); + process.exit(1); +} + +console.log(`[render-diagrams] rendering ${sources.length} diagram(s)`); +let failures = 0; +for (const src of sources) { + const input = join(srcDir, src); + const output = join(outDir, src.replace(/\.mmd$/, ".svg")); + console.log(` - ${src} -> ${output.replace(repoRoot + "/", "")}`); + const result = spawnSync( + "mmdc", + [ + "-i", + input, + "-o", + output, + "--backgroundColor", + "white", + "--puppeteerConfigFile", + puppeteerConfigPath, + ], + { stdio: "inherit" } + ); + if (result.status !== 0) { + console.error(` [FAIL] ${src} (exit ${result.status})`); + failures += 1; + } +} + +if (failures > 0) { + console.error(`[render-diagrams] ${failures} failure(s)`); + process.exit(1); +} +console.log(`[render-diagrams] all ${sources.length} diagram(s) rendered.`); diff --git a/scripts/i18n/check-translation-drift.mjs b/scripts/i18n/check-translation-drift.mjs new file mode 100755 index 0000000000..17719d23b8 --- /dev/null +++ b/scripts/i18n/check-translation-drift.mjs @@ -0,0 +1,161 @@ +#!/usr/bin/env node +/** + * OmniRoute — i18n translation drift checker (CI gate). + * + * Verifies that every source file recorded in `.i18n-state.json` still has + * the same SHA-256 hash on disk and that every produced translation file + * exists with the recorded target hash. Does NOT call any API — purely a + * deterministic state-vs-disk comparison. + * + * Modes: + * --strict (default) exit 1 on any drift, print the offending paths + * --warn exit 0, print warnings only + * --json emit a JSON report to stdout (no human log lines) + * + * Recommended usage in CI: + * npm run i18n:check + */ + +import { promises as fs, existsSync } from "node:fs"; +import path from "node:path"; +import crypto from "node:crypto"; +import process from "node:process"; +import { fileURLToPath, pathToFileURL } from "node:url"; + +const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(SCRIPT_DIR, "..", ".."); +const STATE_PATH = path.join(ROOT, ".i18n-state.json"); + +function parseArgs(argv) { + const opts = { mode: "strict", json: false }; + for (const arg of argv.slice(2)) { + if (arg === "--warn") opts.mode = "warn"; + else if (arg === "--strict") opts.mode = "strict"; + else if (arg === "--json") opts.json = true; + else if (arg === "--help" || arg === "-h") { + console.log( + [ + "Usage: node scripts/i18n/check-translation-drift.mjs [--strict|--warn] [--json]", + "", + " --strict (default) exit 1 when any source or target is out of date", + " --warn report drift but exit 0", + " --json write a machine-readable report to stdout", + ].join("\n") + ); + process.exit(0); + } + } + return opts; +} + +function sha256(buf) { + return crypto.createHash("sha256").update(buf).digest("hex"); +} + +async function main() { + const opts = parseArgs(process.argv); + + if (!existsSync(STATE_PATH)) { + const msg = ".i18n-state.json not found — run `npm run i18n:run` to bootstrap."; + if (opts.json) { + process.stdout.write(JSON.stringify({ ok: false, reason: "missing-state" }) + "\n"); + } else { + console.error(`[i18n-check] ${msg}`); + } + process.exit(opts.mode === "warn" ? 0 : 1); + } + + const state = JSON.parse(await fs.readFile(STATE_PATH, "utf8")); + const sources = state.sources || {}; + + const driftedSources = []; + const missingTargets = []; + const driftedTargets = []; + let checkedSources = 0; + let checkedTargets = 0; + + for (const [rel, entry] of Object.entries(sources)) { + checkedSources++; + const absSource = path.join(ROOT, rel); + if (!existsSync(absSource)) { + driftedSources.push({ rel, reason: "source-missing" }); + continue; + } + const currentHash = sha256(await fs.readFile(absSource)); + if (currentHash !== entry.source_hash) { + driftedSources.push({ + rel, + reason: "source-changed", + recorded: entry.source_hash, + current: currentHash, + }); + } + + for (const [locale, info] of Object.entries(entry.locales || {})) { + checkedTargets++; + // Mirror the path layout used by run-translation.mjs. + const targetAbs = rel.includes("/") + ? path.join(ROOT, "docs", "i18n", locale, rel) + : path.join(ROOT, "docs", "i18n", locale, rel); + if (!existsSync(targetAbs)) { + missingTargets.push({ rel, locale }); + continue; + } + const targetHash = sha256(await fs.readFile(targetAbs)); + if (info.target_hash && targetHash !== info.target_hash) { + driftedTargets.push({ rel, locale, recorded: info.target_hash, current: targetHash }); + } + } + } + + const ok = + driftedSources.length === 0 && missingTargets.length === 0 && driftedTargets.length === 0; + + if (opts.json) { + process.stdout.write( + JSON.stringify( + { + ok, + checkedSources, + checkedTargets, + driftedSources, + missingTargets, + driftedTargets, + }, + null, + 2 + ) + "\n" + ); + } else { + console.log(`[i18n-check] checked sources=${checkedSources}, targets=${checkedTargets}`); + if (driftedSources.length) { + console.log(`[i18n-check] drifted sources (${driftedSources.length}):`); + for (const d of driftedSources) console.log(` - ${d.rel} (${d.reason})`); + } + if (missingTargets.length) { + console.log(`[i18n-check] missing targets (${missingTargets.length}):`); + for (const m of missingTargets) console.log(` - ${m.rel} [${m.locale}]`); + } + if (driftedTargets.length) { + console.log(`[i18n-check] drifted targets (${driftedTargets.length}):`); + for (const t of driftedTargets) console.log(` - ${t.rel} [${t.locale}]`); + } + if (ok) { + console.log("[i18n-check] PASS — all sources and targets match recorded hashes."); + } else if (opts.mode === "warn") { + console.log("[i18n-check] WARN — drift detected (warn mode, exiting 0)."); + } else { + console.log("[i18n-check] FAIL — drift detected. Run `npm run i18n:run` to refresh."); + } + } + + if (!ok && opts.mode !== "warn") process.exit(1); +} + +const isDirectRun = import.meta.url === pathToFileURL(process.argv[1]).href; +if (isDirectRun) { + main().catch((err) => { + console.error("[i18n-check] ERROR", err?.stack || err?.message || String(err)); + process.exit(1); + }); +} diff --git a/scripts/i18n/check-ui-keys-coverage.mjs b/scripts/i18n/check-ui-keys-coverage.mjs new file mode 100644 index 0000000000..24be2aa9e5 --- /dev/null +++ b/scripts/i18n/check-ui-keys-coverage.mjs @@ -0,0 +1,277 @@ +#!/usr/bin/env node +/** + * OmniRoute — UI i18n key coverage gate. + * + * Compares every `src/i18n/messages/<locale>.json` against `en.json` and + * reports: + * - total_en: total leaves in en.json + * - present: leaves present in the locale (any shape match) + * - missing: leaves absent in the locale + * - placeholder: leaves whose value starts with __MISSING__: + * - coverage: (present - placeholder) / total_en * 100 + * + * Usage: + * npm run i18n:check-ui-coverage # threshold 80, fail on drop + * npm run i18n:check-ui-coverage -- --threshold=75 + * npm run i18n:check-ui-coverage -- --report # informational tabular output + * npm run i18n:check-ui-coverage -- --json # machine-readable report + * + * Exits 1 when any locale falls below `--threshold` (default 80), unless + * `--report` is set, in which case the table is printed and exit code is 0. + */ + +import { promises as fs, existsSync } from "node:fs"; +import path from "node:path"; +import process from "node:process"; +import { fileURLToPath, pathToFileURL } from "node:url"; + +const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(SCRIPT_DIR, "..", ".."); +const MESSAGES_DIR = path.join(ROOT, "src", "i18n", "messages"); +const CONFIG_PATH = path.join(ROOT, "config", "i18n.json"); +const SOURCE_LOCALE = "en"; +const PLACEHOLDER_PREFIX = "__MISSING__:"; + +function logInfo(...parts) { + console.log("[i18n-ui-coverage]", ...parts); +} +function logWarn(...parts) { + console.warn("[i18n-ui-coverage] WARN", ...parts); +} + +function parseArgs(argv) { + const opts = { threshold: 80, report: false, json: false }; + for (const arg of argv.slice(2)) { + if (arg.startsWith("--threshold=")) { + opts.threshold = Number(arg.slice(12)); + } else if (arg === "--report") { + opts.report = true; + } else if (arg === "--json") { + opts.json = true; + } else if (arg === "--help" || arg === "-h") { + console.log( + [ + "Usage: node scripts/i18n/check-ui-keys-coverage.mjs [options]", + "", + " --threshold=<n> Minimum coverage % for every locale (default 80)", + " --report Print full coverage table, exit 0 regardless", + " --json Emit JSON report to stdout", + ].join("\n") + ); + process.exit(0); + } + } + if (!Number.isFinite(opts.threshold) || opts.threshold < 0 || opts.threshold > 100) { + throw new Error(`Invalid --threshold value: ${opts.threshold}`); + } + return opts; +} + +async function loadJson(filePath) { + const raw = await fs.readFile(filePath, "utf8"); + return JSON.parse(raw); +} + +function isPlainObject(value) { + return value !== null && typeof value === "object" && !Array.isArray(value); +} + +function collectLeafPaths(obj, prefix = "") { + const paths = []; + for (const [key, value] of Object.entries(obj)) { + const next = prefix ? `${prefix}.${key}` : key; + if (isPlainObject(value)) { + paths.push(...collectLeafPaths(value, next)); + } else { + paths.push(next); + } + } + return paths; +} + +// Reject any segment that could traverse into the object prototype chain. This +// is defensive — our inputs are JSON files we authored, but the static +// scanner correctly flags any dynamic indexing with untrusted-looking keys. +const FORBIDDEN_KEY_SEGMENTS = new Set(["__proto__", "prototype", "constructor"]); + +function lookupPath(obj, dotPath) { + const parts = dotPath.split("."); + let cur = obj; + for (const part of parts) { + if (!isPlainObject(cur)) return undefined; + if (FORBIDDEN_KEY_SEGMENTS.has(part)) return undefined; + if (!Object.prototype.hasOwnProperty.call(cur, part)) return undefined; + // Use Map-like get via Object.entries to avoid dynamic bracket access + // patterns the static analyzer warns about. We already validated the key + // exists as an own property above. + const entry = Object.entries(cur).find(([k]) => k === part); + cur = entry ? entry[1] : undefined; + } + return cur; +} + +function pad(str, width) { + const s = String(str); + return s.length >= width ? s : s + " ".repeat(width - s.length); +} +function padLeft(str, width) { + const s = String(str); + return s.length >= width ? s : " ".repeat(width - s.length) + s; +} + +async function main() { + const opts = parseArgs(process.argv); + + const sourcePath = path.join(MESSAGES_DIR, `${SOURCE_LOCALE}.json`); + if (!existsSync(sourcePath)) { + throw new Error(`Source messages file not found: ${sourcePath}`); + } + const source = await loadJson(sourcePath); + const enPaths = collectLeafPaths(source); + const totalEn = enPaths.length; + + // Locale set: every <code>.json on disk except en, intersected with config. + let configCodes = null; + if (existsSync(CONFIG_PATH)) { + try { + const cfg = JSON.parse(await fs.readFile(CONFIG_PATH, "utf8")); + if (Array.isArray(cfg.locales)) { + configCodes = new Set(cfg.locales.map((l) => l.code)); + } + } catch { + /* ignore — fall back to disk listing only */ + } + } + const onDisk = (await fs.readdir(MESSAGES_DIR)) + .filter((f) => f.endsWith(".json") && f !== `${SOURCE_LOCALE}.json`) + .map((f) => f.slice(0, -5)) + .filter((code) => (configCodes ? configCodes.has(code) : true)) + .sort(); + + const results = []; + for (const locale of onDisk) { + const localePath = path.join(MESSAGES_DIR, `${locale}.json`); + let target; + try { + target = await loadJson(localePath); + } catch (err) { + logWarn(`${locale}: failed to parse JSON (${err.message})`); + results.push({ + locale, + total_en: totalEn, + present: 0, + missing: totalEn, + placeholder: 0, + coverage: 0, + }); + continue; + } + + let present = 0; + let missing = 0; + let placeholder = 0; + for (const dotPath of enPaths) { + const value = lookupPath(target, dotPath); + if (value === undefined) { + missing++; + continue; + } + // Treat plain objects at scalar positions as missing — shape mismatch. + if (isPlainObject(value)) { + missing++; + continue; + } + present++; + if (typeof value === "string" && value.startsWith(PLACEHOLDER_PREFIX)) { + placeholder++; + } + } + const real = present - placeholder; + const coverage = totalEn === 0 ? 100 : (real / totalEn) * 100; + results.push({ locale, total_en: totalEn, present, missing, placeholder, coverage }); + } + + const failures = results.filter((r) => r.coverage < opts.threshold); + + if (opts.json) { + process.stdout.write( + JSON.stringify( + { + source: SOURCE_LOCALE, + totalKeys: totalEn, + threshold: opts.threshold, + ok: failures.length === 0, + results, + }, + null, + 2 + ) + "\n" + ); + if (failures.length && !opts.report) process.exit(1); + return; + } + + // Human-readable output (table). + const localeW = Math.max(8, ...results.map((r) => r.locale.length)); + const header = + pad("locale", localeW) + + " " + + padLeft("coverage", 10) + + " " + + padLeft("real", 6) + + " " + + padLeft("present", 7) + + " " + + padLeft("missing", 7) + + " " + + padLeft("placeholder", 11) + + " " + + padLeft("total_en", 8); + console.log(header); + console.log("-".repeat(header.length)); + for (const r of results) { + const real = r.present - r.placeholder; + const pct = `${r.coverage.toFixed(1)}%`; + const marker = r.coverage < opts.threshold ? " ✗" : ""; + console.log( + pad(r.locale, localeW) + + " " + + padLeft(pct, 10) + + " " + + padLeft(real, 6) + + " " + + padLeft(r.present, 7) + + " " + + padLeft(r.missing, 7) + + " " + + padLeft(r.placeholder, 11) + + " " + + padLeft(r.total_en, 8) + + marker + ); + } + + if (failures.length) { + if (opts.report) { + logInfo( + `${failures.length} locale(s) below threshold ${opts.threshold}% — report mode, exiting 0.` + ); + } else { + logInfo(`FAIL — ${failures.length} locale(s) below threshold ${opts.threshold}%.`); + for (const f of failures) { + console.log(` - ${f.locale}: ${f.coverage.toFixed(1)}%`); + } + process.exit(1); + } + } else { + logInfo(`PASS — all ${results.length} locale(s) at or above ${opts.threshold}% coverage.`); + } +} + +const isDirectRun = import.meta.url === pathToFileURL(process.argv[1]).href; +if (isDirectRun) { + main().catch((err) => { + console.error("[i18n-ui-coverage] ERROR", err?.stack || err?.message || String(err)); + process.exit(1); + }); +} diff --git a/scripts/check_translations.py b/scripts/i18n/check_translations.py similarity index 97% rename from scripts/check_translations.py rename to scripts/i18n/check_translations.py index 80d662c0a7..2f2f38abe8 100755 --- a/scripts/check_translations.py +++ b/scripts/i18n/check_translations.py @@ -4,9 +4,9 @@ Translation check script for OmniRoute. Checks if all translation keys used in code exist in en.json. Usage: - python scripts/check_translations.py - python scripts/check_translations.py --verbose - python scripts/check_translations.py --fix + python scripts/i18n/check_translations.py + python scripts/i18n/check_translations.py --verbose + python scripts/i18n/check_translations.py --fix """ import json diff --git a/scripts/i18n/generate-multilang.mjs b/scripts/i18n/generate-multilang.mjs index b2479a50fc..ec4a6f3a61 100644 --- a/scripts/i18n/generate-multilang.mjs +++ b/scripts/i18n/generate-multilang.mjs @@ -1,8 +1,22 @@ #!/usr/bin/env node +/** + * DEPRECATED 2026-05-13. Use `npm run i18n:run` + * (scripts/i18n/run-translation.mjs) for docs translation. + * + * This Google-Translate-backed generator is kept for the `messages` and + * `readme` modes which target `src/i18n/messages/*.json` and root README + * variants — those are not yet handled by the new LLM pipeline. The `docs` + * mode is superseded and will be removed in v3.10. + */ + import { promises as fs } from "node:fs"; import path from "node:path"; +console.warn( + "[generate-multilang] DEPRECATED: prefer `npm run i18n:run` for docs (this script will be removed in v3.10)." +); + const ROOT = process.cwd(); const MESSAGES_DIR = path.join(ROOT, "src", "i18n", "messages"); const DOCS_DIR = path.join(ROOT, "docs"); diff --git a/scripts/i18n_autotranslate.py b/scripts/i18n/i18n_autotranslate.py similarity index 89% rename from scripts/i18n_autotranslate.py rename to scripts/i18n/i18n_autotranslate.py index 9321ff57f6..e05749a3ea 100755 --- a/scripts/i18n_autotranslate.py +++ b/scripts/i18n/i18n_autotranslate.py @@ -1,17 +1,27 @@ #!/usr/bin/env python3 """ -OmniRoute i18n Auto-Translator -This script scans all docs/i18n directory markdown files and uses an LLM -API (like OmniRoute itself) to translate any English paragraphs into the -target language. +DEPRECATED 2026-05-13. Use `npm run i18n:run` +(scripts/i18n/run-translation.mjs) instead. This Python script will be +removed in v3.10. -Usage: - python3 scripts/i18n_autotranslate.py --api-url http://localhost:20128/v1 --api-key sk-your-omniroute-key --model cx/gpt-5.4 +The Node-based translator is hash-incremental (only retranslates files +whose source SHA-256 changed), runs the OmniRoute Cloud LLM through +OMNIROUTE_TRANSLATION_* env vars, and is wired into `npm run i18n:run` +and `npm run i18n:check`. + +Historical purpose: + Scanned `docs/i18n/` markdown files and translated English paragraphs + into the target language by paragraph through an OpenAI-compatible LLM. """ +import sys +print( + "WARN: scripts/i18n/i18n_autotranslate.py is deprecated. Use 'npm run i18n:run' instead.", + file=sys.stderr, +) + import os import re -import sys import glob import json import urllib.request diff --git a/scripts/i18n/run-translation.mjs b/scripts/i18n/run-translation.mjs new file mode 100755 index 0000000000..117ba0fd86 --- /dev/null +++ b/scripts/i18n/run-translation.mjs @@ -0,0 +1,628 @@ +#!/usr/bin/env node +/** + * OmniRoute — Docs translation pipeline (hash-based, incremental). + * + * Source of truth: `config/i18n.json` (locale list) and the original English + * markdown files at the repo root (`CLAUDE.md`, `GEMINI.md`, `README.md`, …) + * plus `docs/*.md`. + * + * Targets land in `docs/i18n/<locale>/...` mirroring the source layout, with a + * header (top H1 + language bar) and an `---` separator before the translated + * body. This is the same shape the existing `check-docs-sync.mjs` already + * understands. + * + * State: `.i18n-state.json` stores a SHA-256 hash for every source file and + * for every produced target. Re-runs only retranslate files whose source hash + * changed or whose target file is missing. + * + * Usage (driven by npm scripts in package.json): + * npm run i18n:run + * npm run i18n:run -- --locale=pt-BR + * npm run i18n:run -- --files=CLAUDE.md,docs/ARCHITECTURE.md + * npm run i18n:run -- --force + * npm run i18n:run:dry + * + * Backend (configured via env, never committed): + * OMNIROUTE_TRANSLATION_API_URL e.g. https://cloud.omniroute.dev/v1 + * OMNIROUTE_TRANSLATION_API_KEY bearer token (kept out of logs) + * OMNIROUTE_TRANSLATION_MODEL e.g. cx/gpt-5.4-mini + * OMNIROUTE_TRANSLATION_TIMEOUT_MS optional, default 60000 + * OMNIROUTE_TRANSLATION_CONCURRENCY optional, default 4 + */ + +import { promises as fs, existsSync, readFileSync } from "node:fs"; +import path from "node:path"; +import crypto from "node:crypto"; +import process from "node:process"; +import { fileURLToPath, pathToFileURL } from "node:url"; + +// ----- .env loader -------------------------------------------------------- +// Loads variables from a local `.env` (gitignored) into process.env without +// pulling dotenv as a dependency. Already-set env vars take precedence so the +// shell / CI environment can still override. +(function loadDotEnv() { + const envPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", ".env"); + if (!existsSync(envPath)) return; + try { + const raw = readFileSync(envPath, "utf8"); + for (const rawLine of raw.split(/\r?\n/)) { + const line = rawLine.trim(); + if (!line || line.startsWith("#")) continue; + const eq = line.indexOf("="); + if (eq <= 0) continue; + const key = line.slice(0, eq).trim(); + if (!key || process.env[key] !== undefined) continue; + let value = line.slice(eq + 1); + if ( + (value.startsWith('"') && value.endsWith('"')) || + (value.startsWith("'") && value.endsWith("'")) + ) { + value = value.slice(1, -1); + } + process.env[key] = value; + } + } catch { + /* ignore — script will fall back to the requireEnv error path */ + } +})(); + +// Prettier is loaded lazily on first use so the script still runs (with a +// warning) in environments where node_modules has not been installed. The +// formatter is applied to every translated file before its hash is recorded, +// so a subsequent lint-staged Prettier pass cannot mutate the file content +// out from under `.i18n-state.json`. +let prettierMod = null; +async function getPrettier() { + if (prettierMod !== null) return prettierMod; + try { + prettierMod = await import("prettier"); + } catch { + prettierMod = false; + } + return prettierMod; +} + +async function formatMarkdown(content, fileName) { + const p = await getPrettier(); + if (!p) return content; + try { + return await p.format(content, { parser: "markdown", filepath: fileName }); + } catch (err) { + logWarn(`prettier could not format ${fileName}: ${err.message}`); + return content; + } +} + +const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(SCRIPT_DIR, "..", ".."); +const CONFIG_PATH = path.join(ROOT, "config", "i18n.json"); +const STATE_PATH = path.join(ROOT, ".i18n-state.json"); +const DOCS_I18N_DIR = path.join(ROOT, "docs", "i18n"); +const DOCS_DIR = path.join(ROOT, "docs"); + +// ----- Source set ---------------------------------------------------------- +// +// Root-level markdown files that should be translated as `docs/i18n/<loc>/<name>`. +// Strict-mirror files (`llm.txt`, `CHANGELOG.md`) are intentionally NOT in this +// list — they are handled by `scripts/check-docs-sync.mjs` rules and are kept +// in sync by other tooling. Adding them here would conflict with that script. +const ROOT_DOC_SOURCES = [ + "CLAUDE.md", + "GEMINI.md", + "AGENTS.md", + "CONTRIBUTING.md", + "SECURITY.md", + "CODE_OF_CONDUCT.md", + "README.md", +]; + +// File names inside `docs/` that should NOT be translated. Anything else with +// a `.md` extension at the top of `docs/` is treated as a source. +const DOCS_EXCLUDED_NAMES = new Set([ + "I18N.md", // Translator tooling docs — kept English-only for operators. + "README.md", // Section index files — auto-generated, not prose translation targets. +]); + +// Sub-trees we never recurse into when collecting sources. +const DOCS_EXCLUDED_SUBDIRS = new Set([ + "i18n", + "screenshots", + "superpowers", + "diagrams", + "reports", +]); + +// ----- Helpers ------------------------------------------------------------- + +function logInfo(...parts) { + console.log("[i18n-run]", ...parts); +} + +function logWarn(...parts) { + console.warn("[i18n-run] WARN", ...parts); +} + +function logError(...parts) { + console.error("[i18n-run] ERROR", ...parts); +} + +function sha256(buffer) { + return crypto.createHash("sha256").update(buffer).digest("hex"); +} + +function parseArgs(argv) { + const opts = { + locales: null, + files: null, + force: false, + dryRun: false, + concurrency: null, + }; + for (const arg of argv.slice(2)) { + if (arg === "--force") opts.force = true; + else if (arg === "--dry-run" || arg === "--dryrun") opts.dryRun = true; + else if (arg.startsWith("--locale=")) + opts.locales = arg + .slice(9) + .split(",") + .map((s) => s.trim()) + .filter(Boolean); + else if (arg.startsWith("--locales=")) + opts.locales = arg + .slice(10) + .split(",") + .map((s) => s.trim()) + .filter(Boolean); + else if (arg.startsWith("--files=")) + opts.files = arg + .slice(8) + .split(",") + .map((s) => s.trim()) + .filter(Boolean); + else if (arg.startsWith("--concurrency=")) opts.concurrency = Number(arg.slice(14)); + else if (arg === "--help" || arg === "-h") { + console.log( + [ + "Usage: node scripts/i18n/run-translation.mjs [options]", + "", + " --locale=<csv> Target locales (default: all except `en`)", + " --files=<csv> Relative paths to translate (default: all sources)", + " --force Retranslate even when hashes match", + " --dry-run Report what would happen but never call the API", + " --concurrency=<n> Parallel API requests (default: env CONCURRENCY or 4)", + ].join("\n") + ); + process.exit(0); + } + } + return opts; +} + +async function loadConfig() { + const raw = await fs.readFile(CONFIG_PATH, "utf8"); + const cfg = JSON.parse(raw); + if (!cfg.default || !Array.isArray(cfg.locales)) { + throw new Error("config/i18n.json: invalid shape (need `default` and `locales[]`)"); + } + return cfg; +} + +async function loadState() { + if (!existsSync(STATE_PATH)) return { sources: {} }; + try { + const raw = await fs.readFile(STATE_PATH, "utf8"); + const parsed = JSON.parse(raw); + return parsed && typeof parsed === "object" && parsed.sources ? parsed : { sources: {} }; + } catch (err) { + logWarn(`could not parse ${path.relative(ROOT, STATE_PATH)} — starting fresh (${err.message})`); + return { sources: {} }; + } +} + +async function saveState(state) { + const json = JSON.stringify(state, null, 2) + "\n"; + await fs.writeFile(STATE_PATH, json, "utf8"); +} + +async function collectDocsSources() { + const found = []; + for (const entry of await fs.readdir(DOCS_DIR, { withFileTypes: true })) { + if (entry.isFile() && entry.name.endsWith(".md") && !DOCS_EXCLUDED_NAMES.has(entry.name)) { + found.push(`docs/${entry.name}`); + } else if (entry.isDirectory() && !DOCS_EXCLUDED_SUBDIRS.has(entry.name)) { + // Recurse one level for organized doc groups (e.g. docs/features/*.md). + const sub = path.join(DOCS_DIR, entry.name); + for (const child of await fs.readdir(sub, { withFileTypes: true })) { + if ( + child.isFile() && + child.name.endsWith(".md") && + !DOCS_EXCLUDED_NAMES.has(child.name) && + child.name.toLowerCase() !== "readme.md" + ) { + found.push(`docs/${entry.name}/${child.name}`); + } + } + } + } + return found; +} + +async function collectAllSources() { + const rootSources = []; + for (const name of ROOT_DOC_SOURCES) { + const abs = path.join(ROOT, name); + if (existsSync(abs)) rootSources.push(name); + } + const docsSources = await collectDocsSources(); + return [...rootSources, ...docsSources].sort(); +} + +function targetPathFor(relSource, locale) { + // Root MDs (`CLAUDE.md`, …) → `docs/i18n/<loc>/CLAUDE.md` + if (!relSource.includes("/")) { + return path.join(DOCS_I18N_DIR, locale, relSource); + } + // `docs/X.md` → `docs/i18n/<loc>/docs/X.md` + // `docs/features/Y.md` → `docs/i18n/<loc>/docs/features/Y.md` + return path.join(DOCS_I18N_DIR, locale, relSource); +} + +function relativeBackToRoot(targetAbsPath) { + // From the target file's directory back to the repo root, used to build the + // "🇺🇸 English" link in the language bar. + const targetDir = path.dirname(targetAbsPath); + const rel = path.relative(targetDir, ROOT); + return rel === "" ? "." : rel; +} + +function buildLanguageBar(relSource, locale, config) { + const targetAbs = targetPathFor(relSource, locale); + const targetDir = path.dirname(targetAbs); + const rootRel = relativeBackToRoot(targetAbs); + + const parts = []; + // English link → source file relative to target dir. + const enRel = path.relative(targetDir, path.join(ROOT, relSource)); + parts.push(`🇺🇸 [English](${enRel.split(path.sep).join("/")})`); + + for (const entry of config.locales) { + if (entry.code === "en" || entry.code === locale) continue; + const peerAbs = targetPathFor(relSource, entry.code); + const peerRel = path.relative(targetDir, peerAbs).split(path.sep).join("/"); + parts.push(`${entry.flag} [${entry.code}](${peerRel})`); + } + + return `🌐 **Languages:** ${parts.join(" · ")}`; + // Quiet the unused linter warning for rootRel — kept here for future expansion. + void rootRel; +} + +function extractTopHeading(markdown) { + const m = markdown.match(/^# (.+)\r?\n/); + return m ? m[1].trim() : null; +} + +function stripTopHeading(markdown) { + return markdown.replace(/^# .+\r?\n+/, ""); +} + +// ----- Translator backend -------------------------------------------------- + +function requireEnv(name) { + const v = process.env[name]; + if (!v || !v.trim()) { + throw new Error( + `Missing required env var: ${name}. Set it in .env (see docs/guides/I18N.md → "Translation pipeline").` + ); + } + return v.trim(); +} + +function backendConfig() { + const apiUrl = requireEnv("OMNIROUTE_TRANSLATION_API_URL").replace(/\/$/, ""); + const apiKey = requireEnv("OMNIROUTE_TRANSLATION_API_KEY"); + const model = requireEnv("OMNIROUTE_TRANSLATION_MODEL"); + const timeoutMs = Number(process.env.OMNIROUTE_TRANSLATION_TIMEOUT_MS || 60000); + return { apiUrl, apiKey, model, timeoutMs }; +} + +async function callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry = 0) { + const ctrl = new AbortController(); + const timer = setTimeout(() => ctrl.abort(), timeoutMs); + try { + const res = await fetch(`${apiUrl}/chat/completions`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${apiKey}`, + }, + body: JSON.stringify({ + model, + messages, + temperature: 0.15, + stream: false, + }), + signal: ctrl.signal, + }); + if (!res.ok) { + const text = await res.text().catch(() => ""); + const transient = res.status === 408 || res.status === 429 || res.status >= 500; + if (transient && retry < 1) { + const wait = 1500 + retry * 1500; + logWarn(`upstream ${res.status} — retrying after ${wait}ms`); + await new Promise((r) => setTimeout(r, wait)); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw new Error(`upstream ${res.status}: ${text.slice(0, 200)}`); + } + const json = await res.json(); + const content = json?.choices?.[0]?.message?.content; + if (typeof content !== "string" || !content) { + throw new Error("upstream returned empty content"); + } + return content; + } catch (err) { + if (err?.name === "AbortError") { + if (retry < 1) { + logWarn(`timeout after ${timeoutMs}ms — retrying`); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw new Error(`timeout after ${timeoutMs}ms`); + } + if ( + retry < 1 && + err instanceof TypeError && + /fetch failed|ECONN|ENOTFOUND|network/i.test(String(err.cause ?? err.message)) + ) { + logWarn(`network error: ${err.message} — retrying`); + await new Promise((r) => setTimeout(r, 1500)); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw err; + } finally { + clearTimeout(timer); + } +} + +const SYSTEM_PROMPT = (englishName, native) => + [ + `You are a professional translator for technical software documentation.`, + `Translate the user's markdown content into ${englishName} (native: ${native}).`, + `Preserve all markdown syntax EXACTLY: headings, lists, code blocks (\`\`\`), inline code (\`...\`), links, images, tables, blockquotes, HTML tags.`, + `Do NOT translate: source code, URLs, file paths, command names (npm/git/curl/node/etc), environment variable names (UPPER_SNAKE_CASE),`, + `version numbers, package names, shell flags, function/class identifiers, JSON keys.`, + `Translate ALL prose, including comments inside code blocks IF they are clearly prose comments (lines starting with # or //).`, + `Return ONLY the translated markdown — no preamble, no explanation, no surrounding fences.`, + ].join(" "); + +// Splits a markdown body into chunks of <= maxChars, breaking on top-level `## ` headings only. +function chunkMarkdown(markdown, maxChars = 6000) { + if (markdown.length <= maxChars) return [markdown]; + const lines = markdown.split("\n"); + const chunks = []; + let buf = []; + let size = 0; + for (const line of lines) { + if (line.startsWith("## ") && size > maxChars * 0.5) { + chunks.push(buf.join("\n")); + buf = [line]; + size = line.length; + } else { + buf.push(line); + size += line.length + 1; + } + } + if (buf.length) chunks.push(buf.join("\n")); + return chunks; +} + +async function translateBody(body, localeEntry, backend) { + const englishName = localeEntry.english ?? localeEntry.name; + const native = localeEntry.native ?? localeEntry.name; + const system = SYSTEM_PROMPT(englishName, native); + const chunks = chunkMarkdown(body); + const translated = []; + for (let i = 0; i < chunks.length; i++) { + const messages = [ + { role: "system", content: system }, + { role: "user", content: chunks[i] }, + ]; + const out = await callChat(messages, backend); + translated.push(out.trim()); + if (chunks.length > 1) { + logInfo( + ` chunk ${i + 1}/${chunks.length} translated (${chunks[i].length} → ${out.length} chars)` + ); + } + } + // Re-join with a blank line between chunks (we split on `## ` headings). + return translated.join("\n\n"); +} + +// Simple promise-based semaphore (avoid runtime deps). +function createLimiter(max) { + let active = 0; + const queue = []; + const next = () => { + if (!queue.length || active >= max) return; + active++; + const { fn, resolve, reject } = queue.shift(); + fn() + .then((v) => { + active--; + resolve(v); + next(); + }) + .catch((err) => { + active--; + reject(err); + next(); + }); + }; + return (fn) => + new Promise((resolve, reject) => { + queue.push({ fn, resolve, reject }); + next(); + }); +} + +// ----- Main ---------------------------------------------------------------- + +async function main() { + const opts = parseArgs(process.argv); + const config = await loadConfig(); + const allSources = await collectAllSources(); + const state = await loadState(); + + const sources = opts.files ? allSources.filter((s) => opts.files.includes(s)) : allSources; + if (opts.files) { + const missing = opts.files.filter((f) => !allSources.includes(f)); + if (missing.length) { + logWarn(`--files contains paths not in the source set: ${missing.join(", ")}`); + } + } + + const docsExcluded = new Set(config.docsExcluded ?? ["en"]); + let targetLocales = config.locales.map((l) => l.code).filter((code) => !docsExcluded.has(code)); + if (opts.locales) { + targetLocales = targetLocales.filter((code) => opts.locales.includes(code)); + const missing = opts.locales.filter((c) => !config.locales.some((l) => l.code === c)); + if (missing.length) { + logWarn(`--locale contains codes not in config/i18n.json: ${missing.join(", ")}`); + } + } + + logInfo(`sources: ${sources.length}`); + logInfo(`locales: ${targetLocales.length} (${targetLocales.join(", ")})`); + logInfo(`dry-run: ${opts.dryRun ? "yes" : "no"}, force: ${opts.force ? "yes" : "no"}`); + + // Read backend env up front so dry-run can still print masked summary. + let backend = null; + if (!opts.dryRun) { + backend = backendConfig(); + if (opts.concurrency) backend.concurrency = opts.concurrency; + else backend.concurrency = Number(process.env.OMNIROUTE_TRANSLATION_CONCURRENCY || 4); + logInfo( + `backend: ${backend.apiUrl} (model=${backend.model}, concurrency=${backend.concurrency}, timeout=${backend.timeoutMs}ms)` + ); + } else { + const apiUrl = (process.env.OMNIROUTE_TRANSLATION_API_URL || "").replace(/\/$/, ""); + logInfo(`backend (dry-run): ${apiUrl || "<unset>"}`); + } + + const limit = createLimiter(opts.dryRun ? 1 : backend.concurrency); + + let stats = { translated: 0, skipped: 0, failed: 0, considered: 0 }; + const failures = []; + + // Precompute source hashes once per source. + const sourceHashes = new Map(); + for (const rel of sources) { + const abs = path.join(ROOT, rel); + const buf = await fs.readFile(abs); + sourceHashes.set(rel, { hash: sha256(buf), text: buf.toString("utf8") }); + } + + // Build a flat queue of (source, locale) work units. + const tasks = []; + for (const rel of sources) { + const { hash: sourceHash } = sourceHashes.get(rel); + const entry = + state.sources[rel] || (state.sources[rel] = { source_hash: sourceHash, locales: {} }); + entry.source_hash = sourceHash; + + for (const locale of targetLocales) { + stats.considered++; + const targetAbs = targetPathFor(rel, locale); + const previous = entry.locales[locale]; + const sourceChanged = previous?.source_hash !== sourceHash; + const missingTarget = !existsSync(targetAbs); + if (!opts.force && !sourceChanged && !missingTarget) { + stats.skipped++; + continue; + } + tasks.push({ rel, locale, targetAbs, sourceChanged, missingTarget }); + } + } + + logInfo( + `work units: ${tasks.length} (skipped up-to-date: ${stats.skipped} of ${stats.considered})` + ); + + if (opts.dryRun) { + for (const t of tasks) { + console.log(` [DRY] ${t.rel} → ${path.relative(ROOT, t.targetAbs)}`); + } + logInfo(`dry-run complete — would translate ${tasks.length} files`); + return; + } + + const startMs = Date.now(); + + await Promise.all( + tasks.map((task) => + limit(async () => { + const localeEntry = config.locales.find((l) => l.code === task.locale); + const sourceText = sourceHashes.get(task.rel).text; + const sourceHash = sourceHashes.get(task.rel).hash; + const topHeading = extractTopHeading(sourceText); + const body = stripTopHeading(sourceText); + + let translatedBody; + try { + translatedBody = await translateBody(body, localeEntry, backend); + } catch (err) { + stats.failed++; + failures.push({ rel: task.rel, locale: task.locale, error: err.message }); + logError(`${task.rel} [${task.locale}] failed: ${err.message}`); + return; + } + + const heading = topHeading + ? `# ${topHeading} (${localeEntry.native})` + : `# ${path.basename(task.rel, ".md")} (${localeEntry.native})`; + const langBar = buildLanguageBar(task.rel, task.locale, config); + const rawContent = `${heading}\n\n${langBar}\n\n---\n\n${translatedBody.trim()}\n`; + // Pre-format with Prettier (markdown parser) so the on-disk content + // matches what `lint-staged` would produce. This keeps `target_hash` + // stable across commit hooks. + const finalContent = await formatMarkdown(rawContent, task.targetAbs); + + await fs.mkdir(path.dirname(task.targetAbs), { recursive: true }); + await fs.writeFile(task.targetAbs, finalContent, "utf8"); + + const targetHash = sha256(Buffer.from(finalContent, "utf8")); + state.sources[task.rel].locales[task.locale] = { + source_hash: sourceHash, + target_hash: targetHash, + updated_at: new Date().toISOString(), + }; + + stats.translated++; + logInfo(`✓ ${task.rel} → ${task.locale} (${translatedBody.length} chars)`); + }) + ) + ); + + // Save state even on partial failure so future runs only retry what failed. + await saveState(state); + + const elapsedSec = ((Date.now() - startMs) / 1000).toFixed(1); + logInfo( + `summary: translated=${stats.translated}, skipped=${stats.skipped}, failed=${stats.failed}, total considered=${stats.considered}, elapsed=${elapsedSec}s` + ); + + if (failures.length) { + logWarn(`${failures.length} failures:`); + for (const f of failures) console.warn(` - ${f.rel} [${f.locale}]: ${f.error}`); + process.exit(1); + } +} + +const isDirectRun = import.meta.url === pathToFileURL(process.argv[1]).href; +if (isDirectRun) { + main().catch((err) => { + logError(err?.stack || err?.message || String(err)); + process.exit(1); + }); +} diff --git a/scripts/i18n/sync-llm-mirrors.mjs b/scripts/i18n/sync-llm-mirrors.mjs new file mode 100644 index 0000000000..2d63d22257 --- /dev/null +++ b/scripts/i18n/sync-llm-mirrors.mjs @@ -0,0 +1,89 @@ +#!/usr/bin/env node +/** + * sync-llm-mirrors.mjs — keep docs/i18n/<locale>/llm.txt in lock-step with + * the root `llm.txt`. The mirrors are strict copies (no translation): they + * preserve the per-locale heading + language bar block they already have at + * the top of the file, then replace everything after the `---` separator with + * the root body (heading stripped). + * + * Usage: + * node scripts/i18n/sync-llm-mirrors.mjs + * + * Idempotent. Safe to run repeatedly. Used after any edit to `llm.txt` to + * keep `npm run check:docs-sync` green. + */ + +import { promises as fs } from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); +const ROOT = path.resolve(__dirname, "..", ".."); +const I18N_DIR = path.join(ROOT, "docs", "i18n"); +const ROOT_LLM = path.join(ROOT, "llm.txt"); +const FILE_NAME = "llm.txt"; + +function stripTopHeading(content) { + return content.replace(/^# .+\r?\n+/, ""); +} + +async function main() { + const rootText = await fs.readFile(ROOT_LLM, "utf8"); + const rootBody = stripTopHeading(rootText).replace(/\r\n/g, "\n"); + + const entries = await fs.readdir(I18N_DIR, { withFileTypes: true }); + const locales = entries + .filter((e) => e.isDirectory()) + .map((e) => e.name) + .sort(); + + let updated = 0; + let unchanged = 0; + let missing = 0; + + for (const locale of locales) { + const target = path.join(I18N_DIR, locale, FILE_NAME); + let existing; + try { + existing = await fs.readFile(target, "utf8"); + } catch { + console.warn(`[sync-llm-mirrors] skip ${locale}: ${FILE_NAME} missing`); + missing += 1; + continue; + } + + // The locale header is everything up to and including the first `---` + // separator on its own line. We keep that prefix verbatim and replace + // the rest with the root body. + const sepMatch = existing.match(/^---\s*$/m); + if (!sepMatch || sepMatch.index === undefined) { + console.warn(`[sync-llm-mirrors] skip ${locale}: missing --- separator`); + missing += 1; + continue; + } + + const headerEnd = sepMatch.index + sepMatch[0].length; + const header = existing.slice(0, headerEnd).replace(/\r\n/g, "\n"); + const trimmedHeader = header.replace(/\n+$/, ""); + const next = `${trimmedHeader}\n\n${rootBody.trimStart()}`.replace(/\r\n/g, "\n"); + + const normalizedExisting = existing.replace(/\r\n/g, "\n"); + if (normalizedExisting === next) { + unchanged += 1; + continue; + } + await fs.writeFile(target, next, "utf8"); + updated += 1; + console.log(`[sync-llm-mirrors] updated docs/i18n/${locale}/${FILE_NAME}`); + } + + console.log( + `[sync-llm-mirrors] done — updated=${updated} unchanged=${unchanged} missing=${missing} (${locales.length} locales)` + ); +} + +main().catch((err) => { + console.error(err); + process.exit(1); +}); diff --git a/scripts/i18n/sync-ui-keys.mjs b/scripts/i18n/sync-ui-keys.mjs new file mode 100755 index 0000000000..46a7366b9b --- /dev/null +++ b/scripts/i18n/sync-ui-keys.mjs @@ -0,0 +1,496 @@ +#!/usr/bin/env node +/** + * OmniRoute — UI i18n key sync (next-intl message catalogs). + * + * Source of truth: `src/i18n/messages/en.json`. Every other locale JSON in + * `src/i18n/messages/` should mirror the same key tree. This script replicates + * any keys that are missing in a target locale, marking them with a + * `__MISSING__:<english_value>` sentinel so reviewers (and the optional LLM + * pass below) can spot them. It never overwrites an existing translated value. + * + * Usage (driven by npm scripts in package.json): + * npm run i18n:sync-ui + * npm run i18n:sync-ui -- --locale=pt-BR,zh-CN + * npm run i18n:sync-ui -- --dry-run + * npm run i18n:sync-ui -- --translate-markers + * npm run i18n:sync-ui -- --translate-markers --locale=pt-BR --concurrency=4 + * + * --translate-markers calls the OmniRoute translation backend (same env vars + * as `run-translation.mjs`) and replaces every `__MISSING__:<en>` placeholder + * with a translated string. Missing env vars cause the script to fail + * fast — the markers stay in place for a later run. + * + * Output examples: + * [i18n-ui-sync] pt-BR: +589 missing keys (589 __MISSING__, 0 translated) + * [i18n-ui-sync] pt-BR: +0 missing keys (already in sync) + */ + +import { promises as fs, existsSync, readFileSync } from "node:fs"; +import path from "node:path"; +import process from "node:process"; +import { fileURLToPath, pathToFileURL } from "node:url"; + +// ----- .env loader -------------------------------------------------------- +// Loads variables from a local `.env` (gitignored) into process.env without +// pulling dotenv as a dependency. Already-set env vars take precedence so the +// shell / CI environment can still override. +(function loadDotEnv() { + const envPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", ".env"); + if (!existsSync(envPath)) return; + try { + const raw = readFileSync(envPath, "utf8"); + for (const rawLine of raw.split(/\r?\n/)) { + const line = rawLine.trim(); + if (!line || line.startsWith("#")) continue; + const eq = line.indexOf("="); + if (eq <= 0) continue; + const key = line.slice(0, eq).trim(); + if (!key || process.env[key] !== undefined) continue; + let value = line.slice(eq + 1); + if ( + (value.startsWith('"') && value.endsWith('"')) || + (value.startsWith("'") && value.endsWith("'")) + ) { + value = value.slice(1, -1); + } + process.env[key] = value; + } + } catch { + /* ignore — script will fall back to the requireEnv error path */ + } +})(); + +const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(SCRIPT_DIR, "..", ".."); +const CONFIG_PATH = path.join(ROOT, "config", "i18n.json"); +const MESSAGES_DIR = path.join(ROOT, "src", "i18n", "messages"); +const SOURCE_LOCALE = "en"; +const PLACEHOLDER_PREFIX = "__MISSING__:"; + +// ----- Helpers ------------------------------------------------------------- + +function logInfo(...parts) { + console.log("[i18n-ui-sync]", ...parts); +} +function logWarn(...parts) { + console.warn("[i18n-ui-sync] WARN", ...parts); +} +function logError(...parts) { + console.error("[i18n-ui-sync] ERROR", ...parts); +} + +function parseArgs(argv) { + const opts = { + locales: null, + dryRun: false, + translateMarkers: false, + concurrency: null, + }; + for (const arg of argv.slice(2)) { + if (arg === "--dry-run" || arg === "--dryrun") opts.dryRun = true; + else if (arg === "--translate-markers") opts.translateMarkers = true; + else if (arg.startsWith("--locale=")) { + opts.locales = arg + .slice(9) + .split(",") + .map((s) => s.trim()) + .filter(Boolean); + } else if (arg.startsWith("--locales=")) { + opts.locales = arg + .slice(10) + .split(",") + .map((s) => s.trim()) + .filter(Boolean); + } else if (arg.startsWith("--concurrency=")) { + opts.concurrency = Number(arg.slice(14)); + } else if (arg === "--help" || arg === "-h") { + console.log( + [ + "Usage: node scripts/i18n/sync-ui-keys.mjs [options]", + "", + " --locale=<csv> Target locales (default: all except `en`)", + " --dry-run Report what would change, write nothing", + " --translate-markers Call the translation backend to translate every", + " __MISSING__:<en> placeholder", + " --concurrency=<n> Parallel translation requests (default: env or 4)", + ].join("\n") + ); + process.exit(0); + } + } + return opts; +} + +async function loadConfig() { + const raw = await fs.readFile(CONFIG_PATH, "utf8"); + const cfg = JSON.parse(raw); + if (!cfg.default || !Array.isArray(cfg.locales)) { + throw new Error("config/i18n.json: invalid shape (need `default` and `locales[]`)"); + } + return cfg; +} + +async function loadJson(filePath) { + const raw = await fs.readFile(filePath, "utf8"); + return JSON.parse(raw); +} + +function isPlainObject(value) { + return value !== null && typeof value === "object" && !Array.isArray(value); +} + +// Defensive: reject any key that could traverse into the object prototype +// chain when we copy/merge values across JSON trees. Our inputs are +// authored JSON we already control, but excluding these keys is a cheap +// safety net. +const FORBIDDEN_KEYS = new Set(["__proto__", "prototype", "constructor"]); + +/** + * Walks the source tree key-by-key. For each leaf in `source` that is not + * present in `target` (or whose corresponding target path is an object when + * source is a leaf, etc.), copies the source value into a new merged object, + * prefixing scalar values with PLACEHOLDER_PREFIX. Existing translated keys + * are preserved verbatim. + * + * Returns a tuple: { merged, addedPaths } so the caller can report the + * additions and (optionally) translate them. + */ +function mergeMissing(source, target) { + const addedPaths = []; + + function walk(srcNode, tgtNode, prefix) { + if (!isPlainObject(srcNode)) { + // Source is a leaf. If target is missing or shape-mismatched, insert. + if (tgtNode === undefined) { + addedPaths.push(prefix); + return typeof srcNode === "string" ? `${PLACEHOLDER_PREFIX}${srcNode}` : srcNode; + } + // Existing value (even if string starts with placeholder) is kept. + return tgtNode; + } + + // Source is an object — produce a prototype-less object preserving source + // key order. Using Object.create(null) guarantees no inherited keys can + // leak through later lookups, and we skip any key that resolves to a + // built-in prototype property name as a defense in depth. + const out = Object.create(null); + for (const [key, value] of Object.entries(srcNode)) { + if (FORBIDDEN_KEYS.has(key)) continue; + const nextPrefix = prefix ? `${prefix}.${key}` : key; + let tgtChild; + if (isPlainObject(tgtNode) && Object.prototype.hasOwnProperty.call(tgtNode, key)) { + // Read the property via Object.entries instead of dynamic bracket + // access to keep static analyzers happy. + const entry = Object.entries(tgtNode).find(([k]) => k === key); + tgtChild = entry ? entry[1] : undefined; + } + out[key] = walk(value, tgtChild, nextPrefix); + } + return out; + } + + const merged = walk(source, target, ""); + return { merged, addedPaths }; +} + +function countPlaceholders(node) { + if (typeof node === "string") return node.startsWith(PLACEHOLDER_PREFIX) ? 1 : 0; + if (!isPlainObject(node)) return 0; + let total = 0; + for (const value of Object.values(node)) total += countPlaceholders(value); + return total; +} + +// ----- Translator backend (mirrors run-translation.mjs) -------------------- + +function requireEnv(name) { + const v = process.env[name]; + if (!v || !v.trim()) { + throw new Error( + `Missing required env var: ${name}. Set it in .env (see docs/guides/I18N.md → "Translation pipeline").` + ); + } + return v.trim(); +} + +function backendConfig() { + const apiUrl = requireEnv("OMNIROUTE_TRANSLATION_API_URL").replace(/\/$/, ""); + const apiKey = requireEnv("OMNIROUTE_TRANSLATION_API_KEY"); + const model = requireEnv("OMNIROUTE_TRANSLATION_MODEL"); + const timeoutMs = Number(process.env.OMNIROUTE_TRANSLATION_TIMEOUT_MS || 60000); + return { apiUrl, apiKey, model, timeoutMs }; +} + +async function callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry = 0) { + const ctrl = new AbortController(); + const timer = setTimeout(() => ctrl.abort(), timeoutMs); + try { + const res = await fetch(`${apiUrl}/chat/completions`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${apiKey}`, + }, + body: JSON.stringify({ + model, + messages, + temperature: 0.15, + stream: false, + }), + signal: ctrl.signal, + }); + if (!res.ok) { + const text = await res.text().catch(() => ""); + const transient = res.status === 408 || res.status === 429 || res.status >= 500; + if (transient && retry < 1) { + const wait = 1500 + retry * 1500; + logWarn(`upstream ${res.status} — retrying after ${wait}ms`); + await new Promise((r) => setTimeout(r, wait)); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw new Error(`upstream ${res.status}: ${text.slice(0, 200)}`); + } + const json = await res.json(); + const content = json?.choices?.[0]?.message?.content; + if (typeof content !== "string" || !content) { + throw new Error("upstream returned empty content"); + } + return content; + } catch (err) { + if (err?.name === "AbortError") { + if (retry < 1) { + logWarn(`timeout after ${timeoutMs}ms — retrying`); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw new Error(`timeout after ${timeoutMs}ms`); + } + if ( + retry < 1 && + err instanceof TypeError && + /fetch failed|ECONN|ENOTFOUND|network/i.test(String(err.cause ?? err.message)) + ) { + logWarn(`network error: ${err.message} — retrying`); + await new Promise((r) => setTimeout(r, 1500)); + return callChat(messages, { apiUrl, apiKey, model, timeoutMs }, retry + 1); + } + throw err; + } finally { + clearTimeout(timer); + } +} + +// Simple promise-based semaphore (avoid runtime deps). +function createLimiter(max) { + let active = 0; + const queue = []; + const next = () => { + if (!queue.length || active >= max) return; + active++; + const { fn, resolve, reject } = queue.shift(); + fn() + .then((v) => { + active--; + resolve(v); + next(); + }) + .catch((err) => { + active--; + reject(err); + next(); + }); + }; + return (fn) => + new Promise((resolve, reject) => { + queue.push({ fn, resolve, reject }); + next(); + }); +} + +const TRANSLATION_SYSTEM = (englishName, native) => + [ + `You are a professional translator for technical software UI strings.`, + `Translate the user's English UI string into ${englishName} (native: ${native}).`, + `Return ONLY the translated string — no quotes, no commentary, no surrounding markdown.`, + `Preserve placeholders such as {name}, {{count}}, %s, %d, and any HTML tags exactly.`, + `Do NOT translate command names (npm/git/curl/etc), code identifiers, URLs, or environment variable names.`, + `Keep the same casing style (Title Case stays Title Case, sentence case stays sentence case).`, + `Keep punctuation and trailing whitespace identical to the source.`, + ].join(" "); + +async function translateString(englishValue, localeEntry, backend) { + const englishName = localeEntry.english ?? localeEntry.name; + const native = localeEntry.native ?? localeEntry.name; + const messages = [ + { role: "system", content: TRANSLATION_SYSTEM(englishName, native) }, + { role: "user", content: englishValue }, + ]; + const out = await callChat(messages, backend); + return out.trim(); +} + +/** + * Walks a merged tree, finding every leaf that starts with PLACEHOLDER_PREFIX + * and replacing it with the translation produced by the backend. + * + * Translations happen with bounded concurrency. On failure, the placeholder + * is preserved so a later run can retry. + */ +async function translatePlaceholders(merged, localeEntry, backend, concurrency) { + const tasks = []; + function collect(node, parent, key) { + if (typeof node === "string") { + if (node.startsWith(PLACEHOLDER_PREFIX)) { + const englishValue = node.slice(PLACEHOLDER_PREFIX.length); + tasks.push({ parent, key, englishValue }); + } + return; + } + if (!isPlainObject(node)) return; + for (const [k, v] of Object.entries(node)) { + collect(v, node, k); + } + } + collect(merged, null, null); + + if (tasks.length === 0) return { translated: 0, failed: 0 }; + + const limit = createLimiter(concurrency); + let translated = 0; + let failed = 0; + await Promise.all( + tasks.map((task) => + limit(async () => { + try { + const value = await translateString(task.englishValue, localeEntry, backend); + task.parent[task.key] = value; + translated++; + } catch (err) { + // Keep the __MISSING__ marker so subsequent runs can retry. + failed++; + logWarn(`translation failed for ${localeEntry.code}: ${err.message}`); + } + }) + ) + ); + return { translated, failed }; +} + +// ----- Main ---------------------------------------------------------------- + +async function processLocale(locale, source, config, opts, backend) { + const localePath = path.join(MESSAGES_DIR, `${locale}.json`); + let target = {}; + if (existsSync(localePath)) { + try { + target = await loadJson(localePath); + } catch (err) { + logWarn(`${locale}: failed to parse existing JSON — starting fresh (${err.message})`); + target = {}; + } + } else { + logWarn(`${locale}: messages file did not exist — creating it`); + } + + const { merged, addedPaths } = mergeMissing(source, target); + const placeholderCountBefore = countPlaceholders(merged); + + let translateStats = { translated: 0, failed: 0 }; + if (opts.translateMarkers && placeholderCountBefore > 0 && backend) { + const localeEntry = config.locales.find((l) => l.code === locale); + if (!localeEntry) { + logWarn(`${locale}: not present in config/i18n.json — skipping translation`); + } else { + const concurrency = + opts.concurrency ?? Number(process.env.OMNIROUTE_TRANSLATION_CONCURRENCY || 4); + translateStats = await translatePlaceholders(merged, localeEntry, backend, concurrency); + } + } + + const placeholderCountAfter = countPlaceholders(merged); + const totalMissing = addedPaths.length; + const stillPlaceholder = placeholderCountAfter; + + const summary = `${locale}: +${totalMissing} missing keys (${stillPlaceholder} __MISSING__, ${translateStats.translated} translated${translateStats.failed ? `, ${translateStats.failed} failed` : ""})`; + + if (opts.dryRun) { + logInfo(`[DRY] ${summary}`); + return { addedPaths, translated: translateStats.translated }; + } + + // Only write when something changed. (json-stable serialization) + const before = existsSync(localePath) ? await fs.readFile(localePath, "utf8") : ""; + const after = JSON.stringify(merged, null, 2) + "\n"; + if (before === after) { + logInfo(`${locale}: already in sync (no changes)`); + return { addedPaths, translated: translateStats.translated }; + } + await fs.writeFile(localePath, after, "utf8"); + logInfo(summary); + return { addedPaths, translated: translateStats.translated }; +} + +async function main() { + const opts = parseArgs(process.argv); + const config = await loadConfig(); + + const sourcePath = path.join(MESSAGES_DIR, `${SOURCE_LOCALE}.json`); + if (!existsSync(sourcePath)) { + throw new Error(`Source messages file not found: ${sourcePath}`); + } + const source = await loadJson(sourcePath); + + // Locales = every code in config except `en`, intersected with locales that + // already exist on disk (so we never silently create unknown locale files). + const onDisk = new Set( + (await fs.readdir(MESSAGES_DIR)).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)) + ); + + let targetLocales = config.locales + .map((l) => l.code) + .filter((code) => code !== SOURCE_LOCALE && onDisk.has(code)); + + if (opts.locales) { + const missingFromConfig = opts.locales.filter((c) => !config.locales.some((l) => l.code === c)); + if (missingFromConfig.length) { + logWarn(`--locale contains codes not in config/i18n.json: ${missingFromConfig.join(", ")}`); + } + targetLocales = targetLocales.filter((code) => opts.locales.includes(code)); + } + + logInfo(`source: ${path.relative(ROOT, sourcePath)}`); + logInfo(`locales: ${targetLocales.length} (${targetLocales.join(", ")})`); + logInfo( + `dry-run: ${opts.dryRun ? "yes" : "no"}, translate-markers: ${opts.translateMarkers ? "yes" : "no"}` + ); + + let backend = null; + if (opts.translateMarkers && !opts.dryRun) { + backend = backendConfig(); + backend.concurrency = + opts.concurrency ?? Number(process.env.OMNIROUTE_TRANSLATION_CONCURRENCY || 4); + logInfo( + `backend: ${backend.apiUrl} (model=${backend.model}, concurrency=${backend.concurrency}, timeout=${backend.timeoutMs}ms)` + ); + } + + const startMs = Date.now(); + let totalAdded = 0; + let totalTranslated = 0; + for (const locale of targetLocales) { + const result = await processLocale(locale, source, config, opts, backend); + totalAdded += result.addedPaths.length; + totalTranslated += result.translated; + } + const elapsedSec = ((Date.now() - startMs) / 1000).toFixed(1); + logInfo( + `summary: locales=${targetLocales.length}, added=${totalAdded}, translated=${totalTranslated}, elapsed=${elapsedSec}s` + ); +} + +const isDirectRun = import.meta.url === pathToFileURL(process.argv[1]).href; +if (isDirectRun) { + main().catch((err) => { + logError(err?.stack || err?.message || String(err)); + process.exit(1); + }); +} diff --git a/scripts/validate_translation.py b/scripts/i18n/validate_translation.py similarity index 99% rename from scripts/validate_translation.py rename to scripts/i18n/validate_translation.py index 087879fc00..5c1f236124 100755 --- a/scripts/validate_translation.py +++ b/scripts/i18n/validate_translation.py @@ -30,8 +30,10 @@ NC = "\033[0m" # Configuration - find repo root relative to this script _script_dir = Path(__file__).parent.resolve() -# If script is in scripts/ subfolder, go up one level to repo root -if _script_dir.name == "scripts": +# Walk up out of scripts/<group>/, scripts/, or stay at cwd +if _script_dir.name == "i18n" and _script_dir.parent.name == "scripts": + SCRIPT_DIR = _script_dir.parent.parent +elif _script_dir.name == "scripts": SCRIPT_DIR = _script_dir.parent else: SCRIPT_DIR = _script_dir diff --git a/scripts/scratch.mjs b/scripts/scratch.mjs deleted file mode 100644 index 274e16520e..0000000000 --- a/scripts/scratch.mjs +++ /dev/null @@ -1,12 +0,0 @@ -import { test } from "node:test"; -import assert from "node:assert"; -import { providerNodesValidateRoute } from "./src/app/api/provider-nodes/validate/route.js"; - -const req = new Request("http://localhost/api/provider-nodes/validate", { - method: "POST", - headers: { "Content-Type": "application/json" }, - body: JSON.stringify({ baseUrl: "", apiKey: "" }), -}); -const res = await providerNodesValidateRoute.POST(req); -const data = await res.json(); -console.dir(data, { depth: null }); diff --git a/scripts/scratch/categorize_ideas.py b/scripts/scratch/categorize_ideas.py deleted file mode 100644 index 943939d630..0000000000 --- a/scripts/scratch/categorize_ideas.py +++ /dev/null @@ -1,39 +0,0 @@ -import os -import shutil -import subprocess - -categories = { - "viable": [1718, 1731, 1764], - "need_details": [1765, 1679, 1594, 1584], - "defer": [1845, 1833, 1814, 1786, 1737, 1736, 1735, 1716, 1591, 1590, 1589, 1588, 1587], - "notfit": [1826, 1788, 1529, 1586] # 1586 is already exists, goes to notfit -} - -# Create dirs -os.makedirs("_ideia/viable/need_details", exist_ok=True) -os.makedirs("_ideia/defer", exist_ok=True) -os.makedirs("_ideia/notfit", exist_ok=True) - -files = os.listdir("_ideia") - -for f in files: - if not f.endswith(".md"): continue - num_str = f.split('-')[0] - if not num_str.isdigit(): continue - num = int(num_str) - - src = os.path.join("_ideia", f) - - if num in categories["viable"]: - dst = os.path.join("_ideia/viable", f) - elif num in categories["need_details"]: - dst = os.path.join("_ideia/viable/need_details", f) - elif num in categories["defer"]: - dst = os.path.join("_ideia/defer", f) - elif num in categories["notfit"]: - dst = os.path.join("_ideia/notfit", f) - else: - continue - - shutil.move(src, dst) - print(f"Moved {f} to {dst}") diff --git a/scripts/scratch/check_usage.js b/scripts/scratch/check_usage.js deleted file mode 100644 index 15e6cab603..0000000000 --- a/scripts/scratch/check_usage.js +++ /dev/null @@ -1,34 +0,0 @@ -import Database from 'better-sqlite3'; -import path from 'path'; -import os from 'os'; - -const SQLITE_FILE = path.join(process.cwd(), 'data', 'storage.sqlite'); - -console.log('Checking database at:', SQLITE_FILE); - -const db = new Database(SQLITE_FILE, { readonly: true }); - -try { - const rows = db.prepare(` - SELECT api_key_id, api_key_name, COUNT(*) as count, MAX(timestamp) as last_used - FROM usage_history - GROUP BY api_key_id, api_key_name - ORDER BY count DESC - `).all(); - - console.log('Top Usage Entries:'); - console.table(rows); - - const keys = db.prepare(` - SELECT id, name, key_prefix, machine_id - FROM api_keys - `).all(); - - console.log('All API Keys:'); - console.table(keys); - -} catch (err) { - console.error('Error:', err.message); -} finally { - db.close(); -} diff --git a/scripts/scratch/debug-handles.mjs b/scripts/scratch/debug-handles.mjs deleted file mode 100644 index 3f224f6b1a..0000000000 --- a/scripts/scratch/debug-handles.mjs +++ /dev/null @@ -1,17 +0,0 @@ -import process from "node:process"; -import fs from "node:fs"; - -setTimeout(() => { - const activeHandles = process._getActiveHandles(); - console.log("ACTIVE HANDLES: " + activeHandles.length); - activeHandles.forEach((handle, i) => { - console.log(`Handle ${i}:`, handle?.constructor?.name); - // if it's a timer or socket, let's see more - if (handle?.constructor?.name === "Timeout") { - console.log(" Timer wrapper:", handle?._onTimeout?.toString().slice(0, 50)); - } - }); - process.exit(1); -}, 2000); - -await import("./tests/integration/chat-pipeline.test.mjs"); diff --git a/scripts/scratch/debug-sockets.mjs b/scripts/scratch/debug-sockets.mjs deleted file mode 100644 index 345213ebb5..0000000000 --- a/scripts/scratch/debug-sockets.mjs +++ /dev/null @@ -1,14 +0,0 @@ -import process from "node:process"; -import("./tests/integration/chat-pipeline.test.mjs").then((mod) => { - setTimeout(() => { - const activeHandles = process._getActiveHandles(); - console.log("ACTIVE HANDLES: " + activeHandles.length); - activeHandles.forEach((handle, i) => { - console.log(`Handle ${i}:`, handle?.constructor?.name); - if (handle?.constructor?.name === "Socket") { - console.log("Socket ports:", handle?.localPort, handle?.remotePort); - } - }); - process.exit(1); - }, 15000); -}); diff --git a/scripts/scratch/delete_iflow.cjs b/scripts/scratch/delete_iflow.cjs deleted file mode 100644 index 2d80bbf4db..0000000000 --- a/scripts/scratch/delete_iflow.cjs +++ /dev/null @@ -1,7 +0,0 @@ -const Database = require('better-sqlite3'); -const db = new Database(process.env.HOME + '/.omniroute/storage.sqlite'); - -console.log("Deleting iflow connections..."); -const stmt = db.prepare("DELETE FROM provider_connections WHERE provider = 'iflow'"); -const info = stmt.run(); -console.log(`Deleted ${info.changes} rows.`); diff --git a/scripts/scratch/dump-auth-groups.ts b/scripts/scratch/dump-auth-groups.ts deleted file mode 100644 index f598461d4f..0000000000 --- a/scripts/scratch/dump-auth-groups.ts +++ /dev/null @@ -1,23 +0,0 @@ -import { - APIKEY_PROVIDERS, - SEARCH_PROVIDERS, - AUDIO_ONLY_PROVIDERS, - WEB_COOKIE_PROVIDERS, -} from "./src/shared/constants/providers"; - -console.log("SEARCH_PROVIDERS", !!SEARCH_PROVIDERS, Object.keys(SEARCH_PROVIDERS || {})); -console.log("AUDIO_ONLY", !!AUDIO_ONLY_PROVIDERS); -console.log("WEB_COOKIE", !!WEB_COOKIE_PROVIDERS); - -// Determine auth type group for a provider id -function getAuthGroup(providerId: string) { - if (WEB_COOKIE_PROVIDERS && WEB_COOKIE_PROVIDERS[providerId]) return "web-cookie"; - if (SEARCH_PROVIDERS && SEARCH_PROVIDERS[providerId]) return "search"; - if (AUDIO_ONLY_PROVIDERS && AUDIO_ONLY_PROVIDERS[providerId]) return "audio"; - if (APIKEY_PROVIDERS && APIKEY_PROVIDERS[providerId]) return "apikey"; - return "apikey"; -} - -console.log("grok-web returns:", getAuthGroup("grok-web")); -console.log("perplexity-search returns:", getAuthGroup("perplexity-search")); -console.log("openai returns:", getAuthGroup("openai")); diff --git a/scripts/scratch/fix-tests.js b/scripts/scratch/fix-tests.js deleted file mode 100644 index f6ac99e1ff..0000000000 --- a/scripts/scratch/fix-tests.js +++ /dev/null @@ -1,30 +0,0 @@ -const fs = require("fs"); - -function addAnyCast(filePath) { - let content = fs.readFileSync(filePath, "utf8"); - // Match "const varname = await func({...});" and make it "const varname: any = await func({...});" - content = content.replace( - /(const\s+\w+)\s*=\s*(await\s+(?:usageService|usageFetcher)\.getUsageForProvider\()/g, - "$1: any = $2" - ); - fs.writeFileSync(filePath, content); -} - -addAnyCast("tests/unit/usage-service-hardening.test.ts"); -addAnyCast("tests/unit/usage-fetcher-antigravity.test.ts"); - -let bailian = fs.readFileSync("tests/unit/bailian-quota-fetcher.test.ts", "utf8"); -// Fix missing window properties in test typing -bailian = bailian.replace(/const quota = /g, "const quota: any = "); -fs.writeFileSync("tests/unit/bailian-quota-fetcher.test.ts", bailian); - -let routeTest = fs.readFileSync("tests/unit/token-refresh-route-service.test.ts", "utf8"); -// Fix provider mocks typing -routeTest = routeTest.replace(/github: \{/g, '"github": {'); // Fix github -routeTest = routeTest.replace( - /(refreshWithRetry|log\.entries).*?(toBe|equal).*?;/g, - (match) => match -); // just ignore -fs.writeFileSync("tests/unit/token-refresh-route-service.test.ts", routeTest); - -console.log("Fixes applied."); diff --git a/scripts/scratch/fix-types.mjs b/scripts/scratch/fix-types.mjs deleted file mode 100644 index 2001c2b810..0000000000 --- a/scripts/scratch/fix-types.mjs +++ /dev/null @@ -1,52 +0,0 @@ -import fs from "fs"; - -let content = fs.readFileSync("tests/unit/token-refresh-service.test.ts", "utf-8"); - -// Fix jsonResponse -content = content.replace( - /function jsonResponse\(body, status = 200\)/g, - "function jsonResponse(body: any, status = 200)" -); - -// Fix textResponse -content = content.replace( - /function textResponse\(text, status = 400\)/g, - "function textResponse(text: any, status = 400)" -); - -// Fix calls = [] -content = content.replace(/const calls = \[\];/g, "const calls: any[] = [];"); - -// Fix result is possibly null -content = content.replace(/result\.accessToken/g, "result?.accessToken"); -content = content.replace(/result\.refreshToken/g, "result?.refreshToken"); -content = content.replace(/result\.expiresIn/g, "result?.expiresIn"); - -fs.writeFileSync("tests/unit/token-refresh-service.test.ts", content); - -let claudeContent = fs.readFileSync("tests/unit/translator-claude-to-gemini.test.ts", "utf-8"); -claudeContent = claudeContent.replace(/result\.tools/g, "(result as any).tools"); -claudeContent = claudeContent.replace(/result\._toolNameMap/g, "(result as any)._toolNameMap"); -claudeContent = claudeContent.replace(/result\[0\]/g, "(result as any)[0]"); -fs.writeFileSync("tests/unit/translator-claude-to-gemini.test.ts", claudeContent); - -let openaiContent = fs.readFileSync("tests/unit/translator-openai-to-gemini.test.ts", "utf-8"); -openaiContent = openaiContent.replace( - /result\.systemInstruction/g, - "(result as any).systemInstruction" -); -openaiContent = openaiContent.replace(/result\.tools/g, "(result as any).tools"); -openaiContent = openaiContent.replace( - /result\.generationConfig/g, - "(result as any).generationConfig" -); -openaiContent = openaiContent.replace(/result\._toolNameMap/g, "(result as any)._toolNameMap"); -openaiContent = openaiContent.replace( - /result\.request\.systemInstruction/g, - "(result as any).request?.systemInstruction" -); -openaiContent = openaiContent.replace(/result\.request\.tools/g, "(result as any).request?.tools"); -openaiContent = openaiContent.replace(/null\)/g, "null as any)"); -fs.writeFileSync("tests/unit/translator-openai-to-gemini.test.ts", openaiContent); - -console.log("Fixed typings"); diff --git a/scripts/scratch/fix_route.ts b/scripts/scratch/fix_route.ts deleted file mode 100644 index 186ae89e1d..0000000000 --- a/scripts/scratch/fix_route.ts +++ /dev/null @@ -1,708 +0,0 @@ -import fs from "fs"; - -const content = fs.readFileSync("src/app/api/usage/analytics/route.ts", "utf8"); - -// We'll replace the GET function entirely -const getFnStart = content.indexOf("export async function GET(request: Request) {"); -const beforeGet = content.slice(0, getFnStart); - -const newGetFn = `export async function GET(request: Request) { - try { - const { searchParams } = new URL(request.url); - const range = searchParams.get("range") || "30d"; - const startDate = searchParams.get("startDate") || undefined; - const endDate = searchParams.get("endDate") || undefined; - const apiKeyIdsParam = searchParams.get("apiKeyIds") || ""; - const apiKeyIds = apiKeyIdsParam ? apiKeyIdsParam.split(",").filter(Boolean) : []; - - const sinceIso = startDate || getRangeStartIso(range); - const untilIso = endDate || null; - const presetsParam = searchParams.get("presets"); - - const db = getDbInstance(); - - // ── Enrich entries with missing apiKeyName ────────────────────────── - try { - // Only run enrichment if there are actually NULL entries - const hasNull = db.prepare("SELECT 1 FROM usage_history WHERE (api_key_name IS NULL OR api_key_name = '') AND connection_id IS NOT NULL LIMIT 1").get(); - if (hasNull) { - // Step 1: dominant key per connectionId from existing usage data - db.prepare(\` - UPDATE usage_history - SET - api_key_name = ( - SELECT uh2.api_key_name - FROM usage_history AS uh2 - WHERE uh2.connection_id = usage_history.connection_id - AND uh2.api_key_name IS NOT NULL AND uh2.api_key_name != '' - GROUP BY uh2.api_key_name - ORDER BY COUNT(*) DESC - LIMIT 1 - ), - api_key_id = COALESCE(api_key_id, ( - SELECT uh2.api_key_id - FROM usage_history AS uh2 - WHERE uh2.connection_id = usage_history.connection_id - AND uh2.api_key_name IS NOT NULL AND uh2.api_key_name != '' - GROUP BY uh2.api_key_name - ORDER BY COUNT(*) DESC - LIMIT 1 - )) - WHERE (api_key_name IS NULL OR api_key_name = '') - AND connection_id IS NOT NULL - AND EXISTS ( - SELECT 1 FROM usage_history AS uh3 - WHERE uh3.connection_id = usage_history.connection_id - AND uh3.api_key_name IS NOT NULL AND uh3.api_key_name != '' - ) - \`).run(); - - // Step 2 & 3: For still unresolved connections, check apiKeys config - const stillNull = db.prepare("SELECT DISTINCT connection_id FROM usage_history WHERE (api_key_name IS NULL OR api_key_name = '') AND connection_id IS NOT NULL").all(); - if (stillNull.length > 0) { - const { getApiKeys } = await import("@/lib/localDb"); - const apiKeys = (await getApiKeys()) as any[]; - - const updateStmt = db.prepare("UPDATE usage_history SET api_key_name = ?, api_key_id = ? WHERE connection_id = ? AND (api_key_name IS NULL OR api_key_name = '')"); - const updateMany = db.transaction((updates: any[]) => { - for (const u of updates) updateStmt.run(u.name, u.id, u.cid); - }); - - const updates = []; - const orphanIds = new Set(stillNull.map((r: any) => r.connection_id)); - - for (const ak of apiKeys) { - const allowed = Array.isArray(ak.allowedConnections) ? ak.allowedConnections : []; - const keyName = ak.name || ak.id; - const keyId = ak.id || null; - for (const cid of allowed) { - if (typeof cid === "string" && orphanIds.has(cid)) { - updates.push({ name: keyName, id: keyId, cid }); - orphanIds.delete(cid); - } - } - } - - if (orphanIds.size > 0) { - const unrestrictedKeys = apiKeys.filter( - (ak: any) => !Array.isArray(ak.allowedConnections) || ak.allowedConnections.length === 0 - ); - if (unrestrictedKeys.length > 0) { - let bestKey = unrestrictedKeys[0]; - let bestCount = -1; - for (const uk of unrestrictedKeys) { - const countRow = db.prepare("SELECT COUNT(*) as c FROM usage_history WHERE api_key_name = ?").get(uk.name || uk.id) as any; - if (countRow.c > bestCount) { bestCount = countRow.c; bestKey = uk; } - } - const fallbackName = bestKey.name || bestKey.id; - const fallbackId = bestKey.id || null; - for (const cid of orphanIds) { - updates.push({ name: fallbackName, id: fallbackId, cid }); - } - } - } - - if (updates.length > 0) updateMany(updates); - } - } - } catch(e) { - console.error("Failed to backfill missing api_key_name:", e); - } - - const conditions = []; - const params: Record<string, string> = {}; - - if (sinceIso) { - conditions.push("timestamp >= @since"); - params.since = sinceIso; - } - if (untilIso) { - conditions.push("timestamp <= @until"); - params.until = untilIso; - } - - let apiKeyWhere = ""; - if (apiKeyIds.length > 0) { - const placeholders = apiKeyIds.map((_, i) => \`@apiKey\${i}\`); - apiKeyIds.forEach((key, i) => { - params[\`apiKey\${i}\`] = key; - }); - apiKeyWhere = \`(api_key_name IN (\${placeholders.join(",")}) OR api_key_id IN (\${placeholders.join(",")}))\`; - conditions.push(apiKeyWhere); - } - - const whereClause = conditions.length > 0 ? \`WHERE \${conditions.join(" AND ")}\` : ""; - - // Fetch pricing data for cost calculation (no rows loaded) - const { getPricing } = await import("@/lib/db/settings"); - const pricingByProvider = (await getPricing()) as PricingByProvider; - const { computeCostFromPricing, normalizeModelName } = - await import("@/lib/usage/costCalculator"); - - const summaryRow = db - .prepare( - \` - SELECT - COUNT(*) as totalRequests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens, - COUNT(DISTINCT model) as uniqueModels, - COUNT(DISTINCT connection_id) as uniqueAccounts, - COUNT(DISTINCT api_key_id) as uniqueApiKeys, - COALESCE(SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END), 0) as successfulRequests, - COALESCE(AVG(latency_ms), 0) as avgLatencyMs, - COALESCE(MIN(timestamp), '') as firstRequest, - COALESCE(MAX(timestamp), '') as lastRequest - FROM usage_history - \${whereClause} - \` - ) - .get(params) as Record<string, unknown>; - - const dailyRows = db - .prepare( - \` - SELECT - DATE(timestamp) as date, - COUNT(*) as requests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens - FROM usage_history - \${whereClause} - GROUP BY DATE(timestamp) - ORDER BY date ASC - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const dailyCostRows = db - .prepare( - \` - SELECT - DATE(timestamp) as date, - provider, - model, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens - FROM usage_history - \${whereClause} - GROUP BY DATE(timestamp), provider, model - ORDER BY date ASC - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const heatmapStart = new Date(); - heatmapStart.setUTCDate(heatmapStart.getUTCDate() - 364); - // Custom date range might need a wider heatmap window - if (startDate) { - const customStart = new Date(startDate); - if (customStart.getTime() < heatmapStart.getTime()) { - heatmapStart.setTime(customStart.getTime()); - } - } - - // Heatmap needs its own whereClause if api keys are filtered - const heatmapConditions = ["timestamp >= @heatmapStart"]; - if (apiKeyWhere) heatmapConditions.push(apiKeyWhere); - const heatmapParams: Record<string, string> = { heatmapStart: heatmapStart.toISOString() }; - if (apiKeyIds.length > 0) { - apiKeyIds.forEach((key, i) => { heatmapParams[\`apiKey\${i}\`] = key; }); - } - - const heatmapRows = db - .prepare( - \` - SELECT - DATE(timestamp) as date, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens - FROM usage_history - WHERE \${heatmapConditions.join(" AND ")} - GROUP BY DATE(timestamp) - ORDER BY date ASC - \` - ) - .all(heatmapParams) as Array<Record<string, unknown>>; - - const modelRows = db - .prepare( - \` - SELECT - model, - provider, - COUNT(*) as requests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens, - COALESCE(AVG(latency_ms), 0) as avgLatencyMs, - COALESCE(SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END), 0) as successfulRequests, - COALESCE(MAX(timestamp), '') as lastUsed - FROM usage_history - \${whereClause} - GROUP BY model, provider - ORDER BY requests DESC - LIMIT 50 - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const providerCostRows = db - .prepare( - \` - SELECT - provider, - model, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens - FROM usage_history - \${whereClause} - GROUP BY provider, model - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const providerRows = db - .prepare( - \` - SELECT - provider, - COUNT(*) as requests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens, - COALESCE(AVG(latency_ms), 0) as avgLatencyMs, - COALESCE(SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END), 0) as successfulRequests - FROM usage_history - \${whereClause} - GROUP BY provider - ORDER BY requests DESC - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const accountCostRows = db - .prepare( - \` - SELECT - connection_id as account, - provider, - model, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens - FROM usage_history - \${whereClause} - GROUP BY connection_id, provider, model - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const accountRows = db - .prepare( - \` - SELECT - connection_id as account, - COUNT(*) as requests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens, - COALESCE(AVG(latency_ms), 0) as avgLatencyMs, - COALESCE(MAX(timestamp), '') as lastUsed - FROM usage_history - \${whereClause} - GROUP BY connection_id - ORDER BY requests DESC - LIMIT 50 - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const apiKeyWhereClause = appendWhereCondition( - whereClause, - "(api_key_id IS NOT NULL AND api_key_id != '') OR (api_key_name IS NOT NULL AND api_key_name != '')" - ); - const apiKeyRows = db - .prepare( - \` - SELECT - api_key_id as apiKeyId, - COALESCE(NULLIF(api_key_name, ''), NULLIF(api_key_id, ''), 'Unknown API key') as apiKeyName, - provider, - model, - COUNT(*) as requests, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens - FROM usage_history - \${apiKeyWhereClause} - GROUP BY api_key_id, api_key_name, provider, model - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const weeklyRows = db - .prepare( - \` - SELECT - dayOfWeek, - COUNT(*) as days, - COALESCE(SUM(requests), 0) as requests, - COALESCE(SUM(totalTokens), 0) as totalTokens - FROM ( - SELECT - DATE(timestamp) as date, - strftime('%w', timestamp) as dayOfWeek, - COUNT(*) as requests, - COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens - FROM usage_history - \${whereClause} - GROUP BY DATE(timestamp), strftime('%w', timestamp) - ) - GROUP BY dayOfWeek - ORDER BY dayOfWeek ASC - \` - ) - .all(params) as Array<Record<string, unknown>>; - - const fallbackRow = db - .prepare( - \` - SELECT - COUNT(*) as total, - SUM(CASE WHEN requested_model IS NOT NULL AND requested_model != '' THEN 1 ELSE 0 END) as with_requested, - SUM(CASE - WHEN requested_model IS NOT NULL - AND requested_model != '' - AND model IS NOT NULL - AND requested_model != model - THEN 1 ELSE 0 END - ) as fallbacks - FROM call_logs - \${whereClause} - \` - ) - .get(params) as Record<string, unknown>; - - const summary = { - totalRequests: Number(summaryRow?.totalRequests || 0), - promptTokens: Number(summaryRow?.promptTokens || 0), - completionTokens: Number(summaryRow?.completionTokens || 0), - totalTokens: Number(summaryRow?.totalTokens || 0), - uniqueModels: Number(summaryRow?.uniqueModels || 0), - uniqueAccounts: Number(summaryRow?.uniqueAccounts || 0), - uniqueApiKeys: Number(summaryRow?.uniqueApiKeys || 0), - successfulRequests: Number(summaryRow?.successfulRequests || 0), - successRatePct: - Number(summaryRow?.totalRequests || 0) > 0 - ? Number( - ( - (Number(summaryRow?.successfulRequests || 0) / - Number(summaryRow?.totalRequests || 1)) * - 100 - ).toFixed(2) - ) - : 0, - avgLatencyMs: Math.round(Number(summaryRow?.avgLatencyMs || 0)), - totalCost: 0, - firstRequest: summaryRow?.firstRequest || "", - lastRequest: summaryRow?.lastRequest || "", - fallbackCount: Number(fallbackRow?.fallbacks || 0), - fallbackRatePct: - Number(fallbackRow?.with_requested || 0) > 0 - ? Number( - ( - (Number(fallbackRow?.fallbacks || 0) / Number(fallbackRow?.with_requested || 1)) * - 100 - ).toFixed(2) - ) - : 0, - requestedModelCoveragePct: - Number(fallbackRow?.total || 0) > 0 - ? Number( - ( - (Number(fallbackRow?.with_requested || 0) / Number(fallbackRow?.total || 1)) * - 100 - ).toFixed(2) - ) - : 0, - streak: 0, - }; - - const dailyCostByDate = new Map<string, number>(); - for (const row of dailyCostRows) { - const date = toStringValue(row.date); - if (!date) continue; - const cost = computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - dailyCostByDate.set(date, (dailyCostByDate.get(date) || 0) + cost); - } - - const dailyTrend = dailyRows.map((row) => ({ - date: row.date, - requests: Number(row.requests), - promptTokens: Number(row.promptTokens), - completionTokens: Number(row.completionTokens), - totalTokens: Number(row.totalTokens), - cost: roundCost(dailyCostByDate.get(toStringValue(row.date)) || 0), - })); - - const activityMap: Record<string, number> = {}; - for (const row of heatmapRows) { - activityMap[row.date as string] = Number(row.totalTokens); - } - summary.streak = computeActivityStreak(activityMap); - - const byModel = modelRows.map((row) => { - const model = row.model as string; - const provider = row.provider as string; - const short = shortModelName(model); - const tokens = { - input: Number(row.promptTokens) || 0, - output: Number(row.completionTokens) || 0, - }; - const cost = computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - return { - model: short, - provider, - rawModel: model, - requests: Number(row.requests), - promptTokens: tokens.input, - completionTokens: tokens.output, - totalTokens: Number(row.totalTokens), - avgLatencyMs: Math.round(Number(row.avgLatencyMs)), - successRatePct: - Number(row.requests) > 0 - ? Number((Number(row.successfulRequests) / Number(row.requests)) * 100).toFixed(2) - : 0, - lastUsed: row.lastUsed, - cost: roundCost(cost), - }; - }); - - const totalCost = Array.from(dailyCostByDate.values()).reduce((sum, cost) => sum + cost, 0); - summary.totalCost = roundCost(totalCost); - - const providerCostByProvider = new Map<string, number>(); - for (const row of providerCostRows) { - const provider = toStringValue(row.provider); - if (!provider) continue; - const cost = computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - providerCostByProvider.set(provider, (providerCostByProvider.get(provider) || 0) + cost); - } - - const byProvider = providerRows.map((row) => ({ - provider: row.provider, - requests: Number(row.requests), - promptTokens: Number(row.promptTokens), - completionTokens: Number(row.completionTokens), - totalTokens: Number(row.totalTokens), - avgLatencyMs: Math.round(Number(row.avgLatencyMs)), - successRatePct: - Number(row.requests) > 0 - ? Number((Number(row.successfulRequests) / Number(row.requests)) * 100).toFixed(2) - : 0, - cost: roundCost(providerCostByProvider.get(toStringValue(row.provider)) || 0), - })); - - const accountCostByAccount = new Map<string, number>(); - for (const row of accountCostRows) { - const account = toStringValue(row.account, "unknown"); - const cost = computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - accountCostByAccount.set(account, (accountCostByAccount.get(account) || 0) + cost); - } - - const byAccount = accountRows.map((row) => ({ - account: toStringValue(row.account, "unknown"), - requests: Number(row.requests), - promptTokens: Number(row.promptTokens), - completionTokens: Number(row.completionTokens), - totalTokens: Number(row.totalTokens), - avgLatencyMs: Math.round(Number(row.avgLatencyMs)), - lastUsed: row.lastUsed, - cost: roundCost(accountCostByAccount.get(toStringValue(row.account, "unknown")) || 0), - })); - - const apiKeyMap = new Map< - string, - { - apiKey: string; - apiKeyId: string | null; - apiKeyName: string; - requests: number; - promptTokens: number; - completionTokens: number; - totalTokens: number; - cost: number; - } - >(); - for (const row of apiKeyRows) { - const apiKeyId = toStringValue(row.apiKeyId); - const apiKeyName = toStringValue(row.apiKeyName, apiKeyId || "Unknown API key"); - const key = \`\${apiKeyId || "unknown"}::\${apiKeyName}\`; - const existing = apiKeyMap.get(key) || { - apiKey: apiKeyId && apiKeyName !== apiKeyId ? \`\${apiKeyName} (\${apiKeyId})\` : apiKeyName, - apiKeyId: apiKeyId || null, - apiKeyName, - requests: 0, - promptTokens: 0, - completionTokens: 0, - totalTokens: 0, - cost: 0, - }; - - existing.requests += Number(row.requests); - existing.promptTokens += Number(row.promptTokens); - existing.completionTokens += Number(row.completionTokens); - existing.totalTokens += Number(row.totalTokens); - existing.cost += computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - apiKeyMap.set(key, existing); - } - const byApiKey = Array.from(apiKeyMap.values()) - .map((row) => ({ ...row, cost: roundCost(row.cost) })) - .sort((left, right) => right.cost - left.cost); - - const weeklyTokens = [0, 0, 0, 0, 0, 0, 0]; - const weeklyCounts = [0, 0, 0, 0, 0, 0, 0]; - const weeklyPattern = WEEKDAY_LABELS.map((day) => ({ - day, - avgTokens: 0, - totalTokens: 0, - })); - for (const row of weeklyRows) { - const dayIdx = Number(row.dayOfWeek); - if (dayIdx >= 0 && dayIdx <= 6) { - const totalTokens = Number(row.totalTokens); - const days = Number(row.days); - weeklyTokens[dayIdx] = totalTokens; - weeklyCounts[dayIdx] = Number(row.requests); - weeklyPattern[dayIdx] = { - day: WEEKDAY_LABELS[dayIdx], - avgTokens: days > 0 ? Math.round(totalTokens / days) : 0, - totalTokens, - }; - } - } - - const analytics = { - summary, - dailyTrend, - activityMap, - byModel, - byProvider, - byApiKey, - byAccount, - weeklyPattern, - weeklyTokens, - weeklyCounts, - range, - } as any; - - if (presetsParam) { - const allowedRanges = new Set(["1d", "7d", "30d", "90d", "ytd", "all"]); - const presetRanges = presetsParam - .split(",") - .map((preset) => preset.trim()) - .filter((preset) => allowedRanges.has(preset)); - const presetSummaries: Record<string, { totalCost: number }> = {}; - - for (const presetRange of presetRanges) { - if (presetRange === range) { - presetSummaries[presetRange] = { - totalCost: Number(analytics.summary?.totalCost || 0), - }; - continue; - } - - const presetSinceIso = getRangeStartIso(presetRange); - const presetConditions = []; - const presetParams: Record<string, string> = {}; - if (presetSinceIso) { presetConditions.push("timestamp >= @presetSince"); presetParams.presetSince = presetSinceIso; } - if (apiKeyWhere) { presetConditions.push(apiKeyWhere); Object.assign(presetParams, params); } - - const presetWhere = presetConditions.length > 0 ? \`WHERE \${presetConditions.join(" AND ")}\` : ""; - - const presetModelRows = db - .prepare( - \` - SELECT - model, - provider, - COALESCE(SUM(tokens_input), 0) as promptTokens, - COALESCE(SUM(tokens_output), 0) as completionTokens, - COALESCE(SUM(tokens_cache_read), 0) as cacheReadTokens, - COALESCE(SUM(tokens_cache_creation), 0) as cacheCreationTokens, - COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens - FROM usage_history - \${presetWhere} - GROUP BY model, provider - \` - ) - .all(presetParams) as Array<Record<string, unknown>>; - - let presetTotalCost = 0; - for (const row of presetModelRows) { - presetTotalCost += computeUsageRowCost( - row, - pricingByProvider, - normalizeModelName, - computeCostFromPricing - ); - } - - presetSummaries[presetRange] = { - totalCost: roundCost(presetTotalCost), - }; - } - - analytics.presetSummaries = presetSummaries; - } - - return NextResponse.json(analytics); - } catch (error) { - console.error("Error computing analytics:", error); - return NextResponse.json({ error: "Failed to compute analytics" }, { status: 500 }); - } -} -`; - -fs.writeFileSync("src/app/api/usage/analytics/route.ts", beforeGet + newGetFn, "utf8"); diff --git a/scripts/scratch/harvest_issues.py b/scripts/scratch/harvest_issues.py deleted file mode 100644 index 649e75f511..0000000000 --- a/scripts/scratch/harvest_issues.py +++ /dev/null @@ -1,96 +0,0 @@ -import json -import os -import subprocess -import re - -issues = [1845, 1833, 1826, 1814, 1788, 1786, 1765, 1764, 1737, 1736, 1735, 1731, 1718, 1716, 1679, 1594, 1591, 1590, 1589, 1588, 1587, 1586, 1584, 1529] - -os.makedirs('_ideia', exist_ok=True) - -def slugify(value): - value = re.sub(r'\[Feature\]', '', value, flags=re.IGNORECASE) - value = re.sub(r'[^\w\s-]', '', value).strip().lower() - return re.sub(r'[-\s]+', '-', value) - -for num in issues: - print(f"Processing #{num}...") - try: - res = subprocess.run( - ['gh', 'issue', 'view', str(num), '--repo', 'diegosouzapw/OmniRoute', '--json', 'number,title,labels,body,comments,createdAt,author,assignees'], - capture_output=True, text=True, check=True - ) - data = json.loads(res.stdout) - - slug = slugify(data['title']) - filename = f"_ideia/{data['number']}-{slug}.md" - - author = data['author']['login'] - created_at = data['createdAt'] - body = data['body'] - comments = data['comments'] - - participants = set([author]) - comments_str = "" - if comments: - for c in comments: - c_author = c['author']['login'] - participants.add(c_author) - comments_str += f"**@{c_author}** ({c['createdAt']}):\n{c['body']}\n---\n" - else: - comments_str = "*No comments.*" - - participants_list = "\n".join([f"- @{p}" for p in participants]) - - content = f"""# Feature: {data['title']} - -> GitHub Issue: #{data['number']} — opened by @{author} on {created_at} -> Status: 📋 Cataloged | Priority: TBD - -## 📝 Original Request - -{body} - -## 💬 Community Discussion - -{comments_str} - -### Participants - -{participants_list} - -### Key Points - -- Needs detailed analysis - -## 🎯 Refined Feature Description - -Feature needs manual refinement and interpretation to fill logical gaps and outline high-level technical scope. - -### What it solves - -- TBD - -### How it should work (high level) - -1. TBD -2. TBD - -### Affected areas - -- TBD - -## 📎 Attachments & References - -- Check issue body for references - -## 🔗 Related Ideas - -- None yet -""" - with open(filename, 'w', encoding='utf-8') as f: - f.write(content) - - except Exception as e: - print(f"Error processing {num}: {e}") - -print("Done.") diff --git a/scripts/scratch/overlap.js b/scripts/scratch/overlap.js deleted file mode 100644 index 93ac1df151..0000000000 --- a/scripts/scratch/overlap.js +++ /dev/null @@ -1,21 +0,0 @@ -import { - APIKEY_PROVIDERS, - SEARCH_PROVIDERS, - AUDIO_ONLY_PROVIDERS, - WEB_COOKIE_PROVIDERS, -} from "./src/shared/constants/providers.ts"; - -const apiKeys = Object.keys(APIKEY_PROVIDERS); -console.log("Searching overlap in APIKEY_PROVIDERS:"); -console.log( - "Search overlap:", - Object.keys(SEARCH_PROVIDERS).filter((k) => apiKeys.includes(k)) -); -console.log( - "Audio overlap:", - Object.keys(AUDIO_ONLY_PROVIDERS).filter((k) => apiKeys.includes(k)) -); -console.log( - "Web Cookie overlap:", - Object.keys(WEB_COOKIE_PROVIDERS).filter((k) => apiKeys.includes(k)) -); diff --git a/scripts/scratch/overlap.ts b/scripts/scratch/overlap.ts deleted file mode 100644 index ceb10a0aad..0000000000 --- a/scripts/scratch/overlap.ts +++ /dev/null @@ -1,8 +0,0 @@ -import { APIKEY_PROVIDERS, SEARCH_PROVIDERS } from "./src/shared/constants/providers.ts"; - -const apiKeys = Object.keys(APIKEY_PROVIDERS); -console.log( - "Overlap:", - Object.keys(SEARCH_PROVIDERS).filter((k) => apiKeys.includes(k)) -); -console.log("Is perplexity-search in APIKEY?", "perplexity-search" in APIKEY_PROVIDERS); diff --git a/scripts/scratch/pr_body.md b/scripts/scratch/pr_body.md deleted file mode 100644 index 25326e6e60..0000000000 --- a/scripts/scratch/pr_body.md +++ /dev/null @@ -1,46 +0,0 @@ -### ✨ New Features - -- **feat(compression):** major upgrade to Caveman and RTK compression pipelines (#1876, #1889): - - Add RTK tool-output compression, stacked Caveman + RTK pipelines, compression combo assignments, dashboard context pages, MCP management tools, and language-aware Caveman rule packs. - - Expand RTK parity with a 39-filter catalog, RTK-style JSON DSL stages, inline verify/benchmark coverage, trust-gated custom filters, expanded command detection, and redacted raw-output recovery. - - Expose rule intensities, track USD savings, unify config validation, and persist MCP savings. - - Expand Caveman parity and MCP metadata compression. -- **feat(provider):** update Jina AI model catalog to support Embeddings and Rerank natively (#1874 — thanks @backryun) -- **feat(provider):** add NanoGPT image generation provider (#1899 — thanks @Aculeasis) -- **feat(ui):** move proxy configuration to dedicated System → Proxy page (#1907 — thanks @oyi77) -- **feat(ui):** add K/M/B/T cost shortener utility (#1902 — thanks @oyi77) -- **feat(providers):** implement bulk paste for extra API keys (#1916 — thanks @0xtbug) -- **feat(analytics):** usage history API key backfill + dark mode pricing (#1896 — thanks @Gi99lin) -- **feat(logs):** show RTK and Caveman compression token savings accurately in request log UI (#1923 — thanks @emdash) - -### 🐛 Bug Fixes - -- **fix(providers):** allow local OpenAI-compatible endpoints (like Ollama) to be added without an API key (fixes #1893) -- **fix(providers):** bypass AgentRouter unauthorized_client_error by spoofing Claude CLI headers via Anthropic endpoints (fixes #1921) -- **fix(copilot):** emit compatible reasoning text deltas (#1919 — thanks @ivan-mezentsev) -- **fix(api-manager):** show validation errors inline in modals, not behind (#1920 — thanks @andrewmunsell) -- **fix(compression):** align seeded standard savings combo with stacked default, preserve stacked defaults, and secure metadata routes. -- **fix(gemini-cli):** separate Cloud Code transport from Antigravity (#1869 — thanks @dhaern) -- **fix(codex):** map prompt field to input array for Cursor compatibility (fixes #1872) -- **fix(core):** align stream parameter default to false per strict OpenAI spec (fixes #1873) -- **fix(ui):** restore Next.js CSP `unsafe-eval` in production `script-src` to fix unresponsive Onboarding button (fixes #1883) -- **fix(proxy):** globally strip `prompt_cache_retention` in `BaseExecutor` to prevent upstream 400 errors from strict endpoints like droid/gemini-2-pro (fixes #1884) -- **fix(ui):** include `isOpen` dependency in `EditConnectionModal` state sync to ensure `maxConcurrent` is properly hydrated when reopening the modal (fixes #1859) -- **fix(security):** remediate 4 polynomial-redos CodeQL alerts in compression regexes by bounding repetitions and removing overlapping quantifiers -- **fix(codex):** flatten Chat Completions tool format to Codex Responses format in `normalizeCodexTools` — prevents `Missing required parameter: tools[0].name` upstream errors (#1914 — thanks @tranduykhanh030) -- **fix(proxy):** add proxy-aware execution context to image generation route — proxy settings are now correctly applied for image providers behind restricted networks (#1904 — thanks @Aculeasis) -- **fix(translator):** inject `properties: {}` into zero-argument MCP tool schemas during Anthropic→OpenAI translation — prevents 400 errors from OpenAI strict schema validation (#1898 — thanks @bryceIT) -- **fix(codex):** sanitize raw responses input (#1895 — thanks @dhaern) -- **fix(combos):** align strategy contracts (#1892 — thanks @dhaern) -- **fix(combos):** fix combo provider breaker profile handling (#1891 — thanks @rdself) -- **fix(migrations):** duplicate-column no-op fix (#1886 — thanks @smartenok-ops) -- **fix(auth):** per-connection OAuth refresh mutex (#1885 — thanks @smartenok-ops) -- **fix(auth):** require dashboard management auth for compression preview - -### 📝 Documentation - -- **docs(compression):** document RTK+Caveman stacked savings ranges - -### 🏆 Release Attribution & Retroactive Credits - -- **@payne0420** (PR #1828 / #1839) — Implementation of the **Rate Limit Watchdog** and environment overrides. (This feature was manually backported to v3.7.8, causing the automatic GitHub Release notes to omit the author's credit). diff --git a/scripts/scratch/query_db.js b/scripts/scratch/query_db.js deleted file mode 100644 index 7f94c56e1c..0000000000 --- a/scripts/scratch/query_db.js +++ /dev/null @@ -1,10 +0,0 @@ -const Database = require("better-sqlite3"); -const db = new Database(process.env.HOME + "/.omniroute/storage.sqlite"); -console.log("=== provider_connections containing iflow ==="); -console.log( - db - .prepare( - "SELECT id, provider_id, alias, account_id FROM provider_connections WHERE provider_id LIKE '%iflow%' OR alias LIKE '%iflow%' OR account_id LIKE '%iflow%'" - ) - .all() -); diff --git a/scripts/scratch/refine_viable.py b/scripts/scratch/refine_viable.py deleted file mode 100644 index abdf86ed5d..0000000000 --- a/scripts/scratch/refine_viable.py +++ /dev/null @@ -1,91 +0,0 @@ -import os - -viable_data = { - 1718: { - "title": "expose upstream error details in client-facing error responses", - "solves": "Debugging upstream errors is difficult because they are hidden behind generic '[400] Error from provider' wrappers.", - "how": "1. Modify `buildErrorBody` to accept `upstream_details`.\n2. In `BaseExecutor` or specific handlers, parse the raw upstream response on failure.\n3. Propagate the parsed body to the client response inside `upstream_details`.", - "areas": "open-sse/executors/base.ts, open-sse/utils/errors.ts, src/app/api/v1/chat/completions/route.ts", - "req_summary": "Expose the upstream error body (e.g. context_length_exceeded) directly in the error response under an `upstream_details` key, without breaking OpenAI compatibility.", - "req_approach": "Modify the central error generation functions (like `buildErrorBody`) to optionally accept an `upstreamDetails` object. Update the request executors to pass the JSON parsed error from the upstream response into this new parameter when a request fails.", - "req_files": "| File | Changes |\n|---|---|\n| `open-sse/utils/errors.ts` | Update `buildErrorBody` to include `upstream_details`. |\n| `open-sse/executors/base.ts` | Extract response body on failure and pass to error builder. |", - "req_effort": "Low. A few files changed. No breaking changes." - }, - 1731: { - "title": "(combo): provider-level exhaustion tracking to skip same-provider targets", - "solves": "Combo routing wastes significant time retrying multiple targets from the same provider when the entire provider is rate-limited or quota-exhausted.", - "how": "1. Track 429 quota exhaustion errors at the provider level.\n2. In `combo.ts`, before attempting a target, check if its provider is currently marked as exhausted.\n3. If exhausted, skip the target and move to the next provider.", - "areas": "open-sse/services/combo.ts, open-sse/services/accountFallback.ts", - "req_summary": "Implement provider-level 429 exhaustion tracking in the combo router so it skips remaining targets of a provider if a 429 quota exhaustion occurs.", - "req_approach": "Add a temporary exclusion set in `handleComboChat` that tracks providers that have returned a hard 429. Before evaluating the next target in the combo, check if its provider is in the exclusion set and skip it if true.", - "req_files": "| File | Changes |\n|---|---|\n| `open-sse/services/combo.ts` | Add logic to track provider failures and skip matching targets. |\n| `open-sse/services/accountFallback.ts` | Properly bubble up the 429 status. |", - "req_effort": "Medium. Needs careful state tracking across the combo loop. No breaking changes." - }, - 1764: { - "title": "Make installation script detect termux", - "solves": "OmniRoute fails to start or install properly on Termux because `wreq-js` attempts to load a native `libgcc` arm64 module which is incompatible.", - "how": "1. Update the `postinstall` script to check `process.env.PREFIX` for termux.\n2. If termux is detected, gracefully skip or patch the wreq-js installation/loading.", - "areas": "scripts/postinstall.mjs, open-sse/executors/wreq.ts", - "req_summary": "Detect termux environments during installation or runtime and gracefully handle the `wreq-js` native module failure, allowing the rest of OmniRoute to function.", - "req_approach": "Modify `scripts/postinstall.mjs` or the wreq-js loader logic. If `process.env.PREFIX && process.env.PREFIX.includes('termux')` is true, avoid hard crashing on wreq-js load failures.", - "req_files": "| File | Changes |\n|---|---|\n| `scripts/postinstall.mjs` | Add termux detection and warning. |\n| `open-sse/utils/env.ts` (or similar) | Graceful downgrade. |", - "req_effort": "Low. Very localized fix." - } -} - -for root, _, files in os.walk("_ideia/viable"): - for f in files: - if not f.endswith(".md") or "requirements" in f: continue - num = int(f.split('-')[0]) - if num in viable_data: - path = os.path.join(root, f) - with open(path, 'r') as file: - content = file.read() - - d = viable_data[num] - - # replace TBDs - content = content.replace("### What it solves\n\n- TBD", f"### What it solves\n\n- {d['solves']}") - content = content.replace("### How it should work (high level)\n\n1. TBD\n2. TBD", f"### How it should work (high level)\n\n{d['how']}") - content = content.replace("### Affected areas\n\n- TBD", f"### Affected areas\n\n- {d['areas']}") - content = content.replace("Feature needs manual refinement and interpretation to fill logical gaps and outline high-level technical scope.", "Refined and scoped for implementation.") - - with open(path, 'w') as file: - file.write(content) - - req_content = f"""# Requirements: {d['title']} - -> Feature Idea: [#{num}](./{f}) -> Research Date: 2026-05-01 -> Verdict: ✅ VIABLE - -## 🔍 Research Summary - -{d['req_summary']} - -## 📚 Reference Implementations - -| # | Repository | Stars | Last Updated | Approach | Relevance | -| --- | ---------------- | ----- | ------------ | -------- | ------------ | -| 1 | OmniRoute Source | - | 2026-05-01 | Internal | High | - -## 📐 Proposed Solution Architecture - -### Approach - -{d['req_approach']} - -### Modified Files - -{d['req_files']} - -## ⚙️ Implementation Effort - -- **Estimated complexity**: {d['req_effort']} -- **Breaking changes**: No -""" - req_path = os.path.join(root, f.replace(".md", ".requirements.md")) - with open(req_path, 'w') as req_file: - req_file.write(req_content) - - print(f"Refined {num} and created requirements.") diff --git a/scripts/scratch/test-cherry.js b/scripts/scratch/test-cherry.js deleted file mode 100644 index 07fb46df26..0000000000 --- a/scripts/scratch/test-cherry.js +++ /dev/null @@ -1,2 +0,0 @@ -const { convertOpenAIContentToParts } = require("./open-sse/translator/helpers/geminiHelper.ts"); -// since it's typescript/ESM, we might need a ts-node or vitest diff --git a/scripts/scratch/test-executor.ts b/scripts/scratch/test-executor.ts deleted file mode 100644 index 754b6f5414..0000000000 --- a/scripts/scratch/test-executor.ts +++ /dev/null @@ -1,38 +0,0 @@ -import { QoderExecutor } from "./open-sse/executors/qoder.ts"; -import fs from "fs"; -import os from "os"; - -async function run() { - const credsPath = os.homedir() + "/.qwen/oauth_creds.json"; - const creds = JSON.parse(fs.readFileSync(credsPath, "utf8")); - - const executor = new QoderExecutor(); - const result = await executor.execute({ - model: "coder-model", - body: { - messages: [{ role: "user", content: "hello test" }], - stream: true, - max_tokens: 10, - }, - credentials: { - accessToken: creds.access_token, - resourceUrl: creds.resource_url, - }, - signal: new AbortController().signal, - }); - - console.log("Status:", result.response.status); - - if (result.response.body) { - // If it's a web stream, readable stream - const reader = result.response.body.getReader(); - const decoder = new TextDecoder("utf-8"); - while (true) { - const { done, value } = await reader.read(); - if (done) break; - console.log(decoder.decode(value)); - } - } -} - -run().catch(console.error); diff --git a/scripts/scratch/test-math-regex.js b/scripts/scratch/test-math-regex.js deleted file mode 100644 index e42a210ec8..0000000000 --- a/scripts/scratch/test-math-regex.js +++ /dev/null @@ -1,3 +0,0 @@ -const re = /\$\$[^$]*(?:\$(?!\$)[^$]*)*\$\$/g; -const txt = "some text $$ a + b = c $$ more text $$ x + $y$ = z $$ end"; -console.log(txt.match(re)); diff --git a/scripts/scratch/test-migrations.ts b/scripts/scratch/test-migrations.ts deleted file mode 100644 index f21ca16ca8..0000000000 --- a/scripts/scratch/test-migrations.ts +++ /dev/null @@ -1,56 +0,0 @@ -import Database from "better-sqlite3"; -import { runMigrations, getMigrationStatus } from "../../src/lib/db/migrationRunner.js"; - -const db = new Database("/tmp/test-migrations.sqlite"); -db.exec( - "CREATE TABLE _omniroute_migrations (version TEXT PRIMARY KEY, name TEXT NOT NULL, applied_at TEXT NOT NULL DEFAULT (datetime('now')))" -); - -const fakeApplied = [ - "001", - "002", - "003", - "004", - "005", - "006", - "007", - "008", - "009", - "010", - "011", - "012", - "013", - "014", - "015", - "016", - "017", - "018", - "019", - "020", - "021", -]; -for (const v of fakeApplied) { - db.prepare("INSERT INTO _omniroute_migrations (version, name) VALUES (?, ?)").run(v, "fake_" + v); -} -db.prepare("INSERT INTO _omniroute_migrations (version, name) VALUES (?, ?)").run( - "026", - "call_logs_cache_source" -); -db.prepare("INSERT INTO _omniroute_migrations (version, name) VALUES (?, ?)").run( - "029", - "provider_connection_max_concurrent" -); - -console.log( - "Status before:", - getMigrationStatus(db).pending.map((p) => p.version) -); -try { - runMigrations(db, { isNewDb: false }); -} catch (e: any) { - console.error("Error:", e.message); -} -console.log( - "Status after:", - getMigrationStatus(db).pending.map((p) => p.version) -); diff --git a/scripts/scratch/test-regex.js b/scripts/scratch/test-regex.js deleted file mode 100644 index deba62356e..0000000000 --- a/scripts/scratch/test-regex.js +++ /dev/null @@ -1,5 +0,0 @@ -const text = "hello world. this is a test\n\nnew line. another."; -const re1 = /(^|[.!?][ \t]+|\n+[ \t]*)([a-z])/g; -const re2 = /(^|[.!?]\s+)([a-z])/gm; -console.log(text.replace(re1, (m, p, c) => p + c.toUpperCase())); -console.log(text.replace(re2, (m, p, c) => p + c.toUpperCase())); diff --git a/scripts/scratch/test-regex2.js b/scripts/scratch/test-regex2.js deleted file mode 100644 index c6eeb518a6..0000000000 --- a/scripts/scratch/test-regex2.js +++ /dev/null @@ -1,5 +0,0 @@ -const text = "hello\n world"; -const re1 = /(^|[.!?][ \t]+|\n+[ \t]*)([a-z])/g; -const re3 = /(^|[.!?]\s+|^\s+)([a-z])/gm; -console.log(text.replace(re1, (m, p, c) => p + c.toUpperCase())); -console.log(text.replace(re3, (m, p, c) => p + c.toUpperCase())); diff --git a/scripts/scratch/test_gemini.mjs b/scripts/scratch/test_gemini.mjs deleted file mode 100644 index f875cf3316..0000000000 --- a/scripts/scratch/test_gemini.mjs +++ /dev/null @@ -1,9 +0,0 @@ -import { convertOpenAIContentToParts } from "./open-sse/translator/helpers/geminiHelper.ts"; - -const cherryMsg = [ - { type: "text", text: "What runs on this?" }, - { type: "file", file: { data: "ABCDEFG", type: "application/pdf" } }, - { type: "file", file_url: { url: "data:application/pdf;base64,ABCDEFG" } }, -]; - -console.log(convertOpenAIContentToParts(cherryMsg)); diff --git a/scripts/scratch/update_ui.cjs b/scripts/scratch/update_ui.cjs deleted file mode 100644 index 98e083adca..0000000000 --- a/scripts/scratch/update_ui.cjs +++ /dev/null @@ -1,170 +0,0 @@ -const fs = require('fs'); - -const path = 'src/app/(dashboard)/dashboard/providers/[id]/page.tsx'; -let content = fs.readFileSync(path, 'utf8'); - -// 1. Add ModelRowProps fields -content = content.replace( - ' togglingHidden?: boolean;\n}', - ' togglingHidden?: boolean;\n onTestModel?: (modelId: string, fullModel: string) => Promise<void>;\n testStatus?: "ok" | "error" | null;\n testingModel?: boolean;\n}' -); - -// 2. Add PassthroughModelRowProps fields -content = content.replace( - ' togglingHidden?: boolean;\n}', - ' togglingHidden?: boolean;\n onTestModel?: (modelId: string, fullModel: string) => Promise<void>;\n testStatus?: "ok" | "error" | null;\n testingModel?: boolean;\n}' -); - -// 3. Add PassthroughModelsSectionProps fields -content = content.replace( - ' togglingModelId?: string | null;\n}', - ' togglingModelId?: string | null;\n onTestModel?: (modelId: string, fullModel: string) => Promise<void>;\n modelTestStatus?: Record<string, "ok" | "error" | null>;\n testingModelId?: string | null;\n}' -); - -// 4. Add CompatibleModelsSectionProps fields -content = content.replace( - ' togglingModelId?: string | null;\n}', - ' togglingModelId?: string | null;\n onTestModel?: (modelId: string, fullModel: string) => Promise<void>;\n modelTestStatus?: Record<string, "ok" | "error" | null>;\n testingModelId?: string | null;\n}' -); - -// 5. Update ModelRow -content = content.replace( - ' compatDisabled,\n onToggleHidden,\n togglingHidden,\n}: ModelRowProps) {', - ' compatDisabled,\n onToggleHidden,\n togglingHidden,\n onTestModel,\n testStatus,\n testingModel,\n}: ModelRowProps) {' -); -content = content.replace( - ' <div className="flex shrink-0 items-center gap-1">', - ` <div className="flex shrink-0 items-center gap-1"> - {onTestModel && ( - <button - onClick={() => onTestModel(model.id, fullModel)} - disabled={testingModel} - className={\`rounded p-0.5 hover:bg-sidebar transition-colors disabled:opacity-40 disabled:cursor-not-allowed \${testStatus === "ok" ? "text-green-500" : testStatus === "error" ? "text-red-500" : "text-text-muted hover:text-primary"}\`} - title={testingModel ? t("testingModel", "Testing...") : testStatus === "ok" ? "OK" : testStatus === "error" ? "Error" : t("testModel", "Test Model")} - > - {testingModel ? ( - <span className="material-symbols-outlined text-sm animate-spin">progress_activity</span> - ) : testStatus === "ok" ? ( - <span className="material-symbols-outlined text-sm">check_circle</span> - ) : testStatus === "error" ? ( - <span className="material-symbols-outlined text-sm">error</span> - ) : ( - <span className="material-symbols-outlined text-sm">play_circle</span> - )} - </button> - )}` -); - -// 6. Update PassthroughModelRow -content = content.replace( - ' compatDisabled,\n onToggleHidden,\n togglingHidden,\n}: PassthroughModelRowProps) {', - ' compatDisabled,\n onToggleHidden,\n togglingHidden,\n onTestModel,\n testStatus,\n testingModel,\n}: PassthroughModelRowProps) {' -); -content = content.replace( - ' <div className="flex shrink-0 items-center gap-1 self-start">', - ` <div className="flex shrink-0 items-center gap-1 self-start"> - {onTestModel && ( - <button - onClick={() => onTestModel(modelId, fullModel)} - disabled={testingModel} - className={\`rounded p-0.5 hover:bg-sidebar transition-colors disabled:opacity-40 disabled:cursor-not-allowed \${testStatus === "ok" ? "text-green-500" : testStatus === "error" ? "text-red-500" : "text-text-muted hover:text-primary"}\`} - title={testingModel ? t("testingModel", "Testing...") : testStatus === "ok" ? "OK" : testStatus === "error" ? "Error" : t("testModel", "Test Model")} - > - {testingModel ? ( - <span className="material-symbols-outlined text-sm animate-spin">progress_activity</span> - ) : testStatus === "ok" ? ( - <span className="material-symbols-outlined text-sm">check_circle</span> - ) : testStatus === "error" ? ( - <span className="material-symbols-outlined text-sm">error</span> - ) : ( - <span className="material-symbols-outlined text-sm">play_circle</span> - )} - </button> - )}` -); - -// 7. Update PassthroughModelsSection component passing props down -content = content.replace( - ' togglingModelId,\n}: PassthroughModelsSectionProps)', - ' togglingModelId,\n onTestModel,\n modelTestStatus,\n testingModelId,\n}: PassthroughModelsSectionProps)' -); -content = content.replace( - ' saveModelCompatFlags={saveModelCompatFlags}\n compatDisabled={compatSavingModelId === cm.id}', - ' saveModelCompatFlags={saveModelCompatFlags}\n compatDisabled={compatSavingModelId === cm.id}\n onTestModel={onTestModel}\n testStatus={modelTestStatus?.[cm.id] || null}\n testingModel={testingModelId === cm.id}' -); -content = content.replace( - ' compatDisabled={compatSavingModelId === alias}\n onToggleHidden={onToggleHidden}', - ' compatDisabled={compatSavingModelId === alias}\n onToggleHidden={onToggleHidden}\n onTestModel={onTestModel}\n testStatus={modelTestStatus?.[alias] || null}\n testingModel={testingModelId === alias}' -); - -// 8. Update CompatibleModelsSection component passing props down -content = content.replace( - ' togglingModelId,\n}: CompatibleModelsSectionProps) {', - ' togglingModelId,\n onTestModel,\n modelTestStatus,\n testingModelId,\n}: CompatibleModelsSectionProps) {' -); -content = content.replace( - ' saveModelCompatFlags={saveModelCompatFlags}\n compatDisabled={compatSavingModelId === cm.id}', - ' saveModelCompatFlags={saveModelCompatFlags}\n compatDisabled={compatSavingModelId === cm.id}\n onTestModel={onTestModel}\n testStatus={modelTestStatus?.[cm.id] || null}\n testingModel={testingModelId === cm.id}' -); -content = content.replace( - ' compatDisabled={compatSavingModelId === model.id}\n onToggleHidden={(modelId, hidden)', - ' compatDisabled={compatSavingModelId === model.id}\n onTestModel={onTestModel}\n testStatus={modelTestStatus?.[model.id] || null}\n testingModel={testingModelId === model.id}\n onToggleHidden={(modelId, hidden)' -); - -// 9. Update ProviderDetailPage -content = content.replace( - ' const [togglingModelId, setTogglingModelId] = useState<string | null>(null);', - ' const [togglingModelId, setTogglingModelId] = useState<string | null>(null);\n const [testingModelId, setTestingModelId] = useState<string | null>(null);\n const [modelTestStatus, setModelTestStatus] = useState<Record<string, "ok" | "error">>({});' -); - -// Add the onTestModel function -content = content.replace( - ' const handleSetAlias = async (modelId, alias, providerAliasOverride = providerAlias) => {', - ` const onTestModel = async (modelId: string, fullModel: string) => { - setTestingModelId(modelId); - setModelTestStatus(prev => ({ ...prev, [modelId]: undefined })); - try { - const res = await fetch("/api/models/test", { - method: "POST", - headers: { "Content-Type": "application/json" }, - body: JSON.stringify({ providerId: selectedConnection?.provider || providerNode?.id || providerId, modelId: fullModel }) - }); - const data = await res.json(); - if (res.ok && data.status === "ok") { - notify.success(providerText(t, "testModelSuccess", \`Model \${modelId} is working. Latency: \${data.latencyMs}ms\`, { modelId, latencyMs: data.latencyMs })); - setModelTestStatus(prev => ({ ...prev, [modelId]: "ok" })); - } else { - notify.error(data.error || "Model test failed"); - setModelTestStatus(prev => ({ ...prev, [modelId]: "error" })); - } - } catch (err) { - notify.error("Network error testing model"); - setModelTestStatus(prev => ({ ...prev, [modelId]: "error" })); - } finally { - setTestingModelId(null); - } - }; - - const handleSetAlias = async (modelId, alias, providerAliasOverride = providerAlias) => {` -); - -// Pass to PassthroughModelsSection in ProviderDetailPage -content = content.replace( - ' togglingModelId={togglingModelId}\n />', - ' togglingModelId={togglingModelId}\n onTestModel={onTestModel}\n modelTestStatus={modelTestStatus}\n testingModelId={testingModelId}\n />' -); - -// Pass to CompatibleModelsSection in ProviderDetailPage -content = content.replace( - ' togglingModelId={togglingModelId}\n />', - ' togglingModelId={togglingModelId}\n onTestModel={onTestModel}\n modelTestStatus={modelTestStatus}\n testingModelId={testingModelId}\n />' -); - -// Pass to ModelRow in ProviderDetailPage (fallback/normal models list) -content = content.replace( - ' togglingHidden={togglingModelId === model.id}\n />', - ' togglingHidden={togglingModelId === model.id}\n onTestModel={onTestModel}\n testStatus={modelTestStatus[model.id] || null}\n testingModel={testingModelId === model.id}\n />' -); - -fs.writeFileSync(path, content); -console.log("Successfully updated page.tsx"); diff --git a/src/app/(dashboard)/dashboard/analytics/AutoRoutingAnalyticsTab.tsx b/src/app/(dashboard)/dashboard/analytics/AutoRoutingAnalyticsTab.tsx new file mode 100644 index 0000000000..abbb4db632 --- /dev/null +++ b/src/app/(dashboard)/dashboard/analytics/AutoRoutingAnalyticsTab.tsx @@ -0,0 +1,166 @@ +"use client"; + +import { useEffect, useState } from "react"; +import { Card } from "@/shared/components"; +import { useTranslations } from "next-intl"; + +interface AutoRoutingStats { + totalRequests: number; + variantBreakdown: Record<string, number>; + avgSelectionScore: number; + topProviders: Array<{ provider: string; count: number }>; + explorationRate: number; + lkgpHitRate: number; +} + +export default function AutoRoutingAnalyticsTab() { + const [stats, setStats] = useState<AutoRoutingStats | null>(null); + const [loading, setLoading] = useState(true); + const t = useTranslations("analytics"); + + useEffect(() => { + fetch("/api/analytics/auto-routing") + .then((res) => res.json()) + .then((data) => { + setStats(data); + setLoading(false); + }) + .catch(() => setLoading(false)); + }, []); + + if (loading) { + return ( + <Card> + <div className="animate-pulse space-y-4"> + <div className="h-4 bg-border rounded w-1/4"></div> + <div className="h-20 bg-border rounded"></div> + </div> + </Card> + ); + } + + if (!stats) { + return ( + <Card> + <div className="text-center py-8 text-text-muted"> + No auto-routing analytics available. Make requests using the auto/ prefix to see metrics. + </div> + </Card> + ); + } + + return ( + <div className="space-y-6"> + {/* Summary Cards */} + <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4"> + <Card className="p-4"> + <div className="flex items-center gap-3"> + <div className="p-2 rounded-lg bg-indigo-500/10 text-indigo-500"> + <span className="material-symbols-outlined text-[20px]">auto_awesome</span> + </div> + <div> + <p className="text-sm text-text-muted">Total Auto Requests</p> + <p className="text-2xl font-bold">{stats.totalRequests.toLocaleString()}</p> + </div> + </div> + </Card> + + <Card className="p-4"> + <div className="flex items-center gap-3"> + <div className="p-2 rounded-lg bg-green-500/10 text-green-500"> + <span className="material-symbols-outlined text-[20px]">target</span> + </div> + <div> + <p className="text-sm text-text-muted">Avg Selection Score</p> + <p className="text-2xl font-bold">{(stats.avgSelectionScore * 100).toFixed(1)}%</p> + </div> + </div> + </Card> + + <Card className="p-4"> + <div className="flex items-center gap-3"> + <div className="p-2 rounded-lg bg-amber-500/10 text-amber-500"> + <span className="material-symbols-outlined text-[20px]">explore</span> + </div> + <div> + <p className="text-sm text-text-muted">Exploration Rate</p> + <p className="text-2xl font-bold">{(stats.explorationRate * 100).toFixed(1)}%</p> + </div> + </div> + </Card> + + <Card className="p-4"> + <div className="flex items-center gap-3"> + <div className="p-2 rounded-lg bg-emerald-500/10 text-emerald-500"> + <span className="material-symbols-outlined text-[20px]">history</span> + </div> + <div> + <p className="text-sm text-text-muted">LKGP Hit Rate</p> + <p className="text-2xl font-bold">{(stats.lkgpHitRate * 100).toFixed(1)}%</p> + </div> + </div> + </Card> + </div> + + {/* Variant Breakdown */} + <Card className="p-6"> + <h3 className="text-lg font-semibold mb-4">Requests by Variant</h3> + <div className="space-y-3"> + {Object.entries(stats.variantBreakdown).map(([variant, count]) => { + const percentage = stats.totalRequests > 0 ? (count / stats.totalRequests) * 100 : 0; + return ( + <div key={variant} className="flex items-center gap-3"> + <div className="w-32 text-sm font-medium capitalize">{variant || "default"}</div> + <div className="flex-1 h-3 bg-border rounded-full overflow-hidden"> + <div + className="h-full bg-indigo-500 rounded-full transition-all" + style={{ width: `${percentage}%` }} + /> + </div> + <div className="w-20 text-sm text-text-muted text-right"> + {count.toLocaleString()} ({percentage.toFixed(1)}%) + </div> + </div> + ); + })} + </div> + </Card> + + {/* Top Providers */} + <Card className="p-6"> + <h3 className="text-lg font-semibold mb-4">Top Routed Providers</h3> + <div className="overflow-x-auto"> + <table className="w-full text-sm"> + <thead> + <tr className="border-b border-border"> + <th className="text-left py-2 px-3 font-medium">Provider</th> + <th className="text-right py-2 px-3 font-medium">Requests</th> + <th className="text-right py-2 px-3 font-medium">Share</th> + </tr> + </thead> + <tbody> + {stats.topProviders.map((provider, index) => { + const percentage = + stats.totalRequests > 0 ? (provider.count / stats.totalRequests) * 100 : 0; + return ( + <tr key={provider.provider} className="border-b border-border/50"> + <td className="py-2 px-3"> + <div className="flex items-center gap-2"> + <span className="text-text-muted">#{index + 1}</span> + <span className="font-medium">{provider.provider}</span> + </div> + </td> + <td className="text-right py-2 px-3">{provider.count.toLocaleString()}</td> + <td className="text-right py-2 px-3 text-text-muted"> + {percentage.toFixed(1)}% + </td> + </tr> + ); + })} + </tbody> + </table> + </div> + </Card> + </div> + ); +} diff --git a/src/app/(dashboard)/dashboard/analytics/page.tsx b/src/app/(dashboard)/dashboard/analytics/page.tsx index b900d4351c..94f22dfab1 100644 --- a/src/app/(dashboard)/dashboard/analytics/page.tsx +++ b/src/app/(dashboard)/dashboard/analytics/page.tsx @@ -8,6 +8,7 @@ import CompressionAnalyticsTab from "./CompressionAnalyticsTab"; import DiversityScoreCard from "./components/DiversityScoreCard"; import ProviderUtilizationTab from "./ProviderUtilizationTab"; import ComboHealthTab from "./ComboHealthTab"; +import AutoRoutingAnalyticsTab from "./AutoRoutingAnalyticsTab"; import { useTranslations } from "next-intl"; export default function AnalyticsPage() { @@ -21,6 +22,8 @@ export default function AnalyticsPage() { utilization: t("utilizationDescription"), comboHealth: t("comboHealthDescription"), compression: t("compressionAnalyticsDescription"), + autoRouting: + "Auto-routing analytics — variant usage, provider selection, and LKGP performance.", }; return ( @@ -42,6 +45,7 @@ export default function AnalyticsPage() { { value: "utilization", label: t("utilization") }, { value: "comboHealth", label: t("comboHealth") }, { value: "compression", label: t("compressionAnalyticsTitle") }, + { value: "autoRouting", label: "Auto-Routing" }, ]} value={activeTab} onChange={setActiveTab} diff --git a/src/app/(dashboard)/dashboard/cache/media/MediaPageClient.tsx b/src/app/(dashboard)/dashboard/cache/media/MediaPageClient.tsx index 5b2ba40bea..ae5b69f32e 100644 --- a/src/app/(dashboard)/dashboard/cache/media/MediaPageClient.tsx +++ b/src/app/(dashboard)/dashboard/cache/media/MediaPageClient.tsx @@ -23,6 +23,7 @@ type MediaModelConfig = { id: string; name: string }; type MediaProviderConfig = { id: string; authType: string; + supportedFormats?: string[]; models: MediaModelConfig[]; }; type ProviderModelGroup = { @@ -172,8 +173,147 @@ const VOICE_PRESETS: Record<string, { id: string; label: string }[]> = { { id: "aura-orion-en", label: "Orion (EN)" }, ], inworld: [ - { id: "Eva", label: "Eva (EN)" }, + { id: "Abby", label: "Abby (EN)" }, + { id: "Alex", label: "Alex (EN)" }, + { id: "Amina", label: "Amina (EN)" }, + { id: "Anjali", label: "Anjali (EN)" }, + { id: "Arjun", label: "Arjun (EN)" }, + { id: "Ashley", label: "Ashley (EN)" }, + { id: "Avery", label: "Avery (EN)" }, + { id: "Bianca", label: "Bianca (EN)" }, + { id: "Blake", label: "Blake (EN)" }, + { id: "Brandon", label: "Brandon (EN)" }, + { id: "Brian", label: "Brian (EN)" }, + { id: "Callum", label: "Callum (EN)" }, + { id: "Carter", label: "Carter (EN)" }, + { id: "Cedric", label: "Cedric (EN)" }, + { id: "Celeste", label: "Celeste (EN)" }, + { id: "Chloe", label: "Chloe (EN)" }, + { id: "Claire", label: "Claire (EN)" }, + { id: "Clive", label: "Clive (EN)" }, + { id: "Conrad", label: "Conrad (EN)" }, + { id: "Craig", label: "Craig (EN)" }, + { id: "Damon", label: "Damon (EN)" }, + { id: "Darlene", label: "Darlene (EN)" }, + { id: "Deborah", label: "Deborah (EN)" }, + { id: "Dennis", label: "Dennis (EN)" }, + { id: "Derek", label: "Derek (EN)" }, + { id: "Dominus", label: "Dominus (EN)" }, + { id: "Duncan", label: "Duncan (EN)" }, + { id: "Edward", label: "Edward (EN)" }, + { id: "Eleanor", label: "Eleanor (EN)" }, + { id: "Elliot", label: "Elliot (EN)" }, + { id: "Ethan", label: "Ethan (EN)" }, + { id: "Evan", label: "Evan (EN)" }, + { id: "Evelyn", label: "Evelyn (EN)" }, + { id: "Felix", label: "Felix (EN)" }, + { id: "Gareth", label: "Gareth (EN)" }, + { id: "Graham", label: "Graham (EN)" }, + { id: "Hades", label: "Hades (EN)" }, + { id: "Hamish", label: "Hamish (EN)" }, + { id: "Hana", label: "Hana (EN)" }, + { id: "Hank", label: "Hank (EN)" }, + { id: "James", label: "James (EN)" }, + { id: "Jason", label: "Jason (EN)" }, + { id: "Jessica", label: "Jessica (EN)" }, + { id: "Jonah", label: "Jonah (EN)" }, + { id: "Kelsey", label: "Kelsey (EN)" }, + { id: "Lauren", label: "Lauren (EN)" }, + { id: "Levi", label: "Levi (EN)" }, + { id: "Liam", label: "Liam (EN)" }, + { id: "Loretta", label: "Loretta (EN)" }, + { id: "Lucian", label: "Lucian (EN)" }, + { id: "Luna", label: "Luna (EN)" }, + { id: "Malcolm", label: "Malcolm (EN)" }, { id: "Marcus", label: "Marcus (EN)" }, + { id: "Mark", label: "Mark (EN)" }, + { id: "Marlene", label: "Marlene (EN)" }, + { id: "Mia", label: "Mia (EN)" }, + { id: "Miranda", label: "Miranda (EN)" }, + { id: "Mortimer", label: "Mortimer (EN)" }, + { id: "Nadia", label: "Nadia (EN)" }, + { id: "Naomi", label: "Naomi (EN)" }, + { id: "Nate", label: "Nate (EN)" }, + { id: "Oliver", label: "Oliver (EN)" }, + { id: "Olivia", label: "Olivia (EN)" }, + { id: "Pippa", label: "Pippa (EN)" }, + { id: "Pixie", label: "Pixie (EN)" }, + { id: "Reed", label: "Reed (EN)" }, + { id: "Riley", label: "Riley (EN)" }, + { id: "Ronald", label: "Ronald (EN)" }, + { id: "Rupert", label: "Rupert (EN)" }, + { id: "Saanvi", label: "Saanvi (EN)" }, + { id: "Sarah", label: "Sarah (EN)" }, + { id: "Sebastian", label: "Sebastian (EN)" }, + { id: "Selene", label: "Selene (EN)" }, + { id: "Serena", label: "Serena (EN)" }, + { id: "Simon", label: "Simon (EN)" }, + { id: "Snik", label: "Snik (EN)" }, + { id: "Sophie", label: "Sophie (EN)" }, + { id: "Tessa", label: "Tessa (EN)" }, + { id: "Theodore", label: "Theodore (EN)" }, + { id: "Timothy", label: "Timothy (EN)" }, + { id: "Trevor", label: "Trevor (EN)" }, + { id: "Tristan", label: "Tristan (EN)" }, + { id: "Tyler", label: "Tyler (EN)" }, + { id: "Veronica", label: "Veronica (EN)" }, + { id: "Victor", label: "Victor (EN)" }, + { id: "Victoria", label: "Victoria (EN)" }, + { id: "Vinny", label: "Vinny (EN)" }, + { id: "Wendy", label: "Wendy (EN)" }, + { id: "Aanya", label: "Aanya (HI)" }, + { id: "Aarav", label: "Aarav (HI)" }, + { id: "Manoj", label: "Manoj (HI)" }, + { id: "Riya", label: "Riya (HI)" }, + { id: "Alain", label: "Alain (FR)" }, + { id: "Étienne", label: "Étienne (FR)" }, + { id: "Hélène", label: "Hélène (FR)" }, + { id: "Mathieu", label: "Mathieu (FR)" }, + { id: "Asuka", label: "Asuka (JP)" }, + { id: "Haruto", label: "Haruto (JP)" }, + { id: "Hina", label: "Hina (JP)" }, + { id: "Satoshi", label: "Satoshi (JP)" }, + { id: "Beatriz", label: "Beatriz (PT)" }, + { id: "Heitor", label: "Heitor (PT)" }, + { id: "Maitê", label: "Maitê (PT)" }, + { id: "Mariana", label: "Mariana (PT)" }, + { id: "Murilo", label: "Murilo (PT)" }, + { id: "Camila", label: "Camila (ES)" }, + { id: "Diego", label: "Diego (ES)" }, + { id: "Lupita", label: "Lupita (ES)" }, + { id: "Mateo", label: "Mateo (ES)" }, + { id: "Mauricio", label: "Mauricio (ES)" }, + { id: "Miguel", label: "Miguel (ES)" }, + { id: "Rafael", label: "Rafael (ES)" }, + { id: "Sofia", label: "Sofia (ES)" }, + { id: "Dmitry", label: "Dmitry (RU)" }, + { id: "Elena", label: "Elena (RU)" }, + { id: "Nikolai", label: "Nikolai (RU)" }, + { id: "Svetlana", label: "Svetlana (RU)" }, + { id: "Erik", label: "Erik (NL)" }, + { id: "Katrien", label: "Katrien (NL)" }, + { id: "Lennart", label: "Lennart (NL)" }, + { id: "Lore", label: "Lore (NL)" }, + { id: "Gianni", label: "Gianni (IT)" }, + { id: "Orietta", label: "Orietta (IT)" }, + { id: "Hyunwoo", label: "Hyunwoo (KO)" }, + { id: "Minji", label: "Minji (KO)" }, + { id: "Seojun", label: "Seojun (KO)" }, + { id: "Yoona", label: "Yoona (KO)" }, + { id: "Jing", label: "Jing (ZH)" }, + { id: "Mei", label: "Mei (ZH)" }, + { id: "Ming", label: "Ming (ZH)" }, + { id: "Xiaoyin", label: "Xiaoyin (ZH)" }, + { id: "Xinyi", label: "Xinyi (ZH)" }, + { id: "Yichen", label: "Yichen (ZH)" }, + { id: "Johanna", label: "Johanna (DE)" }, + { id: "Josef", label: "Josef (DE)" }, + { id: "Nour", label: "Nour (AR)" }, + { id: "Omar", label: "Omar (AR)" }, + { id: "Oren", label: "Oren (HE)" }, + { id: "Yael", label: "Yael (HE)" }, + { id: "Szymon", label: "Szymon (PL)" }, + { id: "Wojciech", label: "Wojciech (PL)" }, ], "xiaomi-mimo": [ { id: "冰糖", label: "冰糖 (Chinese Female)" }, @@ -188,12 +328,10 @@ const VOICE_PRESETS: Record<string, { id: string; label: string }[]> = { }; const SPEECH_FORMATS = ["mp3", "wav", "opus", "flac", "pcm"]; -const SPEECH_FORMATS_BY_PROVIDER: Record<string, string[]> = { - "xiaomi-mimo": ["mp3", "wav"], -}; function getSpeechFormats(providerId: string): string[] { - return SPEECH_FORMATS_BY_PROVIDER[providerId] || SPEECH_FORMATS; + const providerFormats = AUDIO_SPEECH_PROVIDERS[providerId]?.supportedFormats; + return providerFormats?.length ? providerFormats : SPEECH_FORMATS; } function getVoiceList(providerId: string) { diff --git a/src/app/(dashboard)/dashboard/cloud-agents/page.tsx b/src/app/(dashboard)/dashboard/cloud-agents/page.tsx new file mode 100644 index 0000000000..c86aa56235 --- /dev/null +++ b/src/app/(dashboard)/dashboard/cloud-agents/page.tsx @@ -0,0 +1,558 @@ +"use client"; + +import { useState, useEffect, useCallback } from "react"; +import { Card, Button, Input, Badge } from "@/shared/components"; +import { useTranslations } from "next-intl"; + +interface CloudAgentTask { + id: string; + providerId: string; + status: "queued" | "running" | "awaiting_approval" | "completed" | "failed" | "cancelled"; + prompt: string; + source: { + repoName?: string; + repoUrl?: string; + branch?: string; + }; + createdAt: string; + updatedAt: string; + result?: Record<string, unknown> | null; + error?: string; + activities: Array<{ + id: string; + type: "plan" | "command" | "code_change" | "message" | "error" | "completion"; + content: string; + timestamp: string; + }>; +} + +const CLOUD_AGENTS = [ + { + id: "jules", + name: "Jules", + provider: "Google", + description: "Google's autonomous coding agent", + icon: "🟡", + color: "bg-yellow-500/10 text-yellow-600", + }, + { + id: "devin", + name: "Devin", + provider: "Cognition", + description: "Cognition's AI software engineer", + icon: "🔵", + color: "bg-blue-500/10 text-blue-600", + }, + { + id: "codex-cloud", + name: "Codex Cloud", + provider: "OpenAI", + description: "OpenAI's cloud-based coding agent", + icon: "⚡", + color: "bg-emerald-500/10 text-emerald-600", + }, +]; + +export default function CloudAgentsPage() { + const [tasks, setTasks] = useState<CloudAgentTask[]>([]); + const [loading, setLoading] = useState(true); + const [creating, setCreating] = useState(false); + const [selectedTask, setSelectedTask] = useState<CloudAgentTask | null>(null); + const [newTask, setNewTask] = useState({ + providerId: "jules", + prompt: "", + repoName: "", + repoUrl: "", + branch: "main", + autoCreatePr: true, + }); + const [messageInput, setMessageInput] = useState(""); + const t = useTranslations("cloudAgents"); + + const upsertTask = useCallback((task: CloudAgentTask) => { + setTasks((prev) => { + const exists = prev.some((current) => current.id === task.id); + return exists + ? prev.map((current) => (current.id === task.id ? task : current)) + : [task, ...prev]; + }); + setSelectedTask((current) => (current?.id === task.id ? task : current)); + }, []); + + const fetchTasks = useCallback(async () => { + try { + const res = await fetch("/api/v1/agents/tasks"); + if (res.ok) { + const data = await res.json(); + setTasks(Array.isArray(data.data) ? data.data : []); + } + } catch (err) { + console.error("Failed to fetch tasks:", err); + } finally { + setLoading(false); + } + }, []); + + useEffect(() => { + fetchTasks(); + }, [fetchTasks]); + + const handleCreateTask = async (e: React.FormEvent) => { + e.preventDefault(); + setCreating(true); + try { + const source = { + repoName: newTask.repoName.trim(), + repoUrl: newTask.repoUrl.trim(), + ...(newTask.branch.trim() ? { branch: newTask.branch.trim() } : {}), + }; + const res = await fetch("/api/v1/agents/tasks", { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + providerId: newTask.providerId, + prompt: newTask.prompt, + source, + options: { + autoCreatePr: newTask.autoCreatePr, + }, + }), + }); + if (res.ok) { + const data = await res.json(); + if (data.data) upsertTask(data.data); + setNewTask({ + providerId: "jules", + prompt: "", + repoName: "", + repoUrl: "", + branch: "main", + autoCreatePr: true, + }); + } + } catch (err) { + console.error("Failed to create task:", err); + } finally { + setCreating(false); + } + }; + + const handleSendMessage = async () => { + if (!selectedTask || !messageInput.trim()) return; + try { + const res = await fetch(`/api/v1/agents/tasks/${selectedTask.id}`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + action: "message", + message: messageInput, + }), + }); + if (res.ok) { + const data = await res.json(); + if (data.data) upsertTask(data.data); + setMessageInput(""); + } + } catch (err) { + console.error("Failed to send message:", err); + } + }; + + const handleApprovePlan = async () => { + if (!selectedTask) return; + try { + const res = await fetch(`/api/v1/agents/tasks/${selectedTask.id}`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ action: "approve" }), + }); + if (res.ok) { + const data = await res.json(); + if (data.data) upsertTask(data.data); + } + } catch (err) { + console.error("Failed to approve plan:", err); + } + }; + + const handleCancelTask = async (taskId: string) => { + try { + const res = await fetch(`/api/v1/agents/tasks/${taskId}`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ action: "cancel" }), + }); + if (res.ok) { + const data = await res.json(); + if (data.data) upsertTask(data.data); + } + } catch (err) { + console.error("Failed to cancel task:", err); + } + }; + + const handleDeleteTask = async (taskId: string) => { + try { + const res = await fetch(`/api/v1/agents/tasks/${taskId}`, { + method: "DELETE", + }); + if (res.ok) { + setTasks((prev) => prev.filter((t) => t.id !== taskId)); + if (selectedTask?.id === taskId) { + setSelectedTask(null); + } + } + } catch (err) { + console.error("Failed to delete task:", err); + } + }; + + const getStatusBadge = (status: string) => { + const statusMap: Record<string, { color: string; label: string }> = { + queued: { color: "bg-zinc-500/10 text-zinc-500", label: t("statusPending") }, + running: { color: "bg-blue-500/10 text-blue-500", label: t("statusRunning") }, + awaiting_approval: { + color: "bg-amber-500/10 text-amber-600", + label: t("statusWaitingApproval"), + }, + completed: { color: "bg-emerald-500/10 text-emerald-600", label: t("statusCompleted") }, + failed: { color: "bg-red-500/10 text-red-500", label: t("statusFailed") }, + cancelled: { color: "bg-zinc-500/10 text-zinc-400", label: t("statusCancelled") }, + }; + const s = statusMap[status] || statusMap.queued; + return ( + <span + className={`inline-flex items-center gap-1 text-xs px-2 py-0.5 rounded-full font-medium ${s.color}`} + > + {status === "running" && <span className="animate-pulse">●</span>} + {s.label} + </span> + ); + }; + + const getAgentInfo = (providerId: string) => { + return CLOUD_AGENTS.find((a) => a.id === providerId) || CLOUD_AGENTS[0]; + }; + + const getPlanText = (task: CloudAgentTask) => { + return task.activities.find((activity) => activity.type === "plan")?.content || ""; + }; + + const formatResult = (result: CloudAgentTask["result"]) => { + if (!result) return ""; + if (typeof result === "string") return result; + return JSON.stringify(result, null, 2); + }; + + if (loading) { + return ( + <div className="flex flex-col items-center justify-center min-h-[400px] gap-3"> + <div className="animate-spin rounded-full h-8 w-8 border-2 border-primary border-t-transparent" /> + <p className="text-sm text-text-muted">{t("loading")}</p> + </div> + ); + } + + return ( + <div className="flex flex-col gap-6 p-6 max-w-6xl mx-auto"> + <div className="flex items-center justify-between"> + <div> + <h1 className="text-2xl font-bold">{t("title")}</h1> + <p className="text-text-muted mt-1">{t("description")}</p> + </div> + </div> + + <Card className="border-purple-500/20 bg-purple-500/5"> + <div className="flex flex-col gap-4"> + <div className="flex items-start justify-between gap-4 flex-wrap"> + <div> + <h2 className="text-sm font-semibold text-text-main">{t("aboutTitle")}</h2> + <p className="text-sm text-text-muted mt-1">{t("aboutDescription")}</p> + </div> + </div> + <div className="grid grid-cols-1 md:grid-cols-3 gap-3"> + {CLOUD_AGENTS.map((agent) => ( + <div + key={agent.id} + className="rounded-lg border border-purple-500/15 bg-purple-500/5 p-3" + > + <div className="flex items-center gap-2 mb-1"> + <span className="text-lg">{agent.icon}</span> + <p className="text-sm font-medium text-text-main">{agent.name}</p> + </div> + <p className="text-xs text-text-muted">{agent.description}</p> + <p className="text-[10px] text-purple-500 mt-1">{agent.provider}</p> + </div> + ))} + </div> + <div className="rounded-lg border border-purple-500/15 bg-surface/40 p-3 text-sm text-text-muted"> + <span className="font-medium text-text-main">{t("howItWorksTitle")}</span> + <span className="ml-1">{t("howItWorksDesc")}</span> + </div> + </div> + </Card> + + <Card> + <div className="flex items-center gap-3 mb-4"> + <div className="p-2 rounded-lg bg-purple-500/10 text-purple-500"> + <span className="material-symbols-outlined text-[20px]">add_task</span> + </div> + <div> + <h3 className="text-lg font-semibold">{t("newTaskTitle")}</h3> + <p className="text-sm text-text-muted">{t("newTaskDescription")}</p> + </div> + </div> + <form onSubmit={handleCreateTask} className="flex flex-col gap-4"> + <div className="grid grid-cols-1 md:grid-cols-2 gap-4"> + <div> + <label className="text-xs font-medium text-text-muted mb-1.5 block"> + {t("selectAgent")} + </label> + <select + value={newTask.providerId} + onChange={(e) => setNewTask({ ...newTask, providerId: e.target.value })} + className="w-full rounded-lg border border-border/50 bg-card px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-primary/50" + > + {CLOUD_AGENTS.map((agent) => ( + <option key={agent.id} value={agent.id}> + {agent.name} ({agent.provider}) + </option> + ))} + </select> + </div> + </div> + <div> + <label className="text-xs font-medium text-text-muted mb-1.5 block"> + {t("taskDescription")} + </label> + <textarea + placeholder={t("taskDescriptionPlaceholder")} + value={newTask.prompt} + onChange={(e) => setNewTask({ ...newTask, prompt: e.target.value })} + className="min-h-24 w-full rounded-lg border border-border/50 bg-card px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-primary/50" + required + /> + </div> + <div className="grid grid-cols-1 md:grid-cols-2 gap-4"> + <Input + label="Repository name" + placeholder="omniroute" + value={newTask.repoName} + onChange={(e) => setNewTask({ ...newTask, repoName: e.target.value })} + required + /> + <Input + label="Repository URL" + placeholder="https://github.com/owner/repo" + value={newTask.repoUrl} + onChange={(e) => setNewTask({ ...newTask, repoUrl: e.target.value })} + required + /> + </div> + <div className="grid grid-cols-1 md:grid-cols-2 gap-4"> + <Input + label="Branch" + placeholder="main" + value={newTask.branch} + onChange={(e) => setNewTask({ ...newTask, branch: e.target.value })} + /> + <label className="flex items-center gap-2 text-sm text-text-muted pt-7"> + <input + type="checkbox" + checked={newTask.autoCreatePr} + onChange={(e) => setNewTask({ ...newTask, autoCreatePr: e.target.checked })} + className="h-4 w-4 rounded border-border/60" + /> + Auto-create PR + </label> + </div> + <div className="flex justify-end"> + <Button type="submit" variant="primary" loading={creating}> + <span className="material-symbols-outlined text-[16px] mr-1">rocket_launch</span> + {t("startTask")} + </Button> + </div> + </form> + </Card> + + <div className="grid grid-cols-1 lg:grid-cols-2 gap-6"> + <div className="flex flex-col gap-3"> + <h2 className="text-lg font-semibold">{t("tasks")}</h2> + {tasks.length === 0 ? ( + <div className="text-center py-8 text-text-muted"> + <span className="material-symbols-outlined text-[40px] mb-2">assignment</span> + <p>{t("noTasks")}</p> + </div> + ) : ( + tasks.map((task) => { + const agent = getAgentInfo(task.providerId); + return ( + <Card + key={task.id} + className={`cursor-pointer transition-all hover:border-primary/30 ${ + selectedTask?.id === task.id ? "border-primary ring-1 ring-primary/20" : "" + }`} + onClick={() => setSelectedTask(task)} + > + <div className="flex items-start justify-between gap-2"> + <div className="flex items-center gap-2"> + <span className="text-lg">{agent.icon}</span> + <div> + <p className="text-sm font-medium text-text-main line-clamp-1"> + {task.prompt || t("untitledTask")} + </p> + <p className="text-xs text-text-muted"> + {agent.name} • {new Date(task.createdAt).toLocaleString()} + </p> + </div> + </div> + {getStatusBadge(task.status)} + </div> + </Card> + ); + }) + )} + </div> + + <div className="flex flex-col gap-3"> + <h2 className="text-lg font-semibold">{t("taskDetail")}</h2> + {selectedTask ? ( + <Card className="flex flex-col gap-4"> + <div className="flex items-center justify-between"> + <div className="flex items-center gap-2"> + <span className="text-lg">{getAgentInfo(selectedTask.providerId).icon}</span> + <div> + <p className="font-medium">{getAgentInfo(selectedTask.providerId).name}</p> + <p className="text-xs text-text-muted"> + {t("created")}: {new Date(selectedTask.createdAt).toLocaleString()} + </p> + </div> + </div> + {getStatusBadge(selectedTask.status)} + </div> + + {selectedTask.status === "awaiting_approval" && getPlanText(selectedTask) && ( + <div className="rounded-lg border border-amber-500/20 bg-amber-500/5 p-3"> + <div className="flex items-center gap-2 mb-2"> + <span className="material-symbols-outlined text-[16px] text-amber-600"> + description + </span> + <span className="text-sm font-medium text-amber-700 dark:text-amber-400"> + {t("planReady")} + </span> + </div> + <pre className="text-xs text-text-muted whitespace-pre-wrap bg-black/5 dark:bg-white/5 rounded p-2 max-h-32 overflow-auto"> + {getPlanText(selectedTask)} + </pre> + <div className="flex gap-2 mt-2"> + <Button variant="primary" size="sm" onClick={handleApprovePlan}> + <span className="material-symbols-outlined text-[14px] mr-1">check</span> + {t("approvePlan")} + </Button> + <Button + variant="secondary" + size="sm" + onClick={() => handleCancelTask(selectedTask.id)} + > + {t("rejectPlan")} + </Button> + </div> + </div> + )} + + {selectedTask.activities.length > 0 && ( + <div className="flex flex-col gap-2"> + <p className="text-sm font-medium">{t("conversation")}</p> + <div className="flex flex-col gap-2 max-h-64 overflow-auto"> + {selectedTask.activities.map((activity) => ( + <div + key={activity.id} + className={`p-2 rounded-lg text-xs ${ + activity.type === "message" || activity.type === "completion" + ? "bg-purple-500/10 text-text-main" + : "bg-surface/40 text-text-main" + }`} + > + <span className="font-medium capitalize">{activity.type}: </span> + {activity.content} + </div> + ))} + </div> + </div> + )} + + {selectedTask.result && ( + <div className="rounded-lg border border-emerald-500/20 bg-emerald-500/5 p-3"> + <div className="flex items-center gap-2 mb-2"> + <span className="material-symbols-outlined text-[16px] text-emerald-600"> + check_circle + </span> + <span className="text-sm font-medium text-emerald-700 dark:text-emerald-400"> + {t("result")} + </span> + </div> + <pre className="text-xs text-text-muted whitespace-pre-wrap"> + {formatResult(selectedTask.result)} + </pre> + </div> + )} + + {selectedTask.error && ( + <div className="rounded-lg border border-red-500/20 bg-red-500/5 p-3"> + <div className="flex items-center gap-2 mb-2"> + <span className="material-symbols-outlined text-[16px] text-red-500"> + error + </span> + <span className="text-sm font-medium text-red-600">{t("error")}</span> + </div> + <p className="text-xs text-text-muted">{selectedTask.error}</p> + </div> + )} + + {selectedTask.status === "running" && ( + <div className="flex gap-2"> + <Input + placeholder={t("sendMessagePlaceholder")} + value={messageInput} + onChange={(e) => setMessageInput(e.target.value)} + onKeyDown={(e) => e.key === "Enter" && !e.shiftKey && handleSendMessage()} + className="flex-1" + /> + <Button variant="primary" onClick={handleSendMessage}> + <span className="material-symbols-outlined text-[16px]">send</span> + </Button> + </div> + )} + + <div className="flex justify-between pt-3 border-t border-border/30"> + <Button + variant="ghost" + size="sm" + onClick={() => handleCancelTask(selectedTask.id)} + disabled={["completed", "failed", "cancelled"].includes(selectedTask.status)} + > + <span className="material-symbols-outlined text-[14px] mr-1">cancel</span> + {t("cancel")} + </Button> + <Button + variant="ghost" + size="sm" + onClick={() => handleDeleteTask(selectedTask.id)} + className="text-red-500 hover:text-red-400" + > + <span className="material-symbols-outlined text-[14px] mr-1">delete</span> + {t("delete")} + </Button> + </div> + </Card> + ) : ( + <div className="text-center py-8 text-text-muted border border-dashed border-border/50 rounded-lg"> + <span className="material-symbols-outlined text-[40px] mb-2">touch_app</span> + <p>{t("selectTaskPrompt")}</p> + </div> + )} + </div> + </div> + </div> + ); +} diff --git a/src/app/(dashboard)/dashboard/combos/BuilderIntelligentStep.tsx b/src/app/(dashboard)/dashboard/combos/BuilderIntelligentStep.tsx index 3dabb89695..087aba2fbd 100644 --- a/src/app/(dashboard)/dashboard/combos/BuilderIntelligentStep.tsx +++ b/src/app/(dashboard)/dashboard/combos/BuilderIntelligentStep.tsx @@ -15,7 +15,7 @@ function getI18nOrFallback(t: any, key: string, fallback: string) { return fallback; } -function toProviderOptions(activeProviders: any[] = []) { +function toProviderOptions(activeProviders: any[] = [], candidatePool: string[] = []) { const uniqueProviders = new Map<string, { id: string; label: string; connectionCount: number }>(); activeProviders.forEach((provider) => { @@ -41,6 +41,16 @@ function toProviderOptions(activeProviders: any[] = []) { }); }); + candidatePool.forEach((poolId) => { + if (!uniqueProviders.has(poolId)) { + uniqueProviders.set(poolId, { + id: poolId, + label: `${poolId} (Offline/Deleted)`, + connectionCount: 0, + }); + } + }); + return [...uniqueProviders.values()].sort((a, b) => a.label.localeCompare(b.label)); } @@ -56,7 +66,10 @@ export default function BuilderIntelligentStep({ activeProviders: any[]; }) { const normalizedConfig = normalizeIntelligentRoutingConfig(config); - const providerOptions = useMemo(() => toProviderOptions(activeProviders), [activeProviders]); + const providerOptions = useMemo( + () => toProviderOptions(activeProviders, normalizedConfig.candidatePool), + [activeProviders, normalizedConfig.candidatePool] + ); const updateConfig = (patch: Record<string, unknown>) => { onChange({ @@ -64,7 +77,7 @@ export default function BuilderIntelligentStep({ ...patch, weights: { ...normalizedConfig.weights, - ...(patch.weights || {}), + ...((patch.weights as Record<string, number>) || {}), }, }); }; diff --git a/src/app/(dashboard)/dashboard/endpoint/EndpointPageClient.tsx b/src/app/(dashboard)/dashboard/endpoint/EndpointPageClient.tsx index 1617811a12..7e047d1f52 100644 --- a/src/app/(dashboard)/dashboard/endpoint/EndpointPageClient.tsx +++ b/src/app/(dashboard)/dashboard/endpoint/EndpointPageClient.tsx @@ -6,6 +6,7 @@ import { Card, Button, Input, Modal, CardSkeleton, SegmentedControl } from "@/sh import { useCopyToClipboard } from "@/shared/hooks/useCopyToClipboard"; import { useDisplayBaseUrl } from "@/shared/hooks"; import { AI_PROVIDERS, getProviderByAlias } from "@/shared/constants/providers"; +import { getProviderDisplayName } from "@/lib/display/names"; import { useTranslations } from "next-intl"; const BUILD_TIME_CLOUD_URL = process.env.NEXT_PUBLIC_CLOUD_URL || null; @@ -2482,7 +2483,7 @@ function EndpointSection({ const resolveProvider = (id) => AI_PROVIDERS[id] || getProviderByAlias(id); const providerColor = (id) => resolveProvider(id)?.color || "#888"; - const providerName = (id) => resolveProvider(id)?.name || id; + const providerName = (id) => getProviderDisplayName(id, resolveProvider(id)); const copyId = `endpoint_${path}`; return ( diff --git a/src/app/(dashboard)/dashboard/health/page.tsx b/src/app/(dashboard)/dashboard/health/page.tsx index da02692bc1..8d1265b390 100644 --- a/src/app/(dashboard)/dashboard/health/page.tsx +++ b/src/app/(dashboard)/dashboard/health/page.tsx @@ -15,6 +15,7 @@ import { useState, useEffect, useCallback } from "react"; import { Card } from "@/shared/components"; import { AI_PROVIDERS } from "@/shared/constants/providers"; +import { getProviderDisplayName } from "@/lib/display/names"; import { useTranslations } from "next-intl"; import TelemetryCard from "./TelemetryCard"; @@ -762,7 +763,7 @@ export default function HealthPage() { {unhealthy.map(([provider, cb]: [string, any]) => { const style = CB_STYLES[cb.state] || CB_STYLES.OPEN; const providerInfo = AI_PROVIDERS[provider]; - const displayName = providerInfo?.name || provider; + const displayName = getProviderDisplayName(provider, providerInfo); return ( <div key={provider} @@ -820,7 +821,7 @@ export default function HealthPage() { <div className="grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 gap-2"> {healthy.map(([provider]) => { const providerInfo = AI_PROVIDERS[provider]; - const displayName = providerInfo?.name || provider; + const displayName = getProviderDisplayName(provider, providerInfo); return ( <div key={provider} @@ -873,7 +874,7 @@ export default function HealthPage() { if (customName.length > 12) displayName += ` (${customName.slice(0, 8)}…)`; else if (customName) displayName += ` (${customName})`; } else { - displayName = providerInfo?.name || providerId; + displayName = getProviderDisplayName(providerId, providerInfo); } return { providerId, displayName, providerInfo, connectionId, model }; diff --git a/src/app/(dashboard)/dashboard/providers/[id]/page.tsx b/src/app/(dashboard)/dashboard/providers/[id]/page.tsx index e1e4300c90..063183b372 100644 --- a/src/app/(dashboard)/dashboard/providers/[id]/page.tsx +++ b/src/app/(dashboard)/dashboard/providers/[id]/page.tsx @@ -27,6 +27,7 @@ import { isAnthropicCompatibleProvider, isClaudeCodeCompatibleProvider, isSelfHostedChatProvider, + providerAllowsOptionalApiKey, supportsApiKeyOnFreeProvider, } from "@/shared/constants/providers"; import { getModelsByProviderId } from "@/shared/constants/models"; @@ -509,6 +510,7 @@ interface ConnectionRowConnection { expiresAt?: string; tokenExpiresAt?: string; maxConcurrent?: number | null; + authType?: string; } interface ConnectionRowProps { @@ -555,6 +557,9 @@ interface AddApiKeyModalProps { isCompatible?: boolean; isAnthropic?: boolean; isCcCompatible?: boolean; + isCommandCode?: boolean; + commandCodeAuthState?: CommandCodeAuthFlowState; + onStartCommandCodeAuth?: () => void; onSave: (data: { name: string; apiKey?: string; @@ -565,6 +570,23 @@ interface AddApiKeyModalProps { onClose: () => void; } +type CommandCodeAuthFlowState = { + phase: + | "idle" + | "starting" + | "polling" + | "received" + | "applying" + | "applied" + | "expired" + | "error"; + state: string; + authUrl: string; + callbackUrl: string; + expiresAt: string | null; + message?: string; +}; + interface EditConnectionModalConnection { id?: string; name?: string; @@ -575,6 +597,7 @@ interface EditConnectionModalConnection { provider?: string; providerSpecificData?: Record<string, unknown>; healthCheckInterval?: number; + projectId?: string | null; } interface EditConnectionModalProps { @@ -980,6 +1003,14 @@ export default function ProviderDetailPage() { const [showOAuthModal, _setShowOAuthModal] = useState(false); const [reauthConnection, setReauthConnection] = useState<ConnectionRowConnection | null>(null); const [showAddApiKeyModal, setShowAddApiKeyModal] = useState(false); + const [commandCodeAuthState, setCommandCodeAuthState] = useState<CommandCodeAuthFlowState>({ + phase: "idle", + state: "", + authUrl: "", + callbackUrl: "", + expiresAt: null, + message: "", + }); const [showEditModal, setShowEditModal] = useState(false); const [showEditNodeModal, setShowEditNodeModal] = useState(false); const [selectedConnection, setSelectedConnection] = useState(null); @@ -1026,8 +1057,11 @@ export default function ProviderDetailPage() { const [savingCodexGlobalFastServiceTier, setSavingCodexGlobalFastServiceTier] = useState(false); const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set()); const [batchDeleting, setBatchDeleting] = useState(false); + const commandCodeAuthWindowRef = useRef<Window | null>(null); + const commandCodeAuthTimerRef = useRef<number | null>(null); const isOpenAICompatible = isOpenAICompatibleProvider(providerId); const isCcCompatible = isClaudeCodeCompatibleProvider(providerId); + const isCommandCode = providerId === "command-code"; const isAnthropicCompatible = isAnthropicCompatibleProvider(providerId) && !isClaudeCodeCompatibleProvider(providerId); const isCompatible = isOpenAICompatible || isAnthropicCompatible || isCcCompatible; @@ -1435,6 +1469,257 @@ export default function ProviderDetailPage() { setShowAddApiKeyModal(true); }, [isOAuth]); + const clearCommandCodeAuthTimer = useCallback(() => { + if (commandCodeAuthTimerRef.current !== null) { + window.clearTimeout(commandCodeAuthTimerRef.current); + commandCodeAuthTimerRef.current = null; + } + }, []); + + useEffect(() => { + return () => { + clearCommandCodeAuthTimer(); + commandCodeAuthWindowRef.current?.close?.(); + }; + }, [clearCommandCodeAuthTimer]); + + const handleCloseAddApiKeyModal = useCallback(() => { + clearCommandCodeAuthTimer(); + commandCodeAuthWindowRef.current?.close?.(); + commandCodeAuthWindowRef.current = null; + setCommandCodeAuthState({ + phase: "idle", + state: "", + authUrl: "", + callbackUrl: "", + expiresAt: null, + message: "", + }); + setShowAddApiKeyModal(false); + }, [clearCommandCodeAuthTimer]); + + const handleCommandCodeAuthApply = useCallback( + async (state: string, connectionId?: string, name?: string, setDefault?: boolean) => { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "applying", + message: "Applying browser-approved key…", + })); + + try { + const res = await fetch("/api/providers/command-code/auth/apply", { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ state, connectionId, name, setDefault }), + }); + const data = await res.json().catch(() => ({})); + + if (!res.ok) { + const errorMessage = data.error || "Failed to apply Command Code auth"; + setCommandCodeAuthState((current) => ({ + ...current, + phase: "error", + message: errorMessage, + })); + notify.error(errorMessage); + return false; + } + + setCommandCodeAuthState((current) => ({ + ...current, + phase: "applied", + message: "Command Code connected", + })); + commandCodeAuthWindowRef.current?.close?.(); + commandCodeAuthWindowRef.current = null; + await fetchConnections(); + handleCloseAddApiKeyModal(); + notify.success("Command Code connection added"); + return true; + } catch (error) { + console.error("Error applying Command Code auth:", error); + setCommandCodeAuthState((current) => ({ + ...current, + phase: "error", + message: "Failed to apply Command Code auth", + })); + notify.error("Failed to apply Command Code auth"); + return false; + } + }, + [fetchConnections, handleCloseAddApiKeyModal, notify] + ); + + const handleStartCommandCodeAuth = useCallback(async () => { + if (commandCodeAuthState.phase === "starting" || commandCodeAuthState.phase === "polling") { + return; + } + + clearCommandCodeAuthTimer(); + commandCodeAuthWindowRef.current?.close?.(); + + const popup = window.open("about:blank", "_blank"); + setCommandCodeAuthState({ + phase: "starting", + state: "", + authUrl: "", + callbackUrl: "", + expiresAt: null, + message: "Opening Command Code Studio…", + }); + + try { + const res = await fetch("/api/providers/command-code/auth/start", { + method: "POST", + headers: { "Content-Type": "application/json" }, + }); + const data = await res.json().catch(() => ({})); + + if (!res.ok || !data.state || !data.authUrl) { + const errorMessage = data.error || "Failed to start Command Code auth"; + setCommandCodeAuthState((current) => ({ + ...current, + phase: "error", + message: errorMessage, + })); + notify.error(errorMessage); + popup?.close?.(); + return; + } + + setCommandCodeAuthState({ + phase: "polling", + state: data.state, + authUrl: data.authUrl, + callbackUrl: data.callbackUrl || "", + expiresAt: data.expiresAt || null, + message: "Open the auth URL, approve access, then paste the returned key/JSON/URL below…", + }); + + if (popup) { + try { + popup.opener = null; + } catch { + // Ignore opener cleanup failures. + } + popup.location.href = data.authUrl; + commandCodeAuthWindowRef.current = popup; + } else { + const fallbackPopup = window.open(data.authUrl, "_blank", "noopener,noreferrer"); + if (!fallbackPopup) { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "error", + message: "Popup blocked. Please allow popups and try Command Code Connect again.", + })); + notify.error("Popup blocked. Please allow popups and try Command Code Connect again."); + return; + } + commandCodeAuthWindowRef.current = fallbackPopup; + } + + const deadline = data.expiresAt ? new Date(data.expiresAt).getTime() : Date.now() + 180000; + const poll = async () => { + if (Date.now() >= deadline) { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "expired", + message: "Command Code link expired", + })); + commandCodeAuthWindowRef.current?.close?.(); + commandCodeAuthWindowRef.current = null; + notify.error("Command Code auth expired"); + clearCommandCodeAuthTimer(); + return; + } + + try { + const statusRes = await fetch( + `/api/providers/command-code/auth/status?state=${encodeURIComponent(data.state)}`, + { method: "GET", cache: "no-store" } + ); + const statusData = await statusRes.json().catch(() => ({})); + const status = String(statusData.status || statusData.state || statusData.phase || "") + .toLowerCase() + .trim(); + + if (status === "expired") { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "expired", + message: "Command Code link expired", + })); + commandCodeAuthWindowRef.current?.close?.(); + commandCodeAuthWindowRef.current = null; + notify.error("Command Code auth expired"); + clearCommandCodeAuthTimer(); + return; + } + + if (status === "applied") { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "applied", + message: "Command Code connected", + })); + commandCodeAuthWindowRef.current?.close?.(); + commandCodeAuthWindowRef.current = null; + await fetchConnections(); + handleCloseAddApiKeyModal(); + notify.success("Command Code connection added"); + clearCommandCodeAuthTimer(); + return; + } + + if (status === "received") { + setCommandCodeAuthState((current) => ({ + ...current, + phase: "received", + message: "Browser approved, applying…", + })); + clearCommandCodeAuthTimer(); + await handleCommandCodeAuthApply( + data.state, + statusData.connectionId, + statusData.name, + statusData.setDefault + ); + return; + } + } catch { + // Keep polling until the contract reports a terminal state or timeout. + } + + commandCodeAuthTimerRef.current = window.setTimeout(poll, 2000); + }; + + commandCodeAuthTimerRef.current = window.setTimeout(poll, 1000); + } catch (error) { + console.error("Error starting Command Code auth:", error); + setCommandCodeAuthState((current) => ({ + ...current, + phase: "error", + message: "Failed to start Command Code auth", + })); + notify.error("Failed to start Command Code auth"); + popup?.close?.(); + commandCodeAuthWindowRef.current = null; + clearCommandCodeAuthTimer(); + } + }, [ + clearCommandCodeAuthTimer, + handleCloseAddApiKeyModal, + commandCodeAuthState.phase, + fetchConnections, + handleCommandCodeAuthApply, + notify, + ]); + + const handleOpenCommandCodeConnect = useCallback(() => { + setShowAddApiKeyModal(true); + void handleStartCommandCodeAuth(); + }, [handleStartCommandCodeAuth]); + const handleSaveApiKey = async (formData) => { try { const res = await fetch("/api/providers", { @@ -1629,9 +1914,7 @@ export default function ProviderDetailPage() { : connection ) ); - notify.success( - enabled ? "Claude extra-usage blocking enabled" : "Claude extra-usage blocking disabled" - ); + notify.success(enabled ? "Claude extra-usage blocked" : "Claude extra-usage allowed"); } catch (error) { console.error("Error toggling Claude extra-usage policy:", error); notify.error("Failed to update Claude extra-usage policy"); @@ -2951,13 +3234,44 @@ export default function ProviderDetailPage() { )} {!isCompatible ? ( <> - <Button size="sm" icon="add" onClick={openPrimaryAddFlow}> - {providerSupportsPat ? "Add PAT" : t("add")} - </Button> - {providerId === "qoder" && ( - <Button size="sm" variant="secondary" onClick={() => setShowOAuthModal(true)}> - Experimental OAuth - </Button> + {isCommandCode ? ( + <> + <Button + size="sm" + icon="open_in_new" + loading={ + commandCodeAuthState.phase === "starting" || + commandCodeAuthState.phase === "polling" || + commandCodeAuthState.phase === "applying" + } + onClick={handleOpenCommandCodeConnect} + > + Connect + </Button> + <Button + size="sm" + variant="secondary" + icon="add" + onClick={() => setShowAddApiKeyModal(true)} + > + Manual API key + </Button> + </> + ) : ( + <> + <Button size="sm" icon="add" onClick={openPrimaryAddFlow}> + {providerSupportsPat ? "Add PAT" : t("add")} + </Button> + {providerId === "qoder" && ( + <Button + size="sm" + variant="secondary" + onClick={() => setShowOAuthModal(true)} + > + Experimental OAuth + </Button> + )} + </> )} </> ) : ( @@ -2981,13 +3295,38 @@ export default function ProviderDetailPage() { <p className="text-sm text-text-muted mb-4">{t("addFirstConnectionHint")}</p> {!isCompatible && ( <div className="flex items-center justify-center gap-2"> - <Button icon="add" onClick={openPrimaryAddFlow}> - {providerSupportsPat ? "Add PAT" : t("addConnection")} - </Button> - {providerId === "qoder" && ( - <Button variant="secondary" onClick={() => setShowOAuthModal(true)}> - Experimental OAuth - </Button> + {isCommandCode ? ( + <> + <Button + icon="open_in_new" + loading={ + commandCodeAuthState.phase === "starting" || + commandCodeAuthState.phase === "polling" || + commandCodeAuthState.phase === "applying" + } + onClick={handleOpenCommandCodeConnect} + > + Connect + </Button> + <Button + variant="secondary" + icon="add" + onClick={() => setShowAddApiKeyModal(true)} + > + Manual API key + </Button> + </> + ) : ( + <> + <Button icon="add" onClick={openPrimaryAddFlow}> + {providerSupportsPat ? "Add PAT" : t("addConnection")} + </Button> + {providerId === "qoder" && ( + <Button variant="secondary" onClick={() => setShowOAuthModal(true)}> + Experimental OAuth + </Button> + )} + </> )} </div> )} @@ -3024,7 +3363,7 @@ export default function ProviderDetailPage() { {selectedIds.size > 0 && ( <Button - variant="destructive" + variant="danger" size="sm" icon="delete" loading={batchDeleting} @@ -3154,7 +3493,7 @@ export default function ProviderDetailPage() { {selectedIds.size > 0 && ( <Button - variant="destructive" + variant="danger" size="sm" icon="delete" loading={batchDeleting} @@ -3410,8 +3749,11 @@ export default function ProviderDetailPage() { isCompatible={isCompatible} isAnthropic={isAnthropicProtocolCompatible} isCcCompatible={isCcCompatible} + isCommandCode={isCommandCode} + commandCodeAuthState={commandCodeAuthState} + onStartCommandCodeAuth={handleStartCommandCodeAuth} onSave={handleSaveApiKey} - onClose={() => setShowAddApiKeyModal(false)} + onClose={handleCloseAddApiKeyModal} /> )} {!isUpstreamProxyProvider && ( @@ -5376,7 +5718,7 @@ function ConnectionRow({ <button onClick={() => onToggleClaudeExtraUsage?.(!claudeBlockExtraUsageEnabled)} className={`inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-xs font-medium transition-all cursor-pointer ${ - claudeBlockExtraUsageEnabled + !claudeBlockExtraUsageEnabled ? "bg-amber-500/15 text-amber-500 hover:bg-amber-500/25" : "bg-black/[0.03] dark:bg-white/[0.03] text-text-muted/50 hover:text-text-muted hover:bg-black/[0.06] dark:hover:bg-white/[0.06]" }`} @@ -5384,7 +5726,7 @@ function ConnectionRow({ > <span className="material-symbols-outlined text-[13px]">payments</span> {t("claudeExtraUsageShort")}{" "} - {claudeBlockExtraUsageEnabled ? t("toggleOnShort") : t("toggleOffShort")} + {!claudeBlockExtraUsageEnabled ? t("toggleOnShort") : t("toggleOffShort")} </button> </> )} @@ -5581,6 +5923,7 @@ function ConnectionRow({ const CONFIGURABLE_BASE_URL_PROVIDERS = new Set([ "azure-openai", + "azure-ai", "bailian-coding-plan", "xiaomi-mimo", "heroku", @@ -5592,6 +5935,7 @@ const CONFIGURABLE_BASE_URL_PROVIDERS = new Set([ const DEFAULT_PROVIDER_BASE_URLS: Record<string, string> = { "azure-openai": "https://example-resource.openai.azure.com", + "azure-ai": "https://example-resource.services.ai.azure.com/openai/v1", "bailian-coding-plan": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1", "xiaomi-mimo": "https://token-plan-sgp.xiaomimimo.com/v1", "searxng-search": "http://localhost:8888/search", @@ -5716,6 +6060,52 @@ function formatExcludedModelsInput(value: unknown): string { .join(", "); } +function extractCommandCodeCredentialInput(value: string): string { + const trimmed = value.trim(); + if (!trimmed) return ""; + + try { + const parsed = JSON.parse(trimmed) as unknown; + if (parsed && typeof parsed === "object") { + const record = parsed as Record<string, unknown>; + const direct = record.apiKey || record.api_key || record.key || record.token; + if (typeof direct === "string" && direct.trim()) return direct.trim(); + const nested = record.data; + if (nested && typeof nested === "object") { + const nestedRecord = nested as Record<string, unknown>; + const nestedKey = nestedRecord.apiKey || nestedRecord.api_key || nestedRecord.key; + if (typeof nestedKey === "string" && nestedKey.trim()) return nestedKey.trim(); + } + } + } catch { + // Not JSON; continue with URL/raw parsing. + } + + try { + const url = new URL(trimmed); + const key = + url.searchParams.get("apiKey") || + url.searchParams.get("api_key") || + url.searchParams.get("key") || + url.searchParams.get("token"); + if (key?.trim()) return key.trim(); + const hash = url.hash.replace(/^#/, ""); + if (hash) { + const hashParams = new URLSearchParams(hash); + const hashKey = + hashParams.get("apiKey") || + hashParams.get("api_key") || + hashParams.get("key") || + hashParams.get("token"); + if (hashKey?.trim()) return hashKey.trim(); + } + } catch { + // Not a URL; use the raw value. + } + + return trimmed; +} + function AddApiKeyModal({ isOpen, provider, @@ -5723,6 +6113,9 @@ function AddApiKeyModal({ isCompatible, isAnthropic, isCcCompatible, + isCommandCode, + commandCodeAuthState, + onStartCommandCodeAuth, onSave, onClose, }: AddApiKeyModalProps) { @@ -5736,15 +6129,25 @@ function AddApiKeyModal({ const isCloudflare = provider === "cloudflare-ai"; const localProviderMetadata = getLocalProviderMetadata(provider); const isLocalSelfHostedProvider = !!localProviderMetadata; - const isSearxng = provider === "searxng-search"; const isGooglePse = provider === "google-pse-search"; const isGrokWeb = provider === "grok-web"; const isPerplexityWeb = provider === "perplexity-web"; const isBlackboxWeb = provider === "blackbox-web"; const isMuseSparkWeb = provider === "muse-spark-web"; const isWebSessionProvider = isGrokWeb || isPerplexityWeb || isBlackboxWeb || isMuseSparkWeb; - const isPetals = provider === "petals"; - const apiKeyOptional = isSearxng || isPetals || isLocalSelfHostedProvider; + const apiKeyOptional = providerAllowsOptionalApiKey(provider); + const commandCodeAuthPhaseLabel = commandCodeAuthState + ? { + idle: "Ready", + starting: "Starting…", + polling: "Waiting for browser…", + received: "Browser approved", + applying: "Applying key…", + applied: "Connected", + expired: "Link expired", + error: "Connection failed", + }[commandCodeAuthState.phase] + : null; const [formData, setFormData] = useState({ name: "", @@ -5768,6 +6171,7 @@ function AddApiKeyModal({ const [saving, setSaving] = useState(false); const [saveError, setSaveError] = useState<string | null>(null); const [showAdvanced, setShowAdvanced] = useState(false); + const [copiedCommandCodeField, setCopiedCommandCodeField] = useState<string | null>(null); const apiCredentialLabel = isQoder ? t("personalAccessTokenLabel") : isWebSessionProvider @@ -5804,7 +6208,7 @@ function AddApiKeyModal({ ? t("localProviderApiKeyOptionalHint", { provider: localProviderMetadata?.name || providerName || provider || "", }) - : isSearxng || isPetals + : apiKeyOptional ? t("apiKeyOptionalHint") : undefined; @@ -5812,12 +6216,15 @@ function AddApiKeyModal({ setValidating(true); setSaveError(null); try { + const credentialInput = isCommandCode + ? extractCommandCodeCredentialInput(formData.apiKey) + : formData.apiKey; const res = await fetch("/api/providers/validate", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ provider, - apiKey: formData.apiKey, + apiKey: credentialInput, validationModelId: formData.validationModelId || undefined, customUserAgent: formData.customUserAgent.trim() || undefined, baseUrl: formData.baseUrl.trim() || undefined, @@ -5833,8 +6240,22 @@ function AddApiKeyModal({ } }; + const copyCommandCodeValue = async (value: string | undefined, key: string) => { + if (!value) return; + try { + await navigator.clipboard.writeText(value); + setCopiedCommandCodeField(key); + window.setTimeout(() => setCopiedCommandCodeField(null), 1500); + } catch { + setSaveError("Copy failed. Select the text and copy it manually."); + } + }; + const handleSubmit = async () => { - if (!provider || (!isCompatible && !apiKeyOptional && !formData.apiKey)) return; + const credentialInput = isCommandCode + ? extractCommandCodeCredentialInput(formData.apiKey) + : formData.apiKey; + if (!provider || (!isCompatible && !apiKeyOptional && !credentialInput)) return; setSaving(true); setSaveError(null); @@ -5864,7 +6285,7 @@ function AddApiKeyModal({ headers: { "Content-Type": "application/json" }, body: JSON.stringify({ provider, - apiKey: formData.apiKey, + apiKey: credentialInput, validationModelId: formData.validationModelId || undefined, customUserAgent: formData.customUserAgent.trim() || undefined, baseUrl: formData.baseUrl.trim() || undefined, @@ -5884,7 +6305,7 @@ function AddApiKeyModal({ } if (!isValid) { - if (apiKeyOptional && !formData.apiKey) { + if (apiKeyOptional && !credentialInput) { // Bypass validation block for local/optional providers when no key is provided console.debug("Validation failed but apiKey is optional; proceeding to save."); } else { @@ -5927,7 +6348,7 @@ function AddApiKeyModal({ const payload = { name: formData.name, - apiKey: formData.apiKey.trim() || undefined, + apiKey: credentialInput.trim() || undefined, priority: formData.priority, testStatus: "active", providerSpecificData: @@ -5962,6 +6383,84 @@ function AddApiKeyModal({ </div> </div> )} + {isCommandCode && onStartCommandCodeAuth && ( + <div className="rounded-lg border border-sky-500/20 bg-sky-500/10 px-3 py-3 text-sm"> + <div className="flex items-start gap-3"> + <span className="material-symbols-outlined mt-0.5 text-[18px] text-sky-500"> + open_in_new + </span> + <div className="min-w-0 flex-1"> + <p className="font-medium text-text-main">Browser/manual connect</p> + <p className="mt-1 text-xs text-text-muted"> + Open Command Code Studio, then paste the returned key/JSON/URL into the API key + field below. + </p> + {commandCodeAuthState?.message && ( + <p className="mt-2 text-xs text-text-muted"> + {commandCodeAuthPhaseLabel}: {commandCodeAuthState.message} + </p> + )} + {commandCodeAuthState?.authUrl && ( + <div className="mt-3 space-y-2"> + <div> + <p className="mb-1 text-xs font-medium text-text-main">Auth URL</p> + <div className="flex gap-2"> + <Input + value={commandCodeAuthState.authUrl} + readOnly + className="flex-1 font-mono text-xs" + /> + <Button + variant="ghost" + size="sm" + icon={copiedCommandCodeField === "authUrl" ? "check" : "content_copy"} + onClick={() => + copyCommandCodeValue(commandCodeAuthState.authUrl, "authUrl") + } + /> + </div> + </div> + {commandCodeAuthState.callbackUrl && ( + <div> + <p className="mb-1 text-xs font-medium text-text-main">Callback URL</p> + <div className="flex gap-2"> + <Input + value={commandCodeAuthState.callbackUrl} + readOnly + className="flex-1 font-mono text-xs" + /> + <Button + variant="ghost" + size="sm" + icon={ + copiedCommandCodeField === "callbackUrl" ? "check" : "content_copy" + } + onClick={() => + copyCommandCodeValue(commandCodeAuthState.callbackUrl, "callbackUrl") + } + /> + </div> + </div> + )} + </div> + )} + </div> + <Button + variant="secondary" + size="sm" + icon="open_in_new" + loading={ + commandCodeAuthState?.phase === "starting" || + commandCodeAuthState?.phase === "polling" || + commandCodeAuthState?.phase === "applying" + } + onClick={onStartCommandCodeAuth} + > + Connect in browser + </Button> + </div> + </div> + )} <Input label={t("nameLabel")} value={formData.name} @@ -6211,7 +6710,7 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec codexOpenaiStoreEnabled: false, consoleApiKey: "", ccCompatibleContext1m: false, - geminiProjectId: "", + cloudCodeProjectId: "", blockExtraUsage: connection?.provider === "claude" ? isClaudeExtraUsageBlockEnabled(connection?.provider, connection?.providerSpecificData) @@ -6238,19 +6737,19 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec const isCodex = connection?.provider === "codex"; const isClaude = connection?.provider === "claude"; const isGeminiCli = connection?.provider === "gemini-cli"; + const isAntigravity = connection?.provider === "antigravity"; + const supportsGoogleProjectId = isGeminiCli || isAntigravity; const localProviderMetadata = getLocalProviderMetadata(connection?.provider); const isLocalSelfHostedProvider = !!localProviderMetadata; - const isSearxng = connection?.provider === "searxng-search"; const isGooglePse = connection?.provider === "google-pse-search"; - const isPetals = connection?.provider === "petals"; - const apiKeyOptional = isSearxng || isPetals || isLocalSelfHostedProvider; + const apiKeyOptional = providerAllowsOptionalApiKey(connection?.provider); const isCcCompatible = isClaudeCodeCompatibleProvider(connection?.provider); const defaultRegion = "us-central1"; const apiCredentialHint = isLocalSelfHostedProvider ? t("localProviderApiKeyOptionalHint", { provider: localProviderMetadata?.name || connection?.provider || "", }) - : isSearxng || isPetals + : apiKeyOptional ? t("apiKeyOptionalHint") : t("leaveBlankKeepCurrentApiKey"); @@ -6300,7 +6799,8 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec codexOpenaiStoreEnabled: connection.providerSpecificData?.openaiStoreEnabled === true, consoleApiKey: existingConsoleApiKey, ccCompatibleContext1m: ccRequestDefaults.context1m, - geminiProjectId: (connection.providerSpecificData?.projectId as string) || "", + cloudCodeProjectId: + (connection.providerSpecificData?.projectId as string) || connection.projectId || "", blockExtraUsage: isClaudeExtraUsageBlockEnabled( connection.provider, connection.providerSpecificData @@ -6390,6 +6890,7 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec setSaveError(null); try { const trimmedMaxConcurrent = formData.maxConcurrent.trim(); + const trimmedCloudCodeProjectId = formData.cloudCodeProjectId.trim(); let parsedMaxConcurrent: number | null = null; if (trimmedMaxConcurrent) { const numericMaxConcurrent = Number(trimmedMaxConcurrent); @@ -6407,8 +6908,8 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec healthCheckInterval: formData.healthCheckInterval, }; - if (isGeminiCli) { - updates.projectId = formData.geminiProjectId.trim() || null; + if (supportsGoogleProjectId) { + updates.projectId = trimmedCloudCodeProjectId || null; } if (isGooglePse && !formData.cx.trim()) { @@ -6498,6 +6999,9 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec } else if (isCloudflare && formData.accountId.trim()) { updates.providerSpecificData.accountId = formData.accountId.trim(); } + if (supportsGoogleProjectId) { + updates.providerSpecificData.projectId = trimmedCloudCodeProjectId || null; + } if (isCcCompatible) { const currentRequestDefaults = updates.providerSpecificData.requestDefaults && @@ -6532,8 +7036,8 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec updates.providerSpecificData.openaiStoreEnabled = formData.codexOpenaiStoreEnabled === true; } - if (isGeminiCli) { - updates.providerSpecificData.projectId = formData.geminiProjectId.trim() || undefined; + if (supportsGoogleProjectId) { + updates.providerSpecificData.projectId = trimmedCloudCodeProjectId || null; } } const error = (await onSave(updates)) as void | unknown; @@ -6629,14 +7133,18 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }: EditConnec /> </div> )} - {isGeminiCli && ( + {supportsGoogleProjectId && ( <div className="flex flex-col gap-4 rounded-lg border border-border/50 bg-surface/20 p-4"> <Input - label={t("geminiCliProjectIdLabel")} - value={formData.geminiProjectId} - onChange={(e) => setFormData({ ...formData, geminiProjectId: e.target.value })} - placeholder={t("geminiCliProjectIdPlaceholder")} - hint={t("geminiCliProjectIdHint")} + label={isAntigravity ? t("antigravityProjectIdLabel") : t("geminiCliProjectIdLabel")} + value={formData.cloudCodeProjectId} + onChange={(e) => setFormData({ ...formData, cloudCodeProjectId: e.target.value })} + placeholder={ + isAntigravity + ? t("antigravityProjectIdPlaceholder") + : t("geminiCliProjectIdPlaceholder") + } + hint={isAntigravity ? t("antigravityProjectIdHint") : t("geminiCliProjectIdHint")} className="font-mono text-xs" /> </div> diff --git a/src/app/(dashboard)/dashboard/providers/page.tsx b/src/app/(dashboard)/dashboard/providers/page.tsx index 08f9a981ca..ab3a1c583b 100644 --- a/src/app/(dashboard)/dashboard/providers/page.tsx +++ b/src/app/(dashboard)/dashboard/providers/page.tsx @@ -11,6 +11,7 @@ import { IMAGE_ONLY_PROVIDER_IDS, VIDEO_PROVIDER_IDS, isClaudeCodeCompatibleProvider, + CLOUD_AGENT_PROVIDERS, } from "@/shared/constants/providers"; import { useRouter } from "next/navigation"; import { getErrorCode, getRelativeTime } from "@/shared/utils"; @@ -488,6 +489,13 @@ export default function ProvidersPage() { searchQuery ); + const cloudAgentProviderEntriesAll = buildStaticProviderEntries("cloud-agent", getProviderStats); + const cloudAgentProviderEntries = filterConfiguredProviderEntries( + cloudAgentProviderEntriesAll, + showConfiguredOnly, + searchQuery + ); + const upstreamProxyEntriesAll = buildStaticProviderEntries("upstream-proxy", getProviderStats); const upstreamProxyEntries = filterConfiguredProviderEntries( upstreamProxyEntriesAll, @@ -970,6 +978,51 @@ export default function ProvidersPage() { </div> )} + {/* Cloud Agent Providers */} + {cloudAgentProviderEntries.length > 0 && ( + <div className="flex flex-col gap-4"> + <div className="flex flex-wrap items-center gap-2"> + <h2 className="text-xl font-semibold flex items-center gap-2 flex-1 min-w-0"> + {t("cloudAgentProviders")}{" "} + <span + className="size-2.5 rounded-full bg-violet-500" + title={t("cloudAgentProviders")} + /> + <ProviderCountBadge {...countConfigured(cloudAgentProviderEntriesAll)} /> + </h2> + <button + onClick={() => handleBatchTest("cloud-agent")} + disabled={!!testingMode} + className={`flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-xs font-medium border transition-colors ${ + testingMode === "cloud-agent" + ? "bg-primary/20 border-primary/40 text-primary animate-pulse" + : "bg-bg-subtle border-border text-text-muted hover:text-text-primary hover:border-primary/40" + }`} + title={t("testAll")} + > + <span className="material-symbols-outlined text-[14px]"> + {testingMode === "cloud-agent" ? "sync" : "play_arrow"} + </span> + {testingMode === "cloud-agent" ? t("testing") : t("testAll")} + </button> + </div> + <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4"> + {cloudAgentProviderEntries.map( + ({ providerId, provider, stats, displayAuthType, toggleAuthType }) => ( + <ProviderCard + key={providerId} + providerId={providerId} + provider={provider} + stats={stats} + authType={displayAuthType} + onToggle={(active) => handleToggleProvider(providerId, toggleAuthType, active)} + /> + ) + )} + </div> + </div> + )} + {/* Local / Self-Hosted Providers */} {localProviderEntries.length > 0 && ( <div className="flex flex-col gap-4"> diff --git a/src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx b/src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx index a2fc51e900..e1c476be64 100644 --- a/src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx +++ b/src/app/(dashboard)/dashboard/settings/components/MemorySkillsTab.tsx @@ -710,7 +710,7 @@ export default function MemorySkillsTab() { </div> </Card> - {/* Skills Settings (placeholder) */} + {/* Skills Settings */} <Card data-testid="skills-settings-card"> <div className="flex items-center gap-3 mb-5"> <div className="p-2 rounded-lg bg-amber-500/10 text-amber-500"> diff --git a/src/app/(dashboard)/dashboard/settings/components/ModelCooldownsCard.tsx b/src/app/(dashboard)/dashboard/settings/components/ModelCooldownsCard.tsx new file mode 100644 index 0000000000..5ca9122b93 --- /dev/null +++ b/src/app/(dashboard)/dashboard/settings/components/ModelCooldownsCard.tsx @@ -0,0 +1,155 @@ +"use client"; + +import { useCallback, useEffect, useMemo, useState } from "react"; +import { Button, Card } from "@/shared/components"; +import { useNotificationStore } from "@/store/notificationStore"; + +type CooldownItem = { + provider: string; + model: string; + reason: string; + remainingMs: number; + unavailableSince: string; +}; + +function formatRemaining(ms: number): string { + const totalSec = Math.max(0, Math.ceil(ms / 1000)); + const min = Math.floor(totalSec / 60); + const sec = totalSec % 60; + return `${min}m ${sec}s`; +} + +export default function ModelCooldownsCard() { + const notify = useNotificationStore(); + const [items, setItems] = useState<CooldownItem[]>([]); + const [loading, setLoading] = useState(true); + const [busyKey, setBusyKey] = useState<string | null>(null); + + const load = useCallback(async () => { + try { + const res = await fetch("/api/resilience/model-cooldowns", { cache: "no-store" }); + const json = await res.json(); + if (!res.ok) throw new Error(json?.error || `HTTP ${res.status}`); + setItems(Array.isArray(json.items) ? json.items : []); + } catch (error) { + notify.error(error instanceof Error ? error.message : "Failed to load cooldowns"); + } finally { + setLoading(false); + } + }, [notify]); + + useEffect(() => { + void load(); + const timer = setInterval(() => { + void load(); + }, 5000); + return () => clearInterval(timer); + }, [load]); + + const clearOne = useCallback( + async (provider: string, model: string) => { + const key = `${provider}::${model}`; + setBusyKey(key); + try { + const res = await fetch("/api/resilience/model-cooldowns", { + method: "DELETE", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ provider, model }), + }); + const json = await res.json(); + if (!res.ok) throw new Error(json?.error || `HTTP ${res.status}`); + notify.success(`Modelo reativado: ${provider}/${model}`); + await load(); + } catch (error) { + notify.error(error instanceof Error ? error.message : "Failed to clear cooldown"); + } finally { + setBusyKey(null); + } + }, + [load, notify] + ); + + const clearAll = useCallback(async () => { + setBusyKey("ALL"); + try { + const res = await fetch("/api/resilience/model-cooldowns", { + method: "DELETE", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ all: true }), + }); + const json = await res.json(); + if (!res.ok) throw new Error(json?.error || `HTTP ${res.status}`); + notify.success("Todos os modelos em cooldown foram reativados."); + await load(); + } catch (error) { + notify.error(error instanceof Error ? error.message : "Failed to clear cooldowns"); + } finally { + setBusyKey(null); + } + }, [load, notify]); + + const hasItems = items.length > 0; + const sorted = useMemo(() => [...items].sort((a, b) => b.remainingMs - a.remainingMs), [items]); + + return ( + <Card className="p-6"> + <div className="flex items-start justify-between gap-4"> + <div> + <h2 className="text-lg font-bold text-text-main">Modelos em cooldown</h2> + <p className="mt-1 text-sm text-text-muted"> + Lista de modelos temporariamente isolados por falha. Quando o cooldown expira, eles + voltam automaticamente. + </p> + </div> + <div className="flex gap-2"> + <Button size="sm" variant="secondary" onClick={() => void load()} disabled={loading}> + Atualizar + </Button> + <Button + size="sm" + variant="primary" + onClick={() => void clearAll()} + disabled={!hasItems || busyKey === "ALL"} + > + Reativar todos + </Button> + </div> + </div> + + <div className="mt-4 space-y-2"> + {loading ? ( + <p className="text-sm text-text-muted">Carregando...</p> + ) : !hasItems ? ( + <p className="text-sm text-text-muted">Nenhum modelo em cooldown no momento.</p> + ) : ( + sorted.map((item) => { + const rowKey = `${item.provider}::${item.model}`; + return ( + <div + key={rowKey} + className="rounded-lg border border-border bg-bg-subtle px-3 py-2 flex items-center justify-between gap-3" + > + <div className="min-w-0"> + <p className="text-sm font-medium text-text-main truncate"> + {item.provider}/{item.model} + </p> + <p className="text-xs text-text-muted"> + motivo: {item.reason} • restante: {formatRemaining(item.remainingMs)} + </p> + </div> + <Button + size="sm" + variant="secondary" + onClick={() => void clearOne(item.provider, item.model)} + disabled={busyKey === rowKey} + > + Reativar + </Button> + </div> + ); + }) + )} + </div> + </Card> + ); +} diff --git a/src/app/(dashboard)/dashboard/settings/components/ResilienceTab.tsx b/src/app/(dashboard)/dashboard/settings/components/ResilienceTab.tsx index f3ca6f7105..5e2f882263 100644 --- a/src/app/(dashboard)/dashboard/settings/components/ResilienceTab.tsx +++ b/src/app/(dashboard)/dashboard/settings/components/ResilienceTab.tsx @@ -1,9 +1,11 @@ "use client"; -import { type ReactNode, useEffect, useState } from "react"; +import { type ReactNode, useCallback, useEffect, useState } from "react"; import { Button, Card } from "@/shared/components"; import { useNotificationStore } from "@/store/notificationStore"; import { useTranslations } from "next-intl"; +import AutoDisableCard from "./AutoDisableCard"; +import ModelCooldownsCard from "./ModelCooldownsCard"; type RequestQueueSettings = { autoEnableApiKeyProviders: boolean; @@ -16,6 +18,9 @@ type RequestQueueSettings = { type ConnectionCooldownProfileSettings = { baseCooldownMs: number; useUpstreamRetryHints: boolean; + // Issue #2100 follow-up. Optional / undefined when unset; the per-provider + // default in src/shared/utils/providerHints.ts resolves at runtime. + useUpstream429BreakerHints?: boolean; maxBackoffSteps: number; }; @@ -60,13 +65,13 @@ function SectionDescription({ return ( <div className="grid grid-cols-1 gap-2 text-xs text-text-muted sm:grid-cols-3"> <div> - <span className="font-semibold text-text-main">Scope:</span> {scope} + <span className="font-semibold text-text-main">Escopo:</span> {scope} </div> <div> - <span className="font-semibold text-text-main">Trigger:</span> {trigger} + <span className="font-semibold text-text-main">Gatilho:</span> {trigger} </div> <div> - <span className="font-semibold text-text-main">Effect:</span> {effect} + <span className="font-semibold text-text-main">Efeito:</span> {effect} </div> </div> ); @@ -211,12 +216,12 @@ function RequestQueueCard({ <div className="space-y-2"> <div className="flex items-center gap-2"> <span className="material-symbols-outlined text-xl text-primary">speed</span> - <h2 className="text-lg font-bold">Request Queue & Pacing</h2> + <h2 className="text-lg font-bold">Fila de Requisições e Ritmo</h2> </div> <SectionDescription - scope="Per request bucket" - trigger="Before a request is sent upstream" - effect="Queues requests, limits concurrency, and spaces requests out" + scope="Por fila de requisição" + trigger="Antes de enviar para o upstream" + effect="Enfileira requisições, limita concorrência e espaça as chamadas" /> </div> <ActionRow @@ -235,28 +240,29 @@ function RequestQueueCard({ </div> <p className="mb-4 text-sm text-text-muted"> - This layer only controls queueing and pacing. It does not write cooldowns or open breakers. + Esta camada controla apenas enfileiramento e ritmo. Ela não grava cooldown nem abre circuit + breaker. </p> <div className="grid grid-cols-1 gap-3 lg:grid-cols-2"> {editing ? ( <> <BooleanField - label="Auto-enable for API key providers" - description="Enable queue protection by default for active API key connections." + label="Autoativar para provedores com API key" + description="Ativa proteção de fila por padrão para conexões de API key ativas." checked={draft.autoEnableApiKeyProviders} onChange={(autoEnableApiKeyProviders) => setDraft((prev) => ({ ...prev, autoEnableApiKeyProviders })) } /> <NumberField - label="Requests per minute" + label="Requisições por minuto" value={draft.requestsPerMinute} min={1} onChange={(requestsPerMinute) => setDraft((prev) => ({ ...prev, requestsPerMinute }))} /> <NumberField - label="Min time between requests" + label="Tempo mínimo entre requisições" value={draft.minTimeBetweenRequestsMs} suffix="ms" onChange={(minTimeBetweenRequestsMs) => @@ -264,7 +270,7 @@ function RequestQueueCard({ } /> <NumberField - label="Concurrent requests" + label="Requisições concorrentes" value={draft.concurrentRequests} min={1} onChange={(concurrentRequests) => @@ -272,7 +278,7 @@ function RequestQueueCard({ } /> <NumberField - label="Max queue wait" + label="Tempo máximo de espera em fila" value={draft.maxWaitMs} min={1} suffix="ms" @@ -282,31 +288,31 @@ function RequestQueueCard({ ) : ( <> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Auto-enable for API key providers</div> + <div className="text-xs text-text-muted">Autoativar para provedores com API key</div> <div className="mt-1 text-sm font-semibold text-text-main"> - {value.autoEnableApiKeyProviders ? "Enabled" : "Disabled"} + {value.autoEnableApiKeyProviders ? "Ativado" : "Desativado"} </div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Requests per minute</div> + <div className="text-xs text-text-muted">Requisições por minuto</div> <div className="mt-1 text-sm font-semibold text-text-main"> {value.requestsPerMinute} </div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Min time between requests</div> + <div className="text-xs text-text-muted">Tempo mínimo entre requisições</div> <div className="mt-1 text-sm font-semibold text-text-main"> {formatMs(value.minTimeBetweenRequestsMs)} </div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Concurrent requests</div> + <div className="text-xs text-text-muted">Requisições concorrentes</div> <div className="mt-1 text-sm font-semibold text-text-main"> {value.concurrentRequests} </div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Max queue wait</div> + <div className="text-xs text-text-muted">Tempo máximo de espera em fila</div> <div className="mt-1 text-sm font-semibold text-text-main"> {formatMs(value.maxWaitMs)} </div> @@ -341,7 +347,7 @@ function ConnectionCooldownCard({ {editing ? ( <> <NumberField - label="Base cooldown" + label="Cooldown base" value={current.baseCooldownMs} min={0} suffix="ms" @@ -351,7 +357,7 @@ function ConnectionCooldownCard({ /> <BooleanField label="Use upstream retry hints" - description="Use upstream retry-after/reset values when they are present." + description="Usa valores de retry-after/reset do upstream quando disponíveis." checked={current.useUpstreamRetryHints} onChange={(useUpstreamRetryHints) => setDraft((prev) => ({ @@ -360,8 +366,50 @@ function ConnectionCooldownCard({ })) } /> + <div className="flex flex-col gap-1"> + <label className="flex items-center justify-between gap-2 text-sm"> + <span className="text-text-muted">Use upstream 429 hints for breaker cooldown</span> + <select + className="rounded border border-border-default bg-surface-1 px-2 py-1 text-sm font-mono" + value={ + current.useUpstream429BreakerHints === true + ? "on" + : current.useUpstream429BreakerHints === false + ? "off" + : "default" + } + onChange={(e) => { + const v = e.target.value; + const next: boolean | undefined = + v === "on" ? true : v === "off" ? false : undefined; + setDraft((prev) => { + const profile = { ...prev[key] }; + if (next === undefined) { + delete (profile as { useUpstream429BreakerHints?: boolean }) + .useUpstream429BreakerHints; + } else { + ( + profile as { useUpstream429BreakerHints?: boolean } + ).useUpstream429BreakerHints = next; + } + return { ...prev, [key]: profile }; + }); + }} + > + <option value="default">Default (per provider)</option> + <option value="on">Always on</option> + <option value="off">Always off</option> + </select> + </label> + <p className="text-xs text-text-muted"> + Apply Retry-After / quota-exhausted signals from 429 responses to circuit-breaker + cooldown duration. Default uses a per-provider policy: direct cloud providers + default on; reverse-proxy / self-hosted / CLI-backed providers default off. + Independent of "Use upstream retry hints". + </p> + </div> <NumberField - label="Max backoff steps" + label="Máximo de passos de backoff" value={current.maxBackoffSteps} min={0} onChange={(maxBackoffSteps) => @@ -372,17 +420,27 @@ function ConnectionCooldownCard({ ) : ( <> <div className="flex items-center justify-between text-sm"> - <span className="text-text-muted">Base cooldown</span> + <span className="text-text-muted">Cooldown base</span> <span className="font-mono text-text-main">{formatMs(current.baseCooldownMs)}</span> </div> <div className="flex items-center justify-between text-sm"> - <span className="text-text-muted">Use upstream retry hints</span> + <span className="text-text-muted">Usar dicas de retry do upstream</span> <span className="font-mono text-text-main"> - {current.useUpstreamRetryHints ? "Yes" : "No"} + {current.useUpstreamRetryHints ? "Sim" : "Não"} </span> </div> <div className="flex items-center justify-between text-sm"> - <span className="text-text-muted">Max backoff steps</span> + <span className="text-text-muted">Use upstream 429 hints (breaker)</span> + <span className="font-mono text-text-main"> + {current.useUpstream429BreakerHints === true + ? "Yes" + : current.useUpstream429BreakerHints === false + ? "No" + : "Default"} + </span> + </div> + <div className="flex items-center justify-between text-sm"> + <span className="text-text-muted">Máximo de passos de backoff</span> <span className="font-mono text-text-main">{current.maxBackoffSteps}</span> </div> </> @@ -397,12 +455,12 @@ function ConnectionCooldownCard({ <div className="space-y-2"> <div className="flex items-center gap-2"> <span className="material-symbols-outlined text-xl text-primary">timer_off</span> - <h2 className="text-lg font-bold">Connection Cooldown</h2> + <h2 className="text-lg font-bold">Cooldown de Conexão</h2> </div> <SectionDescription - scope="Single connection" - trigger="A connection returns a retryable upstream failure" - effect="Temporarily skips that connection and increases backoff on repeated failures" + scope="Conexão individual" + trigger="Quando uma conexão retorna falha transitória no upstream" + effect="Pula temporariamente essa conexão e aumenta backoff em falhas repetidas" /> </div> <ActionRow @@ -414,20 +472,39 @@ function ConnectionCooldownCard({ setEditing(false); }} onSave={async () => { - await onSave(draft); + // Build PATCH-ready payload: convert undefined useUpstream429BreakerHints + // to explicit null sentinel so the server treats it as unset (not as + // partial-merge "leave unchanged"). JSON.stringify drops undefined keys. + const payload = { + oauth: { + ...draft.oauth, + useUpstream429BreakerHints: + draft.oauth.useUpstream429BreakerHints === undefined + ? (null as unknown as boolean | undefined) + : draft.oauth.useUpstream429BreakerHints, + }, + apikey: { + ...draft.apikey, + useUpstream429BreakerHints: + draft.apikey.useUpstream429BreakerHints === undefined + ? (null as unknown as boolean | undefined) + : draft.apikey.useUpstream429BreakerHints, + }, + }; + await onSave(payload as typeof draft); setEditing(false); }} /> </div> <p className="mb-4 text-sm text-text-muted"> - Base cooldown covers retryable connection failures. When upstream retry hints are enabled, - explicit provider wait windows override the local base cooldown. + O cooldown base cobre falhas transitórias de conexão. Quando as dicas de retry do upstream + estão ativas, a janela explícita do provedor sobrescreve o cooldown local. </p> <div className="grid grid-cols-1 gap-4 md:grid-cols-2"> - {renderProfile("oauth", "OAuth Providers", "lock")} - {renderProfile("apikey", "API Key Providers", "key")} + {renderProfile("oauth", "Provedores OAuth", "lock")} + {renderProfile("apikey", "Provedores API Key", "key")} </div> </Card> ); @@ -456,7 +533,7 @@ function ProviderBreakerCard({ {editing ? ( <> <NumberField - label="Failure threshold" + label="Limite de falhas" value={current.failureThreshold} min={1} onChange={(failureThreshold) => @@ -464,7 +541,7 @@ function ProviderBreakerCard({ } /> <NumberField - label="Reset timeout" + label="Tempo para reset" value={current.resetTimeoutMs} min={1000} suffix="ms" @@ -476,11 +553,11 @@ function ProviderBreakerCard({ ) : ( <> <div className="flex items-center justify-between text-sm"> - <span className="text-text-muted">Failure threshold</span> + <span className="text-text-muted">Limite de falhas</span> <span className="font-mono text-text-main">{current.failureThreshold}</span> </div> <div className="flex items-center justify-between text-sm"> - <span className="text-text-muted">Reset timeout</span> + <span className="text-text-muted">Tempo para reset</span> <span className="font-mono text-text-main">{formatMs(current.resetTimeoutMs)}</span> </div> </> @@ -497,12 +574,12 @@ function ProviderBreakerCard({ <span className="material-symbols-outlined text-xl text-primary"> electrical_services </span> - <h2 className="text-lg font-bold">Provider Circuit Breaker</h2> + <h2 className="text-lg font-bold">Circuit Breaker por Provedor</h2> </div> <SectionDescription - scope="Whole provider" - trigger="Provider-level final transport/server failures after connection fallback is exhausted" - effect="Temporarily blocks that provider until the reset timeout elapses" + scope="Provedor inteiro" + trigger="Falhas finais de transporte/servidor após esgotar fallback de conexão" + effect="Bloqueia temporariamente esse provedor até o tempo de reset expirar" /> </div> <ActionRow @@ -521,13 +598,13 @@ function ProviderBreakerCard({ </div> <p className="mb-4 text-sm text-text-muted"> - Breaker runtime state is shown only on the Health page. Connection-scoped 429 rate limits - stay in Connection Cooldown and do not trip the provider breaker. + O estado em tempo real do breaker aparece apenas na página Saúde. Rate limits 429 no escopo + de conexão ficam no Cooldown de Conexão e não disparam o breaker de provedor. </p> <div className="grid grid-cols-1 gap-4 md:grid-cols-2"> - {renderProfile("oauth", "OAuth Providers", "lock")} - {renderProfile("apikey", "API Key Providers", "key")} + {renderProfile("oauth", "Provedores OAuth", "lock")} + {renderProfile("apikey", "Provedores API Key", "key")} </div> </Card> ); @@ -555,12 +632,12 @@ function WaitForCooldownCard({ <div className="space-y-2"> <div className="flex items-center gap-2"> <span className="material-symbols-outlined text-xl text-primary">hourglass_top</span> - <h2 className="text-lg font-bold">Wait For Cooldown</h2> + <h2 className="text-lg font-bold">Aguardar Cooldown</h2> </div> <SectionDescription - scope="Current client request" - trigger="All candidate connections are already cooling down" - effect="Waits on the server side and retries when the earliest cooldown expires" + scope="Requisição atual do cliente" + trigger="Quando todas as conexões candidatas já estão em cooldown" + effect="Aguarda no servidor e tenta novamente quando o primeiro cooldown expira" /> </div> <ActionRow @@ -579,26 +656,26 @@ function WaitForCooldownCard({ </div> <p className="mb-4 text-sm text-text-muted"> - This only affects the current request. It does not write connection or provider state. + Isso afeta apenas a requisição atual. Não grava estado de conexão nem de provedor. </p> <div className="grid grid-cols-1 gap-3 lg:grid-cols-2"> {editing ? ( <> <BooleanField - label="Enable server-side waiting" - description="When enabled, OmniRoute waits for the earliest cooldown and retries automatically." + label="Ativar espera no servidor" + description="Quando ativo, o OmniRoute aguarda o primeiro cooldown expirar e tenta novamente automaticamente." checked={draft.enabled} onChange={(enabled) => setDraft((prev) => ({ ...prev, enabled }))} /> <NumberField - label="Max retries" + label="Máximo de tentativas" value={draft.maxRetries} min={0} onChange={(maxRetries) => setDraft((prev) => ({ ...prev, maxRetries }))} /> <NumberField - label="Max retry wait" + label="Tempo máximo de espera por tentativa" value={draft.maxRetryWaitSec} min={0} suffix="sec" @@ -608,17 +685,17 @@ function WaitForCooldownCard({ ) : ( <> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Enable server-side waiting</div> + <div className="text-xs text-text-muted">Ativar espera no servidor</div> <div className="mt-1 text-sm font-semibold text-text-main"> - {value.enabled ? "Enabled" : "Disabled"} + {value.enabled ? "Ativado" : "Desativado"} </div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Max retries</div> + <div className="text-xs text-text-muted">Máximo de tentativas</div> <div className="mt-1 text-sm font-semibold text-text-main">{value.maxRetries}</div> </div> <div className="rounded-xl border border-border bg-bg-subtle p-4"> - <div className="text-xs text-text-muted">Max retry wait</div> + <div className="text-xs text-text-muted">Tempo máximo de espera por tentativa</div> <div className="mt-1 text-sm font-semibold text-text-main"> {value.maxRetryWaitSec}s </div> @@ -632,9 +709,19 @@ function WaitForCooldownCard({ export default function ResilienceTab() { const notify = useNotificationStore(); + const t = useTranslations("settings"); const [data, setData] = useState<ResilienceResponse | null>(null); const [loading, setLoading] = useState(true); const [savingSection, setSavingSection] = useState<string | null>(null); + const tx = useCallback( + (key: string, fallback: string) => { + if (typeof t.has === "function" && t.has(key as never)) { + return t(key as never); + } + return fallback; + }, + [t] + ); useEffect(() => { let mounted = true; @@ -654,7 +741,11 @@ export default function ResilienceTab() { waitForCooldown: json.waitForCooldown, }); } catch (error) { - notify.error(error instanceof Error ? error.message : "Failed to load resilience settings"); + notify.error( + error instanceof Error + ? error.message + : tx("failedLoadResilience", "Failed to load resilience settings") + ); } finally { if (mounted) setLoading(false); } @@ -664,7 +755,7 @@ export default function ResilienceTab() { return () => { mounted = false; }; - }, [notify]); + }, [notify, tx]); const savePatch = async (section: string, payload: Record<string, unknown>) => { setSavingSection(section); @@ -684,9 +775,13 @@ export default function ResilienceTab() { providerBreaker: json.providerBreaker, waitForCooldown: json.waitForCooldown, }); - notify.success("Resilience settings updated."); + notify.success(tx("savedSuccessfully", "Resilience settings updated.")); } catch (error) { - notify.error(error instanceof Error ? error.message : "Failed to save resilience settings"); + notify.error( + error instanceof Error + ? error.message + : tx("saveFailed", "Failed to save resilience settings") + ); throw error; } finally { setSavingSection(null); @@ -698,7 +793,7 @@ export default function ResilienceTab() { <Card className="p-6"> <div className="flex items-center gap-2 text-sm text-text-muted"> <span className="material-symbols-outlined animate-spin">progress_activity</span> - Loading resilience settings... + {tx("loadingResilience", "Loading resilience settings...")} </div> </Card> ); @@ -707,21 +802,29 @@ export default function ResilienceTab() { if (!data) { return ( <Card className="p-6"> - <p className="text-sm text-text-muted">Unable to load resilience settings.</p> + <p className="text-sm text-text-muted"> + {tx("failedLoadResilience", "Unable to load resilience settings.")} + </p> </Card> ); } return ( <div className="space-y-6"> + <ModelCooldownsCard /> + <AutoDisableCard /> <Card className="p-6"> <div className="flex items-start gap-3"> <span className="material-symbols-outlined text-xl text-primary">info</span> <div> - <h2 className="text-lg font-bold text-text-main">Resilience Structure</h2> + <h2 className="text-lg font-bold text-text-main"> + {tx("resilienceStructureTitle", "Resilience Structure")} + </h2> <p className="mt-1 text-sm text-text-muted"> - This page only configures behavior. Live breaker state is shown on the Health page. - Combo-specific retry and round-robin slot control remain on combo settings. + {tx( + "resilienceStructureDesc", + "This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings." + )} </p> </div> </div> diff --git a/src/app/(dashboard)/dashboard/settings/components/RoutingTab.tsx b/src/app/(dashboard)/dashboard/settings/components/RoutingTab.tsx index 7568bec217..82f5110939 100644 --- a/src/app/(dashboard)/dashboard/settings/components/RoutingTab.tsx +++ b/src/app/(dashboard)/dashboard/settings/components/RoutingTab.tsx @@ -15,6 +15,8 @@ export default function RoutingTab() { alwaysPreserveClientCache: "auto", antigravitySignatureCacheMode: "enabled", cliCompatProviders: [], + autoRoutingEnabled: true, + autoRoutingDefaultVariant: "lkgp", }); const [loading, setLoading] = useState(true); const [lkgpCacheLoading, setLkgpCacheLoading] = useState(false); @@ -395,6 +397,81 @@ export default function RoutingTab() { ))} </div> </Card> + + <Card> + <div className="flex items-start justify-between gap-4"> + <div className="flex gap-3"> + <div className="p-2 rounded-lg bg-indigo-500/10 text-indigo-500 h-fit"> + <span className="material-symbols-outlined text-[20px]" aria-hidden="true"> + auto_awesome + </span> + </div> + <div> + <h3 className="text-lg font-semibold">Zero-Config Auto-Routing</h3> + <p className="text-sm text-text-muted mt-1"> + Enable automatic provider selection using the auto/ prefix. When enabled, requests + to auto, auto/coding, auto/fast, etc. will dynamically route across all connected + providers. + </p> + </div> + </div> + <div className="pt-1"> + <label className="relative inline-flex items-center cursor-pointer"> + <input + type="checkbox" + className="sr-only peer" + checked={settings.autoRoutingEnabled !== false} + onChange={(e) => updateSetting({ autoRoutingEnabled: e.target.checked })} + disabled={loading} + /> + <div className="w-11 h-6 bg-border peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-gray-300 after:border after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-primary"></div> + </label> + </div> + </div> + <div className="mt-4 pt-4 border-t border-border/30"> + <label className="block text-sm font-medium mb-2">Default Auto Variant</label> + <div className="grid grid-cols-2 sm:grid-cols-3 gap-2"> + {[ + { value: "lkgp", label: "LKGP", desc: "Last Known Good Provider" }, + { value: "coding", label: "Coding", desc: "Quality-first for code" }, + { value: "fast", label: "Fast", desc: "Low-latency routing" }, + { value: "cheap", label: "Cheap", desc: "Cost-optimized" }, + { value: "offline", label: "Offline", desc: "High availability" }, + { value: "smart", label: "Smart", desc: "Best discovery (10% explore)" }, + ].map((option) => ( + <button + key={option.value} + onClick={() => updateSetting({ autoRoutingDefaultVariant: option.value })} + disabled={loading} + className={`p-2 rounded-lg border text-left transition-all ${ + settings.autoRoutingDefaultVariant === option.value + ? "border-indigo-500/50 bg-indigo-500/5 ring-1 ring-indigo-500/20" + : "border-border/50 hover:border-border hover:bg-surface/30" + }`} + > + <div className="flex items-center gap-1"> + <span + className={`material-symbols-outlined text-[14px] ${ + settings.autoRoutingDefaultVariant === option.value + ? "text-indigo-400" + : "text-text-muted" + }`} + > + {settings.autoRoutingDefaultVariant === option.value + ? "check_circle" + : "radio_button_unchecked"} + </span> + <span + className={`text-xs font-medium ${settings.autoRoutingDefaultVariant === option.value ? "text-indigo-400" : ""}`} + > + {option.label} + </span> + </div> + </button> + ))} + </div> + </div> + </Card> </div> ); } diff --git a/src/app/(dashboard)/dashboard/usage/components/ProviderLimits/utils.tsx b/src/app/(dashboard)/dashboard/usage/components/ProviderLimits/utils.tsx index 615dd51c61..6851c621e3 100644 --- a/src/app/(dashboard)/dashboard/usage/components/ProviderLimits/utils.tsx +++ b/src/app/(dashboard)/dashboard/usage/components/ProviderLimits/utils.tsx @@ -26,6 +26,11 @@ const QUOTA_LABEL_MAP: Record<string, string> = { "search-prime": "Web Search", "web-reader": "Web Reader", zread: "Zread", + "5 Hours Quota": "5 Hours", + "Weekly Quota": "Weekly", + "Monthly Tools": "Monthly Tools", + tokens: "Tokens", + time_limit: "Time Limit", }; const GLM_QUOTA_ORDER: Record<string, number> = { diff --git a/src/app/api/analytics/auto-routing/route.ts b/src/app/api/analytics/auto-routing/route.ts new file mode 100644 index 0000000000..65fe319303 --- /dev/null +++ b/src/app/api/analytics/auto-routing/route.ts @@ -0,0 +1,79 @@ +import { NextResponse } from "next/server"; +import { getDbInstance } from "@/lib/db/core"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; + +export const dynamic = "force-dynamic"; + +/** + * GET /api/analytics/auto-routing + * Returns auto-routing usage statistics and metrics. + */ +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { + const db = getDbInstance(); + + // Query usage_logs for auto/ prefix requests + const totalRequests = db + .prepare( + ` + SELECT COUNT(*) as count + FROM usage_logs + WHERE model = 'auto' OR model LIKE 'auto/%' + ` + ) + .get() as { count: number }; + + // Variant breakdown + const variantRows = db + .prepare( + ` + SELECT + CASE + WHEN model = 'auto' THEN 'default' + WHEN model LIKE 'auto/%' THEN SUBSTR(model, 6) + ELSE 'other' + END as variant, + COUNT(*) as count + FROM usage_logs + WHERE model = 'auto' OR model LIKE 'auto/%' + GROUP BY variant + ORDER BY count DESC + ` + ) + .all() as Array<{ variant: string; count: number }>; + + const variantBreakdown: Record<string, number> = {}; + variantRows.forEach((row) => { + variantBreakdown[row.variant] = row.count; + }); + + // Top providers (from LKGP cache or usage logs) + const topProviders = db + .prepare( + ` + SELECT provider, COUNT(*) as count + FROM usage_logs + WHERE model = 'auto' OR model LIKE 'auto/%' + GROUP BY provider + ORDER BY count DESC + LIMIT 10 + ` + ) + .all() as Array<{ provider: string; count: number }>; + + return NextResponse.json({ + totalRequests: totalRequests.count, + variantBreakdown, + topProviders, + }); + } catch (error) { + console.error("Auto-routing analytics error:", error); + return NextResponse.json({ + totalRequests: 0, + variantBreakdown: {}, + topProviders: [], + }); + } +} diff --git a/src/app/api/cli-tools/apply/route.ts b/src/app/api/cli-tools/apply/route.ts new file mode 100644 index 0000000000..8547401b39 --- /dev/null +++ b/src/app/api/cli-tools/apply/route.ts @@ -0,0 +1,82 @@ +import { NextResponse } from "next/server"; +import { requireCliToolsAuth } from "@/lib/api/requireCliToolsAuth"; +import fs from "node:fs"; +import path from "node:path"; +import os from "node:os"; +import { generateConfig } from "@/lib/cli-helper/config-generator"; + +const TOOL_CONFIG_PATHS: Record<string, string> = { + claude: path.join(os.homedir(), ".claude", "settings.json"), + codex: path.join(os.homedir(), ".codex", "config.yaml"), + opencode: path.join(os.homedir(), ".config", "opencode", "opencode.json"), + cline: path.join(os.homedir(), ".cline", "data", "globalState.json"), + kilocode: path.join(os.homedir(), ".config", "kilocode", "settings.json"), + continue: path.join(os.homedir(), ".continue", "config.yaml"), +}; + +function ensureBackup(configPath: string): string | null { + if (!fs.existsSync(configPath)) return null; + const backupDir = path.join(path.dirname(configPath), ".omniroute.bak"); + if (!fs.existsSync(backupDir)) fs.mkdirSync(backupDir, { recursive: true }); + const backupPath = path.join(backupDir, path.basename(configPath) + ".bak"); + fs.copyFileSync(configPath, backupPath); + return backupPath; +} + +// POST /api/cli-tools/apply - Apply config for a specific tool +export async function POST(request: Request) { + const authError = await requireCliToolsAuth(request); + if (authError) return authError; + + try { + const body = await request.json(); + const { toolId, baseUrl, apiKey, model, dryRun } = body; + + if (!toolId) { + return NextResponse.json({ error: "toolId is required" }, { status: 400 }); + } + if (!apiKey) { + return NextResponse.json({ error: "apiKey is required" }, { status: 400 }); + } + + const result = await generateConfig(toolId, { + baseUrl: baseUrl || "http://localhost:20128/v1", + apiKey, + model, + }); + + if (!result.success) { + return NextResponse.json({ error: result.error }, { status: 400 }); + } + + if (dryRun) { + return NextResponse.json({ + dryRun: true, + configPath: result.configPath, + content: result.content, + }); + } + + const configPath = TOOL_CONFIG_PATHS[toolId]; + if (!configPath) { + return NextResponse.json({ error: `Unknown tool: ${toolId}` }, { status: 400 }); + } + + const backupPath = ensureBackup(configPath); + + const dir = path.dirname(configPath); + if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true }); + + fs.writeFileSync(configPath, result.content!, "utf-8"); + + return NextResponse.json({ + success: true, + configPath, + backupPath, + content: result.content, + }); + } catch (error) { + console.log("Error applying config:", error); + return NextResponse.json({ error: "Failed to apply config" }, { status: 500 }); + } +} diff --git a/src/app/api/cli-tools/config/route.ts b/src/app/api/cli-tools/config/route.ts new file mode 100644 index 0000000000..35f74ef613 --- /dev/null +++ b/src/app/api/cli-tools/config/route.ts @@ -0,0 +1,61 @@ +import { NextResponse } from "next/server"; +import { requireCliToolsAuth } from "@/lib/api/requireCliToolsAuth"; +import { generateConfig, generateAllConfigs } from "@/lib/cli-helper/config-generator"; + +// GET /api/cli-tools/config - List generated configs for all tools +export async function GET(request: Request) { + const authError = await requireCliToolsAuth(request); + if (authError) return authError; + + const { searchParams } = new URL(request.url); + const baseUrl = searchParams.get("baseUrl") || "http://localhost:20128/v1"; + const apiKey = searchParams.get("apiKey") || ""; + + if (!apiKey) { + return NextResponse.json({ error: "API key is required" }, { status: 400 }); + } + + try { + const results = await generateAllConfigs({ baseUrl, apiKey }); + return NextResponse.json({ configs: results }); + } catch (error) { + console.log("Error generating configs:", error); + return NextResponse.json({ error: "Failed to generate configs" }, { status: 500 }); + } +} + +// POST /api/cli-tools/config - Generate config for a specific tool +export async function POST(request: Request) { + const authError = await requireCliToolsAuth(request); + if (authError) return authError; + + try { + const body = await request.json(); + const { toolId, baseUrl, apiKey, model } = body; + + if (!toolId) { + return NextResponse.json({ error: "toolId is required" }, { status: 400 }); + } + if (!apiKey) { + return NextResponse.json({ error: "apiKey is required" }, { status: 400 }); + } + + const result = await generateConfig(toolId, { + baseUrl: baseUrl || "http://localhost:20128/v1", + apiKey, + model, + }); + + if (!result.success) { + return NextResponse.json({ error: result.error }, { status: 400 }); + } + + return NextResponse.json({ + configPath: result.configPath, + content: result.content, + }); + } catch (error) { + console.log("Error generating config:", error); + return NextResponse.json({ error: "Failed to generate config" }, { status: 500 }); + } +} diff --git a/src/app/api/cli-tools/detect/route.ts b/src/app/api/cli-tools/detect/route.ts new file mode 100644 index 0000000000..58f0a28e97 --- /dev/null +++ b/src/app/api/cli-tools/detect/route.ts @@ -0,0 +1,28 @@ +import { NextResponse } from "next/server"; +import { requireCliToolsAuth } from "@/lib/api/requireCliToolsAuth"; +import { detectAllTools, detectTool } from "@/lib/cli-helper/tool-detector"; + +// GET /api/cli-tools/detect - Detect all installed CLI tools +export async function GET(request: Request) { + const authError = await requireCliToolsAuth(request); + if (authError) return authError; + + const { searchParams } = new URL(request.url); + const toolId = searchParams.get("tool"); + + try { + if (toolId) { + const tool = await detectTool(toolId); + if (!tool) { + return NextResponse.json({ error: `Unknown tool: ${toolId}` }, { status: 400 }); + } + return NextResponse.json(tool); + } + + const tools = await detectAllTools(); + return NextResponse.json({ tools }); + } catch (error) { + console.log("Error detecting tools:", error); + return NextResponse.json({ error: "Failed to detect tools" }, { status: 500 }); + } +} diff --git a/src/app/api/memory/[id]/route.ts b/src/app/api/memory/[id]/route.ts index a7be2e7748..b4a27e16c1 100644 --- a/src/app/api/memory/[id]/route.ts +++ b/src/app/api/memory/[id]/route.ts @@ -1,7 +1,11 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { deleteMemory, getMemory } from "@/lib/memory/store"; export async function DELETE(request: Request, props: { params: Promise<{ id: string }> }) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { id } = await props.params; const success = await deleteMemory(id); @@ -16,6 +20,9 @@ export async function DELETE(request: Request, props: { params: Promise<{ id: st } export async function GET(request: Request, props: { params: Promise<{ id: string }> }) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { id } = await props.params; const memory = await getMemory(id); diff --git a/src/app/api/memory/route.ts b/src/app/api/memory/route.ts index 785b75002f..4d3cf913e1 100644 --- a/src/app/api/memory/route.ts +++ b/src/app/api/memory/route.ts @@ -1,4 +1,5 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { listMemories, createMemory } from "@/lib/memory/store"; import { MemoryType } from "@/lib/memory/types"; import { parsePaginationParams, buildPaginatedResponse } from "@/shared/types/pagination"; @@ -16,6 +17,9 @@ const createMemorySchema = z.object({ }); export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const url = new URL(request.url); const { searchParams } = url; @@ -68,6 +72,9 @@ export async function GET(request: Request) { } export async function POST(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const rawBody = await request.json(); const validation = validateBody(createMemorySchema, rawBody); diff --git a/src/app/api/model-combo-mappings/[id]/route.ts b/src/app/api/model-combo-mappings/[id]/route.ts index 88c0733c53..33393201f8 100644 --- a/src/app/api/model-combo-mappings/[id]/route.ts +++ b/src/app/api/model-combo-mappings/[id]/route.ts @@ -6,6 +6,7 @@ import { z } from "zod"; import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { updateModelComboMapping, deleteModelComboMapping, @@ -21,7 +22,10 @@ const updateMappingSchema = z.object({ description: z.string().max(1000).optional(), }); -export async function GET(_request: Request, { params }: { params: Promise<{ id: string }> }) { +export async function GET(request: Request, { params }: { params: Promise<{ id: string }> }) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { id } = await params; const mapping = await getModelComboMappingById(id); @@ -30,11 +34,15 @@ export async function GET(_request: Request, { params }: { params: Promise<{ id: } return NextResponse.json({ mapping }); } catch (error: any) { - return NextResponse.json({ error: error.message || "Failed to get mapping" }, { status: 500 }); + console.error("Failed to get mapping:", error); + return NextResponse.json({ error: "Failed to get mapping" }, { status: 500 }); } } export async function PUT(request: Request, { params }: { params: Promise<{ id: string }> }) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { id } = await params; const rawBody = await request.json(); @@ -51,14 +59,15 @@ export async function PUT(request: Request, { params }: { params: Promise<{ id: return NextResponse.json({ mapping }); } catch (error: any) { - return NextResponse.json( - { error: error.message || "Failed to update mapping" }, - { status: 500 } - ); + console.error("Failed to update mapping:", error); + return NextResponse.json({ error: "Failed to update mapping" }, { status: 500 }); } } -export async function DELETE(_request: Request, { params }: { params: Promise<{ id: string }> }) { +export async function DELETE(request: Request, { params }: { params: Promise<{ id: string }> }) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { id } = await params; const deleted = await deleteModelComboMapping(id); @@ -69,9 +78,7 @@ export async function DELETE(_request: Request, { params }: { params: Promise<{ return NextResponse.json({ success: true }); } catch (error: any) { - return NextResponse.json( - { error: error.message || "Failed to delete mapping" }, - { status: 500 } - ); + console.error("Failed to delete mapping:", error); + return NextResponse.json({ error: "Failed to delete mapping" }, { status: 500 }); } } diff --git a/src/app/api/model-combo-mappings/route.ts b/src/app/api/model-combo-mappings/route.ts index 359a7fb569..eb8b7d23f4 100644 --- a/src/app/api/model-combo-mappings/route.ts +++ b/src/app/api/model-combo-mappings/route.ts @@ -6,6 +6,7 @@ import { z } from "zod"; import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getModelComboMappings, createModelComboMapping } from "@/lib/localDb"; import { validateBody, isValidationFailure } from "@/shared/validation/helpers"; @@ -17,19 +18,23 @@ const createMappingSchema = z.object({ description: z.string().max(1000).optional().default(""), }); -export async function GET() { +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const mappings = await getModelComboMappings(); return NextResponse.json({ mappings }); } catch (error: any) { - return NextResponse.json( - { error: error.message || "Failed to list model-combo mappings" }, - { status: 500 } - ); + console.error("Failed to list model-combo mappings:", error); + return NextResponse.json({ error: "Failed to list model-combo mappings" }, { status: 500 }); } } export async function POST(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const rawBody = await request.json(); const validation = validateBody(createMappingSchema, rawBody); @@ -48,9 +53,7 @@ export async function POST(request: Request) { return NextResponse.json({ mapping }, { status: 201 }); } catch (error: any) { - return NextResponse.json( - { error: error.message || "Failed to create model-combo mapping" }, - { status: 500 } - ); + console.error("Failed to create model-combo mapping:", error); + return NextResponse.json({ error: "Failed to create model-combo mapping" }, { status: 500 }); } } diff --git a/src/app/api/oauth/[provider]/[action]/route.ts b/src/app/api/oauth/[provider]/[action]/route.ts index 086ef7da83..341eac7ee0 100755 --- a/src/app/api/oauth/[provider]/[action]/route.ts +++ b/src/app/api/oauth/[provider]/[action]/route.ts @@ -21,6 +21,7 @@ import { runWithProxyContext } from "@omniroute/open-sse/utils/proxyFetch.ts"; import { jsonObjectSchema, oauthExchangeSchema, + oauthImportTokenSchema, oauthPollSchema, } from "@/shared/validation/schemas"; import { isValidationFailure, validateBody } from "@/shared/validation/helpers"; @@ -30,6 +31,16 @@ import { isAuthRequired, isAuthenticated } from "@/shared/utils/apiAuth"; if (!globalThis.__codexCallbackState) { globalThis.__codexCallbackState = null; } +// Windsurf / Devin CLI PKCE callback server state (separate from Codex) +if (!globalThis.__windsurfCallbackState) { + globalThis.__windsurfCallbackState = null; +} + +/** Providers that use the PKCE browser callback flow (like Codex). */ +const PKCE_CALLBACK_PROVIDERS = new Set(["codex", "windsurf", "devin-cli"]); + +/** Providers that allow direct import of a raw API token (no OAuth exchange). */ +const IMPORT_TOKEN_PROVIDERS = new Set(["windsurf", "devin-cli"]); /** * Constant-time string comparison to prevent timing-oracle attacks (CWE-208). @@ -144,46 +155,50 @@ export async function GET( return NextResponse.json({ error: "Unknown action" }, { status: 400 }); } catch (error) { - console.log("OAuth GET error:", error); - return NextResponse.json({ error: (error as any).message }, { status: 500 }); + console.error("OAuth GET error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } /** - * Start Codex callback server on port 1455 - * Returns the auth URL and stores codeVerifier for later exchange + * Start PKCE callback server for Codex, Windsurf, or Devin CLI. + * Codex uses fixed port 1455; Windsurf/Devin CLI use a random free port (port 0). + * Returns the auth URL and stores codeVerifier for later exchange. */ async function handleStartCallbackServer(provider: string, searchParams: URLSearchParams) { - if (provider !== "codex") { + if (!PKCE_CALLBACK_PROVIDERS.has(provider)) { return NextResponse.json( - { error: "Callback server only supported for codex" }, + { error: `Callback server not supported for provider: ${provider}` }, { status: 400 } ); } + const isWindsurf = provider === "windsurf" || provider === "devin-cli"; + const stateKey = isWindsurf ? "__windsurfCallbackState" : "__codexCallbackState"; + // Clean up existing server if any - if (globalThis.__codexCallbackState?.close) { + if (globalThis[stateKey]?.close) { try { - globalThis.__codexCallbackState.close(); + globalThis[stateKey].close(); } catch (e) { /* ignore */ } } - globalThis.__codexCallbackState = null; + globalThis[stateKey] = null; try { - // Start temp server on port 1455 + // Codex: fixed port 1455. Windsurf/Devin CLI: OS-assigned random port (0) + const serverPort = isWindsurf ? 0 : 1455; const { port, close } = await startLocalServer((params) => { - // Write directly to globalThis so it survives module reloads - if (globalThis.__codexCallbackState) { - globalThis.__codexCallbackState.callbackParams = params; + if (globalThis[stateKey]) { + globalThis[stateKey].callbackParams = params; } - }, 1455); + }, serverPort); const redirectUri = `http://localhost:${port}/auth/callback`; const authData = generateAuthData(provider, redirectUri); - globalThis.__codexCallbackState = { + globalThis[stateKey] = { callbackParams: null, close, port, @@ -195,13 +210,13 @@ async function handleStartCallbackServer(provider: string, searchParams: URLSear // Auto-cleanup after 5 minutes const startedAt = Date.now(); setTimeout(() => { - if (globalThis.__codexCallbackState?.startedAt === startedAt) { + if (globalThis[stateKey]?.startedAt === startedAt) { try { close(); } catch (e) { /* ignore */ } - globalThis.__codexCallbackState = null; + globalThis[stateKey] = null; } }, 300000); @@ -212,7 +227,8 @@ async function handleStartCallbackServer(provider: string, searchParams: URLSear serverPort: port, }); } catch (error) { - return NextResponse.json({ error: (error as any).message }, { status: 500 }); + console.error("OAuth start-callback-server error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } @@ -263,6 +279,12 @@ export async function POST( return NextResponse.json({ error: validation.error }, { status: 400 }); } body = validation.data; + } else if (action === "import-token") { + const validation = validateBody(oauthImportTokenSchema, rawBody); + if (isValidationFailure(validation)) { + return NextResponse.json({ error: validation.error }, { status: 400 }); + } + body = validation.data; } if (action === "exchange") { @@ -454,15 +476,20 @@ export async function POST( if (action === "poll-callback") { const { connectionId } = body; - // Poll for Codex callback server result - if (provider !== "codex") { + // poll-callback is supported for all PKCE callback providers + if (!PKCE_CALLBACK_PROVIDERS.has(provider)) { return NextResponse.json( - { error: "poll-callback only supported for codex" }, + { + error: `poll-callback only supported for PKCE callback providers: ${[...PKCE_CALLBACK_PROVIDERS].join(", ")}`, + }, { status: 400 } ); } - if (!globalThis.__codexCallbackState) { + // Windsurf and Devin CLI share __windsurfCallbackState; Codex uses its own slot + const stateKey = provider === "codex" ? "__codexCallbackState" : "__windsurfCallbackState"; + + if (!globalThis[stateKey]) { return NextResponse.json({ success: false, error: "no_server", @@ -470,13 +497,13 @@ export async function POST( }); } - if (!globalThis.__codexCallbackState.callbackParams) { + if (!globalThis[stateKey].callbackParams) { return NextResponse.json({ success: false, pending: true }); } // Callback received! Extract code and exchange for tokens - const params = globalThis.__codexCallbackState.callbackParams; - const { redirectUri, codeVerifier, close } = globalThis.__codexCallbackState; + const params = globalThis[stateKey].callbackParams; + const { redirectUri, codeVerifier, close } = globalThis[stateKey]; // Clean up server try { @@ -484,7 +511,7 @@ export async function POST( } catch (e) { /* ignore */ } - globalThis.__codexCallbackState = null; + globalThis[stateKey] = null; if (params.error) { return NextResponse.json({ @@ -567,14 +594,158 @@ export async function POST( }, }); } catch (exchangeErr: any) { - return NextResponse.json({ success: false, error: exchangeErr.message }, { status: 500 }); + console.error("OAuth exchange error:", exchangeErr); + return NextResponse.json( + { success: false, error: "Internal server error" }, + { status: 500 } + ); + } + } + + if (action === "import-token") { + const { token, connectionId } = body; + + if (!IMPORT_TOKEN_PROVIDERS.has(provider)) { + return NextResponse.json( + { + error: `import-token not supported for provider: ${provider}. Supported: ${[...IMPORT_TOKEN_PROVIDERS].join(", ")}`, + }, + { status: 400 } + ); + } + + try { + // Map the raw token via the provider's mapTokens() — skips the HTTP exchange entirely. + const providerData = getProvider(provider); + const tokenData = providerData.mapTokens({ accessToken: token }); + + // Normalize: if name is missing, use email as fallback display label + if (!tokenData.name && (tokenData.email || tokenData.displayName)) { + tokenData.name = tokenData.email || tokenData.displayName; + } + + const expiresAt = tokenData.expiresIn + ? new Date(Date.now() + tokenData.expiresIn * 1000).toISOString() + : null; + + let connection: any; + if (tokenData.email) { + const existing = await getProviderConnections({ provider }); + const match = existing.find((c: any) => { + if (c.id && safeEqual(connectionId, c.id)) return true; + if (!safeEqual(c.email, tokenData.email) || c.authType !== "oauth") return false; + return true; + }); + const matchId = typeof match?.id === "string" ? match.id : null; + if (matchId) { + connection = await updateProviderConnection(matchId, { + ...tokenData, + expiresAt, + testStatus: "active", + isActive: true, + }); + } + } + if (!connection) { + connection = await createProviderConnection({ + provider, + authType: "oauth", + ...tokenData, + expiresAt, + testStatus: "active", + }); + } + + await syncToCloudIfEnabled(); + + return NextResponse.json({ + success: true, + connection: { + id: connection.id, + provider: connection.provider, + email: connection.email, + displayName: connection.displayName, + }, + }); + } catch (importErr: any) { + return NextResponse.json({ success: false, error: importErr.message }, { status: 500 }); + } + } + + if (action === "import-token") { + const { token, connectionId } = body; + + if (!IMPORT_TOKEN_PROVIDERS.has(provider)) { + return NextResponse.json( + { + error: `import-token not supported for provider: ${provider}. Supported: ${[...IMPORT_TOKEN_PROVIDERS].join(", ")}`, + }, + { status: 400 } + ); + } + + try { + // Map the raw token via the provider's mapTokens() — skips the HTTP exchange entirely. + const providerData = getProvider(provider); + const tokenData = providerData.mapTokens({ accessToken: token }); + + // Normalize: if name is missing, use email as fallback display label + if (!tokenData.name && (tokenData.email || tokenData.displayName)) { + tokenData.name = tokenData.email || tokenData.displayName; + } + + const expiresAt = tokenData.expiresIn + ? new Date(Date.now() + tokenData.expiresIn * 1000).toISOString() + : null; + + let connection: any; + if (tokenData.email) { + const existing = await getProviderConnections({ provider }); + const match = existing.find((c: any) => { + if (c.id && safeEqual(connectionId, c.id)) return true; + if (!safeEqual(c.email, tokenData.email) || c.authType !== "oauth") return false; + return true; + }); + const matchId = typeof match?.id === "string" ? match.id : null; + if (matchId) { + connection = await updateProviderConnection(matchId, { + ...tokenData, + expiresAt, + testStatus: "active", + isActive: true, + }); + } + } + if (!connection) { + connection = await createProviderConnection({ + provider, + authType: "oauth", + ...tokenData, + expiresAt, + testStatus: "active", + }); + } + + await syncToCloudIfEnabled(); + + return NextResponse.json({ + success: true, + connection: { + id: connection.id, + provider: connection.provider, + email: connection.email, + displayName: connection.displayName, + }, + }); + } catch (importErr: any) { + return NextResponse.json({ success: false, error: importErr.message }, { status: 500 }); } } return NextResponse.json({ error: "Unknown action" }, { status: 400 }); } catch (error) { - console.log("OAuth POST error:", error); - return NextResponse.json({ error: (error as any).message }, { status: 500 }); + console.error("OAuth POST error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/cursor/auto-import/route.ts b/src/app/api/oauth/cursor/auto-import/route.ts index aae3925059..937e0fd6c3 100755 --- a/src/app/api/oauth/cursor/auto-import/route.ts +++ b/src/app/api/oauth/cursor/auto-import/route.ts @@ -86,7 +86,8 @@ function tryIdeAuth(): { }; } catch (error) { db?.close(); - return { found: false, error: `Failed to read database: ${(error as any).message}` }; + console.error("Failed to read Cursor IDE database:", error); + return { found: false, error: "Failed to read database" }; } } @@ -132,7 +133,7 @@ export async function GET(request: Request) { error: "No Cursor credentials found. Install Cursor IDE or login with cursor-agent.", }); } catch (error) { - console.log("Cursor auto-import error:", error); - return NextResponse.json({ found: false, error: (error as any).message }, { status: 500 }); + console.error("Cursor auto-import error:", error); + return NextResponse.json({ found: false, error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/cursor/import/route.ts b/src/app/api/oauth/cursor/import/route.ts index f2ba171d62..026cfc51cd 100755 --- a/src/app/api/oauth/cursor/import/route.ts +++ b/src/app/api/oauth/cursor/import/route.ts @@ -58,22 +58,33 @@ export async function POST(request: Request) { cursorService.validateImportToken(accessToken.trim(), machineId?.trim()) ); - // Try to extract user info from token - const userInfo = cursorService.extractUserInfo(tokenData.accessToken); + // Try to extract user info from token (JWT decode, no API call) + const jwtInfo = cursorService.extractUserInfo(tokenData.accessToken); - // Save to database + // Best-effort fetch real profile (email + name) from cursor.com using the + // same WorkOS session cookie format we use for usage limits. + const profile = jwtInfo?.userId + ? await runWithProxyContext(proxy, () => + cursorService.fetchUserInfo(tokenData.accessToken, jwtInfo.userId) + ) + : null; + + const email = profile?.email || jwtInfo?.email || null; + + // Save to database (no `name` — let the dashboard fall back to email so the + // privacy mask toggle applies, matching the codex/claude rendering). const connection: any = await createProviderConnection({ provider: "cursor", authType: "oauth", accessToken: tokenData.accessToken, refreshToken: null, // Cursor doesn't have public refresh endpoint expiresAt: new Date(Date.now() + tokenData.expiresIn * 1000).toISOString(), - email: userInfo?.email || null, + email, providerSpecificData: { machineId: tokenData.machineId, authMethod: "imported", provider: "Imported", - userId: userInfo?.userId, + userId: jwtInfo?.userId, }, testStatus: "active", }); @@ -90,8 +101,8 @@ export async function POST(request: Request) { }, }); } catch (error: any) { - console.log("Cursor import token error:", error); - return NextResponse.json({ error: error.message }, { status: 500 }); + console.error("Cursor import token error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/kiro/auto-import/route.ts b/src/app/api/oauth/kiro/auto-import/route.ts index 25c0f27487..56e43835b7 100755 --- a/src/app/api/oauth/kiro/auto-import/route.ts +++ b/src/app/api/oauth/kiro/auto-import/route.ts @@ -1,14 +1,22 @@ import { NextResponse } from "next/server"; -import { readFile, readdir } from "fs/promises"; import { homedir } from "os"; import { join } from "path"; import { isAuthRequired, isAuthenticated } from "@/shared/utils/apiAuth"; +import { createProviderConnection, isCloudEnabled, resolveProxyForProvider } from "@/models"; +import { syncToCloud } from "@/lib/cloudSync"; +import { getConsistentMachineId } from "@/shared/utils/machineId"; +import { KiroService } from "@/lib/oauth/services/kiro"; +import { runWithProxyContext } from "@omniroute/open-sse/utils/proxyFetch.ts"; /** * GET /api/oauth/kiro/auto-import - * Auto-detect and extract Kiro refresh token from AWS SSO cache. * - * 🔒 Auth-guarded: requires JWT cookie or Bearer API key (finding #258-5). + * Auto-import Kiro credentials from kiro-cli's SQLite database. + * Supports both personal Builder ID and enterprise SSO (IDC/profileArn). + * + * Falls back to ~/.aws/sso/cache if kiro-cli SQLite is not found. + * + * 🔒 Auth-guarded: requires JWT cookie or Bearer API key. */ export async function GET(request: Request) { if (await isAuthRequired(request)) { @@ -17,79 +25,246 @@ export async function GET(request: Request) { } } + const { searchParams } = new URL(request.url); + const targetProvider = searchParams.get("targetProvider") === "amazon-q" ? "amazon-q" : "kiro"; + + // Try kiro-cli SQLite first + const sqliteResult = await tryKiroCliSqlite(); + if (sqliteResult.found) { + return await saveAndRespond(sqliteResult, targetProvider, request); + } + + // Fall back to ~/.aws/sso/cache (social auth / manual token) + const cacheResult = await tryAwsSsoCache(targetProvider); + if (cacheResult.found) { + return await saveAndRespond(cacheResult, targetProvider, request); + } + + return NextResponse.json({ + found: false, + error: + "Kiro credentials not found. " + + "Run `kiro-cli login --use-device-flow` then retry, " + + "or use the Import Token option in the dashboard.", + triedPaths: [sqliteResult.triedPath, cacheResult.triedPath].filter(Boolean), + }); +} + +// ── kiro-cli SQLite reader ──────────────────────────────────────────────────── + +async function tryKiroCliSqlite(): Promise<{ + found: boolean; + triedPath?: string; + refreshToken?: string; + accessToken?: string; + expiresAt?: string; + clientId?: string; + clientSecret?: string; + region?: string; + profileArn?: string; + source?: string; +}> { + const dbPath = join(homedir(), ".local/share/kiro-cli/data.sqlite3"); + + let Database: any; try { - const { searchParams } = new URL(request.url); - const targetProvider = searchParams.get("targetProvider") === "amazon-q" ? "amazon-q" : "kiro"; - const providerLabel = targetProvider === "amazon-q" ? "Amazon Q" : "Kiro"; - const cachePath = join(homedir(), ".aws/sso/cache"); + Database = (await import("better-sqlite3")).default; + } catch { + return { found: false, triedPath: dbPath }; + } - // Try to read cache directory - let files; - try { - files = await readdir(cachePath); - } catch (error) { - return NextResponse.json({ - found: false, - error: `AWS SSO cache not found. Please login to ${providerLabel} first.`, - }); - } - - // Look for kiro-auth-token.json or any .json file with refreshToken - let refreshToken = null; - let foundFile = null; - - // First try kiro-auth-token.json - const preferredTokenFile = - targetProvider === "amazon-q" ? "amazon-q-auth-token.json" : "kiro-auth-token.json"; - if (files.includes(preferredTokenFile)) { - try { - const content = await readFile(join(cachePath, preferredTokenFile), "utf-8"); - const data = JSON.parse(content); - if (data.refreshToken && data.refreshToken.startsWith("aorAAAAAG")) { - refreshToken = data.refreshToken; - foundFile = preferredTokenFile; - } - } catch (error) { - // Continue to search other files - } - } - - // If not found, search all .json files - if (!refreshToken) { - for (const file of files) { - if (!file.endsWith(".json")) continue; + let db: any; + try { + db = new Database(dbPath, { readonly: true, fileMustExist: true }); + } catch { + return { found: false, triedPath: dbPath }; + } + try { + // Read OIDC token (access + refresh token) + const tokenKeys = ["kirocli:odic:token", "kirocli:oidc:token"]; + let tokenData: any = null; + for (const key of tokenKeys) { + const row = db.prepare("SELECT value FROM auth_kv WHERE key = ?").get(key) as + | { value: string } + | undefined; + if (row?.value) { try { - const content = await readFile(join(cachePath, file), "utf-8"); - const data = JSON.parse(content); - - // Look for Kiro refresh token (starts with aorAAAAAG) - if (data.refreshToken && data.refreshToken.startsWith("aorAAAAAG")) { - refreshToken = data.refreshToken; - foundFile = file; - break; - } - } catch (error) { - // Skip invalid JSON files - continue; + tokenData = JSON.parse(row.value); + break; + } catch { + // continue } } } - if (!refreshToken) { - return NextResponse.json({ - found: false, - error: `${providerLabel} token not found in AWS SSO cache. Please login to ${providerLabel} first.`, - }); + if (!tokenData?.refresh_token) { + return { found: false, triedPath: dbPath }; + } + + // Read device registration (client_id + client_secret) + const regKeys = ["kirocli:odic:device-registration", "kirocli:oidc:device-registration"]; + let regData: any = null; + for (const key of regKeys) { + const row = db.prepare("SELECT value FROM auth_kv WHERE key = ?").get(key) as + | { value: string } + | undefined; + if (row?.value) { + try { + regData = JSON.parse(row.value); + break; + } catch { + // continue + } + } + } + + // Read profileArn from state table (enterprise SSO / IDC) + let profileArn: string | undefined; + try { + const profileRow = db + .prepare("SELECT value FROM state WHERE key = 'api.codewhisperer.profile'") + .get() as { value: string } | undefined; + if (profileRow?.value) { + const profileData = JSON.parse(profileRow.value); + profileArn = profileData.arn || profileData.profileArn; + } + } catch { + // state table may not exist for personal Builder ID accounts + } + + const region = tokenData.region || regData?.region || "us-east-1"; + const expiresAt = tokenData.expires_at + ? new Date(tokenData.expires_at).toISOString() + : new Date(Date.now() + 3600 * 1000).toISOString(); + + return { + found: true, + source: "kiro-cli-sqlite", + refreshToken: tokenData.refresh_token, + accessToken: tokenData.access_token, + expiresAt, + clientId: regData?.client_id, + clientSecret: regData?.client_secret, + region, + profileArn, + }; + } finally { + db.close(); + } +} + +// ── ~/.aws/sso/cache fallback ───────────────────────────────────────────────── + +async function tryAwsSsoCache(targetProvider: string): Promise<{ + found: boolean; + triedPath?: string; + refreshToken?: string; + source?: string; +}> { + const { readFile, readdir } = await import("fs/promises"); + const cachePath = join(homedir(), ".aws/sso/cache"); + const preferredFile = + targetProvider === "amazon-q" ? "amazon-q-auth-token.json" : "kiro-auth-token.json"; + + let files: string[]; + try { + files = await readdir(cachePath); + } catch { + return { found: false, triedPath: cachePath }; + } + + // Try preferred file first, then scan all + const ordered = [ + preferredFile, + ...files.filter((f) => f !== preferredFile && f.endsWith(".json")), + ]; + + for (const file of ordered) { + try { + const content = await readFile(join(cachePath, file), "utf-8"); + const data = JSON.parse(content); + if (data.refreshToken?.startsWith("aorAAAAAG")) { + return { found: true, refreshToken: data.refreshToken, source: file }; + } + } catch { + // skip + } + } + + return { found: false, triedPath: cachePath }; +} + +// ── Save to OmniRoute DB ────────────────────────────────────────────────────── + +async function saveAndRespond( + result: Awaited<ReturnType<typeof tryKiroCliSqlite>>, + targetProvider: string, + request: Request +) { + try { + const kiroService = new KiroService(); + const proxy = await resolveProxyForProvider(targetProvider); + + // If we have a refresh token but no valid access token, refresh now + let accessToken = result.accessToken; + let refreshToken = result.refreshToken!; + let expiresAt = result.expiresAt; + let profileArn = result.profileArn; + + const providerSpecificData: Record<string, any> = { + authMethod: result.source === "kiro-cli-sqlite" ? "kiro-cli" : "imported", + provider: result.source === "kiro-cli-sqlite" ? "kiro-cli SQLite" : "AWS SSO Cache", + }; + + if (result.clientId) providerSpecificData.clientId = result.clientId; + if (result.clientSecret) providerSpecificData.clientSecret = result.clientSecret; + if (result.region) providerSpecificData.region = result.region; + if (profileArn) providerSpecificData.profileArn = profileArn; + + // Refresh token to get a fresh access token and confirm it works + const refreshed = await runWithProxyContext(proxy, () => + kiroService.refreshToken(refreshToken, providerSpecificData) + ); + + accessToken = refreshed.accessToken; + refreshToken = refreshed.refreshToken || refreshToken; + expiresAt = new Date(Date.now() + (refreshed.expiresIn || 3600) * 1000).toISOString(); + + // profileArn may come back from social auth refresh + if (refreshed.profileArn && !profileArn) { + profileArn = refreshed.profileArn; + providerSpecificData.profileArn = profileArn; + } + + const email = kiroService.extractEmailFromJWT(accessToken); + + await createProviderConnection({ + provider: targetProvider, + authType: "oauth", + accessToken, + refreshToken, + expiresAt, + email: email || null, + providerSpecificData, + testStatus: "active", + } as any); + + if (isCloudEnabled()) { + const machineId = await getConsistentMachineId(); + await syncToCloud(machineId).catch(() => {}); } return NextResponse.json({ found: true, - refreshToken, - source: foundFile, + source: result.source, + email: email || null, + profileArn: profileArn || null, + region: result.region || null, + message: "Kiro credentials imported successfully.", }); - } catch (error) { - console.log("Kiro auto-import error:", error); - return NextResponse.json({ found: false, error: error.message }, { status: 500 }); + } catch (error: any) { + console.error("[kiro auto-import] save error:", error); + return NextResponse.json({ found: false, error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/kiro/import/route.ts b/src/app/api/oauth/kiro/import/route.ts index 44803229e5..ac65ed0ce6 100755 --- a/src/app/api/oauth/kiro/import/route.ts +++ b/src/app/api/oauth/kiro/import/route.ts @@ -87,8 +87,8 @@ export async function POST(request: Request) { }, }); } catch (error: any) { - console.log("Kiro-compatible import token error:", error); - return NextResponse.json({ error: error.message }, { status: 500 }); + console.error("Kiro-compatible import token error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/kiro/social-authorize/route.ts b/src/app/api/oauth/kiro/social-authorize/route.ts index 61df8219af..6a557abb43 100755 --- a/src/app/api/oauth/kiro/social-authorize/route.ts +++ b/src/app/api/oauth/kiro/social-authorize/route.ts @@ -38,7 +38,7 @@ export async function GET(request) { provider, }); } catch (error) { - console.log("Kiro social authorize error:", error); - return NextResponse.json({ error: error.message }, { status: 500 }); + console.error("Kiro social authorize error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/oauth/kiro/social-exchange/route.ts b/src/app/api/oauth/kiro/social-exchange/route.ts index 950c59e8db..10bafd4cf4 100755 --- a/src/app/api/oauth/kiro/social-exchange/route.ts +++ b/src/app/api/oauth/kiro/social-exchange/route.ts @@ -75,8 +75,8 @@ export async function POST(request: Request) { }, }); } catch (error: any) { - console.log("Kiro social exchange error:", error); - return NextResponse.json({ error: error.message }, { status: 500 }); + console.error("Kiro social exchange error:", error); + return NextResponse.json({ error: "Internal server error" }, { status: 500 }); } } diff --git a/src/app/api/openapi/spec/route.ts b/src/app/api/openapi/spec/route.ts index c4798b3a92..31ef74abb9 100644 --- a/src/app/api/openapi/spec/route.ts +++ b/src/app/api/openapi/spec/route.ts @@ -10,6 +10,9 @@ import yaml from "js-yaml"; let cachedSpec: { data: any; mtime: number } | null = null; const OPENAPI_SPEC_CANDIDATES = [ + path.join(/* turbopackIgnore: true */ process.cwd(), "docs", "reference", "openapi.yaml"), + path.join(/* turbopackIgnore: true */ process.cwd(), "app", "docs", "reference", "openapi.yaml"), + // Legacy locations kept as fallback for old standalone bundles. path.join(/* turbopackIgnore: true */ process.cwd(), "docs", "openapi.yaml"), path.join(/* turbopackIgnore: true */ process.cwd(), "app", "docs", "openapi.yaml"), ]; diff --git a/src/app/api/pricing/route.ts b/src/app/api/pricing/route.ts index 3ea891cb78..7db9659574 100644 --- a/src/app/api/pricing/route.ts +++ b/src/app/api/pricing/route.ts @@ -1,4 +1,5 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getPricing, getPricingWithSources, @@ -14,6 +15,9 @@ import { isValidationFailure, validateBody } from "@/shared/validation/helpers"; * Get current pricing configuration (merged user + defaults) */ export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const includeSources = new URL(request.url).searchParams.get("includeSources") === "1"; if (includeSources) { @@ -34,6 +38,9 @@ export async function GET(request: Request) { * Body: { provider: { model: { input: number, output: number, cached: number, ... } } } */ export async function PATCH(request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + let rawBody; try { rawBody = await request.json(); @@ -70,6 +77,9 @@ export async function PATCH(request) { * Query params: ?provider=xxx&model=yyy (optional) */ export async function DELETE(request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { searchParams } = new URL(request.url); const provider = searchParams.get("provider"); diff --git a/src/app/api/pricing/sync/route.ts b/src/app/api/pricing/sync/route.ts index b60d78fccf..1ff9ece74f 100644 --- a/src/app/api/pricing/sync/route.ts +++ b/src/app/api/pricing/sync/route.ts @@ -7,10 +7,14 @@ */ import { NextRequest, NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { pricingSyncRequestSchema } from "@/shared/validation/schemas"; import { isValidationFailure, validateBody } from "@/shared/validation/helpers"; export async function POST(request: NextRequest) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + let rawBody: unknown; try { rawBody = await request.json(); @@ -43,7 +47,10 @@ export async function POST(request: NextRequest) { } } -export async function GET() { +export async function GET(request: NextRequest) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { getSyncStatus } = await import("@/lib/pricingSync"); return NextResponse.json(getSyncStatus()); @@ -53,7 +60,10 @@ export async function GET() { } } -export async function DELETE() { +export async function DELETE(request: NextRequest) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { clearSyncedPricing } = await import("@/lib/pricingSync"); clearSyncedPricing(); diff --git a/src/app/api/provider-nodes/validate/route.ts b/src/app/api/provider-nodes/validate/route.ts index bc2d13c962..22d9136f73 100644 --- a/src/app/api/provider-nodes/validate/route.ts +++ b/src/app/api/provider-nodes/validate/route.ts @@ -1,4 +1,5 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getAuditRequestContext, logAuditEvent } from "@/lib/compliance/index"; import { validateClaudeCodeCompatibleProvider } from "@/lib/providers/validation"; import { @@ -41,6 +42,9 @@ function sanitizeAuditBaseUrl(baseUrl: string) { // POST /api/provider-nodes/validate - Validate API key against base URL export async function POST(request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + const auditContext = getAuditRequestContext(request); let rawBody; try { diff --git a/src/app/api/providers/[id]/models/route.ts b/src/app/api/providers/[id]/models/route.ts index de67c6487b..d86c6daaca 100755 --- a/src/app/api/providers/[id]/models/route.ts +++ b/src/app/api/providers/[id]/models/route.ts @@ -21,7 +21,11 @@ import { import { getProviderOutboundGuard } from "@/shared/network/outboundUrlGuard"; import { getStaticQoderModels } from "@omniroute/open-sse/services/qoderCli.ts"; import { getAntigravityHeaders } from "@omniroute/open-sse/services/antigravityHeaders.ts"; -import { getAntigravityModelsDiscoveryUrls } from "@omniroute/open-sse/config/antigravityUpstream.ts"; +import { ensureAntigravityProjectAssigned } from "@omniroute/open-sse/services/antigravityProjectBootstrap.ts"; +import { + getAntigravityModelsDiscoveryUrls, + getAntigravityFetchAvailableModelsUrls, +} from "@omniroute/open-sse/config/antigravityUpstream.ts"; import { buildGlmCodingHeaders, buildGlmModelsUrl, @@ -229,8 +233,12 @@ async function fetchAntigravityDiscoveryModelsCached( const promise = (async () => { await resolveAntigravityVersion(); + await ensureAntigravityProjectAssigned(accessToken); - for (const discoveryUrl of getAntigravityModelsDiscoveryUrls()) { + for (const discoveryUrl of [ + ...getAntigravityFetchAvailableModelsUrls(), + ...getAntigravityModelsDiscoveryUrls(), + ]) { try { const response = await safeOutboundFetch(discoveryUrl, { ...SAFE_OUTBOUND_FETCH_PRESETS.modelsDiscovery, @@ -394,14 +402,12 @@ const STATIC_MODEL_PROVIDERS: Record<string, () => Array<{ id: string; name: str { id: "sonar-deep-research", name: "Sonar Deep Research (Expert Analysis)" }, ], "bailian-coding-plan": () => [ - { id: "qwen3.5-plus", name: "Qwen3.5 Plus" }, - { id: "qwen3-max-2026-01-23", name: "Qwen3 Max (2026-01-23)" }, - { id: "qwen3-coder-next", name: "Qwen3 Coder Next" }, - { id: "qwen3-coder-plus", name: "Qwen3 Coder Plus" }, - { id: "MiniMax-M2.5", name: "MiniMax M2.5" }, + { id: "qwen3.6-plus", name: "Qwen3.6 Plus(vision)" }, + { id: "qwen3.5-plus", name: "Qwen3.5 Plus(vision)" }, + { id: "qwen3-max-2026-01-23", name: "Qwen3 Max" }, + { id: "kimi-k2.5", name: "Kimi K2.5(vision)" }, { id: "glm-5", name: "GLM 5" }, - { id: "glm-4.7", name: "GLM 4.7" }, - { id: "kimi-k2.5", name: "Kimi K2.5" }, + { id: "MiniMax-M2.5", name: "MiniMax M2.5" }, ], gitlab: () => [{ id: "gitlab-duo-code-suggestions", name: "GitLab Duo Code Suggestions" }], nlpcloud: () => @@ -854,8 +860,10 @@ export async function GET( return localCatalog.map((model) => ({ id: model.id, name: model.name || model.id, - ...(model.apiFormat ? { apiFormat: model.apiFormat } : {}), - ...(model.supportedEndpoints ? { supportedEndpoints: model.supportedEndpoints } : {}), + ...((model as any).apiFormat ? { apiFormat: (model as any).apiFormat } : {}), + ...((model as any).supportedEndpoints + ? { supportedEndpoints: (model as any).supportedEndpoints } + : {}), ...(registryCatalogModels.length > 0 ? { owned_by: provider } : {}), })); }; @@ -902,7 +910,7 @@ export async function GET( } ) => { const status = getSafeOutboundFetchErrorStatus(error); - if (status === 400) return null; + if (status === 400 || status === 503 || status === 504) return null; return buildDiscoveryFallbackResponse(warnings); }; @@ -1852,8 +1860,10 @@ export async function GET( models: localCatalog.map((m) => ({ id: m.id, name: m.name || m.id, - ...(m.apiFormat ? { apiFormat: m.apiFormat } : {}), - ...(m.supportedEndpoints ? { supportedEndpoints: m.supportedEndpoints } : {}), + ...((m as any).apiFormat ? { apiFormat: (m as any).apiFormat } : {}), + ...((m as any).supportedEndpoints + ? { supportedEndpoints: (m as any).supportedEndpoints } + : {}), ...(registryCatalogModels.length > 0 ? { owned_by: provider } : {}), })), source: "local_catalog", diff --git a/src/app/api/providers/[id]/route.ts b/src/app/api/providers/[id]/route.ts index 3925f88c11..4e954bc917 100644 --- a/src/app/api/providers/[id]/route.ts +++ b/src/app/api/providers/[id]/route.ts @@ -23,6 +23,7 @@ import { isClaudeExtraUsageBlockEnabled, } from "@/lib/providers/claudeExtraUsage"; import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { isApiKeyRevealEnabled, maskStoredApiKey } from "@/lib/apiKeyExposure"; function normalizeCodexLimitPolicy( incoming: unknown, @@ -61,9 +62,13 @@ export async function GET(request: Request, { params }: { params: Promise<{ id: return NextResponse.json({ error: "Connection not found" }, { status: 404 }); } - // Hide sensitive fields + const revealKeys = isApiKeyRevealEnabled(); + + // Hide or mask sensitive fields const result: Record<string, any> = { ...connection }; - delete result.apiKey; + if (!revealKeys) { + result.apiKey = result.apiKey ? maskStoredApiKey(result.apiKey) : undefined; + } delete result.accessToken; delete result.refreshToken; delete result.idToken; diff --git a/src/app/api/providers/[id]/sync-models/route.ts b/src/app/api/providers/[id]/sync-models/route.ts index a8b807985b..036a627477 100644 --- a/src/app/api/providers/[id]/sync-models/route.ts +++ b/src/app/api/providers/[id]/sync-models/route.ts @@ -154,44 +154,205 @@ function getModelSyncChannelLabel(connection: unknown) { ); } +// --------------------------------------------------------------------------- +// Shared loopback readiness gate — eliminates 17× retry amplification at boot +// --------------------------------------------------------------------------- + +// Module-level shared promise: gates all selfFetchWithRetry callers behind a +// single readiness probe. The 17 connections that fire ModelSync at boot all +// await the same promise; the underlying HTTP probe runs exactly once per +// process. Resolves on first HTTP response (any status — even 4xx confirms the +// server is up); rejects only if maxWaitMs elapses with consistent network +// errors. +let __loopbackReadyPromise: Promise<void> | null = null; + +export type EnsureReadyOptions = { + fetch?: typeof fetch; + maxWaitMs?: number; + pollMs?: number; +}; + +export async function ensureLoopbackServerReady(opts: EnsureReadyOptions = {}): Promise<void> { + if (__loopbackReadyPromise) return __loopbackReadyPromise; + __loopbackReadyPromise = (async () => { + const f = opts.fetch ?? fetch; + const maxWaitMs = opts.maxWaitMs ?? 30_000; + const pollMs = opts.pollMs ?? 250; + const deadline = Date.now() + maxWaitMs; + let lastErr: unknown; + while (Date.now() < deadline) { + try { + // Hit a stable endpoint; any HTTP status (200/404/etc) confirms + // readiness — we only care that the dispatcher succeeds (no + // ECONNREFUSED). Using a synthetic connection id so no real DB lookup + // is needed; the 404 is sufficient proof the server is dispatching. + const probePort = process.env.OMNIROUTE_PORT || process.env.PORT || "20128"; + const res = await f( + `http://127.0.0.1:${probePort}/api/providers/__readiness_probe__/models`, + { + signal: AbortSignal.timeout(2_000), + } + ); + if (res.status >= 200 && res.status < 600) return; + } catch (err) { + lastErr = err; + } + await new Promise((r) => setTimeout(r, pollMs)); + } + throw new Error(`loopback server not ready within ${maxWaitMs}ms: ${String(lastErr)}`); + })(); + return __loopbackReadyPromise; +} + +/** Test helper: reset the cached promise so tests can re-exercise the probe. */ +export function __resetLoopbackReadinessForTests(): void { + __loopbackReadyPromise = null; +} + +// --------------------------------------------------------------------------- +// selfFetchWithRetry — exported for unit testing +// --------------------------------------------------------------------------- + +export type SelfFetchWithRetryOptions = { + /** Injectable fetch implementation; defaults to global fetch. */ + fetch?: typeof fetch; + /** Maximum number of HTTP attempts before falling back. Default: 3. */ + maxRetries?: number; + /** + * Base backoff in ms. Each attempt waits backoffMs * (attempt + 1) before + * the next try (linear growth: 200 ms, 400 ms, 600 ms, ... at default 200 ms). + * Default: 200. + */ + backoffMs?: number; + /** Connection ID used only for the warning log message. Optional. */ + connectionId?: string; + /** + * Called as last-resort fallback after all retries are exhausted. + * Must return a Response. If omitted, returns a synthetic 503. + */ + inProcessFallback?: () => Promise<Response>; + /** + * Skip the shared readiness gate. Use in tests that exercise the retry + * loop in isolation without needing a live loopback server. + * Default: false. + */ + skipReadinessGate?: boolean; +}; + +/** + * Wraps a single loopback self-fetch URL with linear-backoff retry logic. + * + * Motivation: at container boot, ModelSync fires up to 17 concurrent + * self-fetches against http://127.0.0.1:PORT before the in-process HTTP + * listener is fully accepting connections. A shared readiness gate + * (ensureLoopbackServerReady) now serialises the boot race — all 17 callers + * await the same promise, so only one probe sequence runs. Retries here are + * a last-resort for transient failures AFTER the server is confirmed up. + * + * Retry contract: + * - Network errors (fetch failed, ECONNREFUSED): retry up to `maxRetries`. + * - Any HTTP response (2xx/4xx/5xx): returned as-is — the server is up, so the + * caller (route handler) handles status interpretation. Retries are only + * for network-level failures, not for HTTP errors. + */ +export async function selfFetchWithRetry( + url: string, + opts: SelfFetchWithRetryOptions = {} +): Promise<Response> { + const f = opts.fetch ?? fetch; + // Reduced from 5 to 3: the readiness gate now handles the boot race. + // Retries here are only for transient failures after server is confirmed up. + const maxRetries = opts.maxRetries ?? 3; + const backoffMs = opts.backoffMs ?? 200; + const connLabel = opts.connectionId ? opts.connectionId.slice(0, 8) : url.slice(-8); + + // Wait for the loopback server to be ready before firing. All concurrent + // callers share the same readiness promise — exactly ONE probe runs per + // process, eliminating the 17× retry amplification observed at boot. + if (opts.skipReadinessGate !== true) { + try { + await ensureLoopbackServerReady({ fetch: f }); + } catch (err) { + // Readiness probe timed out — fall straight through to in-process fallback. + console.warn( + `[ModelSync] Loopback server readiness probe failed; falling back to in-process route immediately (${connLabel}): ${String(err)}` + ); + if (opts.inProcessFallback) { + return opts.inProcessFallback(); + } + return new Response(JSON.stringify({ error: "self-fetch unavailable" }), { status: 503 }); + } + } + + let lastErr: unknown; + for (let attempt = 0; attempt < maxRetries; attempt++) { + try { + const res = await f(url, { method: "GET" }); + // Any HTTP response (2xx, 4xx, 5xx) means the server is up — return as-is. + // We only retry on network-level failures (ECONNREFUSED, "fetch failed") + // which indicate the loopback listener is not yet accepting connections. + return res; + } catch (err) { + lastErr = err; + } + if (attempt < maxRetries - 1) { + await new Promise<void>((r) => setTimeout(r, backoffMs * (attempt + 1))); + } + } + + // All retries exhausted (network-level failures only) — fall back to in-process route + console.warn( + `[ModelSync] Internal /models self-fetch failed for ${connLabel} after ${maxRetries} attempt(s); falling back to in-process route (last err: ${String(lastErr)})` + ); + + if (opts.inProcessFallback) { + return opts.inProcessFallback(); + } + return new Response(JSON.stringify({ error: "self-fetch unavailable" }), { status: 503 }); +} + +// --------------------------------------------------------------------------- +// fetchProviderModelsForSync — private orchestrator (uses selfFetchWithRetry) +// --------------------------------------------------------------------------- + async function fetchProviderModelsForSync(request: Request, connectionId: string) { // Construct a safe localhost URL from the incoming request's origin. // The route only accepts authenticated or internal-scheduler requests, // and the path is hardcoded — no user-controlled URL components reach fetch. + // Always use 127.0.0.1 (IPv4) — never "localhost" which may resolve to ::1 + // (IPv6) in containers, causing TypeError: fetch failed even when the HTTP + // server is bound only to 0.0.0.0 (IPv4 only). const SAFE_HOSTS = new Set(["localhost", "127.0.0.1", "0.0.0.0", "::1"]); const incomingUrl = new URL(request.url); - const safeOrigin = SAFE_HOSTS.has(incomingUrl.hostname) - ? incomingUrl.origin - : `http://127.0.0.1:${process.env.PORT || "20128"}`; + const loopbackPort = + SAFE_HOSTS.has(incomingUrl.hostname) && incomingUrl.port + ? incomingUrl.port + : process.env.PORT || "20128"; + const safeOrigin = `http://127.0.0.1:${loopbackPort}`; const modelsPath = `/api/providers/${encodeURIComponent(connectionId)}/models?refresh=true`; const headers = { cookie: request.headers.get("cookie") || "", ...buildModelSyncInternalHeaders(), }; - try { - return await fetch(new URL(modelsPath, safeOrigin).href, { - method: "GET", - cache: "no-store", - headers, - }); - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - console.warn( - `[ModelSync] Internal /models self-fetch failed for ${connectionId.slice( - 0, - 8 - )}; falling back to in-process route: ${message}` - ); + const targetUrl = new URL(modelsPath, safeOrigin).href; - return getProviderModels( - new Request(new URL(modelsPath, "http://localhost").href, { - method: "GET", - headers, - }), - { params: { id: connectionId } } - ); - } + // Wrap fetch so it forwards the required headers on every retry attempt. + const fetchWithHeaders: typeof fetch = (input, init) => + fetch(input as string, { ...init, headers }); + + return selfFetchWithRetry(targetUrl, { + fetch: fetchWithHeaders, + connectionId, + inProcessFallback: () => + getProviderModels( + new Request(new URL(modelsPath, "http://localhost").href, { + method: "GET", + headers, + }), + { params: { id: connectionId } } + ), + }); } /** diff --git a/src/app/api/providers/[id]/test/route.ts b/src/app/api/providers/[id]/test/route.ts index d1e7ab0b98..5d7c0956b4 100644 --- a/src/app/api/providers/[id]/test/route.ts +++ b/src/app/api/providers/[id]/test/route.ts @@ -21,6 +21,7 @@ import { isGitLabDirectAccessDisabled, resolveGitLabOAuthBaseUrl, } from "@/lib/oauth/gitlab"; +import { providerAllowsOptionalApiKey } from "@/shared/constants/providers"; // OAuth provider test endpoints const OAUTH_TEST_CONFIG = { @@ -522,7 +523,8 @@ async function testOAuthConnection(connection: any) { * Test API key connection */ async function testApiKeyConnection(connection: any) { - if (!connection.apiKey) { + const requiresApiKey = !providerAllowsOptionalApiKey(connection.provider); + if (requiresApiKey && !connection.apiKey) { const error = "Missing API key"; return { valid: false, diff --git a/src/app/api/providers/command-code/auth/apply/route.ts b/src/app/api/providers/command-code/auth/apply/route.ts new file mode 100644 index 0000000000..9e4cb24f0a --- /dev/null +++ b/src/app/api/providers/command-code/auth/apply/route.ts @@ -0,0 +1,101 @@ +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { consumeCommandCodeAuthSecret } from "@/lib/db/commandCodeAuth"; +import { + createProviderConnection, + getProviderConnectionById, + updateProviderConnection, +} from "@/lib/db/providers"; +import { sanitizeProviderSpecificDataForResponse } from "@/lib/providers/requestDefaults"; + +import { commandCodeApplySchema, noStoreJson, stateHashFromState } from "../shared"; + +function safeConnection( + connection: Record<string, unknown> | null +): Record<string, unknown> | null { + if (!connection) return null; + const result = { ...connection }; + delete result.apiKey; + delete result.accessToken; + delete result.refreshToken; + delete result.idToken; + if (result.providerSpecificData) { + result.providerSpecificData = sanitizeProviderSpecificDataForResponse( + result.providerSpecificData + ); + } + return result; +} + +export async function POST(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + + let body: unknown; + try { + body = await request.json(); + } catch { + return noStoreJson({ error: "Invalid JSON body" }, { status: 400 }); + } + + const parsed = commandCodeApplySchema.safeParse(body); + if (!parsed.success) return noStoreJson({ error: "Invalid apply payload" }, { status: 400 }); + + let existing: Record<string, unknown> | null = null; + if (parsed.data.connectionId) { + existing = (await getProviderConnectionById(parsed.data.connectionId)) as Record< + string, + unknown + > | null; + if (!existing || existing.provider !== "command-code" || existing.authType !== "apikey") { + return noStoreJson({ error: "Command Code API-key connection not found" }, { status: 404 }); + } + } + + const consumed = consumeCommandCodeAuthSecret(stateHashFromState(parsed.data.state)); + if (!consumed) { + return noStoreJson( + { error: "No received Command Code API key for this state" }, + { status: 409 } + ); + } + + let connection: Record<string, unknown> | null; + if (parsed.data.connectionId && existing) { + connection = (await updateProviderConnection(parsed.data.connectionId, { + apiKey: consumed.apiKey, + name: parsed.data.name || existing.name || consumed.metadata?.keyName || "Command Code", + isActive: true, + testStatus: "unknown", + providerSpecificData: { + ...((existing.providerSpecificData as Record<string, unknown> | null) || {}), + authAssist: { + userId: consumed.metadata?.userId, + userName: consumed.metadata?.userName, + keyName: consumed.metadata?.keyName, + appliedAt: consumed.appliedAt, + }, + }, + ...(parsed.data.setDefault ? { priority: 1 } : {}), + })) as Record<string, unknown> | null; + } else { + connection = (await createProviderConnection({ + provider: "command-code", + authType: "apikey", + name: parsed.data.name || consumed.metadata?.keyName || "Command Code", + apiKey: consumed.apiKey, + priority: parsed.data.setDefault ? 1 : undefined, + isActive: true, + testStatus: "unknown", + providerSpecificData: { + authAssist: { + userId: consumed.metadata?.userId, + userName: consumed.metadata?.userName, + keyName: consumed.metadata?.keyName, + appliedAt: consumed.appliedAt, + }, + }, + })) as Record<string, unknown> | null; + } + + return noStoreJson({ connection: safeConnection(connection), status: "applied" }); +} diff --git a/src/app/api/providers/command-code/auth/callback/route.ts b/src/app/api/providers/command-code/auth/callback/route.ts new file mode 100644 index 0000000000..361d0716a7 --- /dev/null +++ b/src/app/api/providers/command-code/auth/callback/route.ts @@ -0,0 +1,67 @@ +import { markCommandCodeAuthSessionReceived } from "@/lib/db/commandCodeAuth"; + +import { + callbackCorsHeaders, + commandCodeCallbackSchema, + MAX_CALLBACK_BODY_BYTES, + noStoreJson, + readJsonBodyWithLimit, + rejectDisallowedCallbackOrigin, + stateHashFromState, +} from "../shared"; + +export async function OPTIONS(request: Request) { + return new Response(null, { status: 204, headers: callbackCorsHeaders(request) }); +} + +export async function POST(request: Request) { + const originError = rejectDisallowedCallbackOrigin(request); + if (originError) return originError; + + let body: unknown; + try { + body = await readJsonBodyWithLimit(request, MAX_CALLBACK_BODY_BYTES); + } catch (error) { + const isTooLarge = error instanceof Error && error.message === "BODY_TOO_LARGE"; + return noStoreJson( + { success: false, error: isTooLarge ? "Request body too large" : "Invalid JSON body" }, + { status: isTooLarge ? 413 : 400, headers: callbackCorsHeaders(request) } + ); + } + + const parsed = commandCodeCallbackSchema.safeParse(body); + if (!parsed.success) { + return noStoreJson( + { success: false, error: "Invalid callback payload" }, + { status: 400, headers: callbackCorsHeaders(request) } + ); + } + + const session = markCommandCodeAuthSessionReceived({ + stateHash: stateHashFromState(parsed.data.state), + apiKey: parsed.data.apiKey, + metadata: { + userId: parsed.data.userId, + userName: parsed.data.userName, + keyName: parsed.data.keyName, + }, + }); + + if (!session || session.status !== "received") { + return noStoreJson( + { success: false, error: "Invalid or expired state" }, + { status: 400, headers: callbackCorsHeaders(request) } + ); + } + + return noStoreJson( + { + success: true, + ok: true, + status: session.status, + expiresAt: session.expiresAt, + metadata: session.metadata, + }, + { headers: callbackCorsHeaders(request) } + ); +} diff --git a/src/app/api/providers/command-code/auth/shared.ts b/src/app/api/providers/command-code/auth/shared.ts new file mode 100644 index 0000000000..6755f6753d --- /dev/null +++ b/src/app/api/providers/command-code/auth/shared.ts @@ -0,0 +1,120 @@ +import { Buffer } from "node:buffer"; +import { randomBytes } from "crypto"; + +import { NextResponse } from "next/server"; +import { z } from "zod"; + +import { hashCommandCodeAuthState } from "@/lib/db/commandCodeAuth"; + +export const COMMAND_CODE_AUTH_TTL_MS = 15 * 60 * 1000; +export const COMMAND_CODE_STUDIO_AUTH_URL = "https://commandcode.ai/studio/auth/cli"; +export const MAX_CALLBACK_BODY_BYTES = 10 * 1024; +export const COMMAND_CODE_CLI_CALLBACK_PORTS = [ + 5959, 5960, 5961, 5962, 5963, 5964, 5965, 5966, 5967, 5968, +] as const; + +const LOCAL_CALLBACK_ORIGIN = "http://localhost:3000"; +const PRODUCTION_CALLBACK_ORIGINS = ["https://commandcode.ai", "https://staging.commandcode.ai"]; + +export const commandCodeCallbackSchema = z.object({ + apiKey: z.string().trim().min(1).max(4096), + state: z.string().trim().min(32).max(512), + userId: z.string().trim().max(256).optional(), + userName: z.string().trim().max(256).optional(), + keyName: z.string().trim().max(256).optional(), +}); + +export const commandCodeStateSchema = z.object({ + state: z.string().trim().min(32).max(512), +}); + +export const commandCodeApplySchema = commandCodeStateSchema.extend({ + connectionId: z.string().trim().min(1).max(256).optional(), + name: z.string().trim().min(1).max(256).optional(), + setDefault: z.boolean().optional(), +}); + +export function generateCommandCodeState(): string { + return randomBytes(32).toString("base64url"); +} + +export function stateHashFromState(state: string): string { + return hashCommandCodeAuthState(state); +} + +export function noStoreJson(body: unknown, init: ResponseInit = {}): NextResponse { + return NextResponse.json(body, { + ...init, + headers: { + "Cache-Control": "no-store", + ...(init.headers || {}), + }, + }); +} + +export function getAllowedCallbackOrigin(origin: string | null): string | null { + const allowed = + process.env.NODE_ENV === "production" + ? PRODUCTION_CALLBACK_ORIGINS + : [...PRODUCTION_CALLBACK_ORIGINS, LOCAL_CALLBACK_ORIGIN]; + return origin && allowed.includes(origin) ? origin : null; +} + +export function callbackCorsHeaders(request: Request): HeadersInit { + const requestHeaders = request.headers.get("access-control-request-headers") || "content-type"; + const origin = getAllowedCallbackOrigin(request.headers.get("origin")); + const headers: Record<string, string> = { + "Access-Control-Allow-Methods": "POST, OPTIONS", + "Access-Control-Allow-Headers": requestHeaders, + "Access-Control-Allow-Private-Network": "true", + "Content-Type": "application/json", + "Cache-Control": "no-store", + Vary: "Origin, Access-Control-Request-Headers", + }; + if (origin) headers["Access-Control-Allow-Origin"] = origin; + return headers; +} + +export function rejectDisallowedCallbackOrigin(request: Request): Response | null { + const origin = request.headers.get("origin"); + if (!origin || getAllowedCallbackOrigin(origin)) return null; + return new Response(JSON.stringify({ success: false, error: "Origin not allowed" }), { + status: 403, + headers: callbackCorsHeaders(request), + }); +} + +export async function readJsonBodyWithLimit(request: Request, maxBytes: number): Promise<unknown> { + const reader = request.body?.getReader(); + if (!reader) return request.json(); + + const chunks: Uint8Array[] = []; + let total = 0; + while (true) { + const { value, done } = await reader.read(); + if (done) break; + if (!value) continue; + total += value.byteLength; + if (total > maxBytes) { + await reader.cancel(); + throw new Error("BODY_TOO_LARGE"); + } + chunks.push(value); + } + + const body = new TextDecoder().decode(Buffer.concat(chunks)); + return JSON.parse(body); +} + +export function buildCommandCodeCliCallbackUrl(): string { + const configuredPort = process.env.COMMAND_CODE_CALLBACK_PORT || ""; + const port = /^\d+$/.test(configuredPort) + ? Number.parseInt(configuredPort, 10) + : COMMAND_CODE_CLI_CALLBACK_PORTS[0]; + const safePort = COMMAND_CODE_CLI_CALLBACK_PORTS.includes( + port as (typeof COMMAND_CODE_CLI_CALLBACK_PORTS)[number] + ) + ? port + : COMMAND_CODE_CLI_CALLBACK_PORTS[0]; + return `http://localhost:${safePort}/callback`; +} diff --git a/src/app/api/providers/command-code/auth/start/route.ts b/src/app/api/providers/command-code/auth/start/route.ts new file mode 100644 index 0000000000..dfa31dfcec --- /dev/null +++ b/src/app/api/providers/command-code/auth/start/route.ts @@ -0,0 +1,28 @@ +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { createPendingCommandCodeAuthSession } from "@/lib/db/commandCodeAuth"; + +import { + buildCommandCodeCliCallbackUrl, + COMMAND_CODE_AUTH_TTL_MS, + COMMAND_CODE_STUDIO_AUTH_URL, + generateCommandCodeState, + noStoreJson, + stateHashFromState, +} from "../shared"; + +export async function POST(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + + const state = generateCommandCodeState(); + const expiresAt = new Date(Date.now() + COMMAND_CODE_AUTH_TTL_MS).toISOString(); + const stateHash = stateHashFromState(state); + createPendingCommandCodeAuthSession({ stateHash, expiresAt }); + + const callbackUrl = buildCommandCodeCliCallbackUrl(); + const authUrl = `${COMMAND_CODE_STUDIO_AUTH_URL}?callback=${encodeURIComponent( + callbackUrl + )}&state=${encodeURIComponent(state)}`; + + return noStoreJson({ state, authUrl, callbackUrl, expiresAt, mode: "manual" }); +} diff --git a/src/app/api/providers/command-code/auth/status/route.ts b/src/app/api/providers/command-code/auth/status/route.ts new file mode 100644 index 0000000000..4c71096b9e --- /dev/null +++ b/src/app/api/providers/command-code/auth/status/route.ts @@ -0,0 +1,38 @@ +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { getCommandCodeAuthSessionSafeStatus } from "@/lib/db/commandCodeAuth"; + +import { commandCodeStateSchema, noStoreJson, stateHashFromState } from "../shared"; + +async function readState(request: Request): Promise<string | null> { + const urlState = new URL(request.url).searchParams.get("state"); + if (urlState) return urlState; + try { + const parsed = commandCodeStateSchema.safeParse(await request.json()); + return parsed.success ? parsed.data.state : null; + } catch { + return null; + } +} + +async function handle(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + + const state = await readState(request); + const parsed = commandCodeStateSchema.safeParse({ state }); + if (!parsed.success) return noStoreJson({ error: "Invalid state" }, { status: 400 }); + + const session = getCommandCodeAuthSessionSafeStatus(stateHashFromState(parsed.data.state)); + if (!session) return noStoreJson({ status: "not_found" }, { status: 404 }); + + return noStoreJson({ + status: session.status, + metadata: session.metadata, + expiresAt: session.expiresAt, + receivedAt: session.receivedAt, + appliedAt: session.appliedAt, + }); +} + +export const GET = handle; +export const POST = handle; diff --git a/src/app/api/providers/route.ts b/src/app/api/providers/route.ts index 802947bec7..6f964ed423 100644 --- a/src/app/api/providers/route.ts +++ b/src/app/api/providers/route.ts @@ -27,6 +27,7 @@ import { } from "@/lib/providers/requestDefaults"; import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { isManagedProviderConnectionId } from "@/lib/providers/catalog"; +import { isApiKeyRevealEnabled, maskStoredApiKey } from "@/lib/apiKeyExposure"; // GET /api/providers - List all connections export async function GET(request: Request) { @@ -35,11 +36,12 @@ export async function GET(request: Request) { try { const connections = await getProviderConnections(); + const revealKeys = isApiKeyRevealEnabled(); - // Hide sensitive fields + // Hide or mask sensitive fields const safeConnections = connections.map((c) => ({ ...c, - apiKey: undefined, + apiKey: revealKeys ? c.apiKey : c.apiKey ? maskStoredApiKey(c.apiKey) : undefined, accessToken: undefined, refreshToken: undefined, idToken: undefined, diff --git a/src/app/api/providers/test-batch/route.ts b/src/app/api/providers/test-batch/route.ts index ef9f3aa78b..0df170161f 100644 --- a/src/app/api/providers/test-batch/route.ts +++ b/src/app/api/providers/test-batch/route.ts @@ -9,6 +9,7 @@ import { WEB_COOKIE_PROVIDERS, SEARCH_PROVIDERS, AUDIO_ONLY_PROVIDERS, + CLOUD_AGENT_PROVIDERS, OPENAI_COMPATIBLE_PREFIX, ANTHROPIC_COMPATIBLE_PREFIX, } from "@/shared/constants/providers"; @@ -26,6 +27,7 @@ function getAuthGroup(providerId) { if (AUDIO_ONLY_PROVIDERS[providerId]) return "audio"; if (LOCAL_PROVIDERS[providerId]) return "local"; if (UPSTREAM_PROXY_PROVIDERS[providerId]) return "upstream-proxy"; + if (CLOUD_AGENT_PROVIDERS[providerId]) return "cloud-agent"; if (APIKEY_PROVIDERS[providerId]) return "apikey"; if ( typeof providerId === "string" && @@ -99,6 +101,8 @@ export async function POST(request) { connectionsToTest = allConnections.filter( (c) => getAuthGroup(c.provider) === "upstream-proxy" ); + } else if (mode === "cloud-agent") { + connectionsToTest = allConnections.filter((c) => getAuthGroup(c.provider) === "cloud-agent"); } else if (mode === "compatible") { connectionsToTest = allConnections.filter((c) => isCompatibleProvider(c.provider)); } else if (mode === "all") { @@ -107,7 +111,7 @@ export async function POST(request) { return NextResponse.json( { error: - "Invalid mode. Use: provider, oauth, free, apikey, compatible, all, web-cookie, search, audio, local, upstream-proxy", + "Invalid mode. Use: provider, oauth, free, apikey, compatible, all, web-cookie, search, audio, local, upstream-proxy, cloud-agent", }, { status: 400 } ); diff --git a/src/app/api/providers/validate/route.ts b/src/app/api/providers/validate/route.ts index 41f198d992..687d935bf9 100644 --- a/src/app/api/providers/validate/route.ts +++ b/src/app/api/providers/validate/route.ts @@ -1,4 +1,5 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getAuditRequestContext, logAuditEvent } from "@/lib/compliance/index"; import { getProviderNodeById } from "@/models"; import { @@ -24,6 +25,9 @@ function sanitizeAuditUrl(url: string | null | undefined) { // POST /api/providers/validate - Validate API key with provider export async function POST(request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + const auditContext = getAuditRequestContext(request); let rawBody; try { diff --git a/src/app/api/resilience/model-cooldowns/route.ts b/src/app/api/resilience/model-cooldowns/route.ts new file mode 100644 index 0000000000..df5d3b7b06 --- /dev/null +++ b/src/app/api/resilience/model-cooldowns/route.ts @@ -0,0 +1,71 @@ +import { NextResponse } from "next/server"; +import { z } from "zod"; +import { + clearModelUnavailability, + getAvailabilityReport, + resetAllAvailability, +} from "@/domain/modelAvailability"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { validateBody } from "@/shared/validation/helpers"; + +const deleteCooldownSchema = z + .object({ + provider: z.string().optional(), + model: z.string().optional(), + all: z.boolean().optional(), + }) + .passthrough(); + +function getErrorMessage(error: unknown, fallback: string): string { + return error instanceof Error && error.message ? error.message : fallback; +} + +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + + try { + const items = getAvailabilityReport().sort((a, b) => b.remainingMs - a.remainingMs); + return NextResponse.json({ items }); + } catch (error: unknown) { + console.error("[API] GET /api/resilience/model-cooldowns error:", error); + return NextResponse.json( + { error: getErrorMessage(error, "Failed to load cooldowns") }, + { status: 500 } + ); + } +} + +export async function DELETE(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + + try { + const rawBody = await request.json().catch(() => ({})); + const validation = validateBody(deleteCooldownSchema, rawBody); + if (!validation.success) { + return NextResponse.json({ error: validation.error }, { status: 400 }); + } + const body = validation.data; + + if (body.all) { + resetAllAvailability(); + return NextResponse.json({ ok: true, clearedAll: true }); + } + + const provider = typeof body.provider === "string" ? body.provider.trim() : ""; + const model = typeof body.model === "string" ? body.model.trim() : ""; + if (!provider || !model) { + return NextResponse.json({ error: "provider and model are required" }, { status: 400 }); + } + + const removed = clearModelUnavailability(provider, model); + return NextResponse.json({ ok: true, removed }); + } catch (error: unknown) { + console.error("[API] DELETE /api/resilience/model-cooldowns error:", error); + return NextResponse.json( + { error: getErrorMessage(error, "Failed to clear cooldown") }, + { status: 500 } + ); + } +} diff --git a/src/app/api/resilience/route.ts b/src/app/api/resilience/route.ts index 08fe0aeb05..c7c031ed7e 100644 --- a/src/app/api/resilience/route.ts +++ b/src/app/api/resilience/route.ts @@ -9,6 +9,7 @@ import { } from "@/lib/resilience/settings"; import { updateResilienceSchema } from "@/shared/validation/schemas"; import { isValidationFailure, validateBody } from "@/shared/validation/helpers"; +import { resetAllCircuitBreakers } from "@/shared/utils/circuitBreaker"; type JsonRecord = Record<string, unknown>; @@ -196,6 +197,20 @@ export async function PATCH(request) { }); await syncRuntimeSettings(nextResilience); + // Issue #2100 follow-up: detect transitions in useUpstream429BreakerHints + // and reset breakers so the registry stops serving cached options. + // Compared on STORED override transition (boolean | undefined) so that + // `null` (PATCH input) → undefined (stored) is correctly detected as + // "unset request" when the previous stored value was a boolean. + const breakerHintsChanged = + currentResilience.connectionCooldown.oauth.useUpstream429BreakerHints !== + nextResilience.connectionCooldown.oauth.useUpstream429BreakerHints || + currentResilience.connectionCooldown.apikey.useUpstream429BreakerHints !== + nextResilience.connectionCooldown.apikey.useUpstream429BreakerHints; + if (breakerHintsChanged) { + resetAllCircuitBreakers(); + } + return NextResponse.json({ ok: true, requestQueue: nextResilience.requestQueue, diff --git a/src/app/api/settings/export-json/route.ts b/src/app/api/settings/export-json/route.ts index 6eaa783728..0de7dbbe7a 100644 --- a/src/app/api/settings/export-json/route.ts +++ b/src/app/api/settings/export-json/route.ts @@ -21,6 +21,11 @@ export async function GET(request: Request) { } try { + const url = new URL(request.url); + // Telemetry/history tables grow indefinitely and inflate backups. + // Exclude them by default — opt-in with ?includeHistory=true (#2125). + const includeHistory = url.searchParams.get("includeHistory") === "true"; + const rawSettings = await getSettings(); // REDACT sensitive security keys to maintain Zero-Trust posture @@ -33,27 +38,30 @@ export async function GET(request: Request) { const combos = await getCombos(); const apiKeys = await getApiKeys(); - const db = getDbInstance(); - const usageHistory = db.prepare("SELECT * FROM usage_history").all(); - const domainCostHistory = db.prepare("SELECT * FROM domain_cost_history").all(); - const domainBudgets = db.prepare("SELECT * FROM domain_budgets").all(); - - const exportData = { + const exportData: Record<string, unknown> = { settings: safeSettings, providerConnections, providerNodes, combos, apiKeys, - usageHistory, - domainCostHistory, - domainBudgets, // Metadata to identify export version _meta: { exportedAt: new Date().toISOString(), version: "omniroute-v3-legacy-export", + includesHistory: includeHistory, }, }; + // Only include telemetry/history tables when explicitly requested. + // These tables (usage_history, domain_cost_history, domain_budgets) can contain + // thousands of rows and make the config backup grow to many MBs. + if (includeHistory) { + const db = getDbInstance(); + exportData.usageHistory = db.prepare("SELECT * FROM usage_history").all(); + exportData.domainCostHistory = db.prepare("SELECT * FROM domain_cost_history").all(); + exportData.domainBudgets = db.prepare("SELECT * FROM domain_budgets").all(); + } + return new NextResponse(JSON.stringify(exportData, null, 2), { status: 200, headers: { diff --git a/src/app/api/system/env/repair/route.ts b/src/app/api/system/env/repair/route.ts index 64ed9c617e..1f8f8137ef 100644 --- a/src/app/api/system/env/repair/route.ts +++ b/src/app/api/system/env/repair/route.ts @@ -10,7 +10,7 @@ import { join } from "node:path"; import { NextResponse } from "next/server"; import { isAuthenticated } from "@/shared/utils/apiAuth"; // @ts-expect-error - .mjs without types -import { getEnvSyncPlan, syncEnv } from "../../../../../../scripts/sync-env.mjs"; +import { getEnvSyncPlan, syncEnv } from "../../../../../../scripts/dev/sync-env.mjs"; async function loadSyncHelpers() { return { getEnvSyncPlan, syncEnv }; diff --git a/src/app/api/system/version/route.ts b/src/app/api/system/version/route.ts index f05af793f1..94e4cda28b 100644 --- a/src/app/api/system/version/route.ts +++ b/src/app/api/system/version/route.ts @@ -234,7 +234,7 @@ export async function POST(req: NextRequest) { send({ step: "rebuild", status: "done", message: "Dependencies installed" }); try { - await execFileAsync("node", ["scripts/sync-env.mjs"], { + await execFileAsync("node", ["scripts/dev/sync-env.mjs"], { timeout: 15_000, cwd: process.cwd(), }); diff --git a/src/app/api/usage/analytics/route.ts b/src/app/api/usage/analytics/route.ts index e3fada7b03..17fc459e74 100644 --- a/src/app/api/usage/analytics/route.ts +++ b/src/app/api/usage/analytics/route.ts @@ -1,4 +1,5 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getApiKeys } from "@/lib/db/apiKeys"; import { getDbInstance } from "@/lib/db/core"; @@ -261,6 +262,9 @@ function computeActivityStreak(activityMap: Record<string, number>): number { } export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const { searchParams } = new URL(request.url); const range = searchParams.get("range") || "30d"; @@ -555,6 +559,7 @@ export async function GET(request: Request) { COALESCE(NULLIF(service_tier, ''), 'standard') as serviceTier, LOWER(provider) as provider, LOWER(model) as model, + COALESCE(NULLIF(service_tier, ''), 'standard') as serviceTier, COUNT(*) as requests, COALESCE(SUM(tokens_input), 0) as promptTokens, COALESCE(SUM(tokens_output), 0) as completionTokens, @@ -563,6 +568,7 @@ export async function GET(request: Request) { COALESCE(SUM(tokens_reasoning), 0) as reasoningTokens, COALESCE(SUM(tokens_input + tokens_output), 0) as totalTokens FROM usage_history + ${whereClause} GROUP BY serviceTier, LOWER(provider), LOWER(model) ` diff --git a/src/app/api/usage/history/route.ts b/src/app/api/usage/history/route.ts index 16a5d40725..6094e7baec 100644 --- a/src/app/api/usage/history/route.ts +++ b/src/app/api/usage/history/route.ts @@ -1,7 +1,11 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getUsageStats } from "@/lib/usageDb"; -export async function GET() { +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const stats = await getUsageStats(); return NextResponse.json(stats); diff --git a/src/app/api/usage/logs/route.ts b/src/app/api/usage/logs/route.ts index b5b875ec94..ebb409d2f2 100644 --- a/src/app/api/usage/logs/route.ts +++ b/src/app/api/usage/logs/route.ts @@ -1,7 +1,11 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getRecentLogs } from "@/lib/usageDb"; -export async function GET() { +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const logs = await getRecentLogs(200); return NextResponse.json(logs); diff --git a/src/app/api/usage/request-logs/route.ts b/src/app/api/usage/request-logs/route.ts index 0ae5e961cc..0e335c26d9 100644 --- a/src/app/api/usage/request-logs/route.ts +++ b/src/app/api/usage/request-logs/route.ts @@ -1,7 +1,11 @@ import { NextResponse } from "next/server"; +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; import { getRecentLogs } from "@/lib/usageDb"; -export async function GET() { +export async function GET(request: Request) { + const authError = await requireManagementAuth(request); + if (authError) return authError; + try { const logs = await getRecentLogs(200); return NextResponse.json(logs); diff --git a/src/app/api/v1/agents/tasks/[id]/route.ts b/src/app/api/v1/agents/tasks/[id]/route.ts new file mode 100644 index 0000000000..16af314bed --- /dev/null +++ b/src/app/api/v1/agents/tasks/[id]/route.ts @@ -0,0 +1,206 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getAgent } from "@/lib/cloudAgent/registry"; +import { + createCloudAgentTaskTable, + getCloudAgentTaskById, + updateCloudAgentTask, + deleteCloudAgentTask, +} from "@/lib/cloudAgent/db"; +import { + getCloudAgentCorsHeaders, + getCloudAgentCredentials, + requireCloudAgentManagementAuth, + serializeCloudAgentTask, +} from "@/lib/cloudAgent/api"; +import { z } from "zod"; +import pino from "pino"; + +const logger = pino({ name: "cloud-agents-api" }); + +createCloudAgentTaskTable(); + +export async function OPTIONS(request: NextRequest) { + return new NextResponse(null, { headers: getCloudAgentCorsHeaders(request) }); +} + +const ApproveSchema = z.object({ + action: z.literal("approve"), +}); + +const MessageSchema = z.object({ + action: z.literal("message"), + message: z.string().min(1), +}); + +const CancelSchema = z.object({ + action: z.literal("cancel"), +}); + +const TaskActionSchema = z.discriminatedUnion("action", [ + ApproveSchema, + MessageSchema, + CancelSchema, +]); + +function cloudAgentCredentialsRequiredResponse(providerId: string, request: NextRequest) { + return NextResponse.json( + { error: `No active credentials configured for cloud agent provider: ${providerId}` }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); +} + +export async function GET(request: NextRequest, { params }: { params: Promise<{ id: string }> }) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + const { id } = await params; + const task = getCloudAgentTaskById(id); + + if (!task) { + return NextResponse.json( + { error: "Task not found" }, + { status: 404, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const agent = getAgent(task.provider_id); + if (agent && task.external_id) { + try { + const credentials = await getCloudAgentCredentials(task.provider_id); + if (credentials) { + const statusResult = await agent.getStatus(task.external_id, credentials); + + updateCloudAgentTask(id, { + status: statusResult.status, + result: statusResult.result ? JSON.stringify(statusResult.result) : null, + activities: JSON.stringify(statusResult.activities), + error: statusResult.error || null, + completed_at: + statusResult.status === "completed" || statusResult.status === "failed" + ? new Date().toISOString() + : null, + }); + } + } catch (err) { + logger.error({ err }, "Failed to sync task status"); + } + } + + const updatedTask = getCloudAgentTaskById(id); + + return NextResponse.json( + { + data: serializeCloudAgentTask(updatedTask!), + }, + { headers: getCloudAgentCorsHeaders(request) } + ); + } catch (error) { + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} + +export async function POST(request: NextRequest, { params }: { params: Promise<{ id: string }> }) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + const { id } = await params; + const body = await request.json(); + const validation = TaskActionSchema.safeParse(body); + if (!validation.success) { + return NextResponse.json( + { error: "Validation failed", details: validation.error.issues }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const task = getCloudAgentTaskById(id); + if (!task) { + return NextResponse.json( + { error: "Task not found" }, + { status: 404, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const validated = validation.data; + + const agent = getAgent(task.provider_id); + if (!agent) { + return NextResponse.json( + { error: "Agent not found" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } + + if (validated.action === "approve") { + if (!task.external_id) { + return NextResponse.json( + { error: "No external task to approve" }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + const credentials = await getCloudAgentCredentials(task.provider_id); + if (!credentials) return cloudAgentCredentialsRequiredResponse(task.provider_id, request); + await agent.approvePlan(task.external_id, credentials); + updateCloudAgentTask(id, { status: "running" }); + } else if (validated.action === "message") { + if (!task.external_id) { + return NextResponse.json( + { error: "No external task to message" }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + const credentials = await getCloudAgentCredentials(task.provider_id); + if (!credentials) return cloudAgentCredentialsRequiredResponse(task.provider_id, request); + const activity = await agent.sendMessage(task.external_id, validated.message, credentials); + const activities: unknown[] = serializeCloudAgentTask(task).activities; + activities.push(activity); + updateCloudAgentTask(id, { activities: JSON.stringify(activities) }); + } else if (validated.action === "cancel") { + updateCloudAgentTask(id, { status: "cancelled" }); + } + + const updatedTask = getCloudAgentTaskById(id); + return NextResponse.json( + { success: true, data: updatedTask ? serializeCloudAgentTask(updatedTask) : null }, + { headers: getCloudAgentCorsHeaders(request) } + ); + } catch (error) { + logger.error({ err: error }, "Failed to process task action"); + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} + +export async function DELETE( + request: NextRequest, + { params }: { params: Promise<{ id: string }> } +) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + const { id } = await params; + const task = getCloudAgentTaskById(id); + if (!task) { + return NextResponse.json( + { error: "Task not found" }, + { status: 404, headers: getCloudAgentCorsHeaders(request) } + ); + } + + deleteCloudAgentTask(id); + return NextResponse.json({ success: true }, { headers: getCloudAgentCorsHeaders(request) }); + } catch (error) { + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} diff --git a/src/app/api/v1/agents/tasks/route.ts b/src/app/api/v1/agents/tasks/route.ts new file mode 100644 index 0000000000..2a93439f61 --- /dev/null +++ b/src/app/api/v1/agents/tasks/route.ts @@ -0,0 +1,178 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getAgent } from "@/lib/cloudAgent/registry"; +import type { CloudAgentTaskRow } from "@/lib/cloudAgent/db"; +import { + createCloudAgentTaskTable, + insertCloudAgentTask, + getAllCloudAgentTasks, + getCloudAgentTasksByProvider, + getCloudAgentTasksByStatus, + deleteCloudAgentTask, +} from "@/lib/cloudAgent/db"; +import { + getCloudAgentCorsHeaders, + getCloudAgentCredentials, + requireCloudAgentManagementAuth, + serializeCloudAgentTask, +} from "@/lib/cloudAgent/api"; +import { CreateCloudAgentTaskSchema } from "@/lib/cloudAgent/types"; +import pino from "pino"; + +const logger = pino({ name: "cloud-agents-api" }); + +function getLimit(value: string | null): number { + const parsed = Number.parseInt(value || "50", 10); + if (!Number.isFinite(parsed)) return 50; + return Math.max(1, Math.min(parsed, 500)); +} + +export async function OPTIONS(request: NextRequest) { + return new NextResponse(null, { headers: getCloudAgentCorsHeaders(request) }); +} + +export async function GET(request: NextRequest) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + createCloudAgentTaskTable(); + + const { searchParams } = new URL(request.url); + const providerId = searchParams.get("provider"); + const status = searchParams.get("status"); + const limit = getLimit(searchParams.get("limit")); + + let tasks: CloudAgentTaskRow[]; + if (providerId) { + tasks = getCloudAgentTasksByProvider(providerId, limit); + } else if (status) { + tasks = getCloudAgentTasksByStatus(status, limit); + } else { + tasks = getAllCloudAgentTasks(limit); + } + + return NextResponse.json( + { + data: tasks.map(serializeCloudAgentTask), + }, + { headers: getCloudAgentCorsHeaders(request) } + ); + } catch (error) { + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} + +export async function POST(request: NextRequest) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + const body = await request.json(); + const validation = CreateCloudAgentTaskSchema.safeParse(body); + if (!validation.success) { + return NextResponse.json( + { error: "Validation failed", details: validation.error.issues }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const validated = validation.data; + + const agent = getAgent(validated.providerId); + if (!agent) { + return NextResponse.json( + { error: `Unknown provider: ${validated.providerId}` }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const credentials = await getCloudAgentCredentials(validated.providerId); + if (!credentials) { + return NextResponse.json( + { + error: `No active credentials configured for cloud agent provider: ${validated.providerId}`, + }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + + const task = await agent.createTask( + { + prompt: validated.prompt, + source: validated.source, + options: validated.options || {}, + }, + credentials + ); + + createCloudAgentTaskTable(); + insertCloudAgentTask({ + id: task.id, + provider_id: task.providerId, + external_id: task.externalId || null, + status: task.status, + prompt: task.prompt, + source: JSON.stringify(task.source), + options: JSON.stringify(task.options), + result: null, + activities: JSON.stringify(task.activities), + error: null, + created_at: task.createdAt, + updated_at: task.updatedAt, + completed_at: null, + }); + + return NextResponse.json( + { + data: { + id: task.id, + providerId: task.providerId, + externalId: task.externalId, + status: task.status, + prompt: task.prompt, + source: task.source, + options: task.options, + createdAt: task.createdAt, + }, + }, + { status: 201, headers: getCloudAgentCorsHeaders(request) } + ); + } catch (error) { + logger.error({ err: error }, "Failed to create cloud agent task"); + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} + +export async function DELETE(request: NextRequest) { + try { + const authError = await requireCloudAgentManagementAuth(request); + if (authError) return authError; + + createCloudAgentTaskTable(); + + const { searchParams } = new URL(request.url); + const taskId = searchParams.get("id"); + + if (!taskId) { + return NextResponse.json( + { error: "Task ID required" }, + { status: 400, headers: getCloudAgentCorsHeaders(request) } + ); + } + + deleteCloudAgentTask(taskId); + + return NextResponse.json({ success: true }, { headers: getCloudAgentCorsHeaders(request) }); + } catch (error) { + return NextResponse.json( + { error: error instanceof Error ? error.message : "Unknown error" }, + { status: 500, headers: getCloudAgentCorsHeaders(request) } + ); + } +} diff --git a/src/app/api/v1/models/catalog.ts b/src/app/api/v1/models/catalog.ts index 48e24f8f5d..5ffcfaf5f9 100644 --- a/src/app/api/v1/models/catalog.ts +++ b/src/app/api/v1/models/catalog.ts @@ -8,26 +8,41 @@ import { getProviderNodes, getModelIsHidden, } from "@/lib/localDb"; -import { getAllEmbeddingModels } from "@omniroute/open-sse/config/embeddingRegistry.ts"; -import { getAllImageModels } from "@omniroute/open-sse/config/imageRegistry.ts"; -import { getAllRerankModels } from "@omniroute/open-sse/config/rerankRegistry.ts"; -import { getAllAudioModels } from "@omniroute/open-sse/config/audioRegistry.ts"; -import { getAllModerationModels } from "@omniroute/open-sse/config/moderationRegistry.ts"; -import { getAllVideoModels } from "@omniroute/open-sse/config/videoRegistry.ts"; -import { getAllMusicModels } from "@omniroute/open-sse/config/musicRegistry.ts"; -import { REGISTRY } from "@omniroute/open-sse/config/providerRegistry.ts"; -import { CODEX_NATIVE_UNPREFIXED_MODELS } from "@omniroute/open-sse/services/model.ts"; +import { getAllEmbeddingModels } from "@omniroute/open-sse/config/embeddingRegistry"; +import { getAllImageModels } from "@omniroute/open-sse/config/imageRegistry"; +import { getAllRerankModels } from "@omniroute/open-sse/config/rerankRegistry"; +import { getAllAudioModels } from "@omniroute/open-sse/config/audioRegistry"; +import { getAllModerationModels } from "@omniroute/open-sse/config/moderationRegistry"; +import { getAllVideoModels } from "@omniroute/open-sse/config/videoRegistry"; +import { getAllMusicModels } from "@omniroute/open-sse/config/musicRegistry"; +import { REGISTRY } from "@omniroute/open-sse/config/providerRegistry"; +import { CODEX_NATIVE_UNPREFIXED_MODELS } from "@omniroute/open-sse/services/model"; +import { resolveNestedComboTargets } from "@omniroute/open-sse/services/combo"; import { getAllSyncedAvailableModels } from "@/lib/db/models"; import { getCompatibleFallbackModels } from "@/lib/providers/managedAvailableModels"; import { hasEligibleConnectionForModel } from "@/domain/connectionModelRules"; import { INTERNAL_PROXY_ERROR, enrichCatalogModelEntry, + getCanonicalModelMetadata, getCatalogDiagnosticsHeaders, } from "@/lib/modelMetadataRegistry"; +import { getSyncedCapability } from "@/lib/modelsDevSync"; +import { getModelSpec } from "@/shared/constants/modelSpecs"; import { isAuthRequired, isDashboardSessionAuthenticated } from "@/shared/utils/apiAuth"; -import { parseModel } from "@omniroute/open-sse/services/model.ts"; -import { getTokenLimit } from "@omniroute/open-sse/services/contextManager.ts"; +import { parseModel } from "@omniroute/open-sse/services/model"; +import { getTokenLimit } from "@omniroute/open-sse/services/contextManager"; +import type { ComboModelStep } from "@/lib/combos/steps"; + +interface CustomModelEntry { + id?: string; + name?: string; + source?: string; + apiFormat?: string; + supportedEndpoints?: string[]; + inputTokenLimit?: number; + isHidden?: boolean; +} const FALLBACK_ALIAS_TO_PROVIDER = { ag: "antigravity", @@ -43,6 +58,50 @@ const FALLBACK_ALIAS_TO_PROVIDER = { qw: "qwen", }; +type ComboCatalogTarget = { + modelStr?: string; + provider?: string | null; +}; + +type ComboTargetCatalogMetadata = { + contextLength?: number; + maxInputTokens?: number; + maxOutputTokens?: number; + inputModalities?: string[]; + outputModalities?: string[]; + capabilities: Record<string, boolean>; +}; + +function isPositiveFiniteNumber(value: unknown): value is number { + return typeof value === "number" && Number.isFinite(value) && value > 0; +} + +function parseJsonStringArray(value: unknown): string[] { + if (typeof value !== "string" || value.trim().length === 0) return []; + try { + const parsed = JSON.parse(value); + return Array.isArray(parsed) + ? parsed.filter((entry): entry is string => typeof entry === "string" && entry.length > 0) + : []; + } catch { + return []; + } +} + +function intersectStringArrays(arrays: string[][]): string[] { + if (arrays.length === 0 || arrays.some((values) => values.length === 0)) return []; + const [first, ...rest] = arrays; + return first.filter((value, index) => { + if (first.indexOf(value) !== index) return false; + return rest.every((values) => values.includes(value)); + }); +} + +function minKnownNumber(values: Array<number | undefined>): number | undefined { + if (values.length === 0 || !values.every(isPositiveFiniteNumber)) return undefined; + return Math.min(...values); +} + const VISION_MODEL_KEYWORDS = [ "gpt-4o", "gpt-4.1", @@ -309,6 +368,212 @@ export async function getUnifiedModelsResponse( ); }; + const getRegistryModel = (providerId: string, modelId: string) => { + const alias = providerIdToAlias[providerId] || PROVIDER_ID_TO_ALIAS[providerId] || providerId; + const providerModels = PROVIDER_MODELS[alias] || PROVIDER_MODELS[providerId] || []; + return providerModels.find((model) => model?.id === modelId) || null; + }; + + const getProviderPrefixes = (providerId: string, rawProvider: string) => { + const prefixes = new Set<string>([providerId, rawProvider, providerIdToAlias[providerId]]); + for (const [alias, mappedProviderId] of Object.entries(aliasToProviderId)) { + if (mappedProviderId === providerId) prefixes.add(alias); + } + return [...prefixes].filter( + (prefix): prefix is string => typeof prefix === "string" && prefix.length > 0 + ); + }; + + const getComboTargetModelId = (target: ComboCatalogTarget) => { + const rawProvider = typeof target.provider === "string" ? target.provider.trim() : ""; + const modelStr = typeof target.modelStr === "string" ? target.modelStr.trim() : ""; + if (!rawProvider || rawProvider === "unknown" || !modelStr) return null; + + const providerId = resolveCanonicalProviderId(rawProvider); + if (!providerId || providerId === "unknown") return null; + + for (const prefix of getProviderPrefixes(providerId, rawProvider)) { + const prefixWithSlash = `${prefix}/`; + if (modelStr.startsWith(prefixWithSlash)) { + const modelId = modelStr.slice(prefixWithSlash.length).trim(); + return modelId ? { providerId, modelId } : null; + } + } + + return { providerId, modelId: modelStr }; + }; + + const getComboTargetCatalogMetadata = ( + target: ComboCatalogTarget + ): ComboTargetCatalogMetadata | null => { + const targetModel = getComboTargetModelId(target); + if (!targetModel) return null; + + const canonical = getCanonicalModelMetadata({ + provider: targetModel.providerId, + model: targetModel.modelId, + }); + if (!canonical) return null; + + const source = canonical.metadata.source; + if (!source.providerRegistry && !source.staticSpec && !source.syncedCapability) return null; + + const providerId = canonical.provider || targetModel.providerId; + const modelId = canonical.model || targetModel.modelId; + const synced = getSyncedCapability(providerId, modelId); + const spec = getModelSpec(modelId); + const registryModel = getRegistryModel(providerId, modelId); + const syncedInputModalities = parseJsonStringArray(synced?.modalities_input); + const syncedOutputModalities = parseJsonStringArray(synced?.modalities_output); + + const syncedContext = isPositiveFiniteNumber(synced?.limit_context) + ? synced.limit_context + : undefined; + const registryContext = isPositiveFiniteNumber(registryModel?.contextLength) + ? registryModel.contextLength + : undefined; + const specContext = isPositiveFiniteNumber(spec?.contextWindow) + ? spec.contextWindow + : undefined; + const contextLength = syncedContext ?? registryContext ?? specContext; + const maxInputTokens = isPositiveFiniteNumber(synced?.limit_input) + ? synced.limit_input + : contextLength; + const maxOutputTokens = isPositiveFiniteNumber(synced?.limit_output) + ? synced.limit_output + : isPositiveFiniteNumber(spec?.maxOutputTokens) + ? spec.maxOutputTokens + : undefined; + + const syncedVision = + typeof synced?.attachment === "boolean" + ? synced.attachment + : syncedInputModalities.length > 0 || syncedOutputModalities.length > 0 + ? [...syncedInputModalities, ...syncedOutputModalities].some((entry) => + entry.toLowerCase().includes("image") + ) + : undefined; + const registryVision = + typeof registryModel?.supportsVision === "boolean" + ? registryModel.supportsVision + : undefined; + const specVision = + typeof spec?.supportsVision === "boolean" ? spec.supportsVision : undefined; + const knownVision = syncedVision ?? registryVision ?? specVision; + + const inputModalities = + syncedInputModalities.length > 0 + ? syncedInputModalities + : knownVision === true + ? ["text", "image"] + : undefined; + const outputModalities = + syncedOutputModalities.length > 0 + ? syncedOutputModalities + : knownVision === true + ? ["text"] + : undefined; + + const capabilities: Record<string, boolean> = {}; + if (typeof synced?.tool_call === "boolean") { + capabilities.tool_calling = synced.tool_call; + } else if (typeof registryModel?.toolCalling === "boolean") { + capabilities.tool_calling = registryModel.toolCalling; + } else if (typeof spec?.supportsTools === "boolean") { + capabilities.tool_calling = spec.supportsTools; + } + if (typeof synced?.reasoning === "boolean") { + capabilities.reasoning = synced.reasoning; + } else if (typeof registryModel?.supportsReasoning === "boolean") { + capabilities.reasoning = registryModel.supportsReasoning; + } else if (typeof spec?.supportsThinking === "boolean") { + capabilities.reasoning = spec.supportsThinking; + } + if (typeof knownVision === "boolean") capabilities.vision = knownVision; + if (typeof synced?.attachment === "boolean") capabilities.attachment = synced.attachment; + if (typeof synced?.structured_output === "boolean") { + capabilities.structured_output = synced.structured_output; + } + if (typeof synced?.temperature === "boolean") capabilities.temperature = synced.temperature; + if (typeof synced?.reasoning === "boolean") { + capabilities.thinking = synced.reasoning; + } else if (typeof spec?.supportsThinking === "boolean") { + capabilities.thinking = spec.supportsThinking; + } + + return { + ...(contextLength ? { contextLength } : {}), + ...(maxInputTokens ? { maxInputTokens } : {}), + ...(maxOutputTokens ? { maxOutputTokens } : {}), + ...(inputModalities && inputModalities.length > 0 ? { inputModalities } : {}), + ...(outputModalities && outputModalities.length > 0 ? { outputModalities } : {}), + capabilities, + }; + }; + + const buildComboCatalogMetadata = (combo: Record<string, any>, allCombos: any[]) => { + const explicitContextLength = isPositiveFiniteNumber(combo.context_length) + ? combo.context_length + : undefined; + + const baseMetadata = explicitContextLength ? { context_length: explicitContextLength } : {}; + const targets = resolveNestedComboTargets(combo, allCombos) as ComboCatalogTarget[]; + if (targets.length === 0) return baseMetadata; + + const targetMetadata = targets.map((target) => getComboTargetCatalogMetadata(target)); + if (targetMetadata.some((metadata) => metadata === null)) return baseMetadata; + + const knownMetadata = targetMetadata as ComboTargetCatalogMetadata[]; + const contextLength = + explicitContextLength ?? + minKnownNumber(knownMetadata.map((metadata) => metadata.contextLength)); + const maxInputTokens = minKnownNumber( + knownMetadata.map((metadata) => metadata.maxInputTokens) + ); + const maxOutputTokens = minKnownNumber( + knownMetadata.map((metadata) => metadata.maxOutputTokens) + ); + + const inputModalities = knownMetadata.every( + (metadata) => Array.isArray(metadata.inputModalities) && metadata.inputModalities.length > 0 + ) + ? intersectStringArrays(knownMetadata.map((metadata) => metadata.inputModalities || [])) + : []; + const outputModalities = knownMetadata.every( + (metadata) => + Array.isArray(metadata.outputModalities) && metadata.outputModalities.length > 0 + ) + ? intersectStringArrays(knownMetadata.map((metadata) => metadata.outputModalities || [])) + : []; + + const capabilities: Record<string, boolean> = {}; + for (const key of [ + "tool_calling", + "reasoning", + "vision", + "attachment", + "structured_output", + "temperature", + "thinking", + ]) { + const values = knownMetadata.map((metadata) => metadata.capabilities[key]); + if (values.every((value): value is boolean => typeof value === "boolean")) { + const [first] = values; + if (values.every((value) => value === first)) capabilities[key] = first; + } + } + + return { + ...baseMetadata, + ...(contextLength ? { context_length: contextLength } : {}), + ...(maxInputTokens ? { max_input_tokens: maxInputTokens } : {}), + ...(maxOutputTokens ? { max_output_tokens: maxOutputTokens } : {}), + ...(inputModalities.length > 0 ? { input_modalities: inputModalities } : {}), + ...(outputModalities.length > 0 ? { output_modalities: outputModalities } : {}), + ...(Object.keys(capabilities).length > 0 ? { capabilities } : {}), + }; + }; + // Collect models from active providers (or all if none active) const models = []; const timestamp = Math.floor(Date.now() / 1000); @@ -316,29 +581,7 @@ export async function getUnifiedModelsResponse( // Add combos first (they appear at the top) — only active ones for (const combo of combos) { if (combo.isActive === false || combo.isHidden === true) continue; - - // Calculate combo context length from its model targets. - // OpenCode and other clients read context_length from the catalog; without it - // they fall back to a conservative ~4000 token limit, causing truncation. - const comboContextLength = Array.isArray(combo.models) - ? combo.models - .filter((step) => step && step.kind === "model" && step.model) - .map((step) => { - const parsed = parseModel(step.model); - const provider = parsed.provider || (step as any).providerId || "unknown"; - const model = parsed.model || step.model; - return getTokenLimit(provider, model); - }) - .filter((limit): limit is number => typeof limit === "number" && limit > 0) - .reduce((min, limit) => Math.min(min, limit), Infinity) - : undefined; - - const effectiveContextLength = - typeof combo.context_length === "number" && combo.context_length > 0 - ? combo.context_length - : comboContextLength !== undefined && comboContextLength !== Infinity - ? comboContextLength - : undefined; + const comboMetadata = buildComboCatalogMetadata(combo, combos); models.push({ id: combo.name, @@ -348,7 +591,7 @@ export async function getUnifiedModelsResponse( permission: [], root: combo.name, parent: null, - ...(effectiveContextLength !== undefined ? { context_length: effectiveContextLength } : {}), + ...comboMetadata, }); } @@ -685,9 +928,9 @@ export async function getUnifiedModelsResponse( // Skip Gemini — handled by syncedAvailableModels above if (providerId === "gemini") continue; if (providerId === "reka") continue; - const providerCustomModels = Array.isArray(rawProviderCustomModels) + const providerCustomModels: CustomModelEntry[] = Array.isArray(rawProviderCustomModels) ? rawProviderCustomModels.filter( - (model): model is Record<string, unknown> => + (model): model is CustomModelEntry => !!model && typeof model === "object" && !Array.isArray(model) ) : []; @@ -760,8 +1003,8 @@ export async function getUnifiedModelsResponse( ...(endpoints.length > 1 || !endpoints.includes("chat") ? { supported_endpoints: endpoints } : {}), - ...(typeof (model as any).inputTokenLimit === "number" - ? { context_length: (model as any).inputTokenLimit } + ...(typeof model.inputTokenLimit === "number" + ? { context_length: model.inputTokenLimit } : {}), ...(visionFields || {}), }); @@ -785,8 +1028,8 @@ export async function getUnifiedModelsResponse( parent: aliasId, custom: true, ...(modelType ? { type: modelType } : {}), - ...(typeof (model as any).inputTokenLimit === "number" - ? { context_length: (model as any).inputTokenLimit } + ...(typeof model.inputTokenLimit === "number" + ? { context_length: model.inputTokenLimit } : {}), ...(providerVisionFields || {}), }); @@ -821,9 +1064,7 @@ export async function getUnifiedModelsResponse( const visionFields = getVisionCapabilityFields(aliasId) || getVisionCapabilityFields(modelId); const contextLength = - typeof (model as any).contextLength === "number" - ? (model as any).contextLength - : undefined; + typeof model.contextLength === "number" ? model.contextLength : undefined; models.push({ id: aliasId, @@ -867,10 +1108,17 @@ export async function getUnifiedModelsResponse( const provider = typeof model.owned_by === "string" ? model.owned_by : null; if (!provider) return undefined; const canonicalId = aliasToProviderId[provider] || provider; - return REGISTRY[canonicalId]?.defaultContextLength; + + const registryFallback = REGISTRY[canonicalId]?.defaultContextLength; + if (registryFallback) return registryFallback; + + const modelId = + model.root || (typeof model.id === "string" ? model.id.split("/").pop() : undefined); + return modelId ? getTokenLimit(canonicalId, modelId) : getTokenLimit(canonicalId); }; const enrichedModels = finalModels.map((model) => { + if (model.owned_by === "combo") return model; const enriched = enrichCatalogModelEntry(model); const fallbackContextLength = getDefaultContextFallback(enriched); return fallbackContextLength @@ -895,7 +1143,7 @@ export async function getUnifiedModelsResponse( return Response.json( { error: { - message: (error as any).message, + message: error instanceof Error ? error.message : String(error), type: "server_error", code: INTERNAL_PROXY_ERROR, }, diff --git a/src/app/api/v1/providers/[provider]/models/route.ts b/src/app/api/v1/providers/[provider]/models/route.ts new file mode 100644 index 0000000000..525660e4a4 --- /dev/null +++ b/src/app/api/v1/providers/[provider]/models/route.ts @@ -0,0 +1,85 @@ +import { getUnifiedModelsResponse } from "@/app/api/v1/models/catalog"; +import { getRegistryEntry } from "@omniroute/open-sse/config/providerRegistry.ts"; + +/** + * Handle CORS preflight + */ +export async function OPTIONS() { + return new Response(null, { + headers: { + "Access-Control-Allow-Methods": "GET, OPTIONS", + "Access-Control-Allow-Headers": "*", + }, + }); +} + +/** + * GET /v1/providers/{provider}/models + * Returns models for one provider with unprefixed ids. + */ +export async function GET(request: Request, { params }: { params: Promise<{ provider: string }> }) { + const { provider: rawProvider } = await params; + const providerEntry = getRegistryEntry(rawProvider); + + if (!providerEntry) { + return Response.json( + { + error: { + message: `Unknown provider: ${rawProvider}`, + type: "invalid_request_error", + code: "invalid_provider", + }, + }, + { status: 400 } + ); + } + + const response = await getUnifiedModelsResponse(request); + const payload = (await response + .clone() + .json() + .catch(() => null)) as { object?: string; data?: Array<Record<string, any>> } | null; + + if (!response.ok || !payload || !Array.isArray(payload.data)) { + return response; + } + + const providerId = providerEntry.id; + const providerAlias = providerEntry.alias || providerId; + + const toUnprefixedModelId = (model: Record<string, any>) => { + const root = typeof model.root === "string" && model.root.trim().length > 0 ? model.root : null; + if (root) return root; + + const id = typeof model.id === "string" ? model.id : ""; + if (!id) return id; + if (id.startsWith(`${providerAlias}/`)) return id.slice(providerAlias.length + 1); + if (id.startsWith(`${providerId}/`)) return id.slice(providerId.length + 1); + return id; + }; + + const filtered = payload.data.filter((model) => model?.owned_by === providerId); + const deduped = new Map<string, Record<string, any>>(); + + for (const model of filtered) { + const unprefixedId = toUnprefixedModelId(model); + if (!unprefixedId) continue; + if (deduped.has(unprefixedId)) continue; + deduped.set(unprefixedId, { + ...model, + id: unprefixedId, + parent: null, + }); + } + + return Response.json( + { + object: payload.object || "list", + data: [...deduped.values()], + }, + { + status: response.status, + headers: response.headers, + } + ); +} diff --git a/src/app/auth/callback/page.tsx b/src/app/auth/callback/page.tsx new file mode 100644 index 0000000000..4f24ca9e96 --- /dev/null +++ b/src/app/auth/callback/page.tsx @@ -0,0 +1,13 @@ +/** + * /auth/callback — OAuth callback endpoint for providers that use the + * `/auth/callback` path (Windsurf, Devin CLI PKCE flow). + * + * Reuses the same logic as /callback: + * - postMessage to opener (popup mode) + * - BroadcastChannel (same-origin tabs) + * - localStorage fallback + * + * On true localhost the random-port callback server intercepts this path first, + * so this page is only reached in the LAN / popup-without-callback-server case. + */ +export { default } from "@/app/callback/page"; diff --git a/src/app/docs/[slug]/page.tsx b/src/app/docs/[slug]/page.tsx index 27d8147dd9..44499f940a 100644 --- a/src/app/docs/[slug]/page.tsx +++ b/src/app/docs/[slug]/page.tsx @@ -8,6 +8,7 @@ import matter from "gray-matter"; import { marked } from "marked"; import DOMPurify from "isomorphic-dompurify"; import { Metadata } from "next"; +import { getLocale } from "next-intl/server"; import { DocCodeBlocks } from "../components/DocCodeBlocks"; import { FeedbackWidget } from "../components/FeedbackWidget"; import { DocsPageAnalytics } from "../components/DocsPageAnalytics"; @@ -127,8 +128,6 @@ function addProseClasses(html: string): string { return result; } - - export async function generateMetadata({ params, }: { @@ -168,8 +167,27 @@ export default async function DocPage({ params }: { params: Promise<{ slug: stri let mermaidCharts: string[] = []; try { - const docsRoot = path.join(process.cwd(), "docs"); - const fileContent = fs.readFileSync(path.join(docsRoot, item.fileName), "utf8"); + // Resolve the current request locale via next-intl. When it isn't `en` + // and a translated copy exists under `docs/i18n/<locale>/docs/<file>`, + // prefer the translated file. Otherwise fall back to the English source. + // Path resolution is hardened: the docs index supplies the safe filename + // (never user input), and we constrain the resolved path to the docs + // root so traversal sequences in a stray fileName cannot escape it. + const locale = await getLocale(); + const docsRoot = path.resolve(process.cwd(), "docs"); + const englishAbs = path.resolve(docsRoot, item.fileName); + if (!englishAbs.startsWith(docsRoot + path.sep) && englishAbs !== docsRoot) { + throw new Error("Refusing to read doc outside the docs root"); + } + let sourceAbs = englishAbs; + if (locale && locale !== "en") { + const localeRoot = path.resolve(docsRoot, "i18n", locale, "docs"); + const localeAbs = path.resolve(localeRoot, item.fileName); + if (localeAbs.startsWith(localeRoot + path.sep) && fs.existsSync(localeAbs)) { + sourceAbs = localeAbs; + } + } + const fileContent = fs.readFileSync(sourceAbs, "utf8"); const { content, data: frontmatter } = matter(fileContent); pageTitle = (frontmatter.title as string) || item.title; version = (frontmatter.version as string) || null; diff --git a/src/app/docs/components/ApiExplorerClient.tsx b/src/app/docs/components/ApiExplorerClient.tsx index 20f5a189a9..f83af3de50 100644 --- a/src/app/docs/components/ApiExplorerClient.tsx +++ b/src/app/docs/components/ApiExplorerClient.tsx @@ -1,88 +1,12 @@ "use client"; -import React, { useState, useEffect, useCallback } from "react"; - -interface ApiEndpoint { - method: string; - path: string; - description: string; - tag: string; -} - -const API_ENDPOINTS: ApiEndpoint[] = [ - { - method: "POST", - path: "/v1/chat/completions", - description: "OpenAI-compatible chat completions with streaming support", - tag: "Chat", - }, - { - method: "POST", - path: "/v1/responses", - description: "OpenAI Responses API format", - tag: "Responses", - }, - { - method: "GET", - path: "/v1/models", - description: "List available models across all providers", - tag: "Models", - }, - { - method: "POST", - path: "/v1/embeddings", - description: "Generate text embeddings", - tag: "Embeddings", - }, - { - method: "POST", - path: "/v1/images/generations", - description: "Generate images from text prompts", - tag: "Images", - }, - { - method: "POST", - path: "/v1/audio/transcriptions", - description: "Transcribe audio files", - tag: "Audio", - }, - { - method: "POST", - path: "/v1/audio/speech", - description: "Text-to-speech generation", - tag: "Audio", - }, - { - method: "POST", - path: "/v1/moderations", - description: "Content moderation check", - tag: "Moderations", - }, - { - method: "POST", - path: "/v1/rerank", - description: "Re-rank documents by relevance", - tag: "Rerank", - }, - { - method: "POST", - path: "/v1/search", - description: "Web search across 5 providers", - tag: "Search", - }, - { - method: "POST", - path: "/v1/videos/generations", - description: "Generate videos from prompts", - tag: "Video", - }, - { - method: "POST", - path: "/v1/music/generations", - description: "Generate music from prompts", - tag: "Music", - }, -]; +import React, { useState, useCallback, useMemo } from "react"; +import { + OPENAPI_ENDPOINTS, + OPENAPI_TAGS, + OPENAPI_VERSION, + type OpenApiEndpoint, +} from "../lib/openapi.generated"; const METHOD_COLORS: Record<string, string> = { GET: "bg-emerald-500/10 text-emerald-600 border-emerald-500/20", @@ -92,32 +16,79 @@ const METHOD_COLORS: Record<string, string> = { PATCH: "bg-purple-500/10 text-purple-600 border-purple-500/20", }; +/** + * A small map of richer "Try It" example bodies keyed by full path. The + * generated OpenAPI module exposes every endpoint with its description and + * summary; only paths in this map get a non-empty default request body when + * selected. Anything not listed here falls back to the empty placeholder + * (the user can paste their own body). + */ const EXAMPLE_BODIES: Record<string, string> = { - "/v1/chat/completions": JSON.stringify( - { model: "openai/gpt-4o-mini", messages: [{ role: "user", content: "Hello!" }], stream: true }, + "/api/v1/chat/completions": JSON.stringify( + { + model: "openai/gpt-4o-mini", + messages: [{ role: "user", content: "Hello!" }], + stream: true, + }, null, 2 ), - "/v1/models": "", - "/v1/embeddings": JSON.stringify( + "/api/v1/embeddings": JSON.stringify( { model: "openai/text-embedding-3-small", input: "Hello world" }, null, 2 ), - "/v1/images/generations": JSON.stringify( + "/api/v1/images/generations": JSON.stringify( { model: "openai/gpt-image-2", prompt: "A sunset over mountains", n: 1 }, null, 2 ), - "/v1/responses": JSON.stringify( + "/api/v1/responses": JSON.stringify( { model: "openai/gpt-4o-mini", input: "What is OmniRoute?" }, null, 2 ), + "/api/v1/messages": JSON.stringify( + { + model: "anthropic/claude-3-5-sonnet", + max_tokens: 1024, + messages: [{ role: "user", content: "Hi" }], + }, + null, + 2 + ), + "/api/v1/messages/count_tokens": JSON.stringify( + { + model: "anthropic/claude-3-5-sonnet", + messages: [{ role: "user", content: "Hi" }], + }, + null, + 2 + ), + "/api/v1/moderations": JSON.stringify( + { model: "openai/omni-moderation-latest", input: "Sample text" }, + null, + 2 + ), + "/api/v1/rerank": JSON.stringify( + { + model: "cohere/rerank-v3.5", + query: "best ai gateway", + documents: ["Document 1", "Document 2"], + }, + null, + 2 + ), + "/api/v1/audio/transcriptions": "", + "/api/v1/audio/speech": JSON.stringify( + { model: "openai/tts-1", input: "Hello world", voice: "alloy" }, + null, + 2 + ), }; export function ApiExplorerClient() { - const [selected, setSelected] = useState<ApiEndpoint | null>(null); + const [selected, setSelected] = useState<OpenApiEndpoint | null>(null); const [baseUrl, setBaseUrl] = useState("http://localhost:20128"); const [apiKey, setApiKey] = useState(""); const [requestBody, setRequestBody] = useState(""); @@ -125,15 +96,15 @@ export function ApiExplorerClient() { const [loading, setLoading] = useState(false); const [filterTag, setFilterTag] = useState<string | null>(null); - const allTags = [...new Set(API_ENDPOINTS.map((e) => e.tag))]; - const filteredEndpoints = filterTag - ? API_ENDPOINTS.filter((e) => e.tag === filterTag) - : API_ENDPOINTS; + const filteredEndpoints = useMemo( + () => (filterTag ? OPENAPI_ENDPOINTS.filter((e) => e.tag === filterTag) : OPENAPI_ENDPOINTS), + [filterTag] + ); - const handleSelect = useCallback((endpoint: ApiEndpoint) => { + const handleSelect = useCallback((endpoint: OpenApiEndpoint) => { setSelected(endpoint); setResponse(null); - const example = EXAMPLE_BODIES[endpoint.path] || ""; + const example = EXAMPLE_BODIES[endpoint.path] ?? ""; setRequestBody(example); }, []); @@ -151,6 +122,10 @@ export function ApiExplorerClient() { opts.body = requestBody; } + // Strip the leading /api so callers can paste `http://localhost:20128` + // as the base URL without doubling the prefix. The OpenAPI spec uses + // `/api/v1/...` because that is the Next.js route; the runtime client + // hits the same path. const res = await fetch(`${baseUrl}${selected.path}`, opts); const contentType = res.headers.get("content-type") || ""; @@ -171,6 +146,11 @@ export function ApiExplorerClient() { <div className="flex flex-col lg:flex-row gap-6"> <div className="lg:w-72 shrink-0"> <div className="sticky top-4"> + <div className="mb-3 flex items-center gap-2 text-xs text-text-muted"> + <span> + {OPENAPI_ENDPOINTS.length} endpoints · OpenAPI v{OPENAPI_VERSION} + </span> + </div> <div className="flex flex-wrap gap-1.5 mb-4"> <button onClick={() => setFilterTag(null)} @@ -179,7 +159,7 @@ export function ApiExplorerClient() { > All </button> - {allTags.map((tag) => ( + {OPENAPI_TAGS.map((tag) => ( <button key={tag} onClick={() => setFilterTag(filterTag === tag ? null : tag)} @@ -222,15 +202,23 @@ export function ApiExplorerClient() { <div className="flex-1 min-w-0"> {selected ? ( <div className="space-y-4"> - <div className="flex items-center gap-3"> + <div className="flex items-center gap-3 flex-wrap"> <span className={`px-2 py-1 text-xs font-mono font-bold rounded border ${METHOD_COLORS[selected.method]}`} > {selected.method} </span> <span className="font-mono text-sm text-text-main">{selected.path}</span> + {selected.requiresAuth && ( + <span className="px-1.5 py-0.5 text-[10px] font-mono rounded border border-amber-500/30 bg-amber-500/10 text-amber-600"> + auth + </span> + )} </div> - <p className="text-sm text-text-muted">{selected.description}</p> + <p className="text-sm text-text-muted">{selected.summary || selected.description}</p> + {selected.description && selected.description !== selected.summary && ( + <p className="text-xs text-text-muted whitespace-pre-line">{selected.description}</p> + )} <div className="grid grid-cols-1 sm:grid-cols-2 gap-3"> <div> @@ -254,7 +242,7 @@ export function ApiExplorerClient() { </div> </div> - {selected.method !== "GET" && ( + {selected.method !== "GET" && selected.hasRequestBody && ( <div> <label className="text-xs text-text-muted block mb-1">Request Body</label> <textarea diff --git a/src/app/docs/components/DocsI18n.tsx b/src/app/docs/components/DocsI18n.tsx deleted file mode 100644 index 49a76a01f7..0000000000 --- a/src/app/docs/components/DocsI18n.tsx +++ /dev/null @@ -1,200 +0,0 @@ -"use client"; - -import { useMemo, useState } from "react"; -import { useSearchParams, useRouter, usePathname } from "next/navigation"; - -type Locale = "en" | "pt-BR" | "es" | "fr" | "de" | "ja" | "zh-CN" | "ko" | "ru" | "ar"; - -const SECTION_LABELS: Record<Locale, Record<string, string>> = { - en: { - "Getting Started": "Getting Started", - Features: "Features", - "API & Protocols": "API & Protocols", - Deployment: "Deployment", - Operations: "Operations", - Development: "Development", - }, - "pt-BR": { - "Getting Started": "Primeiros Passos", - Features: "Recursos", - "API & Protocols": "API & Protocolos", - Deployment: "Implantação", - Operations: "Operações", - Development: "Desenvolvimento", - }, - es: { - "Getting Started": "Primeros Pasos", - Features: "Características", - "API & Protocols": "API y Protocolos", - Deployment: "Despliegue", - Operations: "Operaciones", - Development: "Desarrollo", - }, - fr: { - "Getting Started": "Démarrage", - Features: "Fonctionnalités", - "API & Protocols": "API et Protocoles", - Deployment: "Déploiement", - Operations: "Opérations", - Development: "Développement", - }, - de: { - "Getting Started": "Erste Schritte", - Features: "Funktionen", - "API & Protocols": "API & Protokolle", - Deployment: "Bereitstellung", - Operations: "Betrieb", - Development: "Entwicklung", - }, - ja: { - "Getting Started": "はじめに", - Features: "機能", - "API & Protocols": "APIとプロトコル", - Deployment: "デプロイ", - Operations: "運用", - Development: "開発", - }, - "zh-CN": { - "Getting Started": "快速开始", - Features: "功能", - "API & Protocols": "API与协议", - Deployment: "部署", - Operations: "运维", - Development: "开发", - }, - ko: { - "Getting Started": "시작하기", - Features: "기능", - "API & Protocols": "API 및 프로토콜", - Deployment: "배포", - Operations: "운영", - Development: "개발", - }, - ru: { - "Getting Started": "Начало работы", - Features: "Возможности", - "API & Protocols": "API и Протоколы", - Deployment: "Развертывание", - Operations: "Эксплуатация", - Development: "Разработка", - }, - ar: { - "Getting Started": "البدء", - Features: "الميزات", - "API & Protocols": "API والبروتوكولات", - Deployment: "النشر", - Operations: "العمليات", - Development: "التطوير", - }, -}; - -function detectLocale(): Locale { - if (typeof navigator === "undefined") return "en"; - const lang = navigator.language; - if (lang.startsWith("pt-BR")) return "pt-BR"; - if (lang.startsWith("es")) return "es"; - if (lang.startsWith("fr")) return "fr"; - if (lang.startsWith("de")) return "de"; - if (lang.startsWith("ja")) return "ja"; - if (lang.startsWith("zh")) return "zh-CN"; - if (lang.startsWith("ko")) return "ko"; - if (lang.startsWith("ru")) return "ru"; - if (lang.startsWith("ar")) return "ar"; - return "en"; -} - -export function useDocsLocale() { - const searchParams = useSearchParams(); - return useMemo<Locale>(() => { - const langParam = searchParams.get("lang"); - if (langParam && langParam in SECTION_LABELS) return langParam as Locale; - return detectLocale(); - }, [searchParams]); -} - -export function useLocalizedSectionTitle(englishTitle: string): string { - const locale = useDocsLocale(); - return SECTION_LABELS[locale]?.[englishTitle] ?? englishTitle; -} - -export function getAvailableLocales(): Locale[] { - return Object.keys(SECTION_LABELS) as Locale[]; -} - -export const LOCALE_NAMES: Record<Locale, string> = { - en: "English", - "pt-BR": "Português (Brasil)", - es: "Español", - fr: "Français", - de: "Deutsch", - ja: "日本語", - "zh-CN": "简体中文", - ko: "한국어", - ru: "Русский", - ar: "العربية", -}; - -const COMMON_LOCALES: Locale[] = ["en", "pt-BR", "es", "fr", "de", "ja", "zh-CN", "ko", "ru", "ar"]; - -export function DocsLocaleSwitcher() { - const searchParams = useSearchParams(); - const router = useRouter(); - const pathname = usePathname(); - const [isOpen, setIsOpen] = useState(false); - const currentLocale = useMemo<Locale>(() => { - const langParam = searchParams.get("lang"); - if (langParam && langParam in SECTION_LABELS) return langParam as Locale; - if (typeof navigator !== "undefined") { - const navLocale = detectLocale(); - if (navLocale in SECTION_LABELS) return navLocale; - } - return "en"; - }, [searchParams]); - - const handleLocaleChange = (locale: Locale) => { - setIsOpen(false); - const params = new URLSearchParams(searchParams.toString()); - if (locale === "en") { - params.delete("lang"); - } else { - params.set("lang", locale); - } - const queryString = params.toString(); - router.push(`${pathname}${queryString ? `?${queryString}` : ""}`); - }; - - return ( - <div className="relative"> - <button - onClick={() => setIsOpen(!isOpen)} - className="flex items-center gap-1 px-2 py-1 text-xs border border-border rounded hover:border-primary/50 transition-colors text-text-muted hover:text-text-main" - aria-label="Change documentation language" - aria-expanded={isOpen} - aria-haspopup="listbox" - > - <span className="material-symbols-outlined text-sm">language</span> - {LOCALE_NAMES[currentLocale]} - </button> - {isOpen && ( - <div - className="absolute right-0 top-full mt-1 bg-bg border border-border rounded-lg shadow-lg z-50 py-1 min-w-[160px]" - role="listbox" - > - {COMMON_LOCALES.map((locale) => ( - <button - key={locale} - onClick={() => handleLocaleChange(locale)} - className={`w-full text-left px-3 py-1.5 text-sm hover:bg-primary/5 transition-colors ${ - locale === currentLocale ? "text-primary font-semibold" : "text-text-muted" - }`} - role="option" - aria-selected={locale === currentLocale} - > - {LOCALE_NAMES[locale]} - </button> - ))} - </div> - )} - </div> - ); -} diff --git a/src/app/docs/content.ts b/src/app/docs/content.ts index 75935e98d6..5b7d5af8b3 100644 --- a/src/app/docs/content.ts +++ b/src/app/docs/content.ts @@ -85,11 +85,47 @@ export const DOCS_USE_CASE_ITEMS = [ ] as const; export const DOCS_DEPLOYMENT_GUIDES = [ + { + icon: "rocket_launch", + titleKey: "deploySetupTitle", + textKey: "deploySetupText", + href: "/docs/setup-guide", + }, + { + icon: "computer", + titleKey: "deployElectronTitle", + textKey: "deployElectronText", + href: "/docs/electron-guide", + }, + { + icon: "directions_boat_filled", + titleKey: "deployDockerTitle", + textKey: "deployDockerText", + href: "/docs/docker-guide", + }, + { + icon: "dns", + titleKey: "deployVmTitle", + textKey: "deployVmText", + href: "/docs/vm-deployment-guide", + }, + { + icon: "cloud", + titleKey: "deployFlyTitle", + textKey: "deployFlyText", + href: "/docs/fly-io-deployment-guide", + }, + { + icon: "phone_iphone", + titleKey: "deployPwaTitle", + textKey: "deployPwaText", + href: "/docs/pwa-guide", + }, { icon: "android", titleKey: "deployTermuxTitle", textKey: "deployTermuxText", - href: "https://github.com/diegosouzapw/OmniRoute/blob/main/docs/TERMUX_GUIDE.md", + href: "/docs/termux-guide", }, ] as const; @@ -155,6 +191,22 @@ export const DOCS_MCP_TOOL_GROUPS = [ textKey: "mcpToolsCacheDesc", tools: ["omniroute_cache_stats", "omniroute_cache_flush"], }, + { + titleKey: "mcpToolsCompressionTitle", + textKey: "mcpToolsCompressionDesc", + tools: [ + "omniroute_compression_status", + "omniroute_compression_configure", + "omniroute_compression_combo_stats", + "omniroute_list_compression_combos", + "omniroute_set_compression_engine", + ], + }, + { + titleKey: "mcpToolsOneProxyTitle", + textKey: "mcpToolsOneProxyDesc", + tools: ["omniroute_oneproxy_fetch", "omniroute_oneproxy_rotate", "omniroute_oneproxy_stats"], + }, { titleKey: "mcpToolsMemoryTitle", textKey: "mcpToolsMemoryDesc", diff --git a/src/app/docs/layout.tsx b/src/app/docs/layout.tsx index 4890d479c4..fbab0e946a 100644 --- a/src/app/docs/layout.tsx +++ b/src/app/docs/layout.tsx @@ -1,7 +1,7 @@ import Link from "next/link"; import { ReactNode, Suspense } from "react"; import { DocsSidebarClient } from "./components/DocsSidebarClient"; -import { DocsLocaleSwitcher } from "./components/DocsI18n"; +import LanguageSelector from "@/shared/components/LanguageSelector"; export const metadata = { title: { @@ -56,7 +56,7 @@ export default function DocsLayout({ children }: { children: ReactNode }) { </Link> </div> <Suspense fallback={<div className="w-24 h-8" />}> - <DocsLocaleSwitcher /> + <LanguageSelector /> </Suspense> </nav> diff --git a/src/app/docs/lib/docs-auto-generated.ts b/src/app/docs/lib/docs-auto-generated.ts index 867dda3e31..b7b4f3d1d8 100644 --- a/src/app/docs/lib/docs-auto-generated.ts +++ b/src/app/docs/lib/docs-auto-generated.ts @@ -1,5 +1,5 @@ -// AUTO-GENERATED by scripts/generate-docs-index.mjs — DO NOT EDIT MANUALLY -// Regenerate with: node scripts/generate-docs-index.mjs +// AUTO-GENERATED by scripts/docs/generate-docs-index.mjs — DO NOT EDIT MANUALLY +// Regenerate with: node scripts/docs/generate-docs-index.mjs export interface AutoGenDocItem { slug: string; @@ -23,201 +23,278 @@ export interface AutoGenSearchItem { export const autoNavSections: AutoGenNavSection[] = [ { - "title": "Getting Started", - "items": [ + title: "Architecture", + items: [ { - "slug": "architecture", - "title": "OmniRoute Architecture", - "fileName": "ARCHITECTURE.md" + slug: "architecture", + title: "OmniRoute Architecture", + fileName: "architecture/ARCHITECTURE.md", }, { - "slug": "cli-tools", - "title": "CLI Tools Setup Guide", - "fileName": "CLI-TOOLS.md" + slug: "authz-guide", + title: "Authorization Guide", + fileName: "architecture/AUTHZ_GUIDE.md", }, { - "slug": "setup-guide", - "title": "Setup Guide", - "fileName": "SETUP_GUIDE.md" + slug: "codebase-documentation", + title: "OmniRoute Codebase Documentation", + fileName: "architecture/CODEBASE_DOCUMENTATION.md", }, { - "slug": "user-guide", - "title": "User Guide", - "fileName": "USER_GUIDE.md" - } - ] + slug: "repository-map", + title: "Repository Map", + fileName: "architecture/REPOSITORY_MAP.md", + }, + { + slug: "resilience-guide", + title: "Resilience Guide", + fileName: "architecture/RESILIENCE_GUIDE.md", + }, + ], }, { - "title": "Features", - "items": [ + title: "Guides", + items: [ { - "slug": "auto-combo", - "title": "OmniRoute Auto-Combo Engine", - "fileName": "AUTO-COMBO.md" + slug: "docker-guide", + title: "🐳 Docker Guide — OmniRoute", + fileName: "guides/DOCKER_GUIDE.md", }, { - "slug": "compression-engines", - "title": "Compression Engines", - "fileName": "COMPRESSION_ENGINES.md" + slug: "electron-guide", + title: "Electron Desktop Guide", + fileName: "guides/ELECTRON_GUIDE.md", }, { - "slug": "compression-guide", - "title": "🗜️ Prompt Compression Guide", - "fileName": "COMPRESSION_GUIDE.md" + slug: "features", + title: "OmniRoute — Dashboard Features Gallery", + fileName: "guides/FEATURES.md", }, { - "slug": "compression-language-packs", - "title": "Compression Language Packs", - "fileName": "COMPRESSION_LANGUAGE_PACKS.md" + slug: "i18n", + title: "i18n — Internationalization Guide", + fileName: "guides/I18N.md", }, { - "slug": "compression-rules-format", - "title": "Compression Rules Format", - "fileName": "COMPRESSION_RULES_FORMAT.md" + slug: "pwa-guide", + title: "Progressive Web App (PWA) Guide", + fileName: "guides/PWA_GUIDE.md", }, { - "slug": "features", - "title": "OmniRoute — Dashboard Features Gallery", - "fileName": "FEATURES.md" + slug: "setup-guide", + title: "📖 Setup Guide — OmniRoute", + fileName: "guides/SETUP_GUIDE.md", }, { - "slug": "free-tiers", - "title": "🆓 Free LLM API Providers — Consolidated Directory", - "fileName": "FREE_TIERS.md" + slug: "termux-guide", + title: "Termux Headless Setup", + fileName: "guides/TERMUX_GUIDE.md", }, { - "slug": "rtk-compression", - "title": "RTK Compression", - "fileName": "RTK_COMPRESSION.md" - } - ] + slug: "troubleshooting", + title: "Troubleshooting", + fileName: "guides/TROUBLESHOOTING.md", + }, + { + slug: "uninstall", + title: "OmniRoute — Uninstall Guide", + fileName: "guides/UNINSTALL.md", + }, + { + slug: "user-guide", + title: "User Guide", + fileName: "guides/USER_GUIDE.md", + }, + ], }, { - "title": "API & Protocols", - "items": [ + title: "Reference", + items: [ { - "slug": "a2a-server", - "title": "OmniRoute A2A Server Documentation", - "fileName": "A2A-SERVER.md" + slug: "api-reference", + title: "API Reference", + fileName: "reference/API_REFERENCE.md", }, { - "slug": "api-reference", - "title": "API Reference", - "fileName": "API_REFERENCE.md" + slug: "cli-tools", + title: "CLI Tools — OmniRoute v3.8.0", + fileName: "reference/CLI-TOOLS.md", }, { - "slug": "mcp-server", - "title": "OmniRoute MCP Server Documentation", - "fileName": "MCP-SERVER.md" - } - ] + slug: "environment", + title: "Environment Variables Reference", + fileName: "reference/ENVIRONMENT.md", + }, + { + slug: "free-tiers", + title: "Free Tiers", + fileName: "reference/FREE_TIERS.md", + }, + { + slug: "provider-reference", + title: "Provider Reference", + fileName: "reference/PROVIDER_REFERENCE.md", + }, + ], }, { - "title": "Deployment", - "items": [ + title: "Frameworks", + items: [ { - "slug": "docker-guide", - "title": "🐳 Docker Guide", - "fileName": "DOCKER_GUIDE.md" + slug: "a2a-server", + title: "OmniRoute A2A Server Documentation", + fileName: "frameworks/A2A-SERVER.md", }, { - "slug": "fly-io-deployment-guide", - "title": "OmniRoute Fly.io 部署指南", - "fileName": "FLY_IO_DEPLOYMENT_GUIDE.md" + slug: "agent-protocols-guide", + title: "Agent Protocols Guide", + fileName: "frameworks/AGENT_PROTOCOLS_GUIDE.md", }, { - "slug": "pwa-guide", - "title": "Progressive Web App (PWA) Guide", - "fileName": "PWA_GUIDE.md" + slug: "cloud-agent", + title: "Cloud Agents", + fileName: "frameworks/CLOUD_AGENT.md", }, { - "slug": "termux-guide", - "title": "Termux Headless Setup", - "fileName": "TERMUX_GUIDE.md" + slug: "evals", + title: "Evaluations (Evals)", + fileName: "frameworks/EVALS.md", }, { - "slug": "vm-deployment-guide", - "title": "OmniRoute — Deployment Guide on VM with Cloudflare", - "fileName": "VM_DEPLOYMENT_GUIDE.md" - } - ] + slug: "mcp-server", + title: "OmniRoute MCP Server Documentation", + fileName: "frameworks/MCP-SERVER.md", + }, + { + slug: "memory", + title: "Memory System", + fileName: "frameworks/MEMORY.md", + }, + { + slug: "skills", + title: "Skills Framework", + fileName: "frameworks/SKILLS.md", + }, + { + slug: "webhooks", + title: "Webhooks", + fileName: "frameworks/WEBHOOKS.md", + }, + ], }, { - "title": "Operations", - "items": [ + title: "Routing", + items: [ { - "slug": "environment", - "title": "Environment Variables Reference", - "fileName": "ENVIRONMENT.md" + slug: "auto-combo", + title: "OmniRoute Auto-Combo Engine", + fileName: "routing/AUTO-COMBO.md", }, { - "slug": "proxy-guide", - "title": "OmniRoute Proxy Guide", - "fileName": "PROXY_GUIDE.md" + slug: "reasoning-replay", + title: "Reasoning Replay Cache", + fileName: "routing/REASONING_REPLAY.md", }, - { - "slug": "resilience-guide", - "title": "🛡️ Resilience Guide", - "fileName": "RESILIENCE_GUIDE.md" - }, - { - "slug": "troubleshooting", - "title": "Troubleshooting", - "fileName": "TROUBLESHOOTING.md" - } - ] + ], }, { - "title": "Development", - "items": [ + title: "Security", + items: [ { - "slug": "codebase-documentation", - "title": "omniroute — Codebase Documentation", - "fileName": "CODEBASE_DOCUMENTATION.md" + slug: "compliance", + title: "Compliance & Audit", + fileName: "security/COMPLIANCE.md", }, { - "slug": "coverage-plan", - "title": "Test Coverage Plan", - "fileName": "COVERAGE_PLAN.md" + slug: "guardrails", + title: "Guardrails", + fileName: "security/GUARDRAILS.md", }, { - "slug": "i18n", - "title": "i18n — Internationalization Guide", - "fileName": "I18N.md" + slug: "stealth-guide", + title: "Stealth Guide", + fileName: "security/STEALTH_GUIDE.md", }, - { - "slug": "release-checklist", - "title": "Release Checklist", - "fileName": "RELEASE_CHECKLIST.md" - }, - { - "slug": "uninstall", - "title": "OmniRoute — Uninstall Guide", - "fileName": "UNINSTALL.md" - } - ] + ], }, { - "title": "Other", - "items": [ + title: "Compression", + items: [ { - "slug": "rfc-auto-assessment", - "title": "RFC: Auto-Assessment & Self-Healing Combo Engine", - "fileName": "RFC-AUTO-ASSESSMENT.md" - } - ] - } + slug: "compression-engines", + title: "Compression Engines", + fileName: "compression/COMPRESSION_ENGINES.md", + }, + { + slug: "compression-guide", + title: "🗜️ Prompt Compression Guide — OmniRoute", + fileName: "compression/COMPRESSION_GUIDE.md", + }, + { + slug: "compression-language-packs", + title: "Compression Language Packs", + fileName: "compression/COMPRESSION_LANGUAGE_PACKS.md", + }, + { + slug: "compression-rules-format", + title: "Compression Rules Format", + fileName: "compression/COMPRESSION_RULES_FORMAT.md", + }, + { + slug: "rtk-compression", + title: "RTK Compression", + fileName: "compression/RTK_COMPRESSION.md", + }, + ], + }, + { + title: "Ops", + items: [ + { + slug: "coverage-plan", + title: "Test Coverage Plan", + fileName: "ops/COVERAGE_PLAN.md", + }, + { + slug: "fly-io-deployment-guide", + title: "OmniRoute Fly.io 部署指南", + fileName: "ops/FLY_IO_DEPLOYMENT_GUIDE.md", + }, + { + slug: "proxy-guide", + title: "🌐 OmniRoute Proxy Guide", + fileName: "ops/PROXY_GUIDE.md", + }, + { + slug: "release-checklist", + title: "Release Checklist", + fileName: "ops/RELEASE_CHECKLIST.md", + }, + { + slug: "tunnels-guide", + title: "Tunnels Guide", + fileName: "ops/TUNNELS_GUIDE.md", + }, + { + slug: "vm-deployment-guide", + title: "OmniRoute — Deployment Guide on VM with Cloudflare", + fileName: "ops/VM_DEPLOYMENT_GUIDE.md", + }, + ], + }, ]; export const autoSearchIndex: AutoGenSearchItem[] = [ { - "slug": "architecture", - "title": "OmniRoute Architecture", - "fileName": "ARCHITECTURE.md", - "section": "Getting Started", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ + slug: "architecture", + title: "OmniRoute Architecture", + fileName: "architecture/ARCHITECTURE.md", + section: "Architecture", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ "Executive Summary", + "Reference Diagrams", "Scope and Boundaries", "In Scope", "Out of Scope", @@ -226,156 +303,135 @@ export const autoSearchIndex: AutoGenSearchItem[] = [ "Core Runtime Components", "1) API and Routing Layer (Next.js App Routes)", "2) SSE + Translation Core", - "3) Persistence Layer" - ] + ], }, { - "slug": "cli-tools", - "title": "CLI Tools Setup Guide", - "fileName": "CLI-TOOLS.md", - "section": "Getting Started", - "content": "This guide explains how to install and configure all supported AI coding CLI tools to use OmniRoute as the unified backend, giving you centralized key management, cost tracking, model switching, and request logging across every tool. The dashboard cards in /dashboard/cli-tools are generated from src", - "headings": [ - "How It Works", - "Supported Tools (Dashboard Source of Truth)", - "CLI fingerprint sync (Agents + Settings)", - "Step 1 — Get an OmniRoute API Key", - "Step 2 — Install CLI Tools", - "Step 3 — Set Global Environment Variables", - "Step 4 — Configure Each Tool", - "Claude Code", - "OpenAI Codex", - "OpenCode" - ] + slug: "authz-guide", + title: "Authorization Guide", + fileName: "architecture/AUTHZ_GUIDE.md", + section: "Architecture", + content: + "Source of truth: src/server/authz/, src/shared/constants/publicApiRoutes.ts, src/lib/api/requireManagementAuth.ts, src/shared/utils/apiAuth.ts Last updated: 2026-05-13 — v3.8.0 OmniRoute has a route-aware authorization pipeline that gates every API request. Classification is deterministic and fail-c", + headings: [ + "Two Auth Modes", + "1. API Key (Bearer)", + "2. Dashboard Session (auth_token cookie)", + "Route Classes", + "Pipeline", + "Policy contracts", + "Public Routes List", + "Adding a New Route", + "Pattern 1 — Public client API endpoint (Bearer-auth)", + "Pattern 2 — Management endpoint (session or Bearer + manage)", + ], }, { - "slug": "setup-guide", - "title": "Setup Guide", - "fileName": "SETUP_GUIDE.md", - "section": "Getting Started", - "content": "Complete setup reference for OmniRoute. For the quick version, see the Quick Start in README. - Install Methods - CLI Tool Configuration - Protocol Setup (MCP + A2A) - Timeout Configuration - Split-Port Mode - Void Linux (xbps-src) - Uninstalling -------------------- --------------------------------", - "headings": [ + slug: "codebase-documentation", + title: "OmniRoute Codebase Documentation", + fileName: "architecture/CODEBASE_DOCUMENTATION.md", + section: "Architecture", + content: + "Version: v3.8.0 Last updated: 2026-05-13 Audience: Engineers contributing to OmniRoute or building integrations on top of it. For high-level architecture diagrams and the reasoning behind each subsystem, read ARCHITECTURE.md. For deep dives on individual subsystems (Auto Combo, MCP server, A2A serve", + headings: [ + "1. Tech Stack", + "2. Repository Layout", + "3. src/ — Next.js Application", + "3.1 src/app/ — App Router", + "3.1.1 src/app/(dashboard)/dashboard/ — UI pages", + "3.1.2 src/app/api/ — Top-level API groups", + "3.1.3 src/app/api/v1/ — OpenAI-compatible public API", + "3.2 src/lib/ — Core libraries", + "3.2.1 src/lib/db/", + "3.3 src/domain/ — Domain layer", + ], + }, + { + slug: "repository-map", + title: "Repository Map", + fileName: "architecture/REPOSITORY_MAP.md", + section: "Architecture", + content: + "One-line description for every directory and root file. Last updated: 2026-05-13 — OmniRoute v3.8.0 Use this map to navigate the codebase quickly. For deep dives, follow links to dedicated docs. ---------------------------------------- ----------------------------------------------------------------", + headings: [ + "Top-level tree", + "Root files", + "src/ — Next.js application", + "src/app/ — App Router (Next.js 16)", + "src/lib/ — Core libraries (~50 modules)", + "src/db/ — Database (45+ modules + 55 migrations)", + "src/domain/", + "src/server/", + "src/shared/", + "open-sse/ — Streaming Engine Workspace", + ], + }, + { + slug: "resilience-guide", + title: "Resilience Guide", + fileName: "architecture/RESILIENCE_GUIDE.md", + section: "Architecture", + content: + "OmniRoute has three distinct but related resilience mechanisms. Each has a different scope and purpose. Keep them separate when debugging routing behavior. Source: diagrams/resilience-3layers.mmd Scope: entire provider (e.g., glm, openai, anthropic). Purpose: stop sending traffic to a provider that ", + headings: [ + "1. Provider Circuit Breaker", + "2. Connection Cooldown", + "3. Model Lockout", + "Model Cooldowns Dashboard (v3.8.0)", + "Other Resilience Features", + "Debugging", + "TLS Fingerprinting & Stealth", + "See Also", + ], + }, + { + slug: "docker-guide", + title: "🐳 Docker Guide — OmniRoute", + fileName: "guides/DOCKER_GUIDE.md", + section: "Guides", + content: + "Complete Docker deployment reference. For a quick start, see the README Docker section. - Quick Run - With Environment File - Docker Compose - Available Profiles - Redis Sidecar - Production Compose - Dockerfile Stages - Critical Environment Variables - Docker Compose with Caddy (HTTPS) - Cloudflare", + headings: [ "Table of Contents", - "Install Methods", - "npm (recommended)", - "pnpm", - "Arch Linux (AUR)", - "From Source", - "Docker", - "CLI Options", - "CLI Tool Configuration", - "1) Connect Providers and Create API Key" - ] + "Quick Run", + "With Environment File", + "Docker Compose", + "Available Profiles", + "Redis Sidecar", + "Production Compose", + "Dockerfile Stages", + "Critical Environment Variables", + "Docker Compose with Caddy (HTTPS Auto-TLS)", + ], }, { - "slug": "user-guide", - "title": "User Guide", - "fileName": "USER_GUIDE.md", - "section": "Getting Started", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ - "Table of Contents", - "💰 Pricing at a Glance", - "🎯 Use Cases", - "Case 1: \"I have Claude Pro subscription\"", - "Case 2: \"I want zero cost\"", - "Case 3: \"I need 24/7 coding, no interruptions\"", - "Case 4: \"I want FREE AI in OpenClaw\"", - "📖 Provider Setup", - "🔐 Subscription Providers", - "Claude Code (Pro/Max)" - ] + slug: "electron-guide", + title: "Electron Desktop Guide", + fileName: "guides/ELECTRON_GUIDE.md", + section: "Guides", + content: + "Source of truth: electron/ workspace Last updated: 2026-05-13 — v3.8.0 OmniRoute ships a cross-platform desktop app (Windows / macOS / Linux) built on Electron 41 + electron-builder 26.10. The desktop app spawns the Next.js standalone server as a child process, points a BrowserWindow at it, and adds", + headings: [ + "Architecture", + "Versions", + "Scripts (root package.json)", + "Directory Layout", + "IPC Bridge (preload.js)", + "Server Lifecycle", + "Zero-config Secret Bootstrap", + "Window & Tray", + "Content Security Policy", + "Auto-update", + ], }, { - "slug": "auto-combo", - "title": "OmniRoute Auto-Combo Engine", - "fileName": "AUTO-COMBO.md", - "section": "Features", - "content": "Self-managing model chains with adaptive scoring The Auto-Combo Engine dynamically selects the best provider/model for each request using a 6-factor scoring function: Factor Weight Description :--------- :----- :---------------------------------------------- Quota 0.20 Remaining capacity [0..1] Heal", - "headings": [ - "How It Works", - "Mode Packs", - "Self-Healing", - "Bandit Exploration", - "API", - "Task Fitness", - "Files" - ] - }, - { - "slug": "compression-engines", - "title": "Compression Engines", - "fileName": "COMPRESSION_ENGINES.md", - "section": "Features", - "content": "OmniRoute compression is built around engine contracts. A mode can run one engine directly (caveman or rtk) or a deterministic stacked pipeline that executes multiple engines in order. Mode Engine path Intended input ------------ ---------------------------------- -----------------------------------", - "headings": [ - "Modes", - "Engine Registry", - "Caveman", - "RTK", - "Stacked Pipelines", - "Compression Combos", - "API Surface", - "MCP Tools", - "Validation" - ] - }, - { - "slug": "compression-guide", - "title": "🗜️ Prompt Compression Guide", - "fileName": "COMPRESSION_GUIDE.md", - "section": "Features", - "content": "Save 15-95% on eligible context automatically. For a quick overview, see the README Compression section. OmniRoute implements a modular prompt compression pipeline that runs proactively before requests hit upstream providers. This means your token savings happen transparently — no changes needed to ", - "headings": [ - "Overview", - "Compression Modes", - "Off", - "Lite Mode (~15% savings, <1ms latency)", - "Standard Mode (~30% savings)", - "Aggressive Mode (~50% savings)", - "Ultra Mode (~75% savings)", - "RTK Mode (60-90% upstream range)", - "Stacked Mode (78-95% eligible range)", - "Upstream Savings Math" - ] - }, - { - "slug": "compression-language-packs", - "title": "Compression Language Packs", - "fileName": "COMPRESSION_LANGUAGE_PACKS.md", - "section": "Features", - "content": "Caveman compression can load language-specific rule packs in addition to the built-in English rules. This keeps the core engine stable while allowing Portuguese, Spanish, German, French, Japanese, and future language packs to evolve independently. Language packs live under: Current shipped packs inc", - "headings": [ - "Location", - "Language Detection", - "Config Shape", - "Adding a Language Pack", - "API", - "Operational Notes" - ] - }, - { - "slug": "compression-rules-format", - "title": "Compression Rules Format", - "fileName": "COMPRESSION_RULES_FORMAT.md", - "section": "Features", - "content": "Compression rules are JSON files loaded at runtime. They are intentionally data-only so new language packs and RTK command filters can be reviewed without changing engine code. Caveman rule packs live under: Each pack contains replacements that apply to normal prose after protected regions are isola", - "headings": [ - "Caveman Rule Packs", - "Caveman Fields", - "RTK Filter Packs", - "RTK Fields", - "Safety Rules", - "Validation" - ] - }, - { - "slug": "features", - "title": "OmniRoute — Dashboard Features Gallery", - "fileName": "FEATURES.md", - "section": "Features", - "content": "🌐 Main README translations: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indones", - "headings": [ + slug: "features", + title: "OmniRoute — Dashboard Features Gallery", + fileName: "guides/FEATURES.md", + section: "Guides", + content: + "🌐 Main README translations: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indones", + headings: [ + "✨ v3.8.0 Highlights", "🔌 Providers", "🎨 Combos", "📊 Analytics", @@ -385,147 +441,36 @@ export const autoSearchIndex: AutoGenSearchItem[] = [ "🎨 Themes _(v2.0.5+)_", "⚙️ Settings", "🔧 CLI Tools", - "🤖 CLI Agents _(v2.0.11+)_" - ] + ], }, { - "slug": "free-tiers", - "title": "🆓 Free LLM API Providers — Consolidated Directory", - "fileName": "FREE_TIERS.md", - "section": "Features", - "content": "The ultimate aggregated reference for all permanently free LLM API providers. Consolidated from 6 community repositories. Use with OmniRoute to route through 25+ free providers simultaneously. Last consolidated: May 2026 · Sources: awesome-free-llm-apis, awesome-free-llm-apis2, free-llm-api-resource", - "headings": [ - "Table of Contents", - "Quick Comparison", - "Provider APIs (First-Party)", - "Google Gemini 🇺🇸", - "Mistral AI 🇫🇷", - "Cohere 🇨🇦", - "Z.AI (Zhipu AI) 🇨🇳", - "IBM watsonx 🇺🇸", - "Inference Providers (Third-Party)", - "Groq 🇺🇸" - ] + slug: "i18n", + title: "i18n — Internationalization Guide", + fileName: "guides/I18N.md", + section: "Guides", + content: + "OmniRoute supports 30 languages with full dashboard UI translation, translated documentation, and RTL support for Arabic and Hebrew. 🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇩🇪 Deutsch 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇯🇵 日本語 🇰🇷 한국어 🇸🇦 العربية 🇮🇳 ", + headings: [ + "Translation pipeline (recommended — v3.8.0)", + "Legacy scripts (deprecated)", + "Quick Reference", + "Architecture", + "Source of Truth", + "Runtime Flow", + "Supported Locales", + "Adding a New Language", + "1. Register the Locale", + "2. Add to Generator", + ], }, { - "slug": "rtk-compression", - "title": "RTK Compression", - "fileName": "RTK_COMPRESSION.md", - "section": "Features", - "content": "RTK compression is OmniRoute's command-aware compression engine for terminal and tool output. It is designed for coding-agent sessions where most context growth comes from test logs, build output, package manager noise, shell transcripts, Docker output, git output, and stack traces. RTK can run dire", - "headings": [ - "What It Compresses", - "Filter Resolution", - "Filter DSL", - "Configuration", - "API", - "Raw Output Recovery", - "Verify Gate", - "Extending RTK" - ] - }, - { - "slug": "a2a-server", - "title": "OmniRoute A2A Server Documentation", - "fileName": "A2A-SERVER.md", - "section": "API & Protocols", - "content": "Agent-to-Agent Protocol v0.3 — OmniRoute as an intelligent routing agent Returns the Agent Card describing OmniRoute's capabilities, skills, and authentication requirements. Sends a message to a skill and waits for the complete response. Response: Same as message/send but returns Server-Sent Events ", - "headings": [ - "Agent Discovery", - "Authentication", - "Enablement", - "JSON-RPC 2.0 Methods", - "message/send — Synchronous Execution", - "message/stream — SSE Streaming", - "tasks/get — Query Task Status", - "tasks/cancel — Cancel a Task", - "Available Skills", - "Task Lifecycle" - ] - }, - { - "slug": "api-reference", - "title": "API Reference", - "fileName": "API_REFERENCE.md", - "section": "API & Protocols", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ - "Table of Contents", - "Chat Completions", - "Custom Headers", - "Embeddings", - "Image Generation", - "List Models", - "Compatibility Endpoints", - "Dedicated Provider Routes", - "Semantic Cache", - "Dashboard & Management" - ] - }, - { - "slug": "mcp-server", - "title": "OmniRoute MCP Server Documentation", - "fileName": "MCP-SERVER.md", - "section": "API & Protocols", - "content": "Model Context Protocol server with 37 tools across routing, cache, compression, memory, skills, and proxy operations OmniRoute MCP is built-in. Start it with: Or via the open-sse transport: See MCP Client Configuration for Claude Desktop, Cursor, Cline, and compatible MCP client setup. -------------", - "headings": [ - "Installation", - "IDE Configuration", - "Essential Tools (8)", - "Advanced Tools (8)", - "Cache Tools (2)", - "Compression Tools (5)", - "Other Tool Groups", - "Authentication", - "Audit Logging", - "Files" - ] - }, - { - "slug": "docker-guide", - "title": "🐳 Docker Guide", - "fileName": "DOCKER_GUIDE.md", - "section": "Deployment", - "content": "Complete Docker deployment reference. For a quick start, see the README Docker section. - Quick Run - With Environment File - Docker Compose - Docker Compose with Caddy (HTTPS) - Cloudflare Quick Tunnel - Image Tags - Important Notes --------------------- -------- ------ --------------------- diegos", - "headings": [ - "Table of Contents", - "Quick Run", - "With Environment File", - "Docker Compose", - "Docker Compose with Caddy (HTTPS Auto-TLS)", - "Cloudflare Quick Tunnel", - "Tunnel Notes", - "Image Tags", - "Important Notes", - "See Also" - ] - }, - { - "slug": "fly-io-deployment-guide", - "title": "OmniRoute Fly.io 部署指南", - "fileName": "FLY_IO_DEPLOYMENT_GUIDE.md", - "section": "Deployment", - "content": "本文档记录 OmniRoute 在 Fly.io 上的实际部署方法，适用于两类场景： - 首次把当前项目部署到 Fly.io - 后续代码更新后继续发布 - 新项目参考同样流程部署 本文基于当前项目已经验证通过的配置整理，应用名为 omniroute。 当前仓库中的 fly.toml 已确认包含以下关键项： 说明： - app = 'omniroute' 决定实际部署到哪个 Fly 应用 - destination = '/data' 决定持久卷挂载目录 - 本项目必须让 DATADIR=/data，否则数据库和密钥会写到容器临时目录 --- Windows PowerShell： 如果安装脚", - "headings": [ - "1. 部署目标", - "2. 当前项目关键配置", - "3. 必备工具", - "3.1 安装 Fly CLI", - "3.2 登录 Fly 账号", - "3.3 检查登录状态", - "4. 首次部署当前项目", - "4.1 获取代码并进入目录", - "4.2 确认应用名", - "4.3 创建应用" - ] - }, - { - "slug": "pwa-guide", - "title": "Progressive Web App (PWA) Guide", - "fileName": "PWA_GUIDE.md", - "section": "Deployment", - "content": "OmniRoute ships as a fully installable Progressive Web App. When you access the dashboard from any mobile browser — Android (Chrome) or iOS (Safari) — you can \"Add to Home Screen\" and get a native app-like experience with no app store required. A Progressive Web App turns the OmniRoute web dashboard", - "headings": [ + slug: "pwa-guide", + title: "Progressive Web App (PWA) Guide", + fileName: "guides/PWA_GUIDE.md", + section: "Guides", + content: + 'OmniRoute ships as a fully installable Progressive Web App. When you access the dashboard from any mobile browser — Android (Chrome) or iOS (Safari) — you can "Add to Home Screen" and get a native app-like experience with no app store required. A Progressive Web App turns the OmniRoute web dashboard', + headings: [ "What Is a PWA?", "Installation", "Android (Chrome)", @@ -535,16 +480,37 @@ export const autoSearchIndex: AutoGenSearchItem[] = [ "Fullscreen Experience", "Offline Support", "Offline Page", - "App Icons" - ] + "App Icons", + ], }, { - "slug": "termux-guide", - "title": "Termux Headless Setup", - "fileName": "TERMUX_GUIDE.md", - "section": "Deployment", - "content": "OmniRoute can run as a headless server on Android through Termux. The Electron desktop app is not supported in Termux, but the web dashboard and OpenAI-compatible API work from the local browser or from other devices on the same network. Install Termux from F-Droid or GitHub releases, then update pa", - "headings": [ + slug: "setup-guide", + title: "📖 Setup Guide — OmniRoute", + fileName: "guides/SETUP_GUIDE.md", + section: "Guides", + content: + "Complete setup reference for OmniRoute. For the quick version, see the Quick Start in README. - Install Methods - CLI Tool Configuration - Protocol Setup (MCP + A2A) - Timeout Configuration - Split-Port Mode - Void Linux (xbps-src) - Uninstalling -------------------- --------------------------------", + headings: [ + "Table of Contents", + "Install Methods", + "npm (recommended)", + "pnpm", + "Arch Linux (AUR)", + "From Source", + "Docker", + "Desktop App (Electron)", + "Headless server (CI/automation)", + "CLI Options", + ], + }, + { + slug: "termux-guide", + title: "Termux Headless Setup", + fileName: "guides/TERMUX_GUIDE.md", + section: "Guides", + content: + "OmniRoute can run as a headless server on Android through Termux. The Electron desktop app is not supported in Termux, but the web dashboard and OpenAI-compatible API work from the local browser or from other devices on the same network. Install Termux from F-Droid or GitHub releases, then update pa", + headings: [ "Prerequisites", "Install", "Run", @@ -554,181 +520,37 @@ export const autoSearchIndex: AutoGenSearchItem[] = [ "Limitations", "Troubleshooting", "better-sqlite3 Build Errors", - "Port Already In Use" - ] + "Port Already In Use", + ], }, { - "slug": "vm-deployment-guide", - "title": "OmniRoute — Deployment Guide on VM with Cloudflare", - "fileName": "VM_DEPLOYMENT_GUIDE.md", - "section": "Deployment", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ - "Prerequisites", - "1. Configure the VM", - "1.1 Create the instance", - "1.2 Connect via SSH", - "1.3 Update the system", - "1.4 Install Docker", - "1.5 Install nginx", - "1.6 Configure Firewall (UFW)", - "2. Install OmniRoute", - "2.1 Create configuration directory" - ] - }, - { - "slug": "environment", - "title": "Environment Variables Reference", - "fileName": "ENVIRONMENT.md", - "section": "Operations", - "content": "Complete reference for every environment variable recognized by OmniRoute. For a quick-start template, see .env.example. These must be set before the first run. Without them, the application will either refuse to start or operate with insecure defaults. Variable Required Default Source File Descript", - "headings": [ - "Table of Contents", - "1. Required Secrets", - "Generation Commands", - "2. Storage & Database", - "Scenarios", - "3. Network & Ports", - "Port Modes", - "4. Security & Authentication", - "Hardening Checklist", - "5. Input Sanitization & PII Protection" - ] - }, - { - "slug": "proxy-guide", - "title": "OmniRoute Proxy Guide", - "fileName": "PROXY_GUIDE.md", - "section": "Operations", - "content": "Bypass geographic blocks, protect your identity, and route AI traffic through any proxy — with zero configuration complexity. OmniRoute includes a full-featured proxy management system that lets you route upstream AI provider traffic through HTTP, HTTPS, or SOCKS5 proxies. Whether you're in a blocke", - "headings": [ - "Table of Contents", - "Why Use Proxies?", - "Architecture Overview", - "Key Components", - "3-Level Proxy System", - "How Resolution Works", - "What Gets Proxied", - "Proxy Registry (CRUD)", - "Creating a Proxy", - "Updating a Proxy" - ] - }, - { - "slug": "resilience-guide", - "title": "🛡️ Resilience Guide", - "fileName": "RESILIENCE_GUIDE.md", - "section": "Operations", - "content": "How OmniRoute keeps your AI coding workflow running when providers fail. OmniRoute implements a multi-layered resilience system that ensures zero downtime: ------------ ------- ------------------------------------ Queue Size 10 Max queued requests per connection Pacing Interval 0ms Minimum gap betwe", - "headings": [ - "Overview", - "Request Queue & Pacing", - "Connection Cooldown", - "Circuit Breaker", - "Wait For Cooldown", - "Anti-Thundering Herd", - "Combo Fallback Chains", - "13 Routing Strategies", - "TLS Fingerprint Spoofing", - "Health Dashboard" - ] - }, - { - "slug": "troubleshooting", - "title": "Troubleshooting", - "fileName": "TROUBLESHOOTING.md", - "section": "Operations", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ + slug: "troubleshooting", + title: "Troubleshooting", + fileName: "guides/TROUBLESHOOTING.md", + section: "Guides", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ "Quick Fixes", "Node.js Compatibility", - "Login page crashes or shows \"Module self-registration\" error", - "macOS: dlopen / \"slice is not valid mach-o file\"", + 'Login page crashes or shows "Module self-registration" error', + 'macOS: dlopen / "slice is not valid mach-o file"', "Proxy Issues", - "Provider validation shows \"fetch failed\"", - "Token health check fails with \"fetch failed\"", - "SOCKS5 proxy returns \"invalid onRequestStart method\"", + 'Provider validation shows "fetch failed"', + 'Token health check fails with "fetch failed"', + 'SOCKS5 proxy returns "invalid onRequestStart method"', "Provider Issues", - "\"Language model did not provide messages\"" - ] + '"Language model did not provide messages"', + ], }, { - "slug": "codebase-documentation", - "title": "omniroute — Codebase Documentation", - "fileName": "CODEBASE_DOCUMENTATION.md", - "section": "Development", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ - "1. What Is omniroute?", - "2. Architecture Overview", - "Core Principle: Hub-and-Spoke Translation", - "3. Project Structure", - "4. Module-by-Module Breakdown", - "4.1 Config (open-sse/config/)", - "Credential Loading Flow", - "4.2 Executors (open-sse/executors/)", - "4.3 Handlers (open-sse/handlers/)", - "Request Lifecycle (chatCore.ts)" - ] - }, - { - "slug": "coverage-plan", - "title": "Test Coverage Plan", - "fileName": "COVERAGE_PLAN.md", - "section": "Development", - "content": "Last updated: 2026-03-28 There are multiple coverage numbers depending on how the report is computed. For planning, only one of them is useful. Metric Scope Statements / Lines Branches Functions Notes -------------------- ----------------------------------------------------- -----------------: -----", - "headings": [ - "Baseline", - "Rules", - "Current command set", - "Milestones", - "Priority hotspots", - "Execution checklist", - "Phase 1: 56.95% -> 60%", - "Phase 2: 60% -> 65%", - "Phase 3: 65% -> 70%", - "Phase 4: 70% -> 75%" - ] - }, - { - "slug": "i18n", - "title": "i18n — Internationalization Guide", - "fileName": "I18N.md", - "section": "Development", - "content": "OmniRoute supports 30 languages with full dashboard UI translation, translated documentation, and RTL support for Arabic and Hebrew. 🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇩🇪 Deutsch 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇯🇵 日本語 🇰🇷 한국어 🇸🇦 العربية 🇮🇳 ", - "headings": [ - "Quick Reference", - "Architecture", - "Source of Truth", - "Runtime Flow", - "Supported Locales", - "Adding a New Language", - "1. Register the Locale", - "2. Add to Generator", - "3. Generate Initial Translation", - "4. Review & Fix Auto-Translations" - ] - }, - { - "slug": "release-checklist", - "title": "Release Checklist", - "fileName": "RELEASE_CHECKLIST.md", - "section": "Development", - "content": "Use this checklist before tagging or publishing a new OmniRoute release. 1. Bump package.json version (x.y.z) in the release branch. 2. Move release notes from [Unreleased] in CHANGELOG.md to a dated section: - [x.y.z] — YYYY-MM-DD 3. Keep [Unreleased] as the first changelog section for upcoming wor", - "headings": [ - "Version and Changelog", - "API Docs", - "Runtime Docs", - "Automated Check" - ] - }, - { - "slug": "uninstall", - "title": "OmniRoute — Uninstall Guide", - "fileName": "UNINSTALL.md", - "section": "Development", - "content": "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", - "headings": [ + slug: "uninstall", + title: "OmniRoute — Uninstall Guide", + fileName: "guides/UNINSTALL.md", + section: "Guides", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ "Quick Uninstall (v3.6.2+)", "Keep Your Data", "Full Removal", @@ -738,70 +560,650 @@ export const autoSearchIndex: AutoGenSearchItem[] = [ "Docker", "Docker Compose", "Electron Desktop App", - "Source Install (git clone)" - ] + "Source Install (git clone)", + ], }, { - "slug": "rfc-auto-assessment", - "title": "RFC: Auto-Assessment & Self-Healing Combo Engine", - "fileName": "RFC-AUTO-ASSESSMENT.md", - "section": "Other", - "content": "Omniroute's combo system currently requires manual configuration: users must know which providers and models are actually working, then manually wire them into combo chains. When providers fail (rate limits, auth errors, model deprecation), combos silently degrade — routing to dead endpoints that ti", - "headings": [ - "Summary", - "Problem Statement", - "What we encountered (real production incident)", - "Current flow (broken)", - "Proposed flow (self-healing)", + slug: "user-guide", + title: "User Guide", + fileName: "guides/USER_GUIDE.md", + section: "Guides", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ + "Table of Contents", + "💰 Pricing at a Glance", + "🎯 Use Cases", + 'Case 1: "I have Claude Pro subscription"', + 'Case 2: "I want zero cost"', + 'Case 3: "I need 24/7 coding, no interruptions"', + 'Case 4: "I want FREE AI in OpenClaw"', + "📖 Provider Setup", + "🔐 Subscription Providers", + "Claude Code (Pro/Max)", + ], + }, + { + slug: "api-reference", + title: "API Reference", + fileName: "reference/API_REFERENCE.md", + section: "Reference", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ + "Table of Contents", + "Chat Completions", + "Custom Headers", + "Embeddings", + "Image Generation", + "List Models", + "Compatibility Endpoints", + "Dedicated Provider Routes", + "Files API", + "Batches API", + ], + }, + { + slug: "cli-tools", + title: "CLI Tools — OmniRoute v3.8.0", + fileName: "reference/CLI-TOOLS.md", + section: "Reference", + content: + "Last updated: 2026-05-13 OmniRoute integrates with two categories of CLI tools: 1. External CLI integrations — third-party CLIs (Cursor, Cline, Codex, Claude Code, Qwen Code, Windsurf, Hermes, Amp, etc.) that you point at OmniRoute's local OpenAI-compatible endpoint. 2. Internal OmniRoute CLI — comm", + headings: [ + "How It Works", + "1. External CLI Integrations", + "Source of Truth", + "Current Catalog (v3.8.0)", + "CLI fingerprint sync (Agents + Settings)", + "Step 1 — Get an OmniRoute API Key", + "Step 2 — Install CLI Tools", + "Step 3 — Set Global Environment Variables", + "Step 4 — Configure Each Tool", + "Claude Code", + ], + }, + { + slug: "environment", + title: "Environment Variables Reference", + fileName: "reference/ENVIRONMENT.md", + section: "Reference", + content: + "Complete reference for every environment variable recognized by OmniRoute. For a quick-start template, see .env.example. [!IMPORTANT] Every variable documented here must also appear in .env.example, and every variable in .env.example must appear here. npm run check:env-doc-sync enforces this on comm", + headings: [ + "Table of Contents", + "1. Required Secrets", + "Generation Commands", + "2. Storage & Database", + "Scenarios", + "3. Network & Ports", + "Port Modes", + "4. Security & Authentication", + "Hardening Checklist", + "5. Input Sanitization & PII Protection", + ], + }, + { + slug: "free-tiers", + title: "Free Tiers", + fileName: "reference/FREE_TIERS.md", + section: "Reference", + content: + "Last consolidated: 2026-05-13 — OmniRoute v3.8.0 Source of truth: src/shared/constants/providers.ts (FREEPROVIDERS, OAUTHPROVIDERS, and APIKEYPROVIDERS entries flagged with hasFree: true + freeNote) This page lists providers with usable free tiers shipped in OmniRoute v3.8.0. The data is derived fro", + headings: [ + "How free providers are wired", + "Quick reference (API key providers with hasFree: true)", + "OAuth-based free tiers", + "Always-free OAuth providers (in FREE_PROVIDERS)", + "OAuth providers with vendor-controlled free tiers (in OAUTH_PROVIDERS)", + "Deprecated / discontinued", + "Qwen Code (qwen)", + "Command Code", + "Environment variables", + "How to use", + ], + }, + { + slug: "provider-reference", + title: "Provider Reference", + fileName: "reference/PROVIDER_REFERENCE.md", + section: "Reference", + content: + "Auto-generated from src/shared/constants/providers.ts — do not edit by hand. Regenerate with: npm run gen:provider-reference Last generated: 2026-05-13 Total providers: 177. See category breakdown below. - Free — free tier with API key (configured via dashboard) - OAuth — sign-in flow handled by Omn", + headings: [ + "Categories", + "Free Tier (OAuth-first or no-key) (5)", + "OAuth Providers (11)", + "Web Cookie Providers (5)", + "API Key Providers (paid / paid-with-free-credits) (123)", + "Local Providers (10)", + "Search Providers (11)", + "Audio-only Providers (7)", + "Upstream Proxy Providers (1)", + "Cloud Agent Providers (3)", + ], + }, + { + slug: "a2a-server", + title: "OmniRoute A2A Server Documentation", + fileName: "frameworks/A2A-SERVER.md", + section: "Frameworks", + content: + "Agent-to-Agent Protocol v0.3 — OmniRoute as an intelligent routing agent The A2A surface has two faces: - JSON-RPC 2.0 at POST /a2a (canonical entry point, defined in src/app/a2a/route.ts). - REST under /api/a2a/ for dashboards and tooling (status, task list, cancel). Tasks are tracked by A2ATaskMan", + headings: [ + "Agent Discovery", + "Authentication", + "Enablement", + "JSON-RPC 2.0 Methods", + "message/send — Synchronous Execution", + "message/stream — SSE Streaming", + "tasks/get — Query Task Status", + "tasks/cancel — Cancel a Task", + "Available Skills", + "REST API (auxiliary)", + ], + }, + { + slug: "agent-protocols-guide", + title: "Agent Protocols Guide", + fileName: "frameworks/AGENT_PROTOCOLS_GUIDE.md", + section: "Frameworks", + content: + "Source: src/lib/{a2a,acp,cloudAgent}/, src/app/api/{a2a,acp,cloud}/, src/app/api/v1/agents/ Last updated: 2026-05-13 — v3.8.0 OmniRoute exposes three different agent-related surfaces. They look similar at first glance but solve different problems. Use this page to pick the right one. Surface Best fo", + headings: [ + "TL;DR", + "Decision Tree", + "1. A2A — Agent-to-Agent", + "When to use", + "Methods", + "Built-in skills (5)", + "Deep dive", + "2. ACP — CLI Agents Registry", + "What it is", + "What it does", + ], + }, + { + slug: "cloud-agent", + title: "Cloud Agents", + fileName: "frameworks/CLOUD_AGENT.md", + section: "Frameworks", + content: + "Source of truth: src/lib/cloudAgent/ and src/app/api/v1/agents/tasks/ Last updated: 2026-05-13 — v3.8.0 OmniRoute orchestrates third-party cloud-hosted coding agents (Codex Cloud, Devin, Jules) as long-running tasks. Each agent is wrapped behind a uniform interface so clients can submit a prompt + r", + headings: [ + "Supported Agents", "Architecture", - "New Components", - "Detailed Design", - "1. Assessor — src/domain/assessor.ts", - "2. Categorizer — src/domain/categorizer.ts" - ] + "CloudAgentBase Interface", + "Domain Types", + "Database", + "REST API — Task Lifecycle", + "Create task", + "Approve a plan", + "Send a follow-up message", + "Cancel (local status only)", + ], }, { - "slug": "api-explorer", - "title": "API Explorer", - "fileName": "API_REFERENCE.md", - "section": "API & Protocols", - "content": "interactive try it live api explorer endpoint test request response curl example", - "headings": [ - "Try It", - "Endpoints" - ] - } + slug: "evals", + title: "Evaluations (Evals)", + fileName: "frameworks/EVALS.md", + section: "Frameworks", + content: + 'Source of truth: src/lib/evals/, src/lib/db/evals.ts, src/app/api/evals/ Last updated: 2026-05-13 — v3.8.0 OmniRoute ships a generic evaluation framework you can use to benchmark routing configurations, single providers/models, or the bundled "golden set" suites. Use it to verify routing changes, va', + headings: [ + "Concepts", + "Suite", + "Case", + "Target", + "Scoring Rubrics", + "Database Schema", + "REST API", + "Running a suite", + "Creating a custom suite", + "Dispatch Pipeline", + ], + }, + { + slug: "mcp-server", + title: "OmniRoute MCP Server Documentation", + fileName: "frameworks/MCP-SERVER.md", + section: "Frameworks", + content: + "Model Context Protocol server with 37 tools across routing, cache, compression, memory, skills, and proxy operations. Source of truth: open-sse/mcp-server/schemas/tools.ts (30 tools) + open-sse/mcp-server/tools/memoryTools.ts (3 tools) + open-sse/mcp-server/tools/skillTools.ts (4 tools). Tool regist", + headings: [ + "Installation", + "Transports", + "IDE Configuration", + "Essential Tools (8) — Phase 1", + "Phase 1 — Search", + "Advanced Tools (11) — Phase 2", + "Cache Tools (2)", + "Compression Tools (5)", + "1Proxy Tools (3)", + "Memory Tools (3)", + ], + }, + { + slug: "memory", + title: "Memory System", + fileName: "frameworks/MEMORY.md", + section: "Frameworks", + content: + "Source of truth: src/lib/memory/ and src/app/api/memory/ Last updated: 2026-05-13 — v3.8.0 OmniRoute provides persistent conversational memory keyed by API key (and optionally session id). Memories are extracted automatically from LLM responses via lightweight regex pattern matching and injected bac", + headings: [ + "Architecture", + "Storage Layers", + "Primary: SQLite (memories table)", + "Full-text Search (memory_fts virtual table)", + "Optional: Qdrant (vector store)", + "Memory Types", + "Fact Extraction (extraction.ts)", + "Retrieval (retrieval.ts)", + "Injection (injection.ts)", + "Settings (settings.ts)", + ], + }, + { + slug: "skills", + title: "Skills Framework", + fileName: "frameworks/SKILLS.md", + section: "Frameworks", + content: + "Source of truth: src/lib/skills/ and src/app/api/skills/ Last updated: 2026-05-13 — v3.8.0 OmniRoute exposes an extensible Skills framework that lets language models (and operators) compose reusable capabilities — from filesystem reads and HTTP requests to sandboxed code execution and curated market", + headings: [ + "Concepts", + "Skill Sources", + "Skill Identity", + "Skill Mode", + "Status (executions)", + "Registry Cache", + "Provider-Aware Injection", + "AUTO Scoring", + "Tool Call Interception", + "Docker Sandbox", + ], + }, + { + slug: "webhooks", + title: "Webhooks", + fileName: "frameworks/WEBHOOKS.md", + section: "Frameworks", + content: + "Source of truth: src/lib/webhookDispatcher.ts, src/lib/db/webhooks.ts, src/app/api/webhooks/ Last updated: 2026-05-13 — v3.8.0 OmniRoute can fire HTTP webhooks on platform events. Use them to integrate with Slack, PagerDuty, Datadog, internal alerting services, or any HTTP receiver. The dispatcher s", + headings: [ + "Supported Events", + "Architecture", + "HMAC Signing", + "Verifying on the receiver", + "Retry & Failure Policy", + "Database", + "REST API", + "Create webhook", + "Test webhook", + "Dashboard", + ], + }, + { + slug: "auto-combo", + title: "OmniRoute Auto-Combo Engine", + fileName: "routing/AUTO-COMBO.md", + section: "Routing", + content: + "Self-managing model chains with adaptive scoring + zero-config auto-routing NEW: No combo creation required. Use auto/ prefix directly in any client. Model ID Variant Behavior -------------- ------- ------------------------------------------------------------------------ auto default All connected p", + headings: [ + "Zero-Config Auto-Routing (auto/ prefix)", + "Quick Examples", + "How It Works (Persisted Auto-Combos)", + "Mode Packs", + "All Routing Strategies", + "Virtual Auto-Combo Factory", + "Self-Healing", + "Bandit Exploration", + "API", + "Task Fitness", + ], + }, + { + slug: "reasoning-replay", + title: "Reasoning Replay Cache", + fileName: "routing/REASONING_REPLAY.md", + section: "Routing", + content: + "Source of truth: src/lib/db/reasoningCache.ts, open-sse/services/reasoningCache.ts Last updated: 2026-05-13 — v3.8.0 OmniRoute captures assistant reasoningcontent produced by thinking-mode models and replays it transparently on multi-turn requests when the upstream provider requires it. This elimina", + headings: [ + "Why This Exists", + "Architecture", + "Storage — Hybrid Memory + SQLite", + "Database Schema", + "Provider / Model Detection", + "REST API", + "Operational Notes", + "See Also", + ], + }, + { + slug: "compliance", + title: "Compliance & Audit", + fileName: "security/COMPLIANCE.md", + section: "Security", + content: + "Source of truth: src/lib/compliance/, src/app/api/compliance/ Last updated: 2026-05-13 — v3.8.0 OmniRoute records administrative actions, authentication events, provider credential lifecycle changes, and MCP tool invocations to SQLite-backed audit tables. This page covers what gets logged, where it ", + headings: [ + "What Gets Logged", + "Administrative audit events (audit_log)", + "MCP tool calls (mcp_tool_audit)", + "Request / usage logs", + "Storage Schema", + "Retention & Cleanup", + "noLog Opt-Out (per API key)", + "REST API", + "Querying /api/compliance/audit-log", + "Dashboard", + ], + }, + { + slug: "guardrails", + title: "Guardrails", + fileName: "security/GUARDRAILS.md", + section: "Security", + content: + "Source of truth: src/lib/guardrails/ Last updated: 2026-05-13 — v3.8.0 Guardrails enforce safety, policy, and content transformations at the boundary between OmniRoute and upstream providers. Each guardrail can inspect (and optionally reject, transform, or annotate) request payloads (preCall) and up", + headings: [ + "Built-in Guardrails", + "Vision Bridge (visionBridge.ts)", + "PII Masker (piiMasker.ts)", + "Prompt Injection (promptInjection.ts)", + "Base Contract (base.ts)", + "Registry (registry.ts)", + "Disabling Guardrails Per-Request", + "Execution Order", + "Configuration", + "Custom Guardrails", + ], + }, + { + slug: "stealth-guide", + title: "Stealth Guide", + fileName: "security/STEALTH_GUIDE.md", + section: "Security", + content: + "Source of truth: open-sse/utils/tlsClient.ts, open-sse/services/{chatgptTlsClient,claudeCodeCCH,claudeCodeFingerprint,claudeCodeObfuscation,claudeCodeCompatible,antigravityObfuscation}.ts, open-sse/config/cliFingerprints.ts, src/mitm/ Last updated: 2026-05-13 — v3.8.0 Audience: Engineers maintaining", + headings: [ + "Legal and Ethical Notice", + "TLS Fingerprinting Layer", + "open-sse/utils/tlsClient.ts — wreq-js (Chrome 124)", + "open-sse/services/chatgptTlsClient.ts — tls-client-node (Firefox 148)", + "Claude Code Stealth Bundle", + "claudeCodeFingerprint.ts", + "claudeCodeCCH.ts (Client Content Hash)", + "claudeCodeObfuscation.ts", + "claudeCodeCompatible.ts — anthropic-compatible-cc- providers", + "Antigravity Stealth", + ], + }, + { + slug: "compression-engines", + title: "Compression Engines", + fileName: "compression/COMPRESSION_ENGINES.md", + section: "Compression", + content: + "OmniRoute compression is built around engine contracts. A mode can run one engine directly (caveman or rtk) or a deterministic stacked pipeline that executes multiple engines in order. Mode Engine path Intended input ------------ ---------------------------------- -----------------------------------", + headings: [ + "Modes", + "Engine Registry", + "MCP description compression (related)", + "Caveman", + "RTK", + "Stacked Pipelines", + "Compression Combos", + "API Surface", + "MCP Tools", + "Validation", + ], + }, + { + slug: "compression-guide", + title: "🗜️ Prompt Compression Guide — OmniRoute", + fileName: "compression/COMPRESSION_GUIDE.md", + section: "Compression", + content: + "Save 15-95% on eligible context automatically. For a quick overview, see the README Compression section. OmniRoute implements a modular prompt compression pipeline that runs proactively before requests hit upstream providers. This means your token savings happen transparently — no changes needed to ", + headings: [ + "Overview", + "Compression Modes", + "Off", + "Lite Mode (~15% savings, <1ms latency)", + "Standard Mode (~30% savings)", + "Aggressive Mode (~50% savings)", + "Ultra Mode (~75% savings)", + "RTK Mode (60-90% upstream range)", + "Stacked Mode (78-95% eligible range)", + "Upstream Savings Math", + ], + }, + { + slug: "compression-language-packs", + title: "Compression Language Packs", + fileName: "compression/COMPRESSION_LANGUAGE_PACKS.md", + section: "Compression", + content: + "Caveman compression can load language-specific rule packs in addition to the built-in English rules. This keeps the core engine stable while allowing Portuguese, Spanish, German, French, Japanese, and future language packs to evolve independently. Language packs live under: Current shipped packs (ve", + headings: [ + "Location", + "Language Detection", + "Config Shape", + "Adding a Language Pack", + "API", + "Operational Notes", + ], + }, + { + slug: "compression-rules-format", + title: "Compression Rules Format", + fileName: "compression/COMPRESSION_RULES_FORMAT.md", + section: "Compression", + content: + "Compression rules are JSON files loaded at runtime. They are intentionally data-only so new language packs and RTK command filters can be reviewed without changing engine code. Canonical schema (source of truth): open-sse/services/compression/rules/schema.json (JSON Schema draft 2020-12). The exampl", + headings: [ + "Caveman Rule Packs", + "Caveman Fields", + "RTK Filter Packs", + "RTK Fields", + "Safety Rules", + "Validation", + ], + }, + { + slug: "rtk-compression", + title: "RTK Compression", + fileName: "compression/RTK_COMPRESSION.md", + section: "Compression", + content: + "RTK compression is OmniRoute's command-aware compression engine for terminal and tool output. It is designed for coding-agent sessions where most context growth comes from test logs, build output, package manager noise, shell transcripts, Docker output, git output, and stack traces. RTK can run dire", + headings: [ + "What It Compresses", + "Filter Resolution", + "Filter DSL", + "Configuration", + "API", + "Raw Output Recovery", + "Verify Gate", + "Extending RTK", + ], + }, + { + slug: "coverage-plan", + title: "Test Coverage Plan", + fileName: "ops/COVERAGE_PLAN.md", + section: "Ops", + content: + "Last updated: 2026-05-13 Status measured on 2026-05-13: lines 82.58%, statements 82.58%, functions 84.23%, branches 75.22%. Phases 1-5 are complete. Current focus is Phase 6 (=85%) and Phase 7 (=90%). There are multiple coverage numbers depending on how the report is computed. For planning, only one", + headings: [ + "Baseline", + "Rules", + "Current command set", + "Milestones", + "Priority hotspots", + "Execution checklist", + "Phase 1: 56.95% -> 60%", + "Phase 2: 60% -> 65%", + "Phase 3: 65% -> 70%", + "Phase 4: 70% -> 75%", + ], + }, + { + slug: "fly-io-deployment-guide", + title: "OmniRoute Fly.io 部署指南", + fileName: "ops/FLY_IO_DEPLOYMENT_GUIDE.md", + section: "Ops", + content: + "本文档记录 OmniRoute 在 Fly.io 上的实际部署方法，适用于两类场景： - 首次把当前项目部署到 Fly.io - 后续代码更新后继续发布 - 新项目参考同样流程部署 本文基于当前项目已经验证通过的配置整理，应用名为 omniroute。 当前仓库中的 fly.toml 已确认包含以下关键项： 说明： - app = 'omniroute' 决定实际部署到哪个 Fly 应用 - destination = '/data' 决定持久卷挂载目录 - 本项目必须让 DATADIR=/data，否则数据库和密钥会写到容器临时目录 --- Windows PowerShell： 如果安装脚", + headings: [ + "1. 部署目标", + "2. 当前项目关键配置", + "3. 必备工具", + "3.1 安装 Fly CLI", + "3.2 登录 Fly 账号", + "3.3 检查登录状态", + "4. 首次部署当前项目", + "4.1 获取代码并进入目录", + "4.2 确认应用名", + "4.3 创建应用", + ], + }, + { + slug: "proxy-guide", + title: "🌐 OmniRoute Proxy Guide", + fileName: "ops/PROXY_GUIDE.md", + section: "Ops", + content: + "Bypass geographic blocks, protect your identity, and route AI traffic through any proxy — with zero configuration complexity. OmniRoute includes a full-featured proxy management system that lets you route upstream AI provider traffic through HTTP, HTTPS, or SOCKS5 proxies. Whether you're in a blocke", + headings: [ + "Table of Contents", + "Why Use Proxies?", + "Architecture Overview", + "Key Components", + "4-Level Proxy System", + "How Resolution Works", + "What Gets Proxied", + "Proxy Registry (CRUD)", + "Creating a Proxy", + "Updating a Proxy", + ], + }, + { + slug: "release-checklist", + title: "Release Checklist", + fileName: "ops/RELEASE_CHECKLIST.md", + section: "Ops", + content: + "Last updated: 2026-05-13 — v3.8.0 Streamlined release flow that leverages Claude Code skills for automation. - [ ] All PRs targeted to this release are merged to release/vX.Y.0 - [ ] All open Linear/issue items for this version are closed or pushed to next milestone - [ ] CI green on release/vX.Y.0 ", + headings: [ + "TL;DR", + "Detailed Checklist", + "Pre-release", + "Version & Changelog", + "Code Quality", + "Testing", + "Hooks (Husky validated)", + "Conventional Commits", + "Documentation", + "i18n", + ], + }, + { + slug: "tunnels-guide", + title: "Tunnels Guide", + fileName: "ops/TUNNELS_GUIDE.md", + section: "Ops", + content: + "Source of truth: src/lib/{cloudflaredTunnel,ngrokTunnel,tailscaleTunnel}.ts, src/app/api/tunnels/ Last updated: 2026-05-13 — v3.8.0 OmniRoute can expose its local server (http://localhost:20128) to the public internet via three tunnel backends. This is useful for: - OAuth callbacks from cloud provid", + headings: [ + "Backends at a glance", + "1. Cloudflare Tunnel (Quick Tunnel)", + "Enable / disable via REST", + "Optional env vars", + "2. ngrok", + "Prerequisites", + "Enable / disable via REST", + "3. Tailscale Funnel", + "Prerequisites", + "REST endpoints", + ], + }, + { + slug: "vm-deployment-guide", + title: "OmniRoute — Deployment Guide on VM with Cloudflare", + fileName: "ops/VM_DEPLOYMENT_GUIDE.md", + section: "Ops", + content: + "🌐 Languages: 🇺🇸 English 🇧🇷 Português (Brasil) 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇷🇺 Русский 🇨🇳 中文 (简体) 🇩🇪 Deutsch 🇮🇳 हिन्दी 🇹🇭 ไทย 🇺🇦 Українська 🇸🇦 العربية 🇯🇵 日本語 🇻🇳 Tiếng Việt 🇧🇬 Български 🇩🇰 Dansk 🇫🇮 Suomi 🇮🇱 עברית 🇭🇺 Magyar 🇮🇩 Bahasa Indonesia 🇰🇷 한국어 🇲\ud83c", + headings: [ + "Prerequisites", + "1. Configure the VM", + "1.1 Create the instance", + "1.2 Connect via SSH", + "1.3 Update the system", + "1.4 Install Docker", + "1.5 Install nginx", + "1.6 Configure Firewall (UFW)", + "2. Install OmniRoute", + "2.1 Create configuration directory", + ], + }, + { + slug: "api-explorer", + title: "API Explorer", + fileName: "reference/API_REFERENCE.md", + section: "Reference", + content: "interactive try it live api explorer endpoint test request response curl example", + headings: ["Try It", "Endpoints"], + }, ]; export const autoAllSlugs: string[] = [ "architecture", - "cli-tools", + "authz-guide", + "codebase-documentation", + "repository-map", + "resilience-guide", + "docker-guide", + "electron-guide", + "features", + "i18n", + "pwa-guide", "setup-guide", + "termux-guide", + "troubleshooting", + "uninstall", "user-guide", + "api-reference", + "cli-tools", + "environment", + "free-tiers", + "provider-reference", + "a2a-server", + "agent-protocols-guide", + "cloud-agent", + "evals", + "mcp-server", + "memory", + "skills", + "webhooks", "auto-combo", + "reasoning-replay", + "compliance", + "guardrails", + "stealth-guide", "compression-engines", "compression-guide", "compression-language-packs", "compression-rules-format", - "features", - "free-tiers", "rtk-compression", - "a2a-server", - "api-reference", - "mcp-server", - "docker-guide", - "fly-io-deployment-guide", - "pwa-guide", - "termux-guide", - "vm-deployment-guide", - "environment", - "proxy-guide", - "resilience-guide", - "troubleshooting", - "codebase-documentation", "coverage-plan", - "i18n", + "fly-io-deployment-guide", + "proxy-guide", "release-checklist", - "uninstall", - "rfc-auto-assessment" + "tunnels-guide", + "vm-deployment-guide", ]; diff --git a/src/app/docs/lib/openapi.generated.ts b/src/app/docs/lib/openapi.generated.ts new file mode 100644 index 0000000000..9e0441e0ae --- /dev/null +++ b/src/app/docs/lib/openapi.generated.ts @@ -0,0 +1,227 @@ +// AUTO-GENERATED by scripts/docs/gen-openapi-module.mjs — DO NOT EDIT MANUALLY +// Regenerate with: node scripts/docs/gen-openapi-module.mjs +// +// Source of truth: docs/reference/openapi.yaml +// +// The Api Explorer consumes `OPENAPI_ENDPOINTS`; the spec metadata +// (`OPENAPI_VERSION`, `OPENAPI_TITLE`) is surfaced in the page header. + +export interface OpenApiEndpoint { + /** Path template — may contain `{param}` placeholders. */ + path: string; + /** HTTP method in upper case (GET / POST / PUT / DELETE / PATCH / ...). */ + method: string; + /** Short one-line summary from the spec. */ + summary: string; + /** Long-form description (markdown is allowed). */ + description: string; + /** Primary tag — used for sidebar grouping in the Api Explorer. */ + tag: string; + /** All tags declared on the operation. */ + tags: string[]; + /** `true` when the operation declares a non-empty `security` array. */ + requiresAuth: boolean; + /** `true` when the operation declares a `requestBody`. */ + hasRequestBody: boolean; +} + +export const OPENAPI_VERSION = "3.8.0"; +export const OPENAPI_TITLE = "OmniRoute API"; + +export const OPENAPI_ENDPOINTS: OpenApiEndpoint[] = [ + { + path: "/api/v1", + method: "GET", + summary: "API v1 root endpoint", + description: "Returns basic API info and status.", + tag: "System", + tags: ["System"], + requiresAuth: true, + hasRequestBody: false, + }, + { + path: "/api/v1/api/chat", + method: "POST", + summary: "Ollama-compatible chat endpoint", + description: "Provides compatibility with Ollama's /api/chat format.", + tag: "Chat", + tags: ["Chat"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/audio/speech", + method: "POST", + summary: "Generate speech audio", + description: "Text-to-speech endpoint. Routes to configured TTS providers.", + tag: "Audio", + tags: ["Audio"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/audio/transcriptions", + method: "POST", + summary: "Transcribe audio", + description: "Audio-to-text transcription endpoint.", + tag: "Audio", + tags: ["Audio"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/chat/completions", + method: "POST", + summary: "Create chat completion", + description: "OpenAI-compatible chat completions endpoint. Routes to configured providers.", + tag: "Chat", + tags: ["Chat"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/embeddings", + method: "POST", + summary: "Create embeddings", + description: "", + tag: "Embeddings", + tags: ["Embeddings"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/images/generations", + method: "POST", + summary: "Generate images", + description: "", + tag: "Images", + tags: ["Images"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/messages", + method: "POST", + summary: "Create message (Anthropic-compatible)", + description: "Anthropic Messages API endpoint. Routes to Claude providers.", + tag: "Messages", + tags: ["Messages"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/messages/count_tokens", + method: "POST", + summary: "Count tokens for a message", + description: "", + tag: "Messages", + tags: ["Messages"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/models", + method: "GET", + summary: "List available models", + description: "Returns all models available across configured providers.", + tag: "Models", + tags: ["Models"], + requiresAuth: true, + hasRequestBody: false, + }, + { + path: "/api/v1/moderations", + method: "POST", + summary: "Create moderation", + description: "Content moderation endpoint. Routes to configured moderation providers.", + tag: "Moderations", + tags: ["Moderations"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/providers/{provider}/chat/completions", + method: "POST", + summary: "Create chat completion (provider-specific)", + description: "Routes to a specific provider by name.", + tag: "Chat", + tags: ["Chat"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/providers/{provider}/embeddings", + method: "POST", + summary: "Create embeddings (provider-specific)", + description: "", + tag: "Embeddings", + tags: ["Embeddings"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/providers/{provider}/images/generations", + method: "POST", + summary: "Generate images (provider-specific)", + description: "", + tag: "Images", + tags: ["Images"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/providers/{provider}/models", + method: "GET", + summary: "List models for a specific provider", + description: + "Returns only models for the selected provider with provider prefix removed from each model id.", + tag: "Models", + tags: ["Models"], + requiresAuth: true, + hasRequestBody: false, + }, + { + path: "/api/v1/rerank", + method: "POST", + summary: "Rerank documents", + description: "Document reranking endpoint.", + tag: "Rerank", + tags: ["Rerank"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1/responses", + method: "POST", + summary: "Create response (OpenAI Responses API)", + description: "OpenAI Responses API endpoint.", + tag: "Responses", + tags: ["Responses"], + requiresAuth: true, + hasRequestBody: true, + }, + { + path: "/api/v1beta/models", + method: "GET", + summary: "List models (Gemini format)", + description: "Returns models in Gemini v1beta format for native SDK compatibility", + tag: "Models", + tags: ["Models"], + requiresAuth: true, + hasRequestBody: false, + }, + { + path: "/api/v1beta/models/{path}", + method: "POST", + summary: "Gemini generateContent", + description: "Gemini-compatible generateContent endpoint", + tag: "Models", + tags: ["Models"], + requiresAuth: true, + hasRequestBody: true, + }, +]; + +export const OPENAPI_TAGS: string[] = Array.from( + new Set(OPENAPI_ENDPOINTS.map((endpoint) => endpoint.tag)) +).sort(); diff --git a/src/domain/modelAvailability.ts b/src/domain/modelAvailability.ts new file mode 100644 index 0000000000..63d05e08f5 --- /dev/null +++ b/src/domain/modelAvailability.ts @@ -0,0 +1,41 @@ +import { + getAllModelLockouts, + clearModelLock, + type ModelLockoutInfo, +} from "@omniroute/open-sse/services/accountFallback"; + +export type AvailabilityReportItem = Pick< + ModelLockoutInfo, + "provider" | "model" | "reason" | "remainingMs" | "failureCount" +> & { + connectionId: string; +}; + +export function getAvailabilityReport(): AvailabilityReportItem[] { + return getAllModelLockouts().map((entry) => ({ + provider: entry.provider, + model: entry.model, + connectionId: entry.connectionId, + reason: entry.reason, + remainingMs: entry.remainingMs, + failureCount: entry.failureCount, + })); +} + +export function clearModelUnavailability(provider: string, model: string): boolean { + const all = getAllModelLockouts(); + const matching = all.filter((e) => e.provider === provider && e.model === model); + if (matching.length === 0) return false; + let cleared = false; + for (const entry of matching) { + if (clearModelLock(provider, entry.connectionId, model)) cleared = true; + } + return cleared; +} + +export function resetAllAvailability(): void { + const all = getAllModelLockouts(); + for (const entry of all) { + clearModelLock(entry.provider, entry.connectionId, entry.model); + } +} diff --git a/src/i18n/config.ts b/src/i18n/config.ts index 0a180c714d..e4d5e3edc2 100644 --- a/src/i18n/config.ts +++ b/src/i18n/config.ts @@ -1,98 +1,68 @@ -export const LOCALES = [ - "ar", - "bg", - "bn", - "cs", - "da", - "de", - "en", - "es", - "fa", - "fi", - "fr", - "gu", - "he", - "hi", - "hu", - "id", - "in", - "it", - "ja", - "ko", - "mr", - "ms", - "nl", - "no", - "phi", - "pl", - "pt", - "pt-BR", - "ro", - "ru", - "sk", - "sv", - "sw", - "ta", - "te", - "th", - "tr", - "uk-UA", - "ur", - "vi", - "zh-CN", -] as const; -export type Locale = (typeof LOCALES)[number]; -export const DEFAULT_LOCALE: Locale = "en"; +// SOURCE OF TRUTH: `config/i18n.json` (also consumed by the docs translation +// pipeline in `scripts/i18n/run-translation.mjs`). Keep this file as a thin +// typed adapter — do NOT add hand-maintained locale lists here. +import i18nConfig from "../../config/i18n.json" with { type: "json" }; + +type RawLocaleEntry = { + code: string; + label: string; + name: string; + native?: string; + english?: string; + flag: string; +}; + +type RawI18nConfig = { + default: string; + rtl: readonly string[]; + uiOnly?: readonly string[]; + docsExcluded?: readonly string[]; + locales: readonly RawLocaleEntry[]; +}; + +const config = i18nConfig as RawI18nConfig; + +export const LOCALES = config.locales.map((l) => l.code) as readonly string[]; +export type Locale = (typeof LOCALES)[number]; +export const DEFAULT_LOCALE: Locale = config.default as Locale; + +/** + * Display metadata for every locale, kept in the same shape the codebase has + * historically consumed (`code`, `label`, `name`, `flag`). We additionally + * expose `native` and `english` as aliases for new call sites that want a + * stable field name regardless of the underlying display string. + */ export const LANGUAGES: readonly { code: Locale; label: string; name: string; + native: string; + english: string; flag: string; -}[] = [ - { code: "ar", label: "AR", name: "العربية", flag: "🇸🇦" }, - { code: "bg", label: "BG", name: "Български", flag: "🇧🇬" }, - { code: "bn", label: "BN", name: "বাংলা", flag: "🇧🇩" }, - { code: "cs", label: "CS", name: "Čeština", flag: "🇨🇿" }, - { code: "da", label: "DA", name: "Dansk", flag: "🇩🇰" }, - { code: "de", label: "DE", name: "Deutsch", flag: "🇩🇪" }, - { code: "en", label: "EN", name: "English", flag: "🇺🇸" }, - { code: "es", label: "ES", name: "Español", flag: "🇪🇸" }, - { code: "fa", label: "FA", name: "فارسی", flag: "🇮🇷" }, - { code: "fi", label: "FI", name: "Suomi", flag: "🇫🇮" }, - { code: "fr", label: "FR", name: "Français", flag: "🇫🇷" }, - { code: "gu", label: "GU", name: "ગુજરાતી", flag: "🇮🇳" }, - { code: "he", label: "HE", name: "עברית", flag: "🇮🇱" }, - { code: "hi", label: "HI", name: "हिन्दी", flag: "🇮🇳" }, - { code: "hu", label: "HU", name: "Magyar", flag: "🇭🇺" }, - { code: "id", label: "ID", name: "Bahasa Indonesia", flag: "🇮🇩" }, - { code: "in", label: "IN", name: "Bahasa Indonesia (Alt)", flag: "🇮🇩" }, - { code: "it", label: "IT", name: "Italiano", flag: "🇮🇹" }, - { code: "ja", label: "JA", name: "日本語", flag: "🇯🇵" }, - { code: "ko", label: "KO", name: "한국어", flag: "🇰🇷" }, - { code: "mr", label: "MR", name: "मराठी", flag: "🇮🇳" }, - { code: "ms", label: "MS", name: "Bahasa Melayu", flag: "🇲🇾" }, - { code: "nl", label: "NL", name: "Nederlands", flag: "🇳🇱" }, - { code: "no", label: "NO", name: "Norsk", flag: "🇳🇴" }, - { code: "phi", label: "PHI", name: "Filipino", flag: "🇵🇭" }, - { code: "pl", label: "PL", name: "Polski", flag: "🇵🇱" }, - { code: "pt-BR", label: "PT-BR", name: "Português (Brasil)", flag: "🇧🇷" }, - { code: "pt", label: "PT", name: "Português (Portugal)", flag: "🇵🇹" }, - { code: "ro", label: "RO", name: "Română", flag: "🇷🇴" }, - { code: "ru", label: "RU", name: "Русский", flag: "🇷🇺" }, - { code: "sk", label: "SK", name: "Slovenčina", flag: "🇸🇰" }, - { code: "sv", label: "SV", name: "Svenska", flag: "🇸🇪" }, - { code: "sw", label: "SW", name: "Kiswahili", flag: "🇰🇪" }, - { code: "ta", label: "TA", name: "தமிழ்", flag: "🇮🇳" }, - { code: "te", label: "TE", name: "తెలుగు", flag: "🇮🇳" }, - { code: "th", label: "TH", name: "ไทย", flag: "🇹🇭" }, - { code: "tr", label: "TR", name: "Türkçe", flag: "🇹🇷" }, - { code: "uk-UA", label: "UK-UA", name: "Українська", flag: "🇺🇦" }, - { code: "ur", label: "UR", name: "اردو", flag: "🇵🇰" }, - { code: "vi", label: "VI", name: "Tiếng Việt", flag: "🇻🇳" }, - { code: "zh-CN", label: "ZH-CN", name: "中文 (简体)", flag: "🇨🇳" }, -] as const; +}[] = config.locales.map((entry) => ({ + code: entry.code as Locale, + label: entry.label, + name: entry.name, + native: entry.native ?? entry.name, + english: entry.english ?? entry.name, + flag: entry.flag, +})); -export const RTL_LOCALES = ["ar", "fa", "he", "ur"] as const; +export const RTL_LOCALES: readonly Locale[] = config.rtl as readonly Locale[]; export const LOCALE_COOKIE = "NEXT_LOCALE"; + +// Convenience helpers -------------------------------------------------------- + +/** Locales that the docs translation pipeline writes to (excludes the source). */ +export const DOCS_TARGET_LOCALES: readonly Locale[] = LANGUAGES.map((l) => l.code).filter( + (code) => !(config.docsExcluded ?? []).includes(code) +) as readonly Locale[]; + +/** Lookup by code; falls back to the default locale entry if not found. */ +export function getLanguage(code: string) { + return ( + LANGUAGES.find((l) => l.code === code) ?? LANGUAGES.find((l) => l.code === DEFAULT_LOCALE)! + ); +} diff --git a/src/i18n/messages/ar.json b/src/i18n/messages/ar.json index 1fec4d9588..48e0325baf 100644 --- a/src/i18n/messages/ar.json +++ b/src/i18n/messages/ar.json @@ -23,6 +23,7 @@ "active": "نشط", "inactive": "غير نشط", "noData": "لا توجد بيانات متاحة", + "nothingHere": "Nothing here yet", "configure": "تكوين", "manage": "إدارة", "name": "الاسم", @@ -137,9 +138,8 @@ "Failed to reset pricing": "فشل في إعادة تعيين التسعير", "apikey": "مفتاح واجهة برمجة التطبيقات", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "ملعب النماذج", "searchTools": "Search Tools", "agents": "وكلاء", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "المستندات", "issues": "القضايا", "endpoints": "نقاط النهاية", "apiManager": "مدير API", "logs": "سجلات", + "webhooks": "__MISSING__:Webhooks", "auditLog": "سجل التدقيق", "shutdown": "إيقاف التشغيل", "restart": "إعادة التشغيل", @@ -705,8 +710,6 @@ "cliToolsShort": "أدوات", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "المواضيع", "description": "اختر قالبًا محددًا مسبقًا أو أنشئ قالبًا خاصًا بك بلون واحد", @@ -826,6 +926,10 @@ "evals": "التقييمات", "utilization": "الاستخدام", "utilizationDescription": "اتجاهات استخدام حصة المزود وتتبع حدود المعدل", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "صحة المجموعة", "comboHealthDescription": "الحصة على مستوى المجموعة وتوزيع الاستخدام ومقاييس الأداء", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "الأخير: {date}", "editPermissions": "تحرير الأذونات", "deleteKey": "حذف المفتاح", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} النموذج", "models": "{count} النماذج", "permissionsTitle": "الأذونات: {name}", @@ -1188,11 +1296,13 @@ "continue": "استخدمه عند تشغيل متابعة في IDEs وتحتاج إلى تكوين موفر محمول يستند إلى JSON.", "opencode": "استخدمه عندما تفضل تشغيل الوكيل الأصلي للمحطة والأتمتة النصية عبر OpenCode.", "kiro": "يُستخدم عند دمج Kiro والتحكم في توجيه النموذج مركزيًا من OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "يُستخدم عندما يجب اعتراض حركة مرور Antigravity/Kiro عبر MITM وتوجيهها إلى OmniRoute.", "copilot": "استخدمه عندما تريد UX بأسلوب دردشة Copilot أثناء فرض مفاتيح OmniRoute وقواعد التوجيه.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "جوجل مكافحة الجاذبية IDE مع MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "التراجع المتسلسل: تجربة النموذج 1 أولاً، ثم 2، وما إلى ذلك.", "weightedDesc": "يوزع حركة المرور حسب نسبة الوزن مع التراجع", "roundRobinDesc": "التوزيع الدائري: ينتقل كل طلب إلى النموذج التالي بالتناوب", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "اختيار عشوائي موحد، ثم الرجوع إلى النماذج المتبقية", "leastUsedDesc": "يختار النموذج الذي يحتوي على أقل عدد من الطلبات، مع موازنة الحمل مع مرور الوقت", "costOptimizedDesc": "الطرق إلى النموذج الأرخص تعتمد أولاً على التسعير", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "نماذج", @@ -1404,6 +1521,13 @@ "retryDelay": "تأخير إعادة المحاولة (ملي ثانية)", "concurrencyPerModel": "التزامن/النموذج", "queueTimeout": "مهلة قائمة الانتظار (مللي ثانية)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "اتركه فارغًا لاستخدام الإعدادات الافتراضية العامة. تتجاوز هذه الإعدادات لكل موفر.", "moveUp": "تحرك للأعلى", "moveDown": "تحرك للأسفل", @@ -1447,20 +1571,45 @@ "avoid": "بيانات التسعير مفقودة أو قديمة.", "example": "وظائف الخلفية أو الدُفعات حيث تكون التكلفة الأقل مفضلة." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", + "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "يعتبر Round - robin أكثر فائدة مع طرازين على الأقل.", "warningCostOptimizedPartialPricing": "فقط {priced} من طرازات {total} لها أسعار. قد يكون التوجيه مدركًا جزئيًا للتكلفة.", "warningCostOptimizedNoPricing": "لم يتم العثور على بيانات تسعير لهذه المجموعة. قد يتم توجيه التكلفة المحسّنة بشكل غير متوقع.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "هل أنت مستعد للحفظ؟", "readinessDescription": "قم بمراجعة قائمة التحقق قبل إنشاء هذا التحرير والسرد أو تحديثه.", "readinessCheckName": "اسم التحرير والسرد صالح", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "candidatePoolLabel": "Candidate Pool", + "emailVisibilityStateOn": "On", "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" - }, "basics": { "label": "Basics", "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" + }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { "label": "Review", "description": "Final validation before saving" } }, - "weightLatencyInv": "Latency", - "filterAll": "All", - "weightTierPriority": "Tier", - "builderPreview": "Preview", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "filterEmptyTitle": "No combos match this strategy filter.", - "reviewAdvanced": "Advanced Settings", - "routerStrategyLabel": "Router Strategy", - "builderFlowTitle": "Combo Builder Flow", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "contextRelaySummaryModel": "Summary Model", - "builderModel": "Model", - "excludedProviders": "Excluded Providers", - "emailVisibilityStateOn": "On", - "noExcludedProviders": "No providers are currently excluded.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "builderTitle": "Build a Combo", - "budgetCapLabel": "Budget Cap (USD / request)", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderStageLocked": "Locked — complete previous stage first", - "reviewComboRefs": "Combo References", - "builderAddStep": "Add step", - "builderComboRef": "Combo Ref", - "candidatePoolAllProviders": "All providers", - "weightStability": "Stability", - "reviewProviders": "Providers", - "builderAccount": "Account", - "weightTaskFit": "Task Fit", - "strategyRules": "Rules (6-Factor Scoring)", - "reorderHandle": "Drag to reorder", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderSelectModel": "Select model", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderBrowseCatalog": "Browse catalog", - "weightQuota": "Quota", - "reviewIntelligentTitle": "Intelligent Routing Config", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "statusOverview": "Status Overview", - "weightHealth": "Health", - "builderProviderFirst": "Pick provider first", - "reviewAgentFlags": "Agent Flags", - "explorationRateLabel": "Exploration Rate", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "filterIntelligent": "Intelligent", - "builderLoadingProviders": "Loading providers...", - "builderProvider": "Provider", - "reviewSequence": "Model Sequence", - "builderPinnedAccount": "Pinned Account", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "budgetCapPlaceholder": "No limit", - "candidatePoolEmpty": "No active providers available yet.", - "modePackLabel": "Mode Pack", - "activeModePack": "Active Mode Pack", - "builderComboRefStep": "Add combo reference", - "failedReorder": "Failed to reorder models", - "incidentMode": "Incident Mode", - "reviewStrategy": "Strategy", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "reviewName": "Name", - "builderAddComboRef": "Add combo reference", - "normalOperation": "Normal Operation", - "builderSelectProvider": "Select provider", - "filterDeterministic": "Deterministic", + "builderStageVisited": "Stage completed", "builderStageCurrent": "Current stage", - "reviewNoSteps": "No steps configured", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "weightCostInv": "Cost", - "providerScores": "Provider Scores", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "reviewSteps": "Steps", - "builderLegacyEntry": "Legacy entry", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelay": "Context Relay", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "builderStagePending": "Pending", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "modePackUpdated": "Mode pack updated to {pack}.", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", "reviewAccounts": "Accounts", - "builderStageVisited": "Stage completed" + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "التكاليف", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "الميزانية", "totalCost": "التكلفة الإجمالية", "breakdown": "تقسيم التكلفة", "noData": "لا توجد بيانات التكلفة", "byModel": "حسب الموديل", "byProvider": "بواسطة المزود", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "نقطة نهاية واجهة برمجة التطبيقات", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "نسخ الملفات الصوتية إلى نص (Whisper)", "textToSpeech": "تحويل النص إلى كلام", "textToSpeechDesc": "تحويل النص إلى كلام يبدو طبيعيا", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "الاعتدالات", "moderationsDesc": "الإشراف على المحتوى وتصنيف السلامة", "responsesDesc": "واجهة Responses من OpenAI لـ Codex وسير العمل الوكيلية المتقدمة", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "تتبع المهام والتحكم فيها باستخدام `tasks/get` و `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "صحة النظام", "description": "المراقبة في الوقت الحقيقي لمثيل OmniRoute الخاص بك", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "الحدود والحصص", "rateLimit": "حد السعر", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "مرحبًا", @@ -2262,6 +2661,12 @@ "errorCount": "{count} خطأ ({code})", "errorCountNoCode": "{count} خطأ", "noConnections": "لا اتصالات", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "معطل", "enableProvider": "تمكين المزود", "disableProvider": "تعطيل المزود", @@ -2296,7 +2701,6 @@ "errorOccurred": "حدث خطأ. يرجى المحاولة مرة أخرى.", "modelStatus": "حالة النموذج", "showConfiguredOnly": "Configured only", - "searchProviders": "البحث عن موفري الخدمة...", "allModelsOperational": "جميع الموديلات شغالة", "modelsWithIssues": "{count} الطراز (النماذج) الذي به مشكلات", "allModelsNormal": "جميع النماذج تستجيب بشكل طبيعي.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "تفاصيل متوافقة مع OpenAI", "messagesApi": "واجهة برمجة تطبيقات الرسائل", "responsesApi": "واجهة برمجة التطبيقات للردود", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "استكمالات الدردشة", "importingModels": "جارٍ الاستيراد...", "importFromModels": "الاستيراد من / النماذج", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "جميع النماذج مستوردة بالفعل", "noNewModelsToImport": "لا توجد نماذج جديدة للاستيراد — جميع النماذج موجودة بالفعل في السجل أو قائمة النماذج المخصصة", "skippingExistingModels": "تخطي {count} نماذج موجودة", @@ -2373,6 +2782,7 @@ "importFailed": "فشل الاستيراد", "noNewModelsAdded": "لم تتم إضافة نماذج جديدة.", "adding": "جارٍ الإضافة...", + "close": "Close", "importingModelsTitle": "استيراد النماذج", "copyModel": "نموذج النسخ", "filterModels": "تصفية النماذج…", @@ -2413,6 +2823,11 @@ "configured": "تم تكوينه", "providerProxyConfigureHint": "قم بتكوين الوكيل لجميع اتصالات هذا الموفر", "providerProxy": "وكيل الموفر", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "لا توجد اتصالات حتى الآن", "addFirstConnectionHint": "أضف اتصالك الأول للبدء", "addConnection": "إضافة اتصال", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "معرف النموذج", "customModelPlaceholder": "على سبيل المثال جي بي تي-4.5-توربو", "loading": "جار التحميل...", @@ -2513,6 +2931,10 @@ "email": "البريد الإلكتروني", "healthCheckMinutes": "فحص الصحة (دقيقة)", "healthCheckHint": "الفاصل الزمني لتحديث الرمز المميز. 0 = معطل.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "فشل في اختبار الاتصال", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "imagesGenerations": "Images Generations", - "repairEnvSuccess": "OAuth defaults restored", - "hideEmails": "Hide all emails", "showEmails": "Show all emails", - "repairEnvWorking": "Repairing...", - "audioTranscriptions": "Audio Transcriptions", - "embeddings": "Embeddings", - "repairEnv": "Repair env", - "selectAllModels": "Select all", - "deselectAllModels": "Deselect all", - "noModelsMatch": "No models match \"{filter}\"", - "audioSpeech": "Audio Speech", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "البحث عن موفري الخدمة...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "الإعدادات", @@ -2723,6 +3137,23 @@ "systemPrompt": "موجه النظام", "thinkingBudget": "ميزانية التفكير", "proxy": "وكيل", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "التسعير", "storage": "التخزين", "policies": "السياسات", @@ -2733,6 +3164,46 @@ "enablePassword": "تمكين كلمة المرور", "darkMode": "الوضع المظلم", "lightMode": "وضع الضوء", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "الآن فقط", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "مقدمي الخدمات", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "موضوع النظام", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "ذاكرة التخزين المؤقت TTL", "maxCacheSize": "الحد الأقصى لحجم ذاكرة التخزين المؤقت", "clearCache": "مسح ذاكرة التخزين المؤقت", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "زيارات ذاكرة التخزين المؤقت", "cacheMisses": "يفتقد ذاكرة التخزين المؤقت", "hitRate": "معدل الإصابة", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "تمكين التفكير", "maxThinkingTokens": "رموز التفكير ماكس", "enableProxy": "تمكين الوكيل", @@ -2802,6 +3277,14 @@ "themeLight": "ضوء", "themeDark": "الظلام", "themeSystem": "النظام", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "حماية نقطة النهاية لواجهة برمجة التطبيقات (API).", "requireAuthModels": "يتطلب مفتاح API لـ /models", "requireAuthModelsDesc": "عند التشغيل، تقوم نقطة النهاية /v1/models بإرجاع 404 للطلبات التي لم تتم مصادقتها. يمنع اكتشاف النموذج بواسطة مستخدمين غير مصرح لهم.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "مقدمي الخدمات المحظورين", "blockedProvidersDesc": "إخفاء موفري خدمات محددين من استجابة /v1/models. لن يظهر مقدمو الخدمات المحظورون في قوائم النماذج.", "providersBlocked": "{count} تم حظر الموفر (المزودين) من /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "اختر الحساب الأقل استخدامًا مؤخرًا", "costOpt": "خيار التكلفة", "costOptDesc": "تفضل أرخص حساب متاح", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "الحد اللزج", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "استراتيجية التحرير والسرد", "priority": "الأولوية", "weighted": "مرجح", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "ماكس إعادة المحاولة", "retryDelayLabel": "تأخير إعادة المحاولة (ملي ثانية)", "timeoutLabel": "المهلة (مللي ثانية)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "أقصى عمق التعشيش", "concurrencyPerModel": "التزامن/النموذج", "queueTimeout": "مهلة قائمة الانتظار (مللي ثانية)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "ملفات تعريف المزود", "providerProfilesDesc": "إعدادات مرونة منفصلة لموفري OAuth (القائم على الجلسة) ومفتاح API (المقيّد). لدى موفري OAuth حدود أكثر صرامة بسبب انخفاض حدود الأسعار.", "oauthProviders": "موفري OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "تم إنشاء النسخة الاحتياطية: {file}", "restoreSuccess": "المستعادة! {connections} اتصالات، {nodes} عقد، {combos} مجموعات، {apiKeys} مفاتيح API.", "importSuccess": "تم استيراد قاعدة البيانات! {connections} اتصالات، {nodes} عقد، {combos} مجموعات، {apiKeys} مفاتيح API.", - "justNow": "الآن فقط", "minutesAgo": "{count} منذ", "hoursAgo": "{count}h منذ", "daysAgo": "{count}d منذ", @@ -3112,7 +3610,6 @@ "errorDuringImport": "حدث خطأ أثناء الاستيراد", "modelPricing": "تسعير النموذج", "modelPricingDesc": "تكوين معدلات التكلفة لكل نموذج • جميع الأسعار بالرموز المميزة $/1M", - "providers": "مقدمي الخدمات", "registry": "التسجيل", "priced": "مسعر", "searchProvidersModels": "البحث عن موفري الخدمة أو النماذج...", @@ -3154,47 +3651,6 @@ "editPricing": "تحرير التسعير", "viewFullDetails": "عرض التفاصيل الكاملة", "themeCoral": "مرجاني", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "خطأ", "formatConverter": "محول التنسيق", "formatConverterDescription": "الصق أو اكتب نص طلب JSON. سيقوم المترجم بالكشف التلقائي عن التنسيق المصدر وتحويله إلى التنسيق الهدف. استخدم هذا لتصحيح كيفية ترجمة OmniRoute للطلبات بين التنسيقات (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "الإدخال", "output": "الإخراج", "auto": "تلقائي", @@ -3573,6 +4059,11 @@ "errorMessage": "خطأ: {message}", "requestFailed": "فشل الطلب", "noTextExtracted": "(لم يتم استخراج النص)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "يعرض أحداث الترجمة أثناء تدفق مكالمات API عبر OmniRoute. تأتي الأحداث من المخزن المؤقت في الذاكرة (يتم إعادة التعيين عند إعادة التشغيل). استخدم", "liveMonitorDescriptionSuffix": "أو مكالمات API الخارجية لإنشاء الأحداث." }, @@ -3648,14 +4139,25 @@ "passSuffix": "تمرير", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "تشغيل التقييم", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "جارٍ تشغيل {current}/{total}...", "passRate": "معدل النجاح", "summaryBreakdown": "تم اجتياز {passed} · فشل {failed} · {total} الإجمالي", "passedIconLabel": "✅ نجح", "failedIconLabel": "❌فشل", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "يحتوي على: \"{term}\"", "detailsRegex": "التعبير العادي: {pattern}", "detailsExpected": "المتوقع: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "لا توجد نتائج حتى الآن", "testCasesCount": "حالات الاختبار ({count})", "noTestCasesDefined": "لم يتم تحديد حالات الاختبار", @@ -3723,6 +4225,16 @@ "tierFree": "مجاني", "tierUnknown": "غير معروف", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "في انتظار تصريح مكافحة الجاذبية...", "waitingForQoderAuthorization": "في انتظار ترخيص Qoder...", "exchangingCodeForTokens": "استبدال الكود بالرموز...", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "التوثيق", "quickStart": "بداية سريعة", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "الميزات", "supportedProviders": "مقدمي الخدمات المدعومة", "supportedProvidersToc": "مقدمي الخدمات", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. قم بتعيين عنوان URL لقاعدة العميل", "quickStartStep4Prefix": "قم بتوجيه عميل IDE أو API الخاص بك إلى", "quickStartStep4Suffix": "استخدم بادئة الموفر، على سبيل المثال", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "التوجيه متعدد الموفرين", "featureRoutingText": "توجيه الطلبات إلى أكثر من 30 من موفري خدمات الذكاء الاصطناعي من خلال نقطة نهاية واحدة متوافقة مع OpenAI. يدعم واجهات برمجة التطبيقات للدردشة والاستجابات والصوت والصورة.", "featureCombosTitle": "المجموعات والموازنة", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "استخدم", "clientClaudeBullet1Middle": "(كلود) أو", "clientClaudeBullet1Suffix": "(مضاد الجاذبية) البادئة.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "البروتوكولات: MCP & A2A", "protocolsDescription": "تعرض OmniRoute بروتوكولين تشغيليين بالإضافة إلى واجهات برمجة التطبيقات المتوافقة مع OpenAI: MCP لتنفيذ الأداة و A2A لسير العمل من وكيل إلى وكيل.", "protocolMcpTitle": "MCP (بروتوكول السياق النموذجي)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "استخدم لوحة المعلومات > الموفرون > اختبار الاتصال قبل الاختبار من بيئات تطوير متكاملة أو عملاء خارجيين.", "troubleshootingCircuitBreaker": "إذا أظهر مقدم الخدمة أن قاطع الدائرة مفتوح، فانتظر حتى فترة التهدئة أو راجع صفحة الصحة للحصول على التفاصيل.", "troubleshootingOAuth": "بالنسبة لموفري OAuth، قم بإعادة المصادقة إذا انتهت صلاحية الرموز المميزة. تحقق من مؤشر حالة بطاقة المزود.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "سياسة الخصوصية", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "دردشة بسيطة", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "cacheRateDesc": "of total requests", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "lastUpdated": "Last updated", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCache": "Semantic Cache", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "busiestHour": "Busiest Hour", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "hoursTracked": "hours tracked", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "cacheRate": "Cache Rate", - "activityVolume": "Activity", - "peakCacheRate": "Peak Cache Rate", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "trendHour": "Hour", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } } diff --git a/src/i18n/messages/bg.json b/src/i18n/messages/bg.json index 615b046d2f..fb6dd2717f 100644 --- a/src/i18n/messages/bg.json +++ b/src/i18n/messages/bg.json @@ -23,6 +23,7 @@ "active": "Активен", "inactive": "Неактивен", "noData": "Няма налични данни", + "nothingHere": "Nothing here yet", "configure": "Конфигуриране", "manage": "Управлявайте", "name": "Име", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Неуспешно нулиране на цените", "apikey": "API ключ", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Площадка", "searchTools": "Search Tools", "agents": "Агенти", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Документи", "issues": "Проблеми", "endpoints": "Крайни точки", "apiManager": "API мениджър", "logs": "трупи", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Дневник за одит", "shutdown": "Изключване", "restart": "Рестартирайте", @@ -705,8 +710,6 @@ "cliToolsShort": "Инструменти", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Теми", "description": "Изберете предварително зададена тема или създайте своя собствена с един цвят", @@ -826,6 +926,10 @@ "evals": "Оценки", "utilization": "Използване", "utilizationDescription": "Тенденции в използването на квотата на доставчика и проследяване на ограниченията на скоростта", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Здраве на комбинацията", "comboHealthDescription": "Квота на ниво комбинация, разпределение на използването и метрики на производителността", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Последно: {date}", "editPermissions": "Разрешения за редактиране", "deleteKey": "Ключ за изтриване", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} модел", "models": "{count} модели", "permissionsTitle": "Разрешения: {name}", @@ -1188,11 +1296,13 @@ "continue": "Използвайте, когато изпълнявате Continue в IDE и имате нужда от преносима JSON-базирана конфигурация на доставчик.", "opencode": "Използвайте, когато предпочитате нативни за терминални агенти и скриптова автоматизация чрез OpenCode.", "kiro": "Използвайте, когато интегрирате Kiro и контролирате маршрутизирането на модела централно от OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Използвайте, когато трафикът на Antigravity/Kiro трябва да бъде прихванат чрез MITM и насочен към OmniRoute.", "copilot": "Използвайте, когато искате UX в стил на чат Copilot, като същевременно налагате OmniRoute ключове и правила за маршрутизиране.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE с MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Последователен резервен вариант: първо се опитва модел 1, след това 2 и т.н.", "weightedDesc": "Разпределя трафика по тегловни проценти с резервен вариант", "roundRobinDesc": "Кръгово разпределение: всяка заявка отива към следващия модел на ротация", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Единен случаен избор, след което се връща към останалите модели", "leastUsedDesc": "Избира модела с най-малко заявки, като балансира натоварването във времето", "costOptimizedDesc": "Първо маршрути към най-евтиния модел въз основа на ценообразуването", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Модели", @@ -1404,6 +1521,13 @@ "retryDelay": "Забавяне при повторен опит (ms)", "concurrencyPerModel": "Паралелност / Модел", "queueTimeout": "Време за изчакване на опашката (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Оставете празно, за да използвате глобалните настройки по подразбиране. Те заменят настройките за всеки доставчик.", "moveUp": "Придвижете се нагоре", "moveDown": "Придвижете се надолу", @@ -1447,6 +1571,11 @@ "avoid": "Ценовите данни липсват или са остарели.", "example": "Задачи на заден фон или партида, при които се предпочитат по - ниски разходи." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1454,13 +1583,33 @@ }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", "when": "Use when long sessions must survive account rotation without losing the working context.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round - robin е най - полезен с поне 2 модела.", "warningCostOptimizedPartialPricing": "Само {priced} от {total} моделите имат ценообразуване. Маршрутизирането може да бъде частично съобразено с разходите.", "warningCostOptimizedNoPricing": "Няма намерени данни за ценообразуване за тази комбинация. Оптимизираният по отношение на разходите маршрут може да е неочакван.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Готови ли сте да запазите?", "readinessDescription": "Прегледайте контролния списък, преди да създадете или актуализирате тази комбинация.", "readinessCheckName": "Комбо името е валидно", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", + "emailVisibilityStateOn": "On", "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" - }, "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" + }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" + }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" } }, - "builderPinnedAccount": "Pinned Account", - "weightTierPriority": "Tier", - "builderStageCurrent": "Current stage", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderAccount": "Account", - "builderAddStep": "Add step", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderModel": "Model", - "builderProvider": "Provider", - "builderStagePending": "Pending", - "filterAll": "All", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "candidatePoolAllProviders": "All providers", - "routerStrategyLabel": "Router Strategy", - "reviewProviders": "Providers", - "reviewAccounts": "Accounts", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "candidatePoolEmpty": "No active providers available yet.", - "builderSelectProvider": "Select provider", - "reviewStrategy": "Strategy", - "strategyRules": "Rules (6-Factor Scoring)", - "normalOperation": "Normal Operation", - "builderTitle": "Build a Combo", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewNoSteps": "No steps configured", - "reviewComboRefs": "Combo References", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderPreview": "Preview", - "reviewIntelligentTitle": "Intelligent Routing Config", - "reviewSteps": "Steps", - "weightTaskFit": "Task Fit", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "builderAddComboRef": "Add combo reference", - "activeModePack": "Active Mode Pack", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "statusOverview": "Status Overview", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reorderHandle": "Drag to reorder", - "modePackLabel": "Mode Pack", - "excludedProviders": "Excluded Providers", - "noExcludedProviders": "No providers are currently excluded.", - "budgetCapPlaceholder": "No limit", - "builderBrowseCatalog": "Browse catalog", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "failedReorder": "Failed to reorder models", - "providerScores": "Provider Scores", - "reviewAgentFlags": "Agent Flags", - "builderLoadingProviders": "Loading providers...", - "builderLegacyEntry": "Legacy entry", - "builderProviderFirst": "Pick provider first", - "reviewName": "Name", - "filterIntelligent": "Intelligent", - "weightLatencyInv": "Latency", - "contextRelaySummaryModel": "Summary Model", - "incidentMode": "Incident Mode", - "builderComboRef": "Combo Ref", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "weightHealth": "Health", - "emailVisibilityStateOn": "On", - "weightStability": "Stability", - "filterDeterministic": "Deterministic", - "explorationRateLabel": "Exploration Rate", - "reviewAdvanced": "Advanced Settings", - "contextRelayMaxMessages": "Max Messages For Summary", - "cooldownMinutes": "Cooldown: {minutes}m", - "reviewSequence": "Model Sequence", "builderStageVisited": "Stage completed", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelay": "Context Relay", - "builderFlowTitle": "Combo Builder Flow", - "weightCostInv": "Cost", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "candidatePoolLabel": "Candidate Pool", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", "builderStageLocked": "Locked — complete previous stage first", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", "builderSelectModel": "Select model", - "filterEmptyTitle": "No combos match this strategy filter.", - "weightQuota": "Quota", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", "builderComboRefStep": "Add combo reference", - "intelligentPanelTitle": "Intelligent Routing Dashboard" + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Разходи", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Бюджет", "totalCost": "Обща цена", "breakdown": "Разбивка на разходите", "noData": "Няма данни за разходите", "byModel": "По модел", "byProvider": "От Доставчик", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Крайна точка на API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Транскрибирайте аудио файлове в текст (Whisper)", "textToSpeech": "Преобразуване на текст в реч", "textToSpeechDesc": "Преобразувайте текст в естествено звучаща реч", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Модерации", "moderationsDesc": "Модериране на съдържанието и класификация за безопасност", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Проследяване и контрол на задачите с помощта на @@ PH0 @@ и @@ PH1 @@.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Здраве на системата", "description": "Мониторинг в реално време на вашето копие OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Ограничения и квоти", "rateLimit": "Лимит на скоростта", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Добре дошли", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Грешка ({code})", "errorCountNoCode": "{count} Грешка", "noConnections": "Никакви връзки", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Забранено", "enableProvider": "Активиране на доставчика", "disableProvider": "Деактивиране на доставчика", @@ -2296,7 +2701,6 @@ "errorOccurred": "Възникна грешка. Моля, опитайте отново.", "modelStatus": "Статус на модела", "showConfiguredOnly": "Configured only", - "searchProviders": "Търсете доставчици...", "allModelsOperational": "Всички модели работещи", "modelsWithIssues": "{count} модел(а) с проблеми", "allModelsNormal": "Всички модели реагират нормално.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Подробности за съвместимост с OpenAI", "messagesApi": "API за съобщения", "responsesApi": "API за отговори", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Чат завършвания", "importingModels": "Импортиране...", "importFromModels": "Импортиране от /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Всички модели вече са импортирани", "noNewModelsToImport": "Няма нови модели за импортиране — всички модели вече са в регистъра или списъка с персонализирани модели", "skippingExistingModels": "Пропускане на {count} съществуващи модела", @@ -2373,6 +2782,7 @@ "importFailed": "Неуспешно импортиране", "noNewModelsAdded": "Няма добавени нови модели.", "adding": "Добавяне...", + "close": "Close", "importingModelsTitle": "Импортиране на модели", "copyModel": "Копиране на модел", "filterModels": "Филтриране на модели…", @@ -2413,6 +2823,11 @@ "configured": "конфигуриран", "providerProxyConfigureHint": "Конфигурирайте прокси за всички връзки на този доставчик", "providerProxy": "Прокси доставчик", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Все още няма връзки", "addFirstConnectionHint": "Добавете първата си връзка, за да започнете", "addConnection": "Добавяне на връзка", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID на модела", "customModelPlaceholder": "напр. gpt-4.5-турбо", "loading": "Зареждане...", @@ -2513,6 +2931,10 @@ "email": "Имейл", "healthCheckMinutes": "Проверка на здравето (мин.)", "healthCheckHint": "Интервал за опресняване на проактивен токен. 0 = забранено.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Неуспешно тестване на връзката", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "noModelsMatch": "No models match \"{filter}\"", - "audioTranscriptions": "Audio Transcriptions", - "deselectAllModels": "Deselect all", - "audioSpeech": "Audio Speech", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "embeddings": "Embeddings", - "hideEmails": "Hide all emails", - "imagesGenerations": "Images Generations", - "repairEnvFailed": "Failed to repair .env", - "repairEnv": "Repair env", - "selectAllModels": "Select all", - "modelsActiveCount": "{active}/{total} active", - "repairEnvWorking": "Repairing...", "showEmails": "Show all emails", - "repairEnvSuccess": "OAuth defaults restored", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Търсете доставчици...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Настройки", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Ценообразуване", "storage": "Съхранение", "policies": "Политики", @@ -2749,6 +3164,46 @@ "enablePassword": "Активиране на парола", "darkMode": "Тъмен режим", "lightMode": "Светлинен режим", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "точно сега", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Доставчици", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Системна тема", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Кеш TTL", "maxCacheSize": "Макс. размер на кеша", "clearCache": "Изчистване на кеша", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Попадения в кеша", "cacheMisses": "Кеш пропуски", "hitRate": "Процент на попадения", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Активиране на мисленето", "maxThinkingTokens": "Макс жетони за мислене", "enableProxy": "Активиране на прокси", @@ -2818,6 +3277,14 @@ "themeLight": "светлина", "themeDark": "Тъмно", "themeSystem": "система", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Изискване на API ключ за /models", "requireAuthModelsDesc": "Когато е ВКЛЮЧЕНО, крайната точка /v1/models връща 404 за неупълномощени заявки. Предотвратява откриването на модел от неоторизирани потребители.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Блокирани доставчици", "blockedProvidersDesc": "Скриване на конкретни доставчици от отговора /v1/models. Блокираните доставчици няма да се показват в списъците с модели.", "providersBlocked": "{count} доставчик(и) е блокиран от /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Изберете най-малко използван акаунт", "costOpt": "Цена Опт", "costOptDesc": "Предпочитайте най-евтиния наличен акаунт", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Лепкава граница", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Комбо стратегия", "priority": "Приоритет", "weighted": "Претеглени", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Макс. повторни опити", "retryDelayLabel": "Забавяне при повторен опит (ms)", "timeoutLabel": "Изчакване (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Максимална дълбочина на влагане", "concurrencyPerModel": "Паралелност / Модел", "queueTimeout": "Време за изчакване на опашката (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Профили на доставчици", "providerProfilesDesc": "Отделни настройки за устойчивост за доставчици на OAuth (базиран на сесия) и API ключ (измерен). Доставчиците на OAuth имат по-строги прагове поради по-ниските лимити на скоростта.", "oauthProviders": "Доставчици на OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "Създаден резервен копие: {file}", "restoreSuccess": "Възстановен! {connections} връзки, {nodes} възли, {combos} комбинации, {apiKeys} API ключове.", "importSuccess": "Базата данни е импортирана! {connections} връзки, {nodes} възли, {combos} комбинации, {apiKeys} API ключове.", - "justNow": "точно сега", "minutesAgo": "преди {count}мин", "hoursAgo": "преди {count}ч", "daysAgo": "преди {count}d", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Възникна грешка при импортиране", "modelPricing": "Ценообразуване на модела", "modelPricingDesc": "Конфигуриране на разходни ставки за модел • Всички ставки в $/1 милион токени", - "providers": "Доставчици", "registry": "Регистър", "priced": "На цена", "searchProvidersModels": "Търсете доставчици или модели...", @@ -3170,47 +3651,6 @@ "editPricing": "Редактиране на цените", "viewFullDetails": "Вижте пълните подробности", "themeCoral": "Корал", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ГРЕШКА", "formatConverter": "Конвертор на формати", "formatConverterDescription": "Поставете или въведете JSON тяло на заявка. Преводачът автоматично ще открие изходния формат и ще го преобразува в целевия формат. Използвайте това за отстраняване на грешки как OmniRoute превежда заявки между формати (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Вход", "output": "Изход", "auto": "Авто", @@ -3573,6 +4059,11 @@ "errorMessage": "Грешка: {message}", "requestFailed": "Неуспешна заявка", "noTextExtracted": "(Не е извлечен текст)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Показва събития за превод, докато извикванията на API протичат през OmniRoute. Събитията идват от буфера в паметта (нулира се при рестартиране). Използвайте", "liveMonitorDescriptionSuffix": "или външни извиквания на API за генериране на събития." }, @@ -3648,14 +4139,25 @@ "passSuffix": "пас", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Стартирайте Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Изпълнява се {current}/{total}...", "passRate": "проходимост", "summaryBreakdown": "{passed} преминат · {failed} неуспешно · {total} общо", "passedIconLabel": "✅ Успешно", "failedIconLabel": "❌ Неуспешно", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Съдържа: \"{term}\"", "detailsRegex": "Регулярен израз: {pattern}", "detailsExpected": "Очаква се: „{expected}“", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Все още няма резултати", "testCasesCount": "Тестови случаи ({count})", "noTestCasesDefined": "Няма дефинирани тестови случаи", @@ -3723,6 +4225,16 @@ "tierFree": "безплатно", "tierUnknown": "неизвестен", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Изчаква се разрешение за антигравитация...", "waitingForQoderAuthorization": "Изчаква се разрешение за Qoder...", "exchangingCodeForTokens": "Размяна на код за токени...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Документация", "quickStart": "Бърз старт", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Характеристики", "supportedProviders": "Поддържани доставчици", "supportedProvidersToc": "Доставчици", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Задайте клиентски базов URL адрес", "quickStartStep4Prefix": "Насочете своя IDE или API клиент към", "quickStartStep4Suffix": "Използвайте например префикс на доставчика", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Маршрутизиране с множество доставчици", "featureRoutingText": "Насочвайте заявки към 30+ доставчици на AI чрез една крайна точка, съвместима с OpenAI. Поддържа API за чат, отговори, аудио и изображения.", "featureCombosTitle": "Комбинации и балансиране", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Използвайте", "clientClaudeBullet1Middle": "(Клод) или", "clientClaudeBullet1Suffix": "(Антигравитация) префикс.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Протоколи: MCP & A2A", "protocolsDescription": "OmniRoute излага два оперативни протокола в допълнение към съвместимите с OpenAI API: MCP за изпълнение на инструменти и A2A за работни процеси от агент към агент.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Използвайте Табло > Доставчици > Тестване на връзката, преди да тествате от IDE или външни клиенти.", "troubleshootingCircuitBreaker": "Ако доставчикът покаже отворен прекъсвач, изчакайте охлаждането или проверете страницата Health за подробности.", "troubleshootingOAuth": "За доставчици на OAuth, повторно удостоверяване, ако токените изтекат. Проверете индикатора за състояние на картата на доставчика.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Политика за поверителност", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Обикновен чат", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "trendHour": "Hour", - "busiestHour": "Busiest Hour", - "activityVolume": "Activity", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "hoursTracked": "hours tracked", - "cacheRate": "Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCache": "Semantic Cache", - "cacheRateDesc": "of total requests", - "lastUpdated": "Last updated", - "peakCacheRate": "Peak Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/bn.json b/src/i18n/messages/bn.json index f710c34764..fce2f806bd 100644 --- a/src/i18n/messages/bn.json +++ b/src/i18n/messages/bn.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/cs.json b/src/i18n/messages/cs.json index 7017c186e9..1de4cae2fd 100644 --- a/src/i18n/messages/cs.json +++ b/src/i18n/messages/cs.json @@ -23,6 +23,7 @@ "active": "Aktivní", "inactive": "Neaktivní", "noData": "Žádné údaje k dispozici", + "nothingHere": "Nothing here yet", "configure": "Konfigurovat", "manage": "Spravovat", "name": "Jméno", @@ -138,7 +139,6 @@ "apikey": "API klíč", "http": "HTTP", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Hřiště", "searchTools": "Vyhledávací nástroje", "agents": "Agenti", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Paměť", + "skills": "Dovednosti", "docs": "Dokumenty", "issues": "Problémy", "endpoints": "Koncové body", "apiManager": "Správce API", "logs": "Protokoly", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Protokolů", "shutdown": "Vypnout", "restart": "Restartovat", @@ -705,8 +710,6 @@ "cliToolsShort": "Nástroje", "cache": "Mezipaměť", "cacheShort": "Mezipaměť", - "memory": "Paměť", - "skills": "Dovednosti", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Motivy", "description": "Vyberte si přednastavený motiv nebo si vytvořte vlastní s jednou barvou", @@ -826,6 +926,10 @@ "evals": "Hodnocení", "utilization": "Využití", "utilizationDescription": "Trendy využití kvót poskytovatele a sledování limitů rychlosti", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Zdraví Combo", "comboHealthDescription": "Kvóta na úrovni kombinace, distribuce využití a metriky výkonu", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Poslední: {date}", "editPermissions": "Upravit oprávnění", "deleteKey": "Smazat klíč", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count, plural, one {# model} other {# modelů}}", "models": "{count} modelů", "permissionsTitle": "Oprávnění: {name}", @@ -1188,11 +1296,13 @@ "continue": "Použijte, pokud spouštíte Continue v IDE a potřebujete přenosnou nastavení poskytovatele založenou na JSON.", "opencode": "Použijte, pokud dáváte přednost spouštění agentů nativně v terminálu a skriptované automatizaci přes OpenCode.", "kiro": "Použijte při integraci Kiro a centrálním řízení směrování modelů z OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Použijte, pokud musí být provoz Antigravity/Kiro zachycen prostřednictvím MITM a směrován do OmniRoute.", "copilot": "Použijte, pokud chcete uživatelské rozhraní ve stylu Copilot chat a zároveň vynutit klíče a pravidla směrování OmniRoute.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE s MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekvenční záloha: nejprve se vyzkouší model 1, poté 2 atd.", "weightedDesc": "Distribuuje pro vyvážení se zálohou", "roundRobinDesc": "Kruhová distribuce: každý požadavek jde dalšímu modelu v rotaci", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Rovnoměrný náhodný výběr, poté návrat ke zbývajícím modelům", "leastUsedDesc": "Vybere model s nejmenším počtem požadavků a vyrovná zátěž v průběhu času.", "costOptimizedDesc": "Trasy k nejlevnějšímu modelu na základě ceny", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Přísná náhoda", "strictRandomDesc": "Zamíchejte balíček karet – každý model se před zamícháním jednou použije", "models": "Modely", @@ -1404,6 +1521,13 @@ "retryDelay": "Zpoždění opakování (ms)", "concurrencyPerModel": "Souběh / Model", "queueTimeout": "Časový limit fronty (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Pro použití globálních výchozích hodnot nechte pole prázdné. Tyto hodnoty přepíší nastavení pro jednotlivé poskytovatele.", "moveUp": "Posunout nahoru", "moveDown": "Přesunout dolů", @@ -1447,20 +1571,45 @@ "avoid": "Údaje o cenách chybí nebo jsou zastaralé.", "example": "Úlohy na pozadí nebo dávkové úlohy, kde se upřednostňují nižší náklady." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Použijte, když chcete rovnoměrné rozložení — každý model se použije jednou před opakováním.", "avoid": "Nepoužívejte, když mají modely různou kvalitu nebo latenci a záleží na pořadí.", "example": "Příklad: Více účtů stejného modelu pro rovnoměrné rozložení využití." }, - "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "when": "Use when long sessions must survive account rotation without losing the working context." - }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin je nejužitečnější s alespoň 2 modely.", "warningCostOptimizedPartialPricing": "Jen {priced} z {total} modelů má stanovenu cenu. Směrování může být částečně zohledněno s ohledem na cenu.", "warningCostOptimizedNoPricing": "Pro toto kombo nebyly nalezeny žádné cenové údaje. Optimalizace nákladů může vést k neočekávanému směrování.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Jste připraveni ušetřit?", "readinessDescription": "Před vytvořením nebo aktualizací tohoto komba si prostudujte kontrolní seznam.", "readinessCheckName": "Název komba je platný", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Použít doporučení", "recommendationsUpdated": "Doporučení pro {strategy} bylo aktualizováno.", "recommendationsApplied": "Doporučení aplikováno na toto kombo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Základní pojistka", @@ -1555,12 +1748,61 @@ "tip2": "Pro náročné výzvy si pořiďte kvalitní záložní řešení.", "tip3": "Používejte pro dávkové/úlohy na pozadí, kde jsou hlavním klíčovým ukazatelem výkonnosti náklady." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Rozložení typu zamíchaného balíčku", "description": "Každý model se použije právě jednou za cyklus před novým zamícháním.", "tip1": "Pro smysluplné rozložení použijte alespoň 2 modely.", "tip2": "Nejlépe funguje s modely podobného výkonu.", "tip3": "Ideální pro vyvažování zátěže mezi více API účty." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Volný zásobník (0 $)", @@ -1581,38 +1823,24 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "weightHealth": "Health", - "candidatePoolEmpty": "No active providers available yet.", - "builderStageLocked": "Locked — complete previous stage first", - "reorderHandle": "Drag to reorder", - "excludedProviders": "Excluded Providers", - "reviewProviders": "Providers", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "reviewSequence": "Model Sequence", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "candidatePoolAllProviders": "All providers", - "weightQuota": "Quota", - "reviewNoSteps": "No steps configured", - "modePackLabel": "Mode Pack", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "reviewAdvanced": "Advanced Settings", - "contextRelayHandoffThreshold": "Handoff Threshold", "emailVisibilityStateOn": "On", - "reviewName": "Name", - "routerStrategyLabel": "Router Strategy", - "weightStability": "Stability", - "normalOperation": "Normal Operation", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", "builderFlowTitle": "Combo Builder Flow", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", "builderStage": { - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" @@ -1620,86 +1848,86 @@ "review": { "label": "Review", "description": "Final validation before saving" - }, - "basics": { - "description": "Name and starting template", - "label": "Basics" } }, - "builderStageCurrent": "Current stage", - "reviewComboRefs": "Combo References", - "failedReorder": "Failed to reorder models", - "builderComboRef": "Combo Ref", - "builderPinnedAccount": "Pinned Account", - "reviewAgentFlags": "Agent Flags", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderSelectModel": "Select model", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderAddStep": "Add step", - "builderAccount": "Account", - "builderAddComboRef": "Add combo reference", - "builderLoadingProviders": "Loading providers...", - "cooldownMinutes": "Cooldown: {minutes}m", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "modePackUpdated": "Mode pack updated to {pack}.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "reviewSteps": "Steps", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "weightLatencyInv": "Latency", - "filterDeterministic": "Deterministic", - "builderSelectProvider": "Select provider", "builderStageVisited": "Stage completed", - "builderTitle": "Build a Combo", - "emailVisibilityStateOff": "Off", - "contextRelaySummaryModel": "Summary Model", - "incidentMode": "Incident Mode", - "candidatePoolLabel": "Candidate Pool", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "builderPreview": "Preview", - "contextRelayMaxMessages": "Max Messages For Summary", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "providerScores": "Provider Scores", - "statusOverview": "Status Overview", - "budgetCapPlaceholder": "No limit", - "reviewIntelligentTitle": "Intelligent Routing Config", - "strategyRules": "Rules (6-Factor Scoring)", - "weightTierPriority": "Tier", - "builderBrowseCatalog": "Browse catalog", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", - "weightCostInv": "Cost", - "builderModel": "Model", - "builderComboRefStep": "Add combo reference", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "filterIntelligent": "Intelligent", - "explorationRateLabel": "Exploration Rate", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelay": "Context Relay", - "reviewAccounts": "Accounts", - "noExcludedProviders": "No providers are currently excluded.", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "filterEmptyTitle": "No combos match this strategy filter.", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", "builderLegacyEntry": "Legacy entry", - "weightTaskFit": "Task Fit", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "filterAll": "All", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "activeModePack": "Active Mode Pack", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "budgetCapLabel": "Budget Cap (USD / request)", - "reviewStrategy": "Strategy" + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Náklady", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Rozpočet", "totalCost": "Celkové náklady", "breakdown": "Rozložení nákladů", "noData": "Bez údajů o nákladech", "byModel": "Podle modelu", "byProvider": "Podle poskytovatele", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Koncový bod", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Přepis zvukových souborů na text (Whisper)", "textToSpeech": "Převod textu na řeč", "textToSpeechDesc": "Převod textu na přirozenou řeč", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderování", "moderationsDesc": "Moderování obsahu a bezpečnostní klasifikace", "responsesDesc": "OpenAI Responses API pro Codex a pokročilé pracovní postupy s agenty", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Sledujte a ovládejte úkoly pomocí příkazů `tasks/get` a `tasks/cancel`.", "completionsLegacy": "Completions (Zastaralé)", "completionsLegacyDesc": "Zastaralé OpenAI text completion – akceptuje oba formáty, prompt string i messages array.", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Koncová Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Správa paměti", + "description": "Zobrazení a správa uložených položek paměti", + "memories": "Vzpomínky", + "totalEntries": "Celkem položek", + "tokensUsed": "Použité tokeny", + "hitRate": "Míra zásahů", + "loading": "Načítám vzpomínky...", + "noMemories": "Nebyly nalezeny žádné vzpomínky", + "search": "Hledat vzpomínky...", + "allTypes": "Všechny typy", + "export": "Exportovat", + "import": "Importovat", + "addMemory": "Přidat vzpomínku", + "type": "Typ", + "key": "Klíč", + "content": "Obsah", + "created": "Vytvořeno", + "actions": "Akce", + "delete": "Delete", + "factual": "Faktická", + "episodic": "Epizodická", + "procedural": "Procedurální", + "semantic": "Sémantická", + "a": "A" + }, + "skills": { + "title": "Dovednosti", + "description": "Správa a sledování AI dovedností", + "skillsTab": "Dovednosti", + "executionsTab": "Spuštění", + "sandboxTab": "Sandbox", + "loading": "Načítám dovednosti...", + "noSkills": "Nebyly nalezeny žádné dovednosti", + "noExecutions": "Nebyla nalezena žádná spuštění", + "enabled": "Povoleno", + "disabled": "Zakázáno", + "version": "Verze", + "tableDescription": "Popis", + "skill": "Dovednost", + "status": "Stav", + "duration": "Trvání", + "time": "Čas", + "sandboxConfig": "Konfigurace sandboxu", + "cpuLimit": "Limit CPU", + "cpuLimitDesc": "Maximální doba spuštění na dovednost", + "memoryLimit": "Limit paměti", + "memoryLimitDesc": "Maximální přidělení paměti", + "timeout": "Časový limit", + "timeoutDesc": "Maximální doba čekání na odpověď", + "networkAccess": "Síťový přístup", + "networkAccessDesc": "Povolit odchozí síťové požadavky", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Stav systému", "description": "Monitorování vaší instance OmniRoute v reálném čase", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limity a kvóty", "rateLimit": "Limit rychlosti", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Vítejte", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Chyb ({code})", "errorCountNoCode": "{count} Chyb", "noConnections": "Nespojeno", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Zakázáno", "enableProvider": "Povolit poskytovatele", "disableProvider": "Zakázat poskytovatele", @@ -2296,7 +2701,6 @@ "errorOccurred": "Došlo k chybě. Zkuste to prosím znovu.", "modelStatus": "Status modelu", "showConfiguredOnly": "Configured only", - "searchProviders": "Hledat poskytovatele...", "allModelsOperational": "Všechny modely funkční", "modelsWithIssues": "{count} model(y) s problémy", "allModelsNormal": "Všechny modely reagují normálně.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Podrobnosti o kompatibilitě s OpenAI", "messagesApi": "Messages API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chat Completions", "importingModels": "Importuji...", "importFromModels": "Import z /models", + "modelsImported": "{count} modelů importováno", "allModelsAlreadyImported": "Všechny modely jsou již importovány", "noNewModelsToImport": "Žádné nové modely k importu — všechny modely jsou již v registru nebo v seznamu vlastních modelů", "skippingExistingModels": "Přeskakování {count} existujících modelů", @@ -2373,6 +2782,7 @@ "importFailed": "Import selhal", "noNewModelsAdded": "Nebyly přidány žádné nové modely.", "adding": "Přidávám...", + "close": "Zavřít", "importingModelsTitle": "Import modelů", "copyModel": "Kopírovat model", "filterModels": "Filtrovat modely…", @@ -2413,6 +2823,11 @@ "configured": "nastaveno", "providerProxyConfigureHint": "Nastavit proxy pro všechna připojení tohoto poskytovatele", "providerProxy": "Proxy poskytovatele", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Zatím bez spojení", "addFirstConnectionHint": "Pro začátek přidejte své první připojení", "addConnection": "Přidat připojení", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Přidat hlavičku", "compatUpstreamRemoveRow": "Odebrat řádek", "compatBadgeUpstreamHeaders": "Hlavičky", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID modelu", "customModelPlaceholder": "např. gpt-4.5-turbo", "loading": "Načítám...", @@ -2513,6 +2931,10 @@ "email": "Email", "healthCheckMinutes": "Kontrola stavu (min)", "healthCheckHint": "Proaktivní interval obnovy tokenu. 0 = zakázáno.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Prostředí", "groupPlaceholder": "např. eKaizen, Osobní", "failedTestConnection": "Test připojení selhal", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Cesta koncového bodu modelu", "modelsPathPlaceholder": "/models", "modelsPathHint": "Cesta k vlastním modelům pro validaci (např. /v4/models)", - "modelsImported": "{count} modelů importováno", - "close": "Zavřít", "statusDeactivated": "Deaktivováno (Manuální)", "statusBanned": "Zablokováno / Porušení sandboxu", "statusCreditsExhausted": "Nedostatečný zůstatek / Kvóta vyčerpána", - "hideEmails": "Hide all emails", - "repairEnv": "Repair env", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", - "audioSpeech": "Audio Speech", - "embeddings": "Embeddings", - "selectAllModels": "Select all", - "deselectAllModels": "Deselect all", - "repairEnvSuccess": "OAuth defaults restored", - "imagesGenerations": "Images Generations", - "audioTranscriptions": "Audio Transcriptions", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvFailed": "Failed to repair .env", - "repairEnvWorking": "Repairing...", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Hledat poskytovatele...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Nastavení", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Ceny", "storage": "Skladování", "policies": "Zásady", @@ -2749,6 +3164,46 @@ "enablePassword": "Povolit heslo", "darkMode": "Tmavý režim", "lightMode": "Světelný režim", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "právě teď", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Poskytovatelé", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Systémové motiv", "debugToggle": "Povolit režim ladění", "sidebarVisibilityToggle": "Zobrazit položky postranního panelu", @@ -2756,6 +3211,8 @@ "cacheTTL": "TTL mezipamět", "maxCacheSize": "Maximální velikost mezipaměti", "clearCache": "Vyčistit mezipaměť", + "cacheCleared": "Mezipaměť úspěšně vymazána", + "clearCacheFailed": "Nepodařilo se vymazat mezipaměť", "cacheHits": "Nalezeno v mezipaměti", "cacheMisses": "Nenalezeno v mezipaměti", "hitRate": "Míra nalezení", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Trvale označí připojení poskytovatele jako deaktivovaná, pokud vrátí specifické signály zablokování (např. HTTP 403 'verify your account'). Tím je odstraní z rotace komb.", "autoDisableThreshold": "Prahová hodnota zablokování", "autoDisableThresholdDesc": "Počet po sobě jdoucích signálů zablokování před trvalou deaktivací.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Umožněte Thinking", "maxThinkingTokens": "Max Thinking Tokenů", "enableProxy": "Povolit Proxy", @@ -2818,6 +3277,14 @@ "themeLight": "Světlý", "themeDark": "Tmavý", "themeSystem": "Systém", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Skrýt položky postranního panelu", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "Ochrana API koncových bodů", "requireAuthModels": "Vyžadovat API klíč pro /models", "requireAuthModelsDesc": "Pokud je tato možnost zapnuta, koncový bod /v1/models vrátí pro neověřené požadavky chybu 404. Zabraňuje objevení modelů neoprávněným.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blokovaní Poskytovatelé", "blockedProvidersDesc": "Skrýt konkrétní poskytovatele z /v1/models odpovědi. Blokovaní poskytovatelé se nezobrazí v seznamu modelů.", "providersBlocked": "{count} poskytovatel(ů) zablokovano z /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Vybrat nejméně používaný účet", "costOpt": "Optimalizace nákladů", "costOptDesc": "Preferuje nejlevnější dostupný účet", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Přísná náhoda", "strictRandomDesc": "Zamíchá balíček karet – každý účet se použije jednou před zamícháním", "stickyLimit": "Lepkavý Limit", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Kombinovaná strategie", "priority": "Přednost", "weighted": "Vyváženo", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max opakování", "retryDelayLabel": "Zpoždění opakování (ms)", "timeoutLabel": "Časový limit (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maximální hloubka vnoření", "concurrencyPerModel": "Souběžnost / Model", "queueTimeout": "Časový limit fronty (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profily poskytovatelů", "providerProfilesDesc": "Samostatné nastavení odolnosti pro OAuth poskytovatele (založeno na relacích) a API klíče (měřené) poskytovatele. OAuth poskytovatelé mají přísnější prahové hodnoty kvůli nižším limitům rychlosti.", "oauthProviders": "OAuth Poskytovatelé", @@ -3113,7 +3596,6 @@ "backupCreated": "Záloha vytvořena: {file}", "restoreSuccess": "Obnoveno! {connections} připojení, {nodes} uzlů, {combos} komb, {apiKeys} API klíčů.", "importSuccess": "Databáze importována! {connections} připojení, {nodes} uzlů, {combos} komb, {apiKeys} API klíčů.", - "justNow": "právě teď", "minutesAgo": "před {count} min", "hoursAgo": "před {count}h", "daysAgo": "před {count} dny", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Během importu došlo k chybě", "modelPricing": "Ceny modelů", "modelPricingDesc": "Nastavení cenových sazeb pro každý model • Všechny sazby jsou v $/1 milion tokenů", - "providers": "Poskytovatelé", "registry": "Registr", "priced": "Cena", "searchProvidersModels": "Hledat poskytovatele nebo modely...", @@ -3170,47 +3651,6 @@ "editPricing": "Upravit ceny", "viewFullDetails": "Zobrazit všechny podrobnosti", "themeCoral": "Korál", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Dny", - "cacheCleared": "Mezipaměť úspěšně vymazána", - "clearCacheFailed": "Nepodařilo se vymazat mezipaměť", "adaptiveVolumeRouting": "Adaptivní objemové směrování", "adaptiveVolumeRoutingDesc": "Dynamické škálování připojení na základě objemu dat a propustnosti.", "lkgpToggleTitle": "Poslední známý dobrý poskytovatel (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Vymazat mezipaměť LKGP", "lkgpCacheCleared": "Mezipaměť LKGP úspěšně vymazána", "lkgpCacheClearFailed": "Nepodařilo se vymazat mezipaměť LKGP", + "days": "Dny", "lkgp": "Režim LKGP", "lkgpDesc": "Poslední známý dobrý poskytovatel (Predikovatelná odolnost)", "maintenance": "Údržba", "purgeExpiredLogs": "Vymazat expirované protokoly", "purgeLogsFailed": "Nepodařilo se vymazat protokoly", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "CHYBA", "formatConverter": "Převodník formátů", "formatConverterDescription": "Vložte nebo zadejte tělo JSON požadavku. Překladač automaticky rozpozná zdrojový formát a převede jej do cílového formátu. Použijte k ladění způsobu, jakým OmniRoute překládá požadavky mezi formáty (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Vstup", "output": "Výstup", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Chyba: {message}", "requestFailed": "Žádost se nezdařila", "noTextExtracted": "(Žádný text nebyl extrahován)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Zobrazuje události překladu, jak API volání probíhají přes OmniRoute. Události pocházejí z vyrovnávací paměti (resetují se při restartu). Použití", "liveMonitorDescriptionSuffix": "nebo externí volání API pro generování událostí." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# pád} other {# pádů}}", "runEval": "Spustit hodnocení", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Běží {current}/{total}...", "passRate": "míra úspěšnosti", "summaryBreakdown": "{passed} prošlo · {failed} selhalo · {total} celkem", "passedIconLabel": "✅ Prošel", "failedIconLabel": "❌ Selhal", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Obsahuje: \"{termín}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Očekáváno: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Zatím žádné výsledky", "testCasesCount": "Testovací případy ({count})", "noTestCasesDefined": "Žádné testovací případy nejsou definovány", @@ -3723,6 +4225,16 @@ "tierFree": "Zdarma", "tierUnknown": "Neznámý", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Čekám na Antigravity autorizaci...", "waitingForQoderAuthorization": "Čekám na Qoder autorizaci...", "exchangingCodeForTokens": "Vyměňuji kód za tokeny...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentace", "quickStart": "Rychlý start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funkce", "supportedProviders": "Podporovaní poskytovatelé", "supportedProvidersToc": "Poskytovatelé", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Nastavení adresy URL klientské základny", "quickStartStep4Prefix": "Nasměrujte své IDE nebo API klienta na", "quickStartStep4Suffix": "Použijte například prefix poskytovatele", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Směrování s více poskytovateli", "featureRoutingText": "Směrujte požadavky k více než 30 AI poskytovatelům prostřednictvím jediného koncového bodu kompatibilního s OpenAI. Podporuje chat, responses, audio i obrazová API.", "featureCombosTitle": "Kombinace a vyvažování", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Použít", "clientClaudeBullet1Middle": "(Claude) nebo", "clientClaudeBullet1Suffix": "(Antigravity) předponu.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protokoly: MCP a A2A", "protocolsDescription": "OmniRoute nabízí kromě API kompatibilních s OpenAI dva operační protokoly: MCP pro spouštění nástrojů a A2A pro pracovní postupy mezi agenty.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Před testováním z IDE nebo externích klientů použijte Nstěnka > Poskytovatelé > Test Připojení.", "troubleshootingCircuitBreaker": "Pokud poskytovatel zobrazuje vypnutý jistič, počkejte na ochlazení nebo si pro podrobnosti prohlédněte stránku Stav.", "troubleshootingOAuth": "U poskytovatelů OAuth proveďte opětovné ověření, pokud platnost tokenů vyprší. Zkontrolujte indikátor stavu karty poskytovatele.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Zásady ochrany osobních údajů", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Jednoduchý chat", @@ -4337,8 +4990,14 @@ "unavailable": "Mezipaměť nedostupná", "unavailableDesc": "Nepodařilo se načíst statistiky mezipaměti. Ujistěte se, že server běží.", "promptCache": "Prompt mezipaměť (na straně poskytovatele)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Uložené požadavky", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Míra úspěšnosti mezipaměti", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Tokeny v mezipaměti", "cacheCreationTokens": "Tokeny vytvoření mezipaměti", "cacheMetrics": "Metriky mezipaměti promptů", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Poměr opětovného použití", "cacheReuseRatioDesc": "Tokeny v mezipaměti / Celkem vstupních tokenů", "estCostSaved": "Odhadovaná úspora nákladů", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "pož.", "inputShort": "Vstup", "cachedShort": "V mezipaměti", @@ -4355,198 +5020,283 @@ "resetting": "Resetuji...", "resetMetrics": "Resetovat metriky", "byProvider": "Rozpis podle poskytovatele", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Požadavky", "inputTokens": "Vstupní tokeny", "cachedTokensCol": "V mezipaměti", "cacheCreation": "Vytvoření", "trend24h": "Trend mezipaměti (24 h)", + "peakCached": "Vrchol mezipaměti", "cached": "V mezipaměti", "overview": "Přehled", "entries": "Položky", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Hledat položky...", "search": "Hledat", "loading": "Načítám...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "Nebyly nalezeny žádné položky mezipaměti", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signatura", "model": "Model", "created": "Vytvořeno", "expires": "Vyprší", "actions": "Akce", - "peakCached": "Vrchol mezipaměti", "deduplicatedRequests": "Deduplikované požadavky", "savedCalls": "Uložená API volání", "totalProcessed": "Celkem zpracováno", - "cachedRequests24h": "Cached Requests (24h)", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "lastUpdated": "Last updated", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "cacheRateDesc": "of total requests", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cacheRate": "Cache Rate", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "busiestHour": "Busiest Hour", - "trendHour": "Hour", - "peakCacheRate": "Peak Cache Rate", - "hoursTracked": "hours tracked", - "semanticCache": "Semantic Cache", - "entriesLoadError": "Failed to load semantic cache entries.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "activityVolume": "Activity", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Správa paměti", - "description": "Zobrazení a správa uložených položek paměti", - "memories": "Vzpomínky", - "totalEntries": "Celkem položek", - "tokensUsed": "Použité tokeny", - "hitRate": "Míra zásahů", - "loading": "Načítám vzpomínky...", - "noMemories": "Nebyly nalezeny žádné vzpomínky", - "search": "Hledat vzpomínky...", - "allTypes": "Všechny typy", - "export": "Exportovat", - "import": "Importovat", - "addMemory": "Přidat vzpomínku", - "type": "Typ", - "key": "Klíč", - "content": "Obsah", - "created": "Vytvořeno", - "actions": "Akce", - "factual": "Faktická", - "episodic": "Epizodická", - "procedural": "Procedurální", - "semantic": "Sémantická", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Dovednosti", - "description": "Správa a sledování AI dovedností", - "skillsTab": "Dovednosti", - "executionsTab": "Spuštění", - "sandboxTab": "Sandbox", - "loading": "Načítám dovednosti...", - "noSkills": "Nebyly nalezeny žádné dovednosti", - "noExecutions": "Nebyla nalezena žádná spuštění", - "enabled": "Povoleno", - "disabled": "Zakázáno", - "version": "Verze", - "tableDescription": "Popis", - "skill": "Dovednost", - "status": "Stav", - "duration": "Trvání", - "time": "Čas", - "sandboxConfig": "Konfigurace sandboxu", - "cpuLimit": "Limit CPU", - "cpuLimitDesc": "Maximální doba spuštění na dovednost", - "memoryLimit": "Limit paměti", - "memoryLimitDesc": "Maximální přidělení paměti", - "timeout": "Časový limit", - "timeoutDesc": "Maximální doba čekání na odpověď", - "networkAccess": "Síťový přístup", - "networkAccessDesc": "Povolit odchozí síťové požadavky", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/da.json b/src/i18n/messages/da.json index 5336c71495..618f341594 100644 --- a/src/i18n/messages/da.json +++ b/src/i18n/messages/da.json @@ -23,6 +23,7 @@ "active": "Aktiv", "inactive": "Inaktiv", "noData": "Ingen tilgængelige data", + "nothingHere": "Nothing here yet", "configure": "Konfigurer", "manage": "Administrer", "name": "Navn", @@ -139,7 +140,6 @@ "http": "HTTP", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Legeplads", "searchTools": "Search Tools", "agents": "Agenter", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumenter", "issues": "Problemer", "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Revisionslog", "shutdown": "Nedlukning", "restart": "Genstart", @@ -705,8 +710,6 @@ "cliToolsShort": "Værktøjer", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Temaer", "description": "Vælg et forudindstillet tema, eller opret dit eget med en enkelt farve", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Udnyttelse", "utilizationDescription": "Leverandørkvoteforbrugstendenser og hastighedsgrænseovervågning", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kombosundhed", "comboHealthDescription": "Komboniveaudkvote, fordeling af brug og ydeevnemålinger", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Sidste: {date}", "editPermissions": "Rediger tilladelser", "deleteKey": "Slet nøgle", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} modeller", "permissionsTitle": "Tilladelser: {name}", @@ -1188,11 +1296,13 @@ "continue": "Brug, når du kører Continue i IDE'er, og du har brug for bærbar JSON-baseret udbyderkonfiguration.", "opencode": "Brug, når du foretrækker terminal-native agentkørsler og scriptet automatisering via OpenCode.", "kiro": "Bruges ved integration af Kiro og styring af modelrouting centralt fra OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Bruges, når Antigravity/Kiro-trafik skal opsnappes gennem MITM og dirigeres til OmniRoute.", "copilot": "Brug, når du ønsker Copilot-chatstil UX, mens du håndhæver OmniRoute-nøgler og routingregler.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE med MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekventiel fallback: prøver model 1 først, derefter 2 osv.", "weightedDesc": "Fordeler trafik efter vægtprocent med fallback", "roundRobinDesc": "Cirkulær fordeling: hver anmodning går til den næste model i rotation", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Ensartet tilfældig udvælgelse, derefter tilbagevenden til de resterende modeller", "leastUsedDesc": "Vælger modellen med færrest anmodninger, balancerer belastningen over tid", "costOptimizedDesc": "Ruter til den billigste model først baseret på priser", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modeller", @@ -1404,6 +1521,13 @@ "retryDelay": "Forsinkelse af forsøg igen (ms)", "concurrencyPerModel": "Samtidighed / Model", "queueTimeout": "Timeout for kø (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Lad være tom for at bruge globale standardindstillinger. Disse tilsidesætter indstillinger for hver udbyder.", "moveUp": "Flyt op", "moveDown": "Flyt ned", @@ -1447,20 +1571,45 @@ "avoid": "Prissætningsdata mangler eller er forældede.", "example": "Baggrunds- eller batchjob, hvor lavere omkostninger foretrækkes." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", "when": "Use when long sessions must survive account rotation without losing the working context.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin er mest nyttig med mindst 2 modeller.", "warningCostOptimizedPartialPricing": "Kun {priced} af {total}-modeller har priser. Routing kan være delvist omkostningsbevidst.", "warningCostOptimizedNoPricing": "Der blev ikke fundet nogen prisdata for denne kombination. Omkostningsoptimeret kan rute uventet.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Klar til at spare?", "readinessDescription": "Gennemgå tjeklisten, før du opretter eller opdaterer denne kombination.", "readinessCheckName": "Kombinationsnavnet er gyldigt", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderProviderFirst": "Pick provider first", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "modePackUpdated": "Mode pack updated to {pack}.", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { + "basics": { + "label": "Basics", + "description": "Name and starting template" + }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" }, - "review": { - "description": "Final validation before saving", - "label": "Review" - }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "explorationRateLabel": "Exploration Rate", - "budgetCapLabel": "Budget Cap (USD / request)", - "reorderHandle": "Drag to reorder", - "builderPreview": "Preview", - "reviewName": "Name", - "weightStability": "Stability", "builderStageVisited": "Stage completed", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "routerStrategyLabel": "Router Strategy", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "filterIntelligent": "Intelligent", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "providerScores": "Provider Scores", - "modePackLabel": "Mode Pack", - "builderAddStep": "Add step", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "reviewNoSteps": "No steps configured", "builderLoadingProviders": "Loading providers...", "builderSelectProvider": "Select provider", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "reviewAccounts": "Accounts", - "failedReorder": "Failed to reorder models", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderStagePending": "Pending", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", "builderPinnedAccount": "Pinned Account", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "normalOperation": "Normal Operation", - "filterEmptyTitle": "No combos match this strategy filter.", - "excludedProviders": "Excluded Providers", - "contextRelaySummaryModel": "Summary Model", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", "reviewComboRefs": "Combo References", "reviewAdvanced": "Advanced Settings", - "builderModel": "Model", - "candidatePoolEmpty": "No active providers available yet.", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "builderLegacyEntry": "Legacy entry", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "incidentMode": "Incident Mode", - "reviewProviders": "Providers", - "budgetCapPlaceholder": "No limit", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "filterDeterministic": "Deterministic", - "weightTierPriority": "Tier", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "emailVisibilityStateOn": "On", - "reviewSequence": "Model Sequence", - "strategyRules": "Rules (6-Factor Scoring)", - "builderComboRefStep": "Add combo reference", - "builderBrowseCatalog": "Browse catalog", - "builderComboRef": "Combo Ref", - "builderAccount": "Account", - "builderStageLocked": "Locked — complete previous stage first", - "contextRelayHandoffThreshold": "Handoff Threshold", - "candidatePoolAllProviders": "All providers", - "reviewSteps": "Steps", - "candidatePoolLabel": "Candidate Pool", - "contextRelay": "Context Relay", - "filterAll": "All", - "builderAddComboRef": "Add combo reference", - "weightLatencyInv": "Latency", - "emailVisibilityStateOff": "Off", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "weightCostInv": "Cost", - "weightTaskFit": "Task Fit", - "reviewStrategy": "Strategy", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "cooldownMinutes": "Cooldown: {minutes}m", - "statusOverview": "Status Overview", - "builderTitle": "Build a Combo", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "reviewIntelligentTitle": "Intelligent Routing Config", - "activeModePack": "Active Mode Pack", - "builderSelectModel": "Select model", - "weightHealth": "Health", - "weightQuota": "Quota", "reviewAgentFlags": "Agent Flags", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "noExcludedProviders": "No providers are currently excluded.", - "builderStageCurrent": "Current stage", - "builderFlowTitle": "Combo Builder Flow", - "contextRelayMaxMessages": "Max Messages For Summary" + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Omkostninger", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budget", "totalCost": "Samlede omkostninger", "breakdown": "Omkostningsfordeling", "noData": "Ingen omkostningsdata", "byModel": "Efter model", "byProvider": "Af udbyder", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-endepunkt", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transskriber lydfiler til tekst (Whisper)", "textToSpeech": "Tekst til tale", "textToSpeechDesc": "Konverter tekst til naturligt klingende tale", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderationer", "moderationsDesc": "Indholdsmoderering og sikkerhedsklassificering", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Spor og kontroller opgaver ved hjælp af `tasks/get` og `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Systemsundhed", "description": "Realtidsovervågning af din OmniRoute-instans", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Grænser og kvoter", "rateLimit": "Satsgrænse", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Velkommen", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Fejl ({code})", "errorCountNoCode": "{count} Fejl", "noConnections": "Ingen forbindelser", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Deaktiveret", "enableProvider": "Aktiver udbyder", "disableProvider": "Deaktiver udbyder", @@ -2296,7 +2701,6 @@ "errorOccurred": "Der opstod en fejl. Prøv venligst igen.", "modelStatus": "Modelstatus", "showConfiguredOnly": "Configured only", - "searchProviders": "Søg efter udbydere...", "allModelsOperational": "Alle modeller i drift", "modelsWithIssues": "{count} model(er) med problemer", "allModelsNormal": "Alle modeller reagerer normalt.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-kompatible detaljer", "messagesApi": "Beskeder API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chatafslutninger", "importingModels": "Importerer...", "importFromModels": "Importer fra /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Alle modeller er allerede importeret", "noNewModelsToImport": "Ingen nye modeller at importere — alle modeller findes allerede i registreret eller brugerdefineret liste", "skippingExistingModels": "Springer {count} eksisterende modeller over", @@ -2373,6 +2782,7 @@ "importFailed": "Import mislykkedes", "noNewModelsAdded": "Der blev ikke tilføjet nye modeller.", "adding": "Tilføjer...", + "close": "Close", "importingModelsTitle": "Import af modeller", "copyModel": "Kopi model", "filterModels": "Filtrer modeller…", @@ -2413,6 +2823,11 @@ "configured": "konfigureret", "providerProxyConfigureHint": "Konfigurer proxy for alle forbindelser fra denne udbyder", "providerProxy": "Udbyder proxy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Ingen forbindelser endnu", "addFirstConnectionHint": "Tilføj din første forbindelse for at komme i gang", "addConnection": "Tilføj forbindelse", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Model ID", "customModelPlaceholder": "f.eks. gpt-4.5-turbo", "loading": "Indlæser...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "Sundhedstjek (min)", "healthCheckHint": "Proaktivt token-opdateringsinterval. 0 = deaktiveret.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Forbindelsen kunne ikke testes", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnvWorking": "Repairing...", - "repairEnvSuccess": "OAuth defaults restored", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", "showEmails": "Show all emails", - "audioSpeech": "Audio Speech", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", - "audioTranscriptions": "Audio Transcriptions", - "deselectAllModels": "Deselect all", - "imagesGenerations": "Images Generations", - "embeddings": "Embeddings", "hideEmails": "Hide all emails", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnv": "Repair env", - "selectAllModels": "Select all", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Søg efter udbydere...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Indstillinger", @@ -2723,6 +3137,23 @@ "systemPrompt": "Systemprompt", "thinkingBudget": "Tænke budget", "proxy": "Fuldmagt", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prissætning", "storage": "Opbevaring", "policies": "Politikker", @@ -2733,6 +3164,46 @@ "enablePassword": "Aktiver adgangskode", "darkMode": "Mørk tilstand", "lightMode": "Lys tilstand", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "lige nu", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Udbydere", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "System tema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Max cachestørrelse", "clearCache": "Ryd cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache hits", "cacheMisses": "Cache misses", "hitRate": "Hitrate", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Aktiver tænkning", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Aktiver proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Lys", "themeDark": "Mørk", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "API-endepunktsbeskyttelse", "requireAuthModels": "Kræv API-nøgle til /models", "requireAuthModelsDesc": "Når ON, returnerer /v1/models-slutpunktet 404 for ikke-godkendte anmodninger. Forhindrer modelopdagelse af uautoriserede brugere.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blokerede udbydere", "blockedProvidersDesc": "Skjul specifikke udbydere fra /v1/models-svaret. Blokerede udbydere vises ikke i modellister.", "providersBlocked": "{count} udbyder(e) blokeret fra /modeller", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Vælg den mindst brugte konto", "costOpt": "Omkostningsopt", "costOptDesc": "Foretrækker den billigste tilgængelige konto", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Kombinationsstrategi", "priority": "Prioritet", "weighted": "Vægtet", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max forsøger igen", "retryDelayLabel": "Forsinkelse af forsøg igen (ms)", "timeoutLabel": "Timeout (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Maks. rededybde", "concurrencyPerModel": "Samtidighed / Model", "queueTimeout": "Timeout for kø (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Udbyder profiler", "providerProfilesDesc": "Separate indstillinger for modstandsdygtighed for OAuth (session-baserede) og API Key (målte) udbydere. OAuth-udbydere har strengere tærskler på grund af lavere takstgrænser.", "oauthProviders": "OAuth-udbydere", @@ -3097,7 +3596,6 @@ "backupCreated": "Sikkerhedskopiering oprettet: {file}", "restoreSuccess": "Gendannet! {connections} forbindelser, {nodes} noder, {combos} kombinationer, {apiKeys} API nøgler.", "importSuccess": "Database importeret! {connections} forbindelser, {nodes} noder, {combos} kombinationer, {apiKeys} API nøgler.", - "justNow": "lige nu", "minutesAgo": "{count}m siden", "hoursAgo": "{count}t siden", "daysAgo": "{count}d siden", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Der opstod en fejl under importen", "modelPricing": "Modelpriser", "modelPricingDesc": "Konfigurer omkostningssatser pr. model • Alle satser i $/1M tokens", - "providers": "Udbydere", "registry": "Register", "priced": "Prissat", "searchProvidersModels": "Søg efter udbydere eller modeller...", @@ -3154,47 +3651,6 @@ "editPricing": "Rediger prissætning", "viewFullDetails": "Se alle detaljer", "themeCoral": "Koral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Formatkonverter", "formatConverterDescription": "Indsæt eller skriv en JSON-anmodningstekst. Oversætteren vil automatisk registrere kildeformatet og konvertere det til målformatet. Brug dette til at fejlsøge, hvordan OmniRoute oversætter anmodninger mellem formater (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Fejl: {message}", "requestFailed": "Anmodningen mislykkedes", "noTextExtracted": "(Ingen tekst udtrukket)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Viser oversættelsesbegivenheder, mens API-kald flyder gennem OmniRoute. Hændelser kommer fra bufferen i hukommelsen (nulstilles ved genstart). Brug", "liveMonitorDescriptionSuffix": ", eller eksterne API-kald for at generere hændelser." }, @@ -3648,14 +4139,25 @@ "passSuffix": "bestå", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Kør Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Kører {current}/{total}...", "passRate": "beståelsesprocent", "summaryBreakdown": "{passed} bestået · {failed} mislykkedes · {total} i alt", "passedIconLabel": "✅ Bestået", "failedIconLabel": "❌ Mislykkedes", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Indeholder: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Forventet: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Ingen resultater endnu", "testCasesCount": "Testcases ({count})", "noTestCasesDefined": "Ingen testcases defineret", @@ -3723,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Ukendt", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentation", "quickStart": "Hurtig start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funktioner", "supportedProviders": "Understøttede udbydere", "supportedProvidersToc": "Udbydere", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Indstil klientbase-URL", "quickStartStep4Prefix": "Peg din IDE- eller API-klient til", "quickStartStep4Suffix": "Brug for eksempel udbyderpræfiks", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Rut anmodninger til 30+ AI-udbydere gennem et enkelt OpenAI-kompatibelt slutpunkt. Understøtter chat, svar, lyd og billed-API'er.", "featureCombosTitle": "Kombinationer og balancering", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Brug", "clientClaudeBullet1Middle": "(Claude) eller", "clientClaudeBullet1Suffix": "(antityngdekraft) præfiks.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protokoller: MCP & A2A", "protocolsDescription": "OmniRoute afslører to operationelle protokoller ud over OpenAI-kompatible API'er: MCP til værktøjsudførelse og A2A til agent-til-agent arbejdsgange.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Brug Dashboard > Udbydere > Test forbindelse, før du tester fra IDE'er eller eksterne klienter.", "troubleshootingCircuitBreaker": "Hvis en udbyder viser en afbryder åben, skal du vente på nedkøling eller tjekke Health-siden for detaljer.", "troubleshootingOAuth": "For OAuth-udbydere skal du godkende igen, hvis tokens udløber. Tjek udbyderkortets statusindikator.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privatlivspolitik", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simpel chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "lastUpdated": "Last updated", - "peakCacheRate": "Peak Cache Rate", - "cachedRequests24h": "Cached Requests (24h)", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "entriesLoadError": "Failed to load semantic cache entries.", - "trendHour": "Hour", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "hoursTracked": "hours tracked", - "busiestHour": "Busiest Hour", - "cacheRateDesc": "of total requests", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "activityVolume": "Activity", - "semanticCache": "Semantic Cache", - "cacheRate": "Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/de.json b/src/i18n/messages/de.json index 0639d215b7..fe08b20e88 100644 --- a/src/i18n/messages/de.json +++ b/src/i18n/messages/de.json @@ -23,6 +23,7 @@ "active": "Aktiv", "inactive": "Inaktiv", "noData": "Keine Daten verfügbar", + "nothingHere": "Nothing here yet", "configure": "Konfigurieren", "manage": "Verwalten", "name": "Name", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Preise zurücksetzen fehlgeschlagen", "apikey": "API-Schlüssel", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Spielwiese", "searchTools": "Search Tools", "agents": "Agenten", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumente", "issues": "Probleme", "endpoints": "Endpunkte", "apiManager": "API-Manager", "logs": "Protokolle", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit-Protokoll", "shutdown": "Herunterfahren", "restart": "Neustart", @@ -705,8 +710,6 @@ "cliToolsShort": "Werkzeuge", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themen", "description": "Wählen Sie ein voreingestelltes Thema oder erstellen Sie Ihr eigenes mit einer einzigen Farbe", @@ -826,6 +926,10 @@ "evals": "Bewertungen", "utilization": "Auslastung", "utilizationDescription": "Anbieter-Kontingent-Nutzungstrends und Ratenlimit-Verfolgung", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Combo-Gesundheit", "comboHealthDescription": "Combo-level Kontingent, Nutzungsverteilung und Leistungsmetriken", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Zuletzt: {date}", "editPermissions": "Berechtigungen bearbeiten", "deleteKey": "Schlüssel löschen", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} Modell", "models": "{count} Modelle", "permissionsTitle": "Berechtigungen: {name}", @@ -1188,11 +1296,13 @@ "continue": "Verwenden Sie diese Option, wenn Sie Continue in IDEs ausführen und eine portable JSON-basierte Anbieterkonfiguration benötigen.", "opencode": "Verwenden Sie diese Option, wenn Sie terminalnative Agentenausführungen und Skriptautomatisierung über OpenCode bevorzugen.", "kiro": "Zur Verwendung bei der Integration von Kiro und der zentralen Steuerung des Modellroutings über OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Wird verwendet, wenn Antigravity/Kiro-Verkehr über MITM abgefangen und an OmniRoute weitergeleitet werden muss.", "copilot": "Verwenden Sie diese Option, wenn Sie eine UX im Copilot-Chat-Stil wünschen und gleichzeitig OmniRoute-Schlüssel und Routing-Regeln durchsetzen möchten.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE mit MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,6 +1506,8 @@ "priorityDesc": "Sequentielles Fallback: Versucht zuerst Modell 1, dann 2 usw.", "weightedDesc": "Verteilt den Datenverkehr nach Gewichtsprozentsatz mit Fallback", "roundRobinDesc": "Zirkuläre Verteilung: Jede Anfrage wird abwechselnd an das nächste Modell weitergeleitet", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Einheitliche Zufallsauswahl, dann Rückgriff auf verbleibende Modelle", "leastUsedDesc": "Wählt das Modell mit den wenigsten Anfragen aus und gleicht die Last über die Zeit aus", "costOptimizedDesc": "Leitet basierend auf dem Preis zuerst zum günstigsten Modell weiter", @@ -1406,6 +1521,13 @@ "retryDelay": "Wiederholungsverzögerung (ms)", "concurrencyPerModel": "Parallelität / Modell", "queueTimeout": "Warteschlangen-Timeout (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Lassen Sie das Feld leer, um globale Standardeinstellungen zu verwenden. Diese überschreiben die Einstellungen pro Anbieter.", "moveUp": "Bewegen Sie sich nach oben", "moveDown": "Bewegen Sie sich nach unten", @@ -1459,15 +1581,35 @@ "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, + "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." }, - "p2c": { - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1502,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-Robin ist bei mindestens zwei Modellen am nützlichsten.", "warningCostOptimizedPartialPricing": "Nur {priced} der {total} Modelle haben Preise. Die Routenplanung kann teilweise kostenbewusst erfolgen.", "warningCostOptimizedNoPricing": "Für diese Kombination wurden keine Preisdaten gefunden. Eine kostenoptimierte Route kann unerwartet erfolgen.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Bereit zum Speichern?", "readinessDescription": "Prüfe die Checkliste, bevor du dieses Combo erstellst oder aktualisierst.", "readinessCheckName": "Der Combo-Name ist gültig", @@ -1519,6 +1667,44 @@ "applyRecommendations": "Empfehlungen anwenden", "recommendationsUpdated": "Empfehlungen für {strategy} aktualisiert.", "recommendationsApplied": "Empfehlungen für dieses Combo wurden angewendet.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Ausfallsichere Basis", @@ -1575,6 +1761,48 @@ "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1595,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "weightCostInv": "Cost", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, - "review": { - "label": "Review", - "description": "Final validation before saving" + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "builderFlowTitle": "Combo Builder Flow", - "weightHealth": "Health", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "incidentMode": "Incident Mode", - "budgetCapLabel": "Budget Cap (USD / request)", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "filterAll": "All", - "filterEmptyTitle": "No combos match this strategy filter.", - "statusOverview": "Status Overview", - "contextRelay": "Context Relay", - "failedReorder": "Failed to reorder models", - "contextRelayHandoffThreshold": "Handoff Threshold", - "builderPinnedAccount": "Pinned Account", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "excludedProviders": "Excluded Providers", - "builderAddComboRef": "Add combo reference", - "reorderHandle": "Drag to reorder", - "builderComboRef": "Combo Ref", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "builderSelectModel": "Select model", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "providerScores": "Provider Scores", - "activeModePack": "Active Mode Pack", - "builderTitle": "Build a Combo", - "weightQuota": "Quota", - "reviewProviders": "Providers", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "builderSelectProvider": "Select provider", - "reviewSteps": "Steps", - "routerStrategyLabel": "Router Strategy", - "builderPreview": "Preview", - "reviewIntelligentTitle": "Intelligent Routing Config", - "emailVisibilityStateOff": "Off", + "builderStageVisited": "Stage completed", "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", "builderAddStep": "Add step", - "reviewAdvanced": "Advanced Settings", - "noExcludedProviders": "No providers are currently excluded.", - "emailVisibilityStateOn": "On", - "modePackUpdated": "Mode pack updated to {pack}.", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", "builderLegacyEntry": "Legacy entry", "reviewName": "Name", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "weightStability": "Stability", - "budgetCapPlaceholder": "No limit", - "candidatePoolLabel": "Candidate Pool", - "contextRelayMaxMessages": "Max Messages For Summary", - "strategyRules": "Rules (6-Factor Scoring)", - "builderProviderFirst": "Pick provider first", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderProvider": "Provider", - "weightTierPriority": "Tier", - "reviewAgentFlags": "Agent Flags", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "filterIntelligent": "Intelligent", - "builderStagePending": "Pending", - "reviewNoSteps": "No steps configured", - "builderComboRefStep": "Add combo reference", - "cooldownMinutes": "Cooldown: {minutes}m", - "reviewAccounts": "Accounts", - "explorationRateLabel": "Exploration Rate", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "candidatePoolEmpty": "No active providers available yet.", - "reviewComboRefs": "Combo References", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderStageVisited": "Stage completed", - "modePackLabel": "Mode Pack", - "weightLatencyInv": "Latency", - "builderAccount": "Account", - "weightTaskFit": "Task Fit", "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", "reviewSequence": "Model Sequence", - "builderModel": "Model", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "normalOperation": "Normal Operation", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "filterDeterministic": "Deterministic", - "candidatePoolAllProviders": "All providers", - "contextRelaySummaryModel": "Summary Model", - "builderBrowseCatalog": "Browse catalog", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "builderLoadingProviders": "Loading providers..." + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kosten", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budget", "totalCost": "Gesamtkosten", "breakdown": "Kostenaufschlüsselung", "noData": "Keine Kostendaten", "byModel": "Nach Modell", "byProvider": "Nach Anbieter", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1730,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-Endpunkt", @@ -1761,6 +2007,8 @@ "audioTranscriptionDesc": "Audiodateien in Text umwandeln (Flüstern)", "textToSpeech": "Text-to-Speech", "textToSpeechDesc": "Wandeln Sie Text in natürlich klingende Sprache um", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderationen", "moderationsDesc": "Inhaltsmoderation und Sicherheitsklassifizierung", "responsesDesc": "OpenAI Responses API für Codex und fortgeschrittene agentische Workflows", @@ -1861,8 +2109,6 @@ "a2aQuickStartStep3": "Verfolgen und steuern Sie Aufgaben mit `tasks/get` und `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1896,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2040,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Systemgesundheit", "description": "Echtzeitüberwachung Ihrer OmniRoute-Instanz", @@ -2119,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits und Quoten", "rateLimit": "Ratenbegrenzung", @@ -2185,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Willkommen", @@ -2276,6 +2661,12 @@ "errorCount": "{count} Fehler ({code})", "errorCountNoCode": "{count} Fehler", "noConnections": "Keine Verbindungen", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Deaktiviert", "enableProvider": "Anbieter aktivieren", "disableProvider": "Anbieter deaktivieren", @@ -2310,7 +2701,6 @@ "errorOccurred": "Es ist ein Fehler aufgetreten. Bitte versuchen Sie es erneut.", "modelStatus": "Modellstatus", "showConfiguredOnly": "Configured only", - "searchProviders": "Anbieter suchen...", "allModelsOperational": "Alle Modelle betriebsbereit", "modelsWithIssues": "{count} Modell(e) mit Problemen", "allModelsNormal": "Alle Modelle reagieren normal.", @@ -2363,9 +2753,14 @@ "openaiCompatibleDetails": "Details zur OpenAI-Kompatibilität", "messagesApi": "Nachrichten-API", "responsesApi": "Antwort-API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chat-Abschlüsse", "importingModels": "Importieren...", "importFromModels": "Import aus /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Alle Modelle sind bereits importiert", "noNewModelsToImport": "Keine neuen Modelle zum Importieren — alle Modelle sind bereits in der Registry oder der Liste benutzerdefinierter Modelle", "skippingExistingModels": "Überspringe {count} vorhandene Modelle", @@ -2387,6 +2782,7 @@ "importFailed": "Der Import ist fehlgeschlagen", "noNewModelsAdded": "Es wurden keine neuen Modelle hinzugefügt.", "adding": "Hinzufügen...", + "close": "Close", "importingModelsTitle": "Modelle importieren", "copyModel": "Modell kopieren", "filterModels": "Modelle filtern…", @@ -2427,6 +2823,11 @@ "configured": "konfiguriert", "providerProxyConfigureHint": "Proxy für alle Verbindungen dieses Anbieters konfigurieren", "providerProxy": "Anbieter-Proxy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Noch keine Verbindungen", "addFirstConnectionHint": "Fügen Sie Ihre erste Verbindung hinzu, um loszulegen", "addConnection": "Verbindung hinzufügen", @@ -2493,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Modell-ID", "customModelPlaceholder": "z.B. gpt-4,5-turbo", "loading": "Laden...", @@ -2527,6 +2931,10 @@ "email": "E-Mail", "healthCheckMinutes": "Gesundheitscheck (Min.)", "healthCheckHint": "Proaktives Token-Aktualisierungsintervall. 0 = deaktiviert.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Die Verbindung konnte nicht getestet werden", @@ -2551,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "modelsActiveCount": "{active}/{total} active", - "hideEmails": "Hide all emails", - "embeddings": "Embeddings", - "deselectAllModels": "Deselect all", - "audioSpeech": "Audio Speech", - "repairEnvFailed": "Failed to repair .env", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnvSuccess": "OAuth defaults restored", "showEmails": "Show all emails", - "imagesGenerations": "Images Generations", - "repairEnv": "Repair env", - "selectAllModels": "Select all", - "repairEnvWorking": "Repairing...", - "noModelsMatch": "No models match \"{filter}\"", - "audioTranscriptions": "Audio Transcriptions", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2580,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2590,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2645,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2682,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Anbieter suchen...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2720,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Einstellungen", @@ -2737,6 +3137,23 @@ "systemPrompt": "Systemaufforderung", "thinkingBudget": "Denkendes Budget", "proxy": "Stellvertreter", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Preise", "storage": "Lagerung", "policies": "Richtlinien", @@ -2747,6 +3164,46 @@ "enablePassword": "Passwort aktivieren", "darkMode": "Dunkler Modus", "lightMode": "Lichtmodus", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "gerade jetzt", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Anbieter", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Systemthema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2754,6 +3211,8 @@ "cacheTTL": "Cache-TTL", "maxCacheSize": "Maximale Cache-Größe", "clearCache": "Cache leeren", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache-Treffer", "cacheMisses": "Cache-Fehler", "hitRate": "Trefferquote", @@ -2780,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Denken aktivieren", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Proxy aktivieren", @@ -2816,6 +3277,14 @@ "themeLight": "Licht", "themeDark": "Dunkel", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2897,6 +3366,14 @@ "apiEndpointProtection": "API-Endpunktschutz", "requireAuthModels": "API-Schlüssel für /models erforderlich", "requireAuthModelsDesc": "Wenn diese Option aktiviert ist, gibt der Endpunkt /v1/models für nicht authentifizierte Anforderungen 404 zurück. Verhindert die Modellerkennung durch nicht autorisierte Benutzer.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Gesperrte Anbieter", "blockedProvidersDesc": "Verstecken Sie bestimmte Anbieter in der /v1/models-Antwort. Gesperrte Anbieter erscheinen nicht in den Modelllisten.", "providersBlocked": "{count} Anbieter von /models blockiert", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Combo-Strategie", "priority": "Priorität", "weighted": "Gewichtet", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max. Wiederholungsversuche", "retryDelayLabel": "Wiederholungsverzögerung (ms)", "timeoutLabel": "Timeout (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maximale Verschachtelungstiefe", "concurrencyPerModel": "Parallelität / Modell", "queueTimeout": "Warteschlangen-Timeout (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Anbieterprofile", "providerProfilesDesc": "Separate Resilienzeinstellungen für OAuth-Anbieter (sitzungsbasiert) und API-Schlüsselanbieter (gemessen). OAuth-Anbieter haben aufgrund niedrigerer Ratenlimits strengere Schwellenwerte.", "oauthProviders": "OAuth-Anbieter", @@ -3113,7 +3596,6 @@ "backupCreated": "Backup erstellt: {file}", "restoreSuccess": "Restauriert! {connections} Verbindungen, {nodes} Knoten, {combos} Combos, {apiKeys} API-Schlüssel.", "importSuccess": "Datenbank importiert! {connections} Verbindungen, {nodes} Knoten, {combos} Combos, {apiKeys} API-Schlüssel.", - "justNow": "gerade jetzt", "minutesAgo": "Vor {count}m", "hoursAgo": "Vor {count}h", "daysAgo": "Vor {count}d", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Beim Import ist ein Fehler aufgetreten", "modelPricing": "Modellpreise", "modelPricingDesc": "Konfigurieren Sie die Kostensätze pro Modell. • Alle Preise in 1-Millionen-Dollar-Tokens", - "providers": "Anbieter", "registry": "Registrierung", "priced": "Preislich", "searchProvidersModels": "Anbieter oder Modelle suchen...", @@ -3170,47 +3651,6 @@ "editPricing": "Preise bearbeiten", "viewFullDetails": "Vollständige Details anzeigen", "themeCoral": "Koralle", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3368,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3383,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3434,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3481,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Formatkonverter", "formatConverterDescription": "Fügen Sie einen JSON-Anfragetext ein oder geben Sie ihn ein. Der Übersetzer erkennt das Quellformat automatisch und konvertiert es in das Zielformat. Verwenden Sie dies, um zu debuggen, wie OmniRoute Anfragen zwischen Formaten übersetzt (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Eingabe", "output": "Ausgabe", "auto": "Automatisch", @@ -3589,6 +4059,11 @@ "errorMessage": "Fehler: {message}", "requestFailed": "Die Anfrage ist fehlgeschlagen", "noTextExtracted": "(Kein Text extrahiert)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Zeigt Übersetzungsereignisse an, während API-Aufrufe über OmniRoute fließen. Ereignisse kommen aus dem In-Memory-Puffer (wird beim Neustart zurückgesetzt). Benutzen", "liveMonitorDescriptionSuffix": "oder externe API-Aufrufe zum Generieren von Ereignissen." }, @@ -3664,14 +4139,25 @@ "passSuffix": "passieren", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Führen Sie die Evaluierung aus", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Ausführen von {current}/{total}...", "passRate": "Erfolgsquote", "summaryBreakdown": "{passed} bestanden · {failed} fehlgeschlagen · {total} insgesamt", "passedIconLabel": "✅Bestanden", "failedIconLabel": "❌ Fehlgeschlagen", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Enthält: „{term}“", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Erwartet: „{expected}“", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Noch keine Ergebnisse", "testCasesCount": "Testfälle ({count})", "noTestCasesDefined": "Keine Testfälle definiert", @@ -3739,6 +4225,16 @@ "tierFree": "Kostenlos", "tierUnknown": "Unbekannt", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3781,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3794,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3958,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Warte auf Antigravity-Autorisierung...", "waitingForQoderAuthorization": "Warte auf Qoder-Autorisierung...", "exchangingCodeForTokens": "Tausche Code gegen Token aus...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4048,6 +4549,7 @@ "docs": { "title": "Dokumentation", "quickStart": "Schnellstart", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funktionen", "supportedProviders": "Unterstützte Anbieter", "supportedProvidersToc": "Anbieter", @@ -4084,6 +4586,20 @@ "quickStartStep4Title": "4. Legen Sie die Client-Basis-URL fest", "quickStartStep4Prefix": "Verweisen Sie Ihren IDE- oder API-Client auf", "quickStartStep4Suffix": "Verwenden Sie beispielsweise das Provider-Präfix", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider-Routing", "featureRoutingText": "Leiten Sie Anfragen über einen einzigen OpenAI-kompatiblen Endpunkt an über 30 KI-Anbieter weiter. Unterstützt Chat-, Antwort-, Audio- und Bild-APIs.", "featureCombosTitle": "Combos und Balancing", @@ -4128,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Benutzen", "clientClaudeBullet1Middle": "(Claude) oder", "clientClaudeBullet1Suffix": "Präfix (Antigravitation).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protokolle: MCP und A2A", "protocolsDescription": "OmniRoute stellt zusätzlich zu OpenAI-kompatiblen APIs zwei Betriebsprotokolle zur Verfügung: MCP für die Tool-Ausführung und A2A für Agent-zu-Agent-Workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4171,8 +4699,61 @@ "troubleshootingTestConnection": "Verwenden Sie Dashboard > Anbieter > Verbindung testen, bevor Sie Tests mit IDEs oder externen Clients durchführen.", "troubleshootingCircuitBreaker": "Wenn ein Anbieter anzeigt, dass der Leistungsschalter geöffnet ist, warten Sie auf die Abklingzeit oder schauen Sie auf der Seite „Zustand“ nach, um Einzelheiten zu erfahren.", "troubleshootingOAuth": "Führen Sie bei OAuth-Anbietern eine erneute Authentifizierung durch, wenn die Token ablaufen. Überprüfen Sie die Statusanzeige der Anbieterkarte.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Datenschutzrichtlinie", @@ -4276,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Einfacher Chat", @@ -4353,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4364,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4371,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "lastUpdated": "Last updated", - "hoursTracked": "hours tracked", - "cacheRate": "Cache Rate", - "cacheRateDesc": "of total requests", - "cachedRequests24h": "Cached Requests (24h)", - "busiestHour": "Busiest Hour", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "semanticCache": "Semantic Cache", - "activityVolume": "Activity", - "trendHour": "Hour", - "peakCacheRate": "Peak Cache Rate", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "entriesLoadError": "Failed to load semantic cache entries.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4621,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4667,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/en.json b/src/i18n/messages/en.json index 07b6ef1647..7955339c41 100644 --- a/src/i18n/messages/en.json +++ b/src/i18n/messages/en.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -1818,7 +1820,7 @@ "wizardStep2Title": "Add Models", "wizardStep2Desc": "Select AI models and arrange their fallback priority order", "wizardStep3Title": "Choose Strategy", - "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", + "wizardStep3Desc": "Pick how requests are distributed across your models - 14 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", "emailVisibilityStateOn": "On", @@ -2982,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -3040,6 +3043,9 @@ "geminiCliProjectIdHint": "Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", "geminiCliProjectIdLabel": "Google Cloud Project ID", "geminiCliProjectIdPlaceholder": "my-gcp-project-id", + "antigravityProjectIdHint": "Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", @@ -3233,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "Resilience Structure", + "resilienceStructureDesc": "This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3795,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "Optional", + "current": "Current", + "remove": "Remove", + "search": "Search" }, "contextRtk": { "title": "RTK Engine", @@ -4574,6 +4586,18 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "Setup Guide", + "deploySetupText": "Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "Electron Desktop", + "deployElectronText": "Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "Docker", + "deployDockerText": "Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "Virtual Machine", + "deployVmText": "Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "Fly.io", + "deployFlyText": "Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "PWA", + "deployPwaText": "Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", "deployTermuxTitle": "Termux (Android)", "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", @@ -4707,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "Compression Engines", + "mcpToolsCompressionDesc": "Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4851,6 +4879,42 @@ "settingsRoutingLink": "Settings/Routing", "openSettings": "Settings" }, + "cloudAgents": { + "title": "Cloud Agents", + "description": "Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "Loading tasks...", + "aboutTitle": "About Cloud Agents", + "aboutDescription": "Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "How it works:", + "howItWorksDesc": "Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "Create New Task", + "newTaskDescription": "Start a new task with a cloud agent", + "selectAgent": "Select Agent", + "taskDescription": "Task Description", + "taskDescriptionPlaceholder": "Describe what you want the agent to do...", + "startTask": "Start Task", + "tasks": "Tasks", + "taskDetail": "Task Detail", + "noTasks": "No tasks yet. Create one to get started.", + "untitledTask": "Untitled Task", + "created": "Created", + "conversation": "Conversation", + "result": "Result", + "error": "Error", + "planReady": "Plan Ready for Approval", + "approvePlan": "Approve Plan", + "rejectPlan": "Reject & Cancel", + "sendMessagePlaceholder": "Send a message to the agent...", + "cancel": "Cancel", + "delete": "Delete", + "selectTaskPrompt": "Select a task to view details", + "statusPending": "Pending", + "statusRunning": "Running", + "statusWaitingApproval": "Waiting Approval", + "statusCompleted": "Completed", + "statusFailed": "Failed", + "statusCancelled": "Cancelled" + }, "templateNames": { "simple-chat": "Simple Chat", "streaming": "Streaming", diff --git a/src/i18n/messages/es.json b/src/i18n/messages/es.json index 7ca0ac2d41..f87e193b96 100644 --- a/src/i18n/messages/es.json +++ b/src/i18n/messages/es.json @@ -23,6 +23,7 @@ "active": "Activo", "inactive": "Inactivo", "noData": "No hay datos disponibles", + "nothingHere": "Nothing here yet", "configure": "Configurar", "manage": "Administrar", "name": "Nombre", @@ -137,9 +138,8 @@ "Failed to reset pricing": "No se pudo restablecer el precio", "apikey": "Clave API", "http": "HTTP", - "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agentes", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Documentación", "issues": "Problemas", "endpoints": "Endpoints", "apiManager": "Gestor de API", "logs": "Registros", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Registro de auditoría", "shutdown": "Apagar", "restart": "Reiniciar", @@ -705,8 +710,6 @@ "cliToolsShort": "Herramientas", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Temas", "description": "Elige un tema preestablecido o crea el tuyo propio con un solo color", @@ -826,6 +926,10 @@ "evals": "evaluaciones", "utilization": "Utilización", "utilizationDescription": "Tendencias de uso de cuota del proveedor y seguimiento de límites de tasa", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Salud del combo", "comboHealthDescription": "Cuota a nivel de combo, distribución de uso y métricas de rendimiento", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Último: {date}", "editPermissions": "Editar permisos", "deleteKey": "Eliminar clave", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modelo", "models": "{count} modelos", "permissionsTitle": "Permisos: {name}", @@ -1188,11 +1296,13 @@ "continue": "Úselo cuando ejecute Continuar en IDE y necesite una configuración de proveedor portátil basada en JSON.", "opencode": "Úselo cuando prefiera ejecuciones de agentes nativos de terminal y automatización con scripts a través de OpenCode.", "kiro": "Utilícelo al integrar Kiro y controlar el enrutamiento de modelos de forma centralizada desde OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Úselo cuando el tráfico de Antigravity/Kiro debe interceptarse a través de MITM y enrutarse a OmniRoute.", "copilot": "Úselo cuando desee una experiencia de usuario estilo chat Copilot mientras aplica las claves de OmniRoute y las reglas de enrutamiento.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE antigravedad de Google con MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Retroceso secuencial: prueba primero el modelo 1, luego el 2, etc.", "weightedDesc": "Distribuye el tráfico por porcentaje de peso con respaldo", "roundRobinDesc": "Distribución circular: cada solicitud pasa al siguiente modelo en rotación", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Selección aleatoria uniforme y luego recurrir a los modelos restantes.", "leastUsedDesc": "Elige el modelo con menos solicitudes y equilibra la carga a lo largo del tiempo.", "costOptimizedDesc": "Rutas al modelo más barato primero según el precio", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modelos", @@ -1404,6 +1521,13 @@ "retryDelay": "Retardo de reintento (ms)", "concurrencyPerModel": "Concurrencia / Modelo", "queueTimeout": "Tiempo de espera de cola (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Déjelo vacío para usar los valores predeterminados globales. Estos anulan la configuración por proveedor.", "moveUp": "Subir", "moveDown": "Bajar", @@ -1447,6 +1571,11 @@ "avoid": "Faltan datos de precios o están desactualizados.", "example": "Trabajos en segundo plano o por lotes donde se prefiere un menor costo." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1458,9 +1587,29 @@ "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", + "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "El round-robin es más útil con al menos 2 modelos.", "warningCostOptimizedPartialPricing": "Solo {priced} de los modelos {total} tienen precios. El enrutamiento puede tener en cuenta parcialmente los costos.", "warningCostOptimizedNoPricing": "No se encontraron datos de precios para este combo. El costo optimizado puede enrutarse inesperadamente.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "¿Listo para guardar?", "readinessDescription": "Revisa la lista de verificación antes de crear o actualizar este combo.", "readinessCheckName": "El nombre del combo es válido", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Aplicar recomendaciones", "recommendationsUpdated": "Recomendaciones actualizadas para {strategy}.", "recommendationsApplied": "Se aplicaron recomendaciones a este combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Base tolerante a fallos", @@ -1555,12 +1748,61 @@ "tip2": "Mantén un fallback de calidad para prompts difíciles.", "tip3": "Úsala en batch/tareas de fondo donde el costo sea el KPI principal." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "weightTierPriority": "Tier", - "explorationRateLabel": "Exploration Rate", - "normalOperation": "Normal Operation", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" - }, - "review": { - "label": "Review", - "description": "Final validation before saving" - }, "basics": { "label": "Basics", "description": "Name and starting template" }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" + }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "filterEmptyTitle": "No combos match this strategy filter.", - "reviewAdvanced": "Advanced Settings", - "providerScores": "Provider Scores", - "filterDeterministic": "Deterministic", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "filterIntelligent": "Intelligent", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "excludedProviders": "Excluded Providers", - "builderAddStep": "Add step", - "reorderHandle": "Drag to reorder", + "builderStageVisited": "Stage completed", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", "builderLegacyEntry": "Legacy entry", "reviewName": "Name", - "weightQuota": "Quota", - "filterAll": "All", - "builderPreview": "Preview", "reviewStrategy": "Strategy", "reviewSteps": "Steps", - "statusOverview": "Status Overview", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "weightHealth": "Health", - "builderAccount": "Account", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "weightLatencyInv": "Latency", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderLoadingProviders": "Loading providers...", - "weightStability": "Stability", - "weightTaskFit": "Task Fit", - "budgetCapPlaceholder": "No limit", - "builderProvider": "Provider", - "emailVisibilityStateOn": "On", - "builderStageVisited": "Stage completed", - "noExcludedProviders": "No providers are currently excluded.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "candidatePoolEmpty": "No active providers available yet.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "reviewAgentFlags": "Agent Flags", - "builderStageLocked": "Locked — complete previous stage first", - "reviewNoSteps": "No steps configured", - "candidatePoolLabel": "Candidate Pool", - "builderStageCurrent": "Current stage", - "builderComboRef": "Combo Ref", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "emailVisibilityStateOff": "Off", - "builderAddComboRef": "Add combo reference", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "modePackUpdated": "Mode pack updated to {pack}.", - "contextRelaySummaryModel": "Summary Model", - "builderModel": "Model", - "reviewProviders": "Providers", - "candidatePoolAllProviders": "All providers", - "builderFlowTitle": "Combo Builder Flow", - "routerStrategyLabel": "Router Strategy", - "builderStagePending": "Pending", - "contextRelayHandoffThreshold": "Handoff Threshold", - "cooldownMinutes": "Cooldown: {minutes}m", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderSelectModel": "Select model", - "builderSelectProvider": "Select provider", - "failedReorder": "Failed to reorder models", - "reviewIntelligentTitle": "Intelligent Routing Config", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "incidentMode": "Incident Mode", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderTitle": "Build a Combo", - "builderPinnedAccount": "Pinned Account", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "activeModePack": "Active Mode Pack", - "builderComboRefStep": "Add combo reference", - "strategyRules": "Rules (6-Factor Scoring)", - "contextRelay": "Context Relay", - "reviewSequence": "Model Sequence", "reviewAccounts": "Accounts", + "reviewProviders": "Providers", "reviewComboRefs": "Combo References", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "budgetCapLabel": "Budget Cap (USD / request)", - "modePackLabel": "Mode Pack", - "weightCostInv": "Cost", - "builderBrowseCatalog": "Browse catalog", - "advancedWeightsTitle": "Advanced: Scoring Weights" + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costos", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Presupuesto", "totalCost": "Costo total", "breakdown": "Desglose de costos", "noData": "Sin datos de coste", "byModel": "Por modelo", "byProvider": "Por proveedor", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Punto final API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transcribir archivos de audio a texto (Whisper)", "textToSpeech": "Texto a voz", "textToSpeechDesc": "Convierta texto en voz con sonido natural", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderaciones", "moderationsDesc": "Moderación de contenidos y clasificación de seguridad.", "responsesDesc": "API Responses de OpenAI para Codex y flujos de trabajo agénticos avanzados", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Realice un seguimiento y controle las tareas utilizando `tasks/get` y `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Estado del sistema", "description": "Monitoreo en tiempo real de su instancia de OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Límites y cuotas", "rateLimit": "Límite de tarifa", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Bienvenido", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "Sin conexiones", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Discapacitado", "enableProvider": "Habilitar proveedor", "disableProvider": "Deshabilitar proveedor", @@ -2296,7 +2701,6 @@ "errorOccurred": "Se produjo un error. Por favor inténtalo de nuevo.", "modelStatus": "Estado del modelo", "showConfiguredOnly": "Configured only", - "searchProviders": "Buscar proveedores...", "allModelsOperational": "Todos los modelos operativos.", "modelsWithIssues": "{count} modelo(s) con problemas", "allModelsNormal": "Todos los modelos están respondiendo normalmente.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Detalles compatibles con OpenAI", "messagesApi": "API de mensajes", "responsesApi": "API de respuestas", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Finalizaciones de chat", "importingModels": "Importando...", "importFromModels": "Importar desde /modelos", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Todos los modelos ya están importados", "noNewModelsToImport": "No hay modelos nuevos para importar — todos los modelos ya están en el registro o en la lista de modelos personalizados", "skippingExistingModels": "Omitiendo {count} modelos existentes", @@ -2373,6 +2782,7 @@ "importFailed": "Importación fallida", "noNewModelsAdded": "No se agregaron nuevos modelos.", "adding": "Añadiendo...", + "close": "Close", "importingModelsTitle": "Importar modelos", "copyModel": "Copiar modelo", "filterModels": "Filtrar modelos…", @@ -2484,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID del modelo", "customModelPlaceholder": "por ej. gpt-4.5-turbo", "loading": "Cargando...", @@ -2518,6 +2931,10 @@ "email": "Correo electrónico", "healthCheckMinutes": "Control de salud (min)", "healthCheckHint": "Intervalo de actualización de token proactivo. 0 = deshabilitado.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "No se pudo probar la conexión", @@ -2542,20 +2959,10 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "modelsActiveCount": "{active}/{total} active", - "audioTranscriptions": "Audio Transcriptions", - "imagesGenerations": "Images Generations", - "deselectAllModels": "Deselect all", - "selectAllModels": "Select all", - "embeddings": "Embeddings", "showEmails": "Show all emails", - "audioSpeech": "Audio Speech", - "noModelsMatch": "No models match \"{filter}\"", "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Buscar proveedores...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Configuración", @@ -2723,6 +3137,23 @@ "systemPrompt": "Aviso del sistema", "thinkingBudget": "Pensando en el presupuesto", "proxy": "apoderado", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Precios", "storage": "Almacenamiento", "policies": "Políticas", @@ -2733,6 +3164,46 @@ "enablePassword": "Habilitar contraseña", "darkMode": "Modo oscuro", "lightMode": "Modo de luz", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "justo ahora", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Proveedores", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema del sistema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "TTL de caché", "maxCacheSize": "Tamaño máximo de caché", "clearCache": "Borrar caché", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Visitas de caché", "cacheMisses": "Errores de caché", "hitRate": "Tasa de aciertos", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Habilitar el pensamiento", "maxThinkingTokens": "Fichas de pensamiento máximo", "enableProxy": "Habilitar proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Luz", "themeDark": "oscuro", "themeSystem": "Sistema", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Protección de terminales API", "requireAuthModels": "Requerir clave API para /models", "requireAuthModelsDesc": "Cuando está activado, el punto final /v1/models devuelve 404 para solicitudes no autenticadas. Impide el descubrimiento del modelo por parte de usuarios no autorizados.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Proveedores bloqueados", "blockedProvidersDesc": "Oculte proveedores específicos de la respuesta /v1/models. Los proveedores bloqueados no aparecerán en los listados de modelos.", "providersBlocked": "{count} proveedor(es) bloqueado(s) en /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Elija la cuenta utilizada menos recientemente", "costOpt": "Opción de costo", "costOptDesc": "Prefiere la cuenta más barata disponible", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Límite fijo", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "estrategia combinada", "priority": "Prioridad", "weighted": "ponderado", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Reintentos máximos", "retryDelayLabel": "Retardo de reintento (ms)", "timeoutLabel": "Tiempo de espera (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Profundidad máxima de anidamiento", "concurrencyPerModel": "Concurrencia / Modelo", "queueTimeout": "Tiempo de espera de cola (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Perfiles de proveedores", "providerProfilesDesc": "Configuraciones de resiliencia separadas para proveedores de OAuth (basado en sesiones) y de clave API (medidas). Los proveedores de OAuth tienen umbrales más estrictos debido a límites de tarifas más bajos.", "oauthProviders": "Proveedores de OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Copia de seguridad creada: {file}", "restoreSuccess": "¡Restaurado! {connections} conexiones, {nodes} nodos, {combos} combos, {apiKeys} claves API.", "importSuccess": "¡Base de datos importada! {connections} conexiones, {nodes} nodos, {combos} combos, {apiKeys} claves API.", - "justNow": "justo ahora", "minutesAgo": "Hace {count}m", "hoursAgo": "Hace {count}h", "daysAgo": "Hace {count}d", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Se produjo un error durante la importación.", "modelPricing": "Precios del modelo", "modelPricingDesc": "Configurar tarifas de costo por modelo • Todas las tarifas en tokens de $/1 millón", - "providers": "Proveedores", "registry": "Registro", "priced": "Precio", "searchProvidersModels": "Buscar proveedores o modelos...", @@ -3154,47 +3651,6 @@ "editPricing": "Editar precios", "viewFullDetails": "Ver todos los detalles", "themeCoral": "Coral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERROR", "formatConverter": "Convertidor de formato", "formatConverterDescription": "Pegue o escriba un cuerpo de solicitud JSON. El traductor detectará automáticamente el formato de origen y lo convertirá al formato de destino. Utilice esto para depurar cómo OmniRoute traduce solicitudes entre formatos (OpenAI ↔ Claude ↔ Gemini ↔ API de respuestas).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Entrada", "output": "Salida", "auto": "Automático", @@ -3573,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Solicitud fallida", "noTextExtracted": "(No se extrae texto)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). uso", "liveMonitorDescriptionSuffix": "o llamadas API externas para generar eventos." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pasar", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Ejecutar evaluación", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Ejecutando {current}/{total}...", "passRate": "tasa de aprobación", "summaryBreakdown": "{passed} aprobado · {failed} fallido · {total} total", "passedIconLabel": "✅ Aprobado", "failedIconLabel": "❌ Fallido", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contiene: \"{term}\"", "detailsRegex": "Expresión regular: {pattern}", "detailsExpected": "Se esperaba: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Aún no hay resultados", "testCasesCount": "Casos de prueba ({count})", "noTestCasesDefined": "No hay casos de prueba definidos", @@ -3723,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Desconocido", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRuta", @@ -4032,6 +4549,7 @@ "docs": { "title": "Documentación", "quickStart": "Inicio rápido", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Características", "supportedProviders": "Proveedores compatibles", "supportedProvidersToc": "Proveedores", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Establecer la URL de la base de clientes", "quickStartStep4Prefix": "Apunte su cliente IDE o API a", "quickStartStep4Suffix": "Utilice el prefijo del proveedor, por ejemplo", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Enrutamiento multiproveedor", "featureRoutingText": "Enrute solicitudes a más de 30 proveedores de IA a través de un único punto final compatible con OpenAI. Admite API de chat, respuestas, audio e imágenes.", "featureCombosTitle": "Combos y equilibrio", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "uso", "clientClaudeBullet1Middle": "(Claude) o", "clientClaudeBullet1Suffix": "Prefijo (antigravedad).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocolos: MCP y A2A", "protocolsDescription": "OmniRoute expone dos protocolos operativos además de las API compatibles con OpenAI: MCP para la ejecución de herramientas y A2A para flujos de trabajo de agente a agente.", "protocolMcpTitle": "MCP (Protocolo de contexto modelo)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Utilice Panel > Proveedores > Probar conexión antes de realizar pruebas desde IDE o clientes externos.", "troubleshootingCircuitBreaker": "Si un proveedor muestra el disyuntor abierto, espere el tiempo de reutilización o consulte la página de Salud para obtener más detalles.", "troubleshootingOAuth": "Para los proveedores de OAuth, vuelva a autenticarse si los tokens caducan. Verifique el indicador de estado de la tarjeta del proveedor.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Política de privacidad", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "busiestHour": "Busiest Hour", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "activityVolume": "Activity", - "cacheRate": "Cache Rate", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "trendHour": "Hour", - "semanticCache": "Semantic Cache", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "cacheRateDesc": "of total requests", - "peakCacheRate": "Peak Cache Rate", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "hoursTracked": "hours tracked", - "lastUpdated": "Last updated", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "cachedRequests24h": "Cached Requests (24h)", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/fa.json b/src/i18n/messages/fa.json index 7360b369ea..276141ef2f 100644 --- a/src/i18n/messages/fa.json +++ b/src/i18n/messages/fa.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/fi.json b/src/i18n/messages/fi.json index 4e75a03fbf..675ce2f8d1 100644 --- a/src/i18n/messages/fi.json +++ b/src/i18n/messages/fi.json @@ -23,6 +23,7 @@ "active": "Aktiivinen", "inactive": "Ei-aktiivinen", "noData": "Tietoja ei ole saatavilla", + "nothingHere": "Nothing here yet", "configure": "Määritä", "manage": "Hallitse", "name": "Nimi", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Hinnoittelun nollaaminen epäonnistui", "apikey": "API-avain", "http": "HTTP", - "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Leikkipaikka", "searchTools": "Search Tools", "agents": "Agentit", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Asiakirjat", "issues": "Ongelmat", "endpoints": "Päätepisteet", "apiManager": "API Manager", "logs": "Lokit", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Tarkastusloki", "shutdown": "Sammutus", "restart": "Käynnistä uudelleen", @@ -705,8 +710,6 @@ "cliToolsShort": "Työkalut", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Teemat", "description": "Valitse esiasetettu teema tai luo oma yhdellä värillä", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Käyttöaste", "utilizationDescription": "Palveluntarjoajan kiintiön käyttötrendit ja nopeusrajoitusten seuranta", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Yhdistelmän kunto", "comboHealthDescription": "Yhdistelmätason kiintiö, käytön jakautuminen ja suorituskykymittarit", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Viimeisin: {date}", "editPermissions": "Muokkaa käyttöoikeuksia", "deleteKey": "Poista avain", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} malli", "models": "{count} mallit", "permissionsTitle": "Luvat: {name}", @@ -1188,11 +1296,13 @@ "continue": "Käytä, kun käytät Continuea IDE:issä ja tarvitset kannettavan JSON-pohjaisen palveluntarjoajan määrityksen.", "opencode": "Käytä, kun haluat käyttää päätealustaisia ​​agentteja ja komentosarjottua automaatiota OpenCoden kautta.", "kiro": "Käytä integroitaessa Kiroa ja ohjattaessa mallin reititystä keskitetysti OmniRoutesta.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Käytä, kun Antigravity/Kiro-liikenne on siepattava MITM:n kautta ja ohjattava OmniRouteen.", "copilot": "Käytä, kun haluat Copilot-chat-tyylisen UX:n ja pakota OmniRoute-avaimia ja reitityssääntöjä.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE ja MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Peräkkäinen palautus: kokeilee ensin mallia 1, sitten 2 jne.", "weightedDesc": "Jakaa liikenteen painoprosentin mukaan varauksella", "roundRobinDesc": "Pyöreä jakelu: jokainen pyyntö siirtyy seuraavaan kiertoon malliin", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Yhtenäinen satunnainen valinta, sitten takaisin muihin malleihin", "leastUsedDesc": "Valitsee mallin, jolla on vähiten pyyntöjä ja tasapainottaa kuormitusta ajan myötä", "costOptimizedDesc": "Reitit edullisimpaan malliin ensin hinnoittelun perusteella", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Mallit", @@ -1404,6 +1521,13 @@ "retryDelay": "Uudelleenyrityksen viive (ms)", "concurrencyPerModel": "Samanaikaisuus / malli", "queueTimeout": "Jonon aikakatkaisu (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Jätä tyhjäksi, jos haluat käyttää yleisiä oletusasetuksia. Nämä ohittavat palveluntarjoajakohtaiset asetukset.", "moveUp": "Siirrä ylös", "moveDown": "Siirry alas", @@ -1447,20 +1571,45 @@ "avoid": "Hinnoittelutiedot puuttuvat tai ovat vanhentuneet.", "example": "Tausta- tai erätyöt, joissa edullisemmat kustannukset ovat paremmat." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin on hyödyllisin vähintään kahdella mallilla.", "warningCostOptimizedPartialPricing": "Vain {priced} {total}-malleista on hinnoiteltu. Reititys voi olla osittain kustannustietoinen.", "warningCostOptimizedNoPricing": "Tälle yhdistelmälle ei löytynyt hintatietoja. Kustannusoptimoitu voi reitittää odottamatta.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Oletko valmis säästämään?", "readinessDescription": "Tarkista tarkistuslista ennen tämän yhdistelmän luomista tai päivittämistä.", "readinessCheckName": "Yhdistelmänimi on kelvollinen", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "modePackUpdated": "Mode pack updated to {pack}.", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "reviewStrategy": "Strategy", - "incidentMode": "Incident Mode", - "builderTitle": "Build a Combo", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "candidatePoolLabel": "Candidate Pool", - "weightHealth": "Health", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" - }, - "review": { - "label": "Review", - "description": "Final validation before saving" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "statusOverview": "Status Overview", - "weightQuota": "Quota", - "weightTierPriority": "Tier", - "reviewAccounts": "Accounts", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "strategyRules": "Rules (6-Factor Scoring)", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "budgetCapPlaceholder": "No limit", - "modePackLabel": "Mode Pack", - "builderSelectModel": "Select model", - "contextRelaySummaryModel": "Summary Model", - "builderAccount": "Account", - "emailVisibilityStateOn": "On", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "emailVisibilityStateOff": "Off", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "reviewName": "Name", - "filterEmptyTitle": "No combos match this strategy filter.", - "builderLoadingProviders": "Loading providers...", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "reorderHandle": "Drag to reorder", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewSteps": "Steps", - "builderAddStep": "Add step", - "builderComboRef": "Combo Ref", - "weightTaskFit": "Task Fit", - "builderProviderFirst": "Pick provider first", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "weightCostInv": "Cost", - "builderPreview": "Preview", - "reviewComboRefs": "Combo References", - "builderStageCurrent": "Current stage", - "builderLegacyEntry": "Legacy entry", - "weightLatencyInv": "Latency", - "routerStrategyLabel": "Router Strategy", - "failedReorder": "Failed to reorder models", - "builderBrowseCatalog": "Browse catalog", - "candidatePoolAllProviders": "All providers", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "budgetCapLabel": "Budget Cap (USD / request)", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "providerScores": "Provider Scores", - "contextRelay": "Context Relay", - "candidatePoolEmpty": "No active providers available yet.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "filterIntelligent": "Intelligent", - "reviewSequence": "Model Sequence", - "explorationRateLabel": "Exploration Rate", - "builderSelectProvider": "Select provider", - "builderFlowTitle": "Combo Builder Flow", - "activeModePack": "Active Mode Pack", - "reviewNoSteps": "No steps configured", - "reviewAdvanced": "Advanced Settings", - "reviewProviders": "Providers", - "filterAll": "All", - "reviewIntelligentTitle": "Intelligent Routing Config", - "builderComboRefStep": "Add combo reference", - "excludedProviders": "Excluded Providers", - "noExcludedProviders": "No providers are currently excluded.", "builderStageVisited": "Stage completed", - "normalOperation": "Normal Operation", - "intelligentPanelTitle": "Intelligent Routing Dashboard", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayMaxMessages": "Max Messages For Summary", - "filterDeterministic": "Deterministic", - "builderPinnedAccount": "Pinned Account", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "weightStability": "Stability", - "builderProvider": "Provider", - "reviewAgentFlags": "Agent Flags", - "builderModel": "Model", "builderStageLocked": "Locked — complete previous stage first", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderAddComboRef": "Add combo reference" + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kustannukset", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budjetti", "totalCost": "Kokonaiskustannukset", "breakdown": "Kustannusten erittely", "noData": "Ei hintatietoja", "byModel": "Mallin mukaan", "byProvider": "Palveluntarjoajan toimesta", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-päätepiste", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Literoi äänitiedostot tekstiksi (kuiskaus)", "textToSpeech": "Tekstistä puheeksi", "textToSpeechDesc": "Muunna teksti luonnolliselta kuulostavaksi puheeksi", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderaatiot", "moderationsDesc": "Sisällön moderointi ja turvallisuusluokitus", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Seuraa ja ohjaa tehtäviä käyttämällä `tasks/get` ja `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Järjestelmän terveys", "description": "OmniRoute-instanssisi reaaliaikainen seuranta", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Rajoitukset ja kiintiöt", "rateLimit": "Rate Limit", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Tervetuloa", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Virhe ({code})", "errorCountNoCode": "{count} Virhe", "noConnections": "Ei yhteyksiä", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Ei käytössä", "enableProvider": "Ota palveluntarjoaja käyttöön", "disableProvider": "Poista palveluntarjoaja käytöstä", @@ -2296,7 +2701,6 @@ "errorOccurred": "Tapahtui virhe. Yritä uudelleen.", "modelStatus": "Mallin tila", "showConfiguredOnly": "Configured only", - "searchProviders": "Hae palveluntarjoajia...", "allModelsOperational": "Kaikki mallit toimivat", "modelsWithIssues": "{count} malli(t), joissa on ongelmia", "allModelsNormal": "Kaikki mallit reagoivat normaalisti.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-yhteensopivat tiedot", "messagesApi": "Viestit API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chatin loppuun saattaminen", "importingModels": "Tuodaan...", "importFromModels": "Tuo / mallit", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Kaikki mallit on jo tuotu", "noNewModelsToImport": "Ei uusia malleja tuotavaksi — kaikki mallit ovat jo rekisterissä tai mukautetulla mallilistalla", "skippingExistingModels": "Ohitetaan {count} olemassa olevaa mallia", @@ -2373,6 +2782,7 @@ "importFailed": "Tuonti epäonnistui", "noNewModelsAdded": "Uusia malleja ei lisätty.", "adding": "Lisätään...", + "close": "Close", "importingModelsTitle": "Mallien tuonti", "copyModel": "Kopioi malli", "filterModels": "Suodata malleja…", @@ -2413,6 +2823,11 @@ "configured": "määritetty", "providerProxyConfigureHint": "Määritä välityspalvelin kaikille tämän palveluntarjoajan yhteyksille", "providerProxy": "Palveluntarjoajan välityspalvelin", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Ei yhteyksiä vielä", "addFirstConnectionHint": "Aloita lisäämällä ensimmäinen yhteys", "addConnection": "Lisää yhteys", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Mallin tunnus", "customModelPlaceholder": "esim. gpt-4.5-turbo", "loading": "Ladataan...", @@ -2513,6 +2931,10 @@ "email": "Sähköposti", "healthCheckMinutes": "Terveystarkastus (min)", "healthCheckHint": "Ennakoiva tunnuksen päivitysväli. 0 = pois käytöstä.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Yhteyden testaus epäonnistui", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnv": "Repair env", - "audioSpeech": "Audio Speech", - "selectAllModels": "Select all", - "audioTranscriptions": "Audio Transcriptions", - "repairEnvWorking": "Repairing...", - "repairEnvSuccess": "OAuth defaults restored", - "embeddings": "Embeddings", - "deselectAllModels": "Deselect all", - "imagesGenerations": "Images Generations", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", - "hideEmails": "Hide all emails", "showEmails": "Show all emails", - "noModelsMatch": "No models match \"{filter}\"", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Hae palveluntarjoajia...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Asetukset", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Hinnoittelu", "storage": "Varastointi", "policies": "Käytännöt", @@ -2749,6 +3164,46 @@ "enablePassword": "Ota salasana käyttöön", "darkMode": "Tumma tila", "lightMode": "Valotila", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "juuri nyt", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Palveluntarjoajat", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Järjestelmän teema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Välimuisti TTL", "maxCacheSize": "Välimuistin enimmäiskoko", "clearCache": "Tyhjennä välimuisti", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Välimuistin osumia", "cacheMisses": "Välimuisti puuttuu", "hitRate": "Osumaprosentti", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Ota ajattelu käyttöön", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Ota välityspalvelin käyttöön", @@ -2818,6 +3277,14 @@ "themeLight": "Kevyt", "themeDark": "Tumma", "themeSystem": "Järjestelmä", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Vaadi API-avain /mallille", "requireAuthModelsDesc": "Kun PÄÄLLÄ, /v1/models-päätepiste palauttaa 404 todentamattomille pyynnöille. Estää valtuuttamattomien käyttäjien mallin löytämisen.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Estetyt palveluntarjoajat", "blockedProvidersDesc": "Piilota tietyt toimittajat /v1/models-vastauksesta. Estetyt palveluntarjoajat eivät näy malliluetteloissa.", "providersBlocked": "{count} toimittaja(t) estetty /modelsista", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Valitse vähiten käytetty tili", "costOpt": "Kustannusopt", "costOptDesc": "Valitse halvin saatavilla oleva tili", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Yhdistelmästrategia", "priority": "Prioriteetti", "weighted": "Painotettu", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max Uudelleenyritykset", "retryDelayLabel": "Uudelleenyrityksen viive (ms)", "timeoutLabel": "Aikakatkaisu (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Suurin pesintäsyvyys", "concurrencyPerModel": "Samanaikaisuus / malli", "queueTimeout": "Jonon aikakatkaisu (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Palveluntarjoajan profiilit", "providerProfilesDesc": "Erilliset joustavuusasetukset OAuth- (istuntopohjainen) ja API-avaimen (mittari) tarjoajille. OAuth-palveluntarjoajilla on tiukemmat kynnykset alhaisempien nopeusrajojen vuoksi.", "oauthProviders": "OAuth-palveluntarjoajat", @@ -3113,7 +3596,6 @@ "backupCreated": "Varmuuskopio luotu: {file}", "restoreSuccess": "Palautettu! {connections} yhteydet, {nodes} solmut, {combos} yhdistelmät, {apiKeys} API-avaimet.", "importSuccess": "Tietokanta tuotu! {connections} yhteydet, {nodes} solmut, {combos} yhdistelmät, {apiKeys} API-avaimet.", - "justNow": "juuri nyt", "minutesAgo": "{count}min sitten", "hoursAgo": "{count}h sitten", "daysAgo": "{count}pv sitten", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Tuonnin aikana tapahtui virhe", "modelPricing": "Mallin hinnoittelu", "modelPricingDesc": "Määritä mallikohtaiset hintahinnat • Kaikki hinnat $/1M tunnuksissa", - "providers": "Palveluntarjoajat", "registry": "Rekisteri", "priced": "hinnoiteltu", "searchProvidersModels": "Hae palveluntarjoajia tai malleja...", @@ -3170,47 +3651,6 @@ "editPricing": "Muokkaa hinnoittelua", "viewFullDetails": "Näytä täydelliset tiedot", "themeCoral": "Koralli", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Liitä tai kirjoita JSON-pyynnön leipäteksti. Kääntäjä tunnistaa automaattisesti lähdemuodon ja muuntaa sen kohdemuotoon. Käytä tätä virheenkorjaukseen, kuinka OmniRoute kääntää pyynnöt muotojen välillä (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Syöte", "output": "Lähtö", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Virhe: {message}", "requestFailed": "Pyyntö epäonnistui", "noTextExtracted": "(Ei tekstiä poimittu)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Näyttää käännöstapahtumat, kun API-kutsut kulkevat OmniRouten kautta. Tapahtumat tulevat muistin puskurista (palautuu uudelleenkäynnistyksen yhteydessä). Käytä", "liveMonitorDescriptionSuffix": "tai ulkoisia API-kutsuja tapahtumien luomiseksi." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Juokse Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Käynnissä {current}/{total}...", "passRate": "läpäisyaste", "summaryBreakdown": "{passed} hyväksytty · {failed} epäonnistui · {total} yhteensä", "passedIconLabel": "✅ Läpäisty", "failedIconLabel": "❌ Epäonnistui", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Sisältää: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Odotettu: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Ei tuloksia vielä", "testCasesCount": "Testitapaukset ({count})", "noTestCasesDefined": "Testitapauksia ei ole määritelty", @@ -3723,6 +4225,16 @@ "tierFree": "Ilmainen", "tierUnknown": "Tuntematon", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,9 +4459,9 @@ "waitingForAntigravityAuthorization": "Odotetaan antigravitaatiovaltuutusta...", "waitingForQoderAuthorization": "Odotetaan Qoder-valtuutusta...", "exchangingCodeForTokens": "Vaihdetaan koodia tokeneihin...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentaatio", "quickStart": "Pika-aloitus", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Ominaisuudet", "supportedProviders": "Tuetut palveluntarjoajat", "supportedProvidersToc": "Palveluntarjoajat", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Aseta asiakaskannan URL-osoite", "quickStartStep4Prefix": "Osoita IDE- tai API-asiakkaasi", "quickStartStep4Suffix": "Käytä esimerkiksi palveluntarjoajan etuliitettä", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Usean palveluntarjoajan reititys", "featureRoutingText": "Reititä pyynnöt yli 30 tekoälypalveluntarjoajalle yhden OpenAI-yhteensopivan päätepisteen kautta. Tukee chat-, vastaus-, ääni- ja kuvasovellusliittymiä.", "featureCombosTitle": "Yhdistelmät ja tasapainotus", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Käytä", "clientClaudeBullet1Middle": "(Claude) tai", "clientClaudeBullet1Suffix": "(Antigravity) etuliite.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protokollat: MCP & A2A", "protocolsDescription": "OmniRoute paljastaa kaksi toimintaprotokollaa OpenAI-yhteensopivien sovellusliittymien lisäksi: MCP työkalujen suorittamiseen ja A2A agenttien välisiin työnkulkuihin.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Käytä Dashboard > Providers > Test Connection ennen testaamista IDE:istä tai ulkoisista asiakkaista.", "troubleshootingCircuitBreaker": "Jos palveluntarjoaja näyttää katkaisijan auki, odota jäähtymistä tai katso lisätietoja Terveys-sivulta.", "troubleshootingOAuth": "OAuth-palveluntarjoajat todenna uudelleen, jos tunnukset vanhenevat. Tarkista palveluntarjoajan kortin tilailmaisin.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Tietosuojakäytäntö", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Yksinkertainen chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "cacheRateDesc": "of total requests", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "semanticCache": "Semantic Cache", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cacheRate": "Cache Rate", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "entriesLoadError": "Failed to load semantic cache entries.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "hoursTracked": "hours tracked", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "busiestHour": "Busiest Hour", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "peakCacheRate": "Peak Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "trendHour": "Hour", - "lastUpdated": "Last updated", - "activityVolume": "Activity", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/fr.json b/src/i18n/messages/fr.json index 44326e348d..74da22fe37 100644 --- a/src/i18n/messages/fr.json +++ b/src/i18n/messages/fr.json @@ -23,6 +23,7 @@ "active": "Actif", "inactive": "Inactif", "noData": "Aucune donnée disponible", + "nothingHere": "Nothing here yet", "configure": "Configurer", "manage": "Gérer", "name": "Nom", @@ -137,7 +138,6 @@ "Failed to reset pricing": "Échec de la réinitialisation des prix", "apikey": "Clé API", "http": "HTTP", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Documentation", "issues": "Problèmes", "endpoints": "Points d'accès", "apiManager": "Gestionnaire d'API", "logs": "Journaux", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Journal d'audit", "shutdown": "Arrêt", "restart": "Redémarrer", @@ -705,8 +710,6 @@ "cliToolsShort": "Outils", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Thèmes", "description": "Choisissez un thème prédéfini ou créez le vôtre avec une seule couleur", @@ -826,6 +926,10 @@ "evals": "Évaluations", "utilization": "Utilisation", "utilizationDescription": "Tendances d'utilisation du quota fournisseur et suivi des limites de débit", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Santé du combo", "comboHealthDescription": "Quota au niveau combo, distribution de l'utilisation et métriques de performance", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Dernier : {date}", "editPermissions": "Modifier les autorisations", "deleteKey": "Supprimer la clé", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "Modèle {count}", "models": "Modèles {count}", "permissionsTitle": "Autorisations : {name}", @@ -1188,11 +1296,13 @@ "continue": "À utiliser lors de l'exécution de Continue dans les IDE et que vous avez besoin d'une configuration de fournisseur portable basée sur JSON.", "opencode": "À utiliser lorsque vous préférez les exécutions d'agents natifs du terminal et l'automatisation par script via OpenCode.", "kiro": "À utiliser lors de l'intégration de Kiro et du contrôle centralisé du routage de modèles à partir d'OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "À utiliser lorsque le trafic Antigravity/Kiro doit être intercepté via MITM et acheminé vers OmniRoute.", "copilot": "À utiliser lorsque vous souhaitez une UX de style chat Copilot tout en appliquant les clés OmniRoute et les règles de routage.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE Google Antigravity avec MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Repli séquentiel : essaie d'abord le modèle 1, puis le 2, etc.", "weightedDesc": "Répartit le trafic en pourcentage de poids avec repli", "roundRobinDesc": "Distribution circulaire : chaque demande va au modèle suivant en rotation", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Sélection aléatoire uniforme, puis retour aux modèles restants", "leastUsedDesc": "Sélectionne le modèle avec le moins de demandes, en équilibrant la charge au fil du temps", "costOptimizedDesc": "Itinéraires vers le modèle le moins cher en premier en fonction du prix", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modèles", @@ -1404,6 +1521,13 @@ "retryDelay": "Délai de nouvelle tentative (ms)", "concurrencyPerModel": "Concurrence / Modèle", "queueTimeout": "Délai d'expiration de la file d'attente (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Laissez vide pour utiliser les valeurs par défaut globales. Ceux-ci remplacent les paramètres de chaque fournisseur.", "moveUp": "Monter", "moveDown": "Descendre", @@ -1447,20 +1571,45 @@ "avoid": "Les données de tarification sont manquantes ou obsolètes.", "example": "Travaux en arrière-plan ou par lots pour lesquels un coût inférieur est préféré." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, + "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." }, - "p2c": { - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Le round-robin est plus utile avec au moins 2 modèles.", "warningCostOptimizedPartialPricing": "Seuls {priced} des modèles {total} ont un prix. Le routage peut être partiellement axé sur les coûts.", "warningCostOptimizedNoPricing": "Aucune donnée de prix trouvée pour ce combo. Un itinéraire optimisé en termes de coûts peut être inattendu.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Prêt à enregistrer ?", "readinessDescription": "Vérifie la checklist avant de créer ou de mettre à jour ce combo.", "readinessCheckName": "Le nom du combo est valide", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Appliquer les recommandations", "recommendationsUpdated": "Recommandations mises à jour pour {strategy}.", "recommendationsApplied": "Recommandations appliquées à ce combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Base tolérante aux pannes", @@ -1555,12 +1748,61 @@ "tip2": "Garde un fallback de qualité pour les prompts difficiles.", "tip3": "Idéal pour batch/tâches de fond où le coût est le KPI principal." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "reviewAdvanced": "Advanced Settings", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "review": { - "label": "Review", - "description": "Final validation before saving" - }, - "strategy": { - "label": "Strategy", - "description": "Routing behavior and advanced settings" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "builderProviderFirst": "Pick provider first", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderAddStep": "Add step", - "filterIntelligent": "Intelligent", - "failedReorder": "Failed to reorder models", - "providerScores": "Provider Scores", - "reviewIntelligentTitle": "Intelligent Routing Config", - "filterDeterministic": "Deterministic", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "noExcludedProviders": "No providers are currently excluded.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "reviewNoSteps": "No steps configured", - "builderComboRef": "Combo Ref", "builderStageVisited": "Stage completed", - "builderComboRefStep": "Add combo reference", - "builderSelectProvider": "Select provider", - "builderStagePending": "Pending", - "candidatePoolEmpty": "No active providers available yet.", - "reviewSteps": "Steps", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderLegacyEntry": "Legacy entry", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "builderAccount": "Account", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "emailVisibilityStateOff": "Off", - "weightTierPriority": "Tier", - "weightCostInv": "Cost", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewName": "Name", - "builderLoadingProviders": "Loading providers...", - "routerStrategyLabel": "Router Strategy", - "builderFlowTitle": "Combo Builder Flow", - "weightStability": "Stability", - "explorationRateLabel": "Exploration Rate", - "activeModePack": "Active Mode Pack", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "excludedProviders": "Excluded Providers", - "builderSelectModel": "Select model", - "weightQuota": "Quota", - "reviewSequence": "Model Sequence", - "builderAddComboRef": "Add combo reference", - "contextRelayHandoffThreshold": "Handoff Threshold", - "filterAll": "All", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderStageLocked": "Locked — complete previous stage first", - "weightHealth": "Health", - "budgetCapLabel": "Budget Cap (USD / request)", - "reviewComboRefs": "Combo References", - "budgetCapPlaceholder": "No limit", - "builderProvider": "Provider", - "builderBrowseCatalog": "Browse catalog", "builderStageCurrent": "Current stage", - "incidentMode": "Incident Mode", - "contextRelaySummaryModel": "Summary Model", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "weightLatencyInv": "Latency", - "builderPreview": "Preview", - "candidatePoolAllProviders": "All providers", - "filterEmptyTitle": "No combos match this strategy filter.", - "reviewAgentFlags": "Agent Flags", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "weightTaskFit": "Task Fit", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "contextRelay": "Context Relay", - "statusOverview": "Status Overview", - "modePackUpdated": "Mode pack updated to {pack}.", - "reorderHandle": "Drag to reorder", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", "builderTitle": "Build a Combo", - "candidatePoolLabel": "Candidate Pool", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "modePackLabel": "Mode Pack", - "reviewStrategy": "Strategy", - "strategyRules": "Rules (6-Factor Scoring)", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "reviewProviders": "Providers", - "reviewAccounts": "Accounts", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", "builderModel": "Model", - "normalOperation": "Normal Operation", - "emailVisibilityStateOn": "On", - "builderPinnedAccount": "Pinned Account" + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Coûts", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budget", "totalCost": "Coût total", "breakdown": "Répartition des coûts", "noData": "Aucune donnée sur les coûts", "byModel": "Par modèle", "byProvider": "Par fournisseur", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Point de terminaison de l'API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transcrire des fichiers audio en texte (Whisper)", "textToSpeech": "Synthèse vocale", "textToSpeechDesc": "Convertir du texte en discours au son naturel", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Modérations", "moderationsDesc": "Modération du contenu et classification de sécurité", "responsesDesc": "API Responses d'OpenAI pour Codex et workflows agentiques avancés", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Suivez et contrôlez les tâches à l’aide de `tasks/get` et `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Santé du système", "description": "Surveillance en temps réel de votre instance OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limites et quotas", "rateLimit": "Limite de taux", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Bienvenue", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Erreur ({code})", "errorCountNoCode": "{count} Erreur", "noConnections": "Aucune connexion", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Désactivé", "enableProvider": "Activer le fournisseur", "disableProvider": "Désactiver le fournisseur", @@ -2296,7 +2701,6 @@ "errorOccurred": "Une erreur s'est produite. Veuillez réessayer.", "modelStatus": "Statut du modèle", "showConfiguredOnly": "Configured only", - "searchProviders": "Rechercher des fournisseurs...", "allModelsOperational": "Tous les modèles opérationnels", "modelsWithIssues": "{count} modèle(s) présentant des problèmes", "allModelsNormal": "Tous les modèles répondent normalement.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Détails compatibles avec OpenAI", "messagesApi": "API de messages", "responsesApi": "API de réponses", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Achèvements des discussions", "importingModels": "Importation...", "importFromModels": "Importer depuis /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Tous les modèles sont déjà importés", "noNewModelsToImport": "Aucun nouveau modèle à importer — tous les modèles sont déjà dans le registre ou la liste de modèles personnalisés", "skippingExistingModels": "Ignorance de {count} modèles existants", @@ -2373,6 +2782,7 @@ "importFailed": "Échec de l'importation", "noNewModelsAdded": "Aucun nouveau modèle n'a été ajouté.", "adding": "Ajout...", + "close": "Close", "importingModelsTitle": "Importation de modèles", "copyModel": "Copier le modèle", "filterModels": "Filtrer les modèles…", @@ -2413,6 +2823,11 @@ "configured": "configuré", "providerProxyConfigureHint": "Configurer le proxy pour toutes les connexions de ce fournisseur", "providerProxy": "Proxy du fournisseur", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Aucune connexion pour l'instant", "addFirstConnectionHint": "Ajoutez votre première connexion pour commencer", "addConnection": "Ajouter une connexion", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID du modèle", "customModelPlaceholder": "par ex. gpt-4.5-turbo", "loading": "Chargement...", @@ -2513,6 +2931,10 @@ "email": "Courriel", "healthCheckMinutes": "Bilan de santé (min)", "healthCheckHint": "Intervalle d’actualisation proactif des jetons. 0 = désactivé.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Échec du test de connexion", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioTranscriptions": "Audio Transcriptions", - "noModelsMatch": "No models match \"{filter}\"", "showEmails": "Show all emails", - "selectAllModels": "Select all", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "audioSpeech": "Audio Speech", - "modelsActiveCount": "{active}/{total} active", - "repairEnvSuccess": "OAuth defaults restored", - "repairEnvWorking": "Repairing...", "hideEmails": "Hide all emails", - "repairEnv": "Repair env", - "deselectAllModels": "Deselect all", - "embeddings": "Embeddings", - "repairEnvFailed": "Failed to repair .env", - "imagesGenerations": "Images Generations", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Rechercher des fournisseurs...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Paramètres", @@ -2723,6 +3137,23 @@ "systemPrompt": "Invite système", "thinkingBudget": "Penser le budget", "proxy": "Procuration", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Tarifs", "storage": "Stockage", "policies": "Politiques", @@ -2733,6 +3164,46 @@ "enablePassword": "Activer le mot de passe", "darkMode": "Mode sombre", "lightMode": "Mode lumière", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "juste maintenant", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Fournisseurs", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Thème système", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Durée de vie du cache", "maxCacheSize": "Taille maximale du cache", "clearCache": "Vider le cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Accès au cache", "cacheMisses": "Manques de cache", "hitRate": "Taux de réussite", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Permettre la réflexion", "maxThinkingTokens": "Jetons de réflexion maximum", "enableProxy": "Activer le proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Lumière", "themeDark": "Sombre", "themeSystem": "Système", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Protection des points de terminaison API", "requireAuthModels": "Exiger une clé API pour /models", "requireAuthModelsDesc": "Lorsqu'il est activé, le point de terminaison /v1/models renvoie 404 pour les demandes non authentifiées. Empêche la découverte de modèles par des utilisateurs non autorisés.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Fournisseurs bloqués", "blockedProvidersDesc": "Masquez les fournisseurs spécifiques de la réponse /v1/models. Les fournisseurs bloqués n'apparaîtront pas dans les listes de modèles.", "providersBlocked": "{count} fournisseur(s) bloqué(s) sur /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Choisissez le compte le moins récemment utilisé", "costOpt": "Option de coût", "costOptDesc": "Préférer le compte disponible le moins cher", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Limite collante", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Stratégie combinée", "priority": "Priorité", "weighted": "Pondéré", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Nombre maximal de tentatives", "retryDelayLabel": "Délai de nouvelle tentative (ms)", "timeoutLabel": "Délai d'expiration (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Profondeur maximale d'emboîtement", "concurrencyPerModel": "Concurrence / Modèle", "queueTimeout": "Délai d'expiration de la file d'attente (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profils de fournisseurs", "providerProfilesDesc": "Paramètres de résilience séparés pour les fournisseurs OAuth (basés sur la session) et API Key (mesurés). Les fournisseurs OAuth ont des seuils plus stricts en raison de limites de débit plus basses.", "oauthProviders": "Fournisseurs OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Sauvegarde créée : {file}", "restoreSuccess": "Restauré ! Connexions {connections}, nœuds {nodes}, combos {combos}, clés API {apiKeys}.", "importSuccess": "Base de données importée ! Connexions {connections}, nœuds {nodes}, combos {combos}, clés API {apiKeys}.", - "justNow": "juste maintenant", "minutesAgo": "il y a {count}m", "hoursAgo": "il y a {count}h", "daysAgo": "Il y a {count}j", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Une erreur s'est produite lors de l'importation", "modelPricing": "Prix ​​du modèle", "modelPricingDesc": "Configurer les tarifs par modèle • Tous les tarifs en jetons $/1 M", - "providers": "Fournisseurs", "registry": "Registre", "priced": "Prix", "searchProvidersModels": "Rechercher des fournisseurs ou des modèles...", @@ -3154,47 +3651,6 @@ "editPricing": "Modifier le prix", "viewFullDetails": "Afficher tous les détails", "themeCoral": "Corail", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERREUR", "formatConverter": "Convertisseur de formats", "formatConverterDescription": "Collez ou saisissez un corps de requête JSON. Le traducteur détectera automatiquement le format source et le convertira au format cible. Utilisez-le pour déboguer la façon dont OmniRoute traduit les requêtes entre les formats (OpenAI ↔ Claude ↔ Gemini ↔ API Responses).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Entrée", "output": "Sortie", "auto": "Automatique", @@ -3573,6 +4059,11 @@ "errorMessage": "Erreur : {message}", "requestFailed": "La demande a échoué", "noTextExtracted": "(Aucun texte extrait)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Affiche les événements de traduction lorsque les appels d'API transitent par OmniRoute. Les événements proviennent du tampon en mémoire (réinitialisation au redémarrage). Utiliser", "liveMonitorDescriptionSuffix": ", ou des appels d'API externes pour générer des événements." }, @@ -3648,14 +4139,25 @@ "passSuffix": "passer", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Exécuter l'évaluation", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Exécution de {current}/{total}...", "passRate": "taux de réussite", "summaryBreakdown": "{passed} réussi · {failed} échoué · {total} total", "passedIconLabel": "✅ Réussi", "failedIconLabel": "❌ Échec", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contient : \"{term}\"", "detailsRegex": "Expression régulière : {pattern}", "detailsExpected": "Attendu : \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Aucun résultat pour l'instant", "testCasesCount": "Cas de test ({count})", "noTestCasesDefined": "Aucun cas de test défini", @@ -3723,6 +4225,16 @@ "tierFree": "Gratuit", "tierUnknown": "Inconnu", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,9 +4459,9 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Démarrage rapide", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Caractéristiques", "supportedProviders": "Fournisseurs pris en charge", "supportedProvidersToc": "Fournisseurs", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Définir l'URL de la base de clients", "quickStartStep4Prefix": "Pointez votre client IDE ou API vers", "quickStartStep4Suffix": "Utilisez le préfixe du fournisseur, par exemple", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Routage multi-fournisseurs", "featureRoutingText": "Acheminez les requêtes vers plus de 30 fournisseurs d’IA via un seul point de terminaison compatible OpenAI. Prend en charge les API de chat, de réponses, d'audio et d'image.", "featureCombosTitle": "Combos et équilibrage", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Utiliser", "clientClaudeBullet1Middle": "(Claude) ou", "clientClaudeBullet1Suffix": "Préfixe (Antigravité).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocoles : MCP et A2A", "protocolsDescription": "OmniRoute expose deux protocoles opérationnels en plus des API compatibles OpenAI : MCP pour l'exécution des outils et A2A pour les flux de travail d'agent à agent.", "protocolMcpTitle": "MCP (protocole de contexte de modèle)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Utilisez Tableau de bord > Fournisseurs > Tester la connexion avant de tester à partir d'IDE ou de clients externes.", "troubleshootingCircuitBreaker": "Si un fournisseur indique que le disjoncteur est ouvert, attendez le temps de recharge ou consultez la page Santé pour plus de détails.", "troubleshootingOAuth": "Pour les fournisseurs OAuth, réauthentifiez-vous si les jetons expirent. Vérifiez l'indicateur d'état de la carte du fournisseur.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Politique de confidentialité", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "trendHour": "Hour", - "cacheRateDesc": "of total requests", - "peakCacheRate": "Peak Cache Rate", - "activityVolume": "Activity", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cachedRequests24h": "Cached Requests (24h)", - "cacheRate": "Cache Rate", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "semanticCache": "Semantic Cache", - "lastUpdated": "Last updated", - "hoursTracked": "hours tracked", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "busiestHour": "Busiest Hour", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/gu.json b/src/i18n/messages/gu.json index 1204fe8a7f..ebb57ba3c2 100644 --- a/src/i18n/messages/gu.json +++ b/src/i18n/messages/gu.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/he.json b/src/i18n/messages/he.json index e733ca551a..011e932f49 100644 --- a/src/i18n/messages/he.json +++ b/src/i18n/messages/he.json @@ -23,6 +23,7 @@ "active": "פעיל", "inactive": "לא פעיל", "noData": "אין נתונים זמינים", + "nothingHere": "Nothing here yet", "configure": "הגדר", "manage": "נהל", "name": "שם", @@ -137,9 +138,8 @@ "Failed to reset pricing": "איפוס התמחור נכשל", "apikey": "מפתח API", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "סוכנים", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "מסמכים", "issues": "בעיות", "endpoints": "נקודות קצה", "apiManager": "מנהל API", "logs": "יומנים", + "webhooks": "__MISSING__:Webhooks", "auditLog": "יומן ביקורת", "shutdown": "כיבוי", "restart": "הפעל מחדש", @@ -705,8 +710,6 @@ "cliToolsShort": "כלים", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "ניצול", "utilizationDescription": "מגמות שימוש במכסת הספק ומעקב אחר מגבלות קצב", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "בריאות הקומבו", "comboHealthDescription": "מכסה ברמת הקומבו, הפצת שימוש ומדדי ביצוע", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "אחרון: {date}", "editPermissions": "ערוך הרשאות", "deleteKey": "מחק מפתח", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "דגם {count}", "models": "דגמי {count}", "permissionsTitle": "הרשאות: {name}", @@ -1188,11 +1296,13 @@ "continue": "השתמש בעת הפעלת Continue ב-IDEs ואתה זקוק לתצורת ספק ניידת מבוססת JSON.", "opencode": "השתמש כאשר אתה מעדיף ריצות סוכנים מקוריים ומאוטומציה של סקריפטים באמצעות OpenCode.", "kiro": "השתמש בעת שילוב Kiro ושליטה בניתוב מודלים באופן מרכזי מ- OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "השתמש כאשר יש ליירט תעבורת Antigravity/Kiro דרך MITM ולנתב אל OmniRoute.", "copilot": "השתמש כאשר אתה רוצה UX בסגנון צ'אט Copilot תוך אכיפת מפתחות וכללי ניתוב OmniRoute.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE עם MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "נפילה רציפה: מנסה קודם את דגם 1, אחר כך 2 וכו'.", "weightedDesc": "מחלק את התעבורה לפי אחוז משקל עם נפילה", "roundRobinDesc": "חלוקה מעגלית: כל בקשה עוברת לדגם הבא בסיבוב", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "בחירה אקראית אחידה, ואז חזרה לדגמים שנותרו", "leastUsedDesc": "בוחר את הדגם עם הכי פחות בקשות, מאזן עומס לאורך זמן", "costOptimizedDesc": "מסלולים לדגם הזול ביותר לפי תמחור", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "דגמים", @@ -1404,6 +1521,13 @@ "retryDelay": "נסה שוב עיכוב (מילישניות)", "concurrencyPerModel": "במקביל / דגם", "queueTimeout": "זמן קצוב לתור (מילישניות)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "השאר ריק כדי להשתמש בברירות המחדל גלובליות. אלה עוקפים הגדרות לכל ספק.", "moveUp": "לזוז למעלה", "moveDown": "לזוז למטה", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Ready to save?", "readinessDescription": "Review the checklist before creating or updating this combo.", "readinessCheckName": "Combo name is valid", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "explorationRateLabel": "Exploration Rate", - "weightTaskFit": "Task Fit", - "builderBrowseCatalog": "Browse catalog", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderFlowTitle": "Combo Builder Flow", - "weightHealth": "Health", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "budgetCapPlaceholder": "No limit", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "providerScores": "Provider Scores", - "builderPreview": "Preview", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "builderStageVisited": "Stage completed", - "weightLatencyInv": "Latency", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "cooldownMinutes": "Cooldown: {minutes}m", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderProvider": "Provider", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", "failedReorder": "Failed to reorder models", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { "basics": { - "description": "Name and starting template", - "label": "Basics" - }, - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, - "review": { - "description": "Final validation before saving", - "label": "Review" - }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "reviewSteps": "Steps", - "builderLoadingProviders": "Loading providers...", - "weightCostInv": "Cost", - "builderAccount": "Account", - "activeModePack": "Active Mode Pack", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "routerStrategyLabel": "Router Strategy", - "reviewAccounts": "Accounts", - "builderStageLocked": "Locked — complete previous stage first", - "reviewStrategy": "Strategy", - "builderProviderFirst": "Pick provider first", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderAddComboRef": "Add combo reference", - "contextRelay": "Context Relay", - "incidentMode": "Incident Mode", - "builderSelectModel": "Select model", - "builderComboRef": "Combo Ref", - "strategyRules": "Rules (6-Factor Scoring)", - "builderStagePending": "Pending", - "reviewAgentFlags": "Agent Flags", - "budgetCapLabel": "Budget Cap (USD / request)", - "normalOperation": "Normal Operation", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderTitle": "Build a Combo", - "reviewIntelligentTitle": "Intelligent Routing Config", - "emailVisibilityStateOff": "Off", - "filterAll": "All", + "builderStageVisited": "Stage completed", "builderStageCurrent": "Current stage", - "builderModel": "Model", - "weightStability": "Stability", - "excludedProviders": "Excluded Providers", - "builderLegacyEntry": "Legacy entry", - "builderPinnedAccount": "Pinned Account", - "contextRelaySummaryModel": "Summary Model", - "candidatePoolEmpty": "No active providers available yet.", - "candidatePoolAllProviders": "All providers", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "reorderHandle": "Drag to reorder", - "noExcludedProviders": "No providers are currently excluded.", - "emailVisibilityStateOn": "On", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "modePackLabel": "Mode Pack", - "weightQuota": "Quota", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", "builderSelectProvider": "Select provider", - "candidatePoolLabel": "Candidate Pool", - "filterDeterministic": "Deterministic", - "reviewName": "Name", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", "builderAddStep": "Add step", - "reviewAdvanced": "Advanced Settings", - "reviewSequence": "Model Sequence", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "statusOverview": "Status Overview", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", "builderComboRefStep": "Add combo reference", - "filterIntelligent": "Intelligent", - "reviewNoSteps": "No steps configured", - "reviewComboRefs": "Combo References", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", "reviewProviders": "Providers", - "weightTierPriority": "Tier", - "filterEmptyTitle": "No combos match this strategy filter." + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "עלויות", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "תקציב", "totalCost": "עלות כוללת", "breakdown": "פירוט עלויות", "noData": "אין נתוני עלויות", "byModel": "לפי דגם", "byProvider": "לפי ספק", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "נקודת קצה API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "תמלול קבצי שמע לטקסט (לחישה)", "textToSpeech": "טקסט לדיבור", "textToSpeechDesc": "המרת טקסט לדיבור בצלילים טבעיים", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "מנחות", "moderationsDesc": "ניהול תוכן וסיווג בטיחות", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "בריאות המערכת", "description": "ניטור בזמן אמת של מופע OmniRoute שלך", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "מגבלות ומכסות", "rateLimit": "מגבלת שיעור", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "ברוך הבא", @@ -2262,6 +2661,12 @@ "errorCount": "{count} שגיאה ({code})", "errorCountNoCode": "{count} שגיאה", "noConnections": "אין קשרים", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "מושבת", "enableProvider": "הפעל ספק", "disableProvider": "השבת את הספק", @@ -2296,7 +2701,6 @@ "errorOccurred": "אירעה שגיאה. אנא נסה שוב.", "modelStatus": "סטטוס דגם", "showConfiguredOnly": "Configured only", - "searchProviders": "חיפוש ספקים...", "allModelsOperational": "כל הדגמים מבצעיים", "modelsWithIssues": "{count} דגמים עם בעיות", "allModelsNormal": "כל הדגמים מגיבים כרגיל.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "פרטים תואמי OpenAI", "messagesApi": "הודעות API", "responsesApi": "API של תגובות", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "השלמת צ'אט", "importingModels": "מייבא...", "importFromModels": "ייבוא מ /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "כל הדגמים כבר מיובאים", "noNewModelsToImport": "אין דגמים חדשים לייבוא — כל הדגמים כבר קיימים ברישום או ברשימת הדגמים המותאמים", "skippingExistingModels": "מדלג על {count} דגמים קיימים", @@ -2373,6 +2782,7 @@ "importFailed": "הייבוא נכשל", "noNewModelsAdded": "לא נוספו דגמים חדשים.", "adding": "מוסיף...", + "close": "Close", "importingModelsTitle": "ייבוא דגמים", "copyModel": "העתק דגם", "filterModels": "סינון מודלים…", @@ -2413,6 +2823,11 @@ "configured": "מוגדר", "providerProxyConfigureHint": "הגדר פרוקסי עבור כל החיבורים של ספק זה", "providerProxy": "פרוקסי של ספק", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "עדיין אין קשרים", "addFirstConnectionHint": "הוסף את החיבור הראשון שלך כדי להתחיל", "addConnection": "הוסף חיבור", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "מזהה דגם", "customModelPlaceholder": "למשל gpt-4.5-טורבו", "loading": "טוען...", @@ -2513,6 +2931,10 @@ "email": "דוא\"ל", "healthCheckMinutes": "בדיקת בריאות (דקה)", "healthCheckHint": "מרווח רענון אסימון פרואקטיבי. 0 = מושבת.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "בדיקת החיבור נכשלה", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnvFailed": "Failed to repair .env", "showEmails": "Show all emails", - "noModelsMatch": "No models match \"{filter}\"", - "deselectAllModels": "Deselect all", - "modelsActiveCount": "{active}/{total} active", - "repairEnvSuccess": "OAuth defaults restored", - "imagesGenerations": "Images Generations", - "embeddings": "Embeddings", - "audioSpeech": "Audio Speech", "hideEmails": "Hide all emails", - "audioTranscriptions": "Audio Transcriptions", - "selectAllModels": "Select all", - "repairEnv": "Repair env", - "repairEnvWorking": "Repairing...", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "חיפוש ספקים...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "הגדרות", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "תמחור", "storage": "אחסון", "policies": "מדיניות", @@ -2749,6 +3164,46 @@ "enablePassword": "אפשר סיסמה", "darkMode": "מצב כהה", "lightMode": "מצב אור", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "רק עכשיו", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "ספקים", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "ערכת נושא של המערכת", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "מטמון TTL", "maxCacheSize": "גודל מטמון מקסימלי", "clearCache": "נקה את המטמון", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "מטמון להיטים", "cacheMisses": "מטמון פספוסים", "hitRate": "שיעור כניסות", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "אפשר חשיבה", "maxThinkingTokens": "מקס חשיבה אסימונים", "enableProxy": "אפשר פרוקסי", @@ -2818,6 +3277,14 @@ "themeLight": "אור", "themeDark": "כהה", "themeSystem": "מערכת", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "הגנת נקודת קצה של API", "requireAuthModels": "דרוש מפתח API עבור /models", "requireAuthModelsDesc": "כאשר מופעל, נקודת הקצה /v1/models מחזירה 404 עבור בקשות לא מאומתות. מונע גילוי מודל על ידי משתמשים לא מורשים.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "ספקים חסומים", "blockedProvidersDesc": "הסתר ספקים ספציפיים מהתגובה /v1/models. ספקים חסומים לא יופיעו ברשימות הדגמים.", "providersBlocked": "{count} ספק(ים) חסומים מ/מודלים", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "בחר חשבון שנעשה בו שימוש לפחות לאחרונה", "costOpt": "אופטימיזציית עלות", "costOptDesc": "העדיפו את החשבון הזול ביותר הזמין", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "גבול דביק", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "אסטרטגיה משולבת", "priority": "עדיפות", "weighted": "משוקלל", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "מקסימום מנסה שוב", "retryDelayLabel": "נסה שוב עיכוב (מילישניות)", "timeoutLabel": "זמן קצוב (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "עומק קינון מקסימלי", "concurrencyPerModel": "במקביל / דגם", "queueTimeout": "זמן קצוב לתור (מילישניות)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "פרופילי ספקים", "providerProfilesDesc": "הגדרות חוסן נפרדות עבור ספקי OAuth (מבוסס הפעלה) ומפתח API (מדוד). לספקי OAuth יש ספים מחמירים יותר בגלל מגבלות תעריפים נמוכות יותר.", "oauthProviders": "ספקי OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "גיבוי נוצר: {file}", "restoreSuccess": "שוחזר! {connections} חיבורים, {nodes} צמתים, {combos} שילובים, {apiKeys} מפתחות API.", "importSuccess": "מסד נתונים מיובא! {connections} חיבורים, {nodes} צמתים, {combos} שילובים, {apiKeys} מפתחות API.", - "justNow": "רק עכשיו", "minutesAgo": "לפני {count}מ'", "hoursAgo": "לפני {count}h", "daysAgo": "לפני {count}d", @@ -3128,7 +3610,6 @@ "errorDuringImport": "אירעה שגיאה במהלך הייבוא", "modelPricing": "תמחור דגם", "modelPricingDesc": "הגדר תעריפי עלות לכל דגם • כל התעריפים באסימונים של $/1M", - "providers": "ספקים", "registry": "רישום", "priced": "במחיר", "searchProvidersModels": "חיפוש ספקים או דגמים...", @@ -3170,47 +3651,6 @@ "editPricing": "ערוך תמחור", "viewFullDetails": "צפה בפרטים המלאים", "themeCoral": "אלמוג", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "שגיאה", "formatConverter": "ממיר פורמטים", "formatConverterDescription": "הדבק או הקלד גוף בקשת JSON. המתרגם יזהה אוטומטית את פורמט המקור וימיר אותו לפורמט היעד. השתמש בזה כדי לנפות באגים כיצד OmniRoute מתרגם בקשות בין פורמטים (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "קלט", "output": "פלט", "auto": "אוטומטי", @@ -3573,6 +4059,11 @@ "errorMessage": "שגיאה: {message}", "requestFailed": "הבקשה נכשלה", "noTextExtracted": "(לא חולץ טקסט)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "מציג אירועי תרגום כאשר קריאות API זורמות דרך OmniRoute. אירועים מגיעים מהמאגר בזיכרון (מתאפסים בהפעלה מחדש). השתמש", "liveMonitorDescriptionSuffix": ", או קריאות API חיצוניות ליצירת אירועים." }, @@ -3648,14 +4139,25 @@ "passSuffix": "לעבור", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "הפעל את Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "פועל {current}/{total}...", "passRate": "שיעור מעבר", "summaryBreakdown": "{passed} עבר · {failed} נכשל · {total} סך הכל", "passedIconLabel": "✅ עבר", "failedIconLabel": "❌ נכשל", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "מכיל: \"{term}\"", "detailsRegex": "ביטוי רגולרי: {pattern}", "detailsExpected": "צפוי: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "עדיין אין תוצאות", "testCasesCount": "מקרי בדיקה ({count})", "noTestCasesDefined": "לא הוגדרו מקרי בדיקה", @@ -3723,6 +4225,16 @@ "tierFree": "חינם", "tierUnknown": "לא ידוע", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "ממתין לאישור נגד כבידה...", "waitingForQoderAuthorization": "ממתין להרשאת Qoder...", "exchangingCodeForTokens": "מחליף קוד לאסימונים...", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "תיעוד", "quickStart": "התחלה מהירה", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "תכונות", "supportedProviders": "ספקים נתמכים", "supportedProvidersToc": "ספקים", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. הגדר את כתובת האתר של בסיס הלקוחות", "quickStartStep4Prefix": "הפנה אל לקוח ה-IDE או ה-API שלך", "quickStartStep4Suffix": "השתמש בקידומת ספק, למשל", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "ניתוב רב ספקים", "featureRoutingText": "נתב בקשות ל-30+ ספקי AI דרך נקודת קצה אחת תואמת OpenAI. תומך בצ'אט, תגובות, אודיו ותמונה API.", "featureCombosTitle": "שילובים ואיזון", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "השתמש", "clientClaudeBullet1Middle": "(קלוד) או", "clientClaudeBullet1Suffix": "קידומת (אנטי כבידה).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "השתמש בלוח מחוונים > ספקים > בדוק חיבור לפני בדיקה מ-IDEs או לקוחות חיצוניים.", "troubleshootingCircuitBreaker": "אם ספק מציג מפסק פתוח, המתן להתקררות או בדוק את דף הבריאות לפרטים.", "troubleshootingOAuth": "עבור ספקי OAuth, בצע אימות מחדש אם פג תוקפם של אסימונים. בדוק את מחוון מצב כרטיס הספק.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "מדיניות פרטיות", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "צ'אט פשוט", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "trendHour": "Hour", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "semanticCache": "Semantic Cache", - "cacheRateDesc": "of total requests", - "activityVolume": "Activity", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "lastUpdated": "Last updated", - "cacheRate": "Cache Rate", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "busiestHour": "Busiest Hour", - "entriesLoadError": "Failed to load semantic cache entries.", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "peakCacheRate": "Peak Cache Rate", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "hoursTracked": "hours tracked", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/hi.json b/src/i18n/messages/hi.json index 6213615420..cd871ae469 100644 --- a/src/i18n/messages/hi.json +++ b/src/i18n/messages/hi.json @@ -23,6 +23,7 @@ "active": "सक्रिय", "inactive": "निष्क्रिय", "noData": "कोई डेटा उपलब्ध नहीं है", + "nothingHere": "Nothing here yet", "configure": "कॉन्फ़िगर करें", "manage": "प्रबंधित करें", "name": "नाम", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Failed to reset pricing", "apikey": "API Key", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "एजेंट", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "दस्तावेज़", "issues": "मुद्दे", "endpoints": "Endpoint", "apiManager": "एपीआई प्रबंधक", "logs": "लॉग", + "webhooks": "__MISSING__:Webhooks", "auditLog": "ऑडिट लॉग", "shutdown": "बंद", "restart": "पुनः प्रारंभ करें", @@ -705,8 +710,6 @@ "cliToolsShort": "उपकरण", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "एवल्स", "utilization": "उपयोग", "utilizationDescription": "प्रदाता कोटा उपयोग रुझान और दर सीमा ट्रैकिंग", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "कॉम्बो स्वास्थ्य", "comboHealthDescription": "कॉम्बो-स्तरीय कोटा, उपयोग वितरण और प्रदर्शन मेट्रिक्स", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "अंतिम: {date}", "editPermissions": "अनुमतियाँ संपादित करें", "deleteKey": "कुंजी हटाएँ", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} मॉडल", "models": "{count} मॉडल", "permissionsTitle": "अनुमतियाँ: {name}", @@ -1188,11 +1296,13 @@ "continue": "IDE में जारी रखें चलाते समय उपयोग करें और आपको पोर्टेबल JSON-आधारित प्रदाता कॉन्फ़िगरेशन की आवश्यकता है।", "opencode": "जब आप ओपनकोड के माध्यम से टर्मिनल-नेटिव एजेंट रन और स्क्रिप्टेड ऑटोमेशन पसंद करते हैं तो इसका उपयोग करें।", "kiro": "किरो को एकीकृत करते समय और ओमनीरूट से केंद्रीय रूप से मॉडल रूटिंग को नियंत्रित करते समय उपयोग करें।", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "इसका उपयोग तब करें जब एंटीग्रेविटी/किरो ट्रैफिक को एमआईटीएम के माध्यम से रोका जाना चाहिए और ओमनीरूट पर भेजा जाना चाहिए।", "copilot": "जब आप ओम्निरूट कुंजी और रूटिंग नियमों को लागू करते समय कोपायलट चैट शैली यूएक्स चाहते हैं तो इसका उपयोग करें।", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "एमआईटीएम के साथ गूगल एंटीग्रेविटी आईडीई", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "अनुक्रमिक फ़ॉलबैक: पहले मॉडल 1 आज़माता है, फिर 2, आदि।", "weightedDesc": "फ़ॉलबैक के साथ ट्रैफ़िक को भार प्रतिशत के आधार पर वितरित करता है", "roundRobinDesc": "परिपत्र वितरण: प्रत्येक अनुरोध रोटेशन में अगले मॉडल पर जाता है", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "समान यादृच्छिक चयन, फिर शेष मॉडलों पर वापस लौटना", "leastUsedDesc": "समय के साथ लोड को संतुलित करते हुए, सबसे कम अनुरोधों वाला मॉडल चुनता है", "costOptimizedDesc": "मूल्य निर्धारण के आधार पर सबसे पहले सबसे सस्ते मॉडल पर रूट करें", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "मॉडल", @@ -1404,6 +1521,13 @@ "retryDelay": "पुनः प्रयास विलंब (एमएस)", "concurrencyPerModel": "समवर्ती/मॉडल", "queueTimeout": "कतार समय समाप्ति (एमएस)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "वैश्विक डिफ़ॉल्ट का उपयोग करने के लिए खाली छोड़ें। ये प्रति-प्रदाता सेटिंग्स को ओवरराइड करते हैं।", "moveUp": "ऊपर बढ़ो", "moveDown": "नीचे जाएँ", @@ -1447,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1461,6 +1590,26 @@ "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Siap menabung?", "readinessDescription": "Tinjau daftar periksa sebelum membuat atau memperbarui kombo ini.", "readinessCheckName": "Nama kombo valid", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,41 +1823,23 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "activeModePack": "Active Mode Pack", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "reviewAccounts": "Accounts", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderTitle": "Build a Combo", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewProviders": "Providers", - "builderModel": "Model", - "weightHealth": "Health", - "weightStability": "Stability", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "emailVisibilityStateOn": "On", "emailVisibilityStateOff": "Off", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "candidatePoolAllProviders": "All providers", - "routerStrategyLabel": "Router Strategy", - "builderBrowseCatalog": "Browse catalog", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { + "basics": { + "label": "Basics", + "description": "Name and starting template" + }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" - }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", @@ -1626,80 +1850,84 @@ "description": "Final validation before saving" } }, - "builderProviderFirst": "Pick provider first", - "reviewNoSteps": "No steps configured", - "contextRelayHandoffThreshold": "Handoff Threshold", - "builderFlowTitle": "Combo Builder Flow", - "builderPinnedAccount": "Pinned Account", - "builderStageLocked": "Locked — complete previous stage first", - "filterDeterministic": "Deterministic", - "candidatePoolLabel": "Candidate Pool", - "contextRelay": "Context Relay", - "reorderHandle": "Drag to reorder", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderAccount": "Account", - "builderAddComboRef": "Add combo reference", - "reviewAdvanced": "Advanced Settings", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderPreview": "Preview", - "noExcludedProviders": "No providers are currently excluded.", - "statusOverview": "Status Overview", - "reviewName": "Name", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "reviewSequence": "Model Sequence", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderComboRefStep": "Add combo reference", - "weightLatencyInv": "Latency", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "weightTierPriority": "Tier", - "modePackLabel": "Mode Pack", - "builderAddStep": "Add step", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderLegacyEntry": "Legacy entry", - "explorationRateLabel": "Exploration Rate", - "filterAll": "All", - "builderStageCurrent": "Current stage", - "filterIntelligent": "Intelligent", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "weightTaskFit": "Task Fit", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "builderStagePending": "Pending", - "budgetCapPlaceholder": "No limit", - "weightQuota": "Quota", - "reviewAgentFlags": "Agent Flags", "builderStageVisited": "Stage completed", - "providerScores": "Provider Scores", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "strategyRules": "Rules (6-Factor Scoring)", - "normalOperation": "Normal Operation", - "builderSelectModel": "Select model", - "builderLoadingProviders": "Loading providers...", - "builderComboRef": "Combo Ref", - "failedReorder": "Failed to reorder models", - "builderSelectProvider": "Select provider", - "weightCostInv": "Cost", - "emailVisibilityStateOn": "On", - "reviewIntelligentTitle": "Intelligent Routing Config", - "candidatePoolEmpty": "No active providers available yet.", - "reviewStrategy": "Strategy", - "reviewComboRefs": "Combo References", - "filterEmptyTitle": "No combos match this strategy filter.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "incidentMode": "Incident Mode", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", "reviewSteps": "Steps", - "excludedProviders": "Excluded Providers" + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "लागत", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "बजट", "totalCost": "कुल लागत", "breakdown": "लागत विच्छेदन", "noData": "कोई लागत डेटा नहीं", "byModel": "मॉडल द्वारा", "byProvider": "प्रदाता द्वारा", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "एपीआई समापन बिंदु", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "ऑडियो फ़ाइलों को टेक्स्ट में ट्रांसक्राइब करें (व्हिस्पर)", "textToSpeech": "पाठ से वाक्", "textToSpeechDesc": "पाठ को प्राकृतिक-ध्वनि वाले भाषण में बदलें", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "संयम", "moderationsDesc": "सामग्री मॉडरेशन और सुरक्षा वर्गीकरण", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "सिस्टम स्वास्थ्य", "description": "आपके ओम्निरूट उदाहरण की वास्तविक समय की निगरानी", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "सीमाएँ और कोटा", "rateLimit": "दर सीमा", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "स्वागत है", @@ -2262,6 +2661,12 @@ "errorCount": "{count} त्रुटि ({code})", "errorCountNoCode": "{count} त्रुटि", "noConnections": "कोई कनेक्शन नहीं", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "विकलांग", "enableProvider": "प्रदाता सक्षम करें", "disableProvider": "प्रदाता को अक्षम करें", @@ -2296,7 +2701,6 @@ "errorOccurred": "एक त्रुटि हुई. कृपया पुन: प्रयास करें।", "modelStatus": "मॉडल स्थिति", "showConfiguredOnly": "Configured only", - "searchProviders": "प्रदाता खोजें...", "allModelsOperational": "सभी मॉडल क्रियाशील", "modelsWithIssues": "मुद्दों के साथ {count} मॉडल", "allModelsNormal": "सभी मॉडल सामान्य रूप से प्रतिक्रिया दे रहे हैं।", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI संगत विवरण", "messagesApi": "संदेश एपीआई", "responsesApi": "प्रतिक्रियाएँ एपीआई", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "चैट समापन", "importingModels": "आयात किया जा रहा है...", "importFromModels": "/मॉडल से आयात करें", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "सभी मॉडल पहले से ही आयातित हैं", "noNewModelsToImport": "आयात करने के लिए कोई नए मॉडल नहीं — सभी मॉडल पहले से ही रजिस्ट्री या कस्टम मॉडल सूची में हैं", "skippingExistingModels": "{count} मौजूदा मॉडल छोड़े जा रहे हैं", @@ -2373,6 +2782,7 @@ "importFailed": "आयात विफल", "noNewModelsAdded": "कोई नया मॉडल नहीं जोड़ा गया.", "adding": "जोड़ा जा रहा है...", + "close": "Close", "importingModelsTitle": "मॉडल आयात करना", "copyModel": "मॉडल कॉपी करें", "filterModels": "मॉडल फ़िल्टर करें…", @@ -2413,6 +2823,11 @@ "configured": "विन्यस्त", "providerProxyConfigureHint": "इस प्रदाता के सभी कनेक्शनों के लिए प्रॉक्सी कॉन्फ़िगर करें", "providerProxy": "प्रदाता प्रॉक्सी", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "अभी तक कोई कनेक्शन नहीं", "addFirstConnectionHint": "आरंभ करने के लिए अपना पहला कनेक्शन जोड़ें", "addConnection": "कनेक्शन जोड़ें", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "मॉडल आईडी", "customModelPlaceholder": "जैसे जीपीटी-4.5-टर्बो", "loading": "लोड हो रहा है...", @@ -2513,6 +2931,10 @@ "email": "ईमेल", "healthCheckMinutes": "स्वास्थ्य जांच (न्यूनतम)", "healthCheckHint": "प्रोएक्टिव टोकन ताज़ा अंतराल। 0 = अक्षम.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "कनेक्शन का परीक्षण करने में विफल", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "noModelsMatch": "No models match \"{filter}\"", - "hideEmails": "Hide all emails", - "imagesGenerations": "Images Generations", - "repairEnvFailed": "Failed to repair .env", - "repairEnvWorking": "Repairing...", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "selectAllModels": "Select all", - "embeddings": "Embeddings", - "deselectAllModels": "Deselect all", - "repairEnv": "Repair env", - "repairEnvSuccess": "OAuth defaults restored", - "audioSpeech": "Audio Speech", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", - "audioTranscriptions": "Audio Transcriptions", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "प्रदाता खोजें...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "सेटिंग्स", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "मूल्य निर्धारण", "storage": "भंडारण", "policies": "नीतियाँ", @@ -2749,6 +3164,46 @@ "enablePassword": "पासवर्ड सक्षम करें", "darkMode": "डार्क मोड", "lightMode": "लाइट मोड", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "अभी अभी", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "प्रदाता", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "सिस्टम थीम", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "कैश टीटीएल", "maxCacheSize": "अधिकतम कैश आकार", "clearCache": "कैश साफ़ करें", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "कैश हिट्स", "cacheMisses": "कैश छूट गया", "hitRate": "हिट दर", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "सोचने को सक्षम करें", "maxThinkingTokens": "मैक्स थिंकिंग टोकन", "enableProxy": "प्रॉक्सी सक्षम करें", @@ -2818,6 +3277,14 @@ "themeLight": "रोशनी", "themeDark": "अंधेरा", "themeSystem": "सिस्टम", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "एपीआई समापन बिंदु सुरक्षा", "requireAuthModels": "/मॉडल के लिए एपीआई कुंजी की आवश्यकता है", "requireAuthModelsDesc": "चालू होने पर, /v1/मॉडल एंडपॉइंट अप्रमाणित अनुरोधों के लिए 404 लौटाता है। अनधिकृत उपयोगकर्ताओं द्वारा मॉडल खोज को रोकता है।", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "अवरुद्ध प्रदाता", "blockedProvidersDesc": "/v1/मॉडल प्रतिक्रिया से विशिष्ट प्रदाताओं को छुपाएं। अवरुद्ध प्रदाता मॉडल सूची में दिखाई नहीं देंगे।", "providersBlocked": "{count} प्रदाता/प्रदाताओं को /मॉडल से अवरोधित किया गया", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "कम से कम हाल ही में उपयोग किया गया खाता चुनें", "costOpt": "लागत विकल्प", "costOptDesc": "सबसे सस्ते उपलब्ध खाते को प्राथमिकता दें", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "चिपचिपी सीमा", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "कॉम्बो रणनीति", "priority": "प्राथमिकता", "weighted": "भारित", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "अधिकतम पुनर्प्रयास", "retryDelayLabel": "पुनः प्रयास विलंब (एमएस)", "timeoutLabel": "टाइमआउट (एमएस)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "अधिकतम नेस्टिंग गहराई", "concurrencyPerModel": "समवर्ती/मॉडल", "queueTimeout": "कतार समय समाप्ति (एमएस)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "प्रदाता प्रोफाइल", "providerProfilesDesc": "OAuth (सत्र-आधारित) और API कुंजी (मीटर्ड) प्रदाताओं के लिए अलग लचीलापन सेटिंग्स। कम दर सीमा के कारण OAuth प्रदाताओं के पास सख्त सीमाएँ हैं।", "oauthProviders": "OAuth प्रदाता", @@ -3113,7 +3596,6 @@ "backupCreated": "बैकअप बनाया गया: {file}", "restoreSuccess": "पुनर्स्थापित! {connections} कनेक्शन, {nodes} नोड्स, {combos} कॉम्बो, {apiKeys} API कुंजियाँ।", "importSuccess": "डेटाबेस आयातित! {connections} कनेक्शन, {nodes} नोड्स, {combos} कॉम्बो, {apiKeys} API कुंजियाँ।", - "justNow": "अभी अभी", "minutesAgo": "{count}m पहले", "hoursAgo": "{count}h पहले", "daysAgo": "{count}दिन पहले", @@ -3128,7 +3610,6 @@ "errorDuringImport": "आयात के दौरान एक त्रुटि उत्पन्न हुई", "modelPricing": "मॉडल मूल्य निर्धारण", "modelPricingDesc": "प्रति मॉडल लागत दरें कॉन्फ़िगर करें • सभी दरें $/1M टोकन में", - "providers": "प्रदाता", "registry": "रजिस्ट्री", "priced": "कीमत", "searchProvidersModels": "प्रदाता या मॉडल खोजें...", @@ -3170,47 +3651,6 @@ "editPricing": "मूल्य निर्धारण संपादित करें", "viewFullDetails": "पूर्ण विवरण देखें", "themeCoral": "कोरल", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "त्रुटि", "formatConverter": "प्रारूप परिवर्तक", "formatConverterDescription": "JSON अनुरोध का मुख्य भाग चिपकाएँ या टाइप करें। अनुवादक स्रोत प्रारूप का स्वतः पता लगाएगा और उसे लक्ष्य प्रारूप में परिवर्तित करेगा। इसका उपयोग डीबग करने के लिए करें कि कैसे ओमनीरूट प्रारूपों के बीच अनुरोधों का अनुवाद करता है (ओपनएआई ↔ क्लाउड ↔ जेमिनी ↔ रिस्पॉन्स एपीआई)।", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "इनपुट", "output": "आउटपुट", "auto": "ऑटो", @@ -3573,6 +4059,11 @@ "errorMessage": "त्रुटि: {message}", "requestFailed": "अनुरोध विफल", "noTextExtracted": "(कोई पाठ नहीं निकाला गया)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "ओमनीरूट के माध्यम से एपीआई कॉल प्रवाह के रूप में अनुवाद घटनाओं को दिखाता है। ईवेंट इन-मेमोरी बफ़र (पुनः आरंभ होने पर रीसेट) से आते हैं। उपयोग करें", "liveMonitorDescriptionSuffix": ", या ईवेंट उत्पन्न करने के लिए बाहरी एपीआई कॉल।" }, @@ -3648,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "चल रहा है {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} उत्तीर्ण · {failed} अनुत्तीर्ण · {total} कुल", "passedIconLabel": "✅उत्तीर्ण", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "इसमें शामिल है: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "अपेक्षित: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "परीक्षण मामले ({count})", "noTestCasesDefined": "No test cases defined", @@ -3723,6 +4225,16 @@ "tierFree": "निःशुल्क", "tierUnknown": "अज्ञात", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3943,8 +4460,8 @@ "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "दस्तावेज़ीकरण", "quickStart": "त्वरित शुरुआत", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "विशेषताएं", "supportedProviders": "समर्थित प्रदाता", "supportedProvidersToc": "प्रदाता", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. क्लाइंट बेस यूआरएल सेट करें", "quickStartStep4Prefix": "अपने आईडीई या एपीआई क्लाइंट को इंगित करें", "quickStartStep4Suffix": "उदाहरण के लिए, प्रदाता उपसर्ग का उपयोग करें", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "बहु-प्रदाता रूटिंग", "featureRoutingText": "एकल OpenAI-संगत एंडपॉइंट के माध्यम से 30+ AI प्रदाताओं को रूट अनुरोध। चैट, प्रतिक्रियाओं, ऑडियो और छवि एपीआई का समर्थन करता है।", "featureCombosTitle": "संयोजन और संतुलन", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "उपयोग करें", "clientClaudeBullet1Middle": "(क्लाउड) या", "clientClaudeBullet1Suffix": "(एंटीग्रेविटी) उपसर्ग।", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "आईडीई या बाहरी क्लाइंट से परीक्षण करने से पहले डैशबोर्ड > प्रदाता > परीक्षण कनेक्शन का उपयोग करें।", "troubleshootingCircuitBreaker": "यदि कोई प्रदाता सर्किट ब्रेकर खुला दिखाता है, तो कूलडाउन की प्रतीक्षा करें या विवरण के लिए स्वास्थ्य पृष्ठ देखें।", "troubleshootingOAuth": "OAuth प्रदाताओं के लिए, यदि टोकन समाप्त हो जाते हैं तो पुनः प्रमाणित करें। प्रदाता कार्ड स्थिति संकेतक की जाँच करें।", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "गोपनीयता नीति", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "semanticCache": "Semantic Cache", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "entriesLoadError": "Failed to load semantic cache entries.", - "peakCacheRate": "Peak Cache Rate", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "activityVolume": "Activity", - "lastUpdated": "Last updated", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "cacheRate": "Cache Rate", - "trendHour": "Hour", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "hoursTracked": "hours tracked", - "cacheRateDesc": "of total requests", - "busiestHour": "Busiest Hour", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/hu.json b/src/i18n/messages/hu.json index 0695fbfa9d..66f53c6956 100644 --- a/src/i18n/messages/hu.json +++ b/src/i18n/messages/hu.json @@ -23,6 +23,7 @@ "active": "Aktív", "inactive": "Inaktív", "noData": "Nincs adat", + "nothingHere": "Nothing here yet", "configure": "Konfigurálás", "manage": "Kezelése", "name": "Név", @@ -137,7 +138,6 @@ "Failed to reset pricing": "Nem sikerült visszaállítani az árakat", "apikey": "API kulcs", "http": "HTTP", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Játszótér", "searchTools": "Search Tools", "agents": "Ügynökök", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumentumok", "issues": "problémák", "endpoints": "Végpontok", "apiManager": "API-kezelő", "logs": "Naplók", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Ellenőrzési napló", "shutdown": "Leállítás", "restart": "Indítsa újra", @@ -705,8 +710,6 @@ "cliToolsShort": "Eszközök", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Témák", "description": "Válasszon egy előre beállított témát, vagy hozzon létre saját témát egyetlen színnel", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Kihasználtság", "utilizationDescription": "Szolgáltatói kvótahasználati trendek és sebességkorlát-követés", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kombo egészsége", "comboHealthDescription": "Kombó szintű kvóta, használateloszlás és teljesítménymutatók", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Utolsó: {date}", "editPermissions": "Engedélyek szerkesztése", "deleteKey": "Kulcs törlése", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modell", "models": "{count} modellek", "permissionsTitle": "Engedélyek: {name}", @@ -1188,11 +1296,13 @@ "continue": "Használja a Continue futtatásakor az IDE-ben, és hordozható JSON-alapú szolgáltatói konfigurációra van szüksége.", "opencode": "Akkor használja, ha a terminál-natív ügynökfuttatásokat és az OpenCode-on keresztüli parancsfájl-automatizálást részesíti előnyben.", "kiro": "Használja a Kiro integrálásához és a modell-útválasztás központi vezérléséhez az OmniRoute-ból.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Akkor használja, ha az Antigravity/Kiro forgalmat MITM-en keresztül kell elfogni, és az OmniRoute-hoz kell irányítani.", "copilot": "Használja, ha másodpilóta csevegési stílusú UX-et szeretne, miközben betartja az OmniRoute kulcsokat és útválasztási szabályokat.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE MITM-mel", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Szekvenciális tartalék: először az 1-es, majd a 2-es modellt próbálja meg stb.", "weightedDesc": "A forgalmat tömegszázalékban osztja el tartalékkal", "roundRobinDesc": "Körkörös eloszlás: minden kérés a következő forgatási modellhez kerül", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Egységes véletlenszerű kiválasztás, majd visszaállás a többi modellhez", "leastUsedDesc": "A legkevesebb kéréssel rendelkező modellt választja, idővel kiegyensúlyozva a terhelést", "costOptimizedDesc": "Először a legolcsóbb modellhez vezet az árak alapján", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modellek", @@ -1404,6 +1521,13 @@ "retryDelay": "Újrapróbálkozás késleltetése (ms)", "concurrencyPerModel": "Egyidejűség / Modell", "queueTimeout": "Sor időtúllépése (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Hagyja üresen a globális alapértelmezések használatához. Ezek felülbírálják a szolgáltatónkénti beállításokat.", "moveUp": "Lépj felfelé", "moveDown": "Mozgás lefelé", @@ -1447,20 +1571,45 @@ "avoid": "Az árképzési adatok hiányoznak vagy elavultak.", "example": "Háttérben végzett vagy kötegelt munkák, ahol az alacsonyabb költséget részesítik előnyben." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "when": "Use when long sessions must survive account rotation without losing the working context." - }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Ready to save?", "readinessDescription": "Review the checklist before creating or updating this combo.", "readinessCheckName": "Combo name is valid", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "reviewIntelligentTitle": "Intelligent Routing Config", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderProvider": "Provider", - "weightTierPriority": "Tier", - "builderComboRefStep": "Add combo reference", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" - }, - "review": { - "description": "Final validation before saving", - "label": "Review" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "normalOperation": "Normal Operation", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "builderStageVisited": "Stage completed", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", - "reorderHandle": "Drag to reorder", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "weightHealth": "Health", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", "reviewStrategy": "Strategy", "reviewSteps": "Steps", - "builderSelectProvider": "Select provider", - "routerStrategyLabel": "Router Strategy", - "candidatePoolAllProviders": "All providers", - "modePackLabel": "Mode Pack", - "builderStagePending": "Pending", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "filterIntelligent": "Intelligent", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelaySummaryModel": "Summary Model", - "builderTitle": "Build a Combo", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "reviewAdvanced": "Advanced Settings", - "emailVisibilityStateOn": "On", - "builderStageCurrent": "Current stage", - "candidatePoolLabel": "Candidate Pool", - "weightTaskFit": "Task Fit", - "builderLegacyEntry": "Legacy entry", - "explorationRateLabel": "Exploration Rate", - "builderBrowseCatalog": "Browse catalog", - "incidentMode": "Incident Mode", - "builderAddStep": "Add step", - "builderFlowTitle": "Combo Builder Flow", - "reviewSequence": "Model Sequence", - "builderStageVisited": "Stage completed", - "noExcludedProviders": "No providers are currently excluded.", - "builderModel": "Model", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "reviewNoSteps": "No steps configured", - "modePackUpdated": "Mode pack updated to {pack}.", - "weightStability": "Stability", - "strategyRules": "Rules (6-Factor Scoring)", - "candidatePoolEmpty": "No active providers available yet.", - "providerScores": "Provider Scores", "reviewAccounts": "Accounts", - "weightQuota": "Quota", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "failedReorder": "Failed to reorder models", - "weightCostInv": "Cost", - "builderPinnedAccount": "Pinned Account", - "weightLatencyInv": "Latency", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "excludedProviders": "Excluded Providers", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "cooldownMinutes": "Cooldown: {minutes}m", - "activeModePack": "Active Mode Pack", "reviewProviders": "Providers", - "builderComboRef": "Combo Ref", - "budgetCapPlaceholder": "No limit", - "builderAccount": "Account", - "statusOverview": "Status Overview", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderAddComboRef": "Add combo reference", - "builderStageLocked": "Locked — complete previous stage first", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelayMaxMessages": "Max Messages For Summary", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderSelectModel": "Select model", - "emailVisibilityStateOff": "Off", - "filterEmptyTitle": "No combos match this strategy filter.", - "filterAll": "All", - "reviewAgentFlags": "Agent Flags", "reviewComboRefs": "Combo References", - "builderPreview": "Preview", - "contextRelayHandoffThreshold": "Handoff Threshold", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderLoadingProviders": "Loading providers...", - "reviewName": "Name", - "contextRelay": "Context Relay", - "filterDeterministic": "Deterministic", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "intelligentPanelTitle": "Intelligent Routing Dashboard" + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Költségek", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Költségvetés", "totalCost": "Teljes költség", "breakdown": "Költségbontás", "noData": "Nincsenek költségadatok", "byModel": "Modell szerint", "byProvider": "Szolgáltató által", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API végpont", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Hangfájlok átírása szöveggé (suttogás)", "textToSpeech": "Text to Speech", "textToSpeechDesc": "Szöveg átalakítása természetes hangzású beszéddé", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderálások", "moderationsDesc": "A tartalom moderálása és biztonsági osztályozása", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Kövesse nyomon és vezérelje a feladatokat a `tasks/get` és `tasks/cancel` használatával.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Rendszer egészsége", "description": "Az OmniRoute példány valós idejű megfigyelése", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Korlátok és kvóták", "rateLimit": "Rate Limit", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Üdvözöljük", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Hiba ({code})", "errorCountNoCode": "{count} Hiba", "noConnections": "Nincsenek kapcsolatok", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Letiltva", "enableProvider": "Szolgáltató engedélyezése", "disableProvider": "Szolgáltató letiltása", @@ -2296,7 +2701,6 @@ "errorOccurred": "Hiba történt. Kérjük, próbálja újra.", "modelStatus": "Modell állapota", "showConfiguredOnly": "Configured only", - "searchProviders": "Keressen szolgáltatók között...", "allModelsOperational": "Minden modell működőképes", "modelsWithIssues": "{count} problémákkal küzdő modell(ek).", "allModelsNormal": "Minden modell normálisan reagál.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-kompatibilis részletek", "messagesApi": "Messages API", "responsesApi": "Válaszok API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Csevegés befejezése", "importingModels": "Importálás...", "importFromModels": "Importálás a /models-ből", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Minden modell már importálva van", "noNewModelsToImport": "Nincs új modell az importáláshoz — minden modell már a nyilvántartásban vagy az egyéni modellek listájában van", "skippingExistingModels": "{count} meglévő modell kihagyása", @@ -2373,6 +2782,7 @@ "importFailed": "Az importálás sikertelen", "noNewModelsAdded": "Nem adtak hozzá új modelleket.", "adding": "Hozzáadás...", + "close": "Close", "importingModelsTitle": "Modellek importálása", "copyModel": "Modell másolása", "filterModels": "Modellek szűrése…", @@ -2413,6 +2823,11 @@ "configured": "konfigurálva", "providerProxyConfigureHint": "Konfigurálja a proxyt a szolgáltató összes kapcsolatához", "providerProxy": "Szolgáltató proxy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Még nincsenek kapcsolatok", "addFirstConnectionHint": "A kezdéshez adja hozzá az első kapcsolatot", "addConnection": "Csatlakozás hozzáadása", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Modellazonosító", "customModelPlaceholder": "pl. gpt-4.5-turbo", "loading": "Betöltés...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "állapotfelmérés (perc)", "healthCheckHint": "Proaktív token frissítési időköz. 0 = letiltva.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Nem sikerült tesztelni a kapcsolatot", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioSpeech": "Audio Speech", - "deselectAllModels": "Deselect all", - "repairEnvFailed": "Failed to repair .env", - "repairEnvWorking": "Repairing...", - "hideEmails": "Hide all emails", - "noModelsMatch": "No models match \"{filter}\"", "showEmails": "Show all emails", - "repairEnvSuccess": "OAuth defaults restored", - "modelsActiveCount": "{active}/{total} active", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnv": "Repair env", - "embeddings": "Embeddings", - "imagesGenerations": "Images Generations", - "audioTranscriptions": "Audio Transcriptions", - "selectAllModels": "Select all", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Keressen szolgáltatók között...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Beállítások elemre", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Árképzés", "storage": "Tárolás", "policies": "Irányelvek", @@ -2749,6 +3164,46 @@ "enablePassword": "Jelszó engedélyezése", "darkMode": "Sötét mód", "lightMode": "Fény mód", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "csak most", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Szolgáltatók", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Rendszer téma", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Gyorsítótár TTL", "maxCacheSize": "Max gyorsítótár mérete", "clearCache": "Törölje a gyorsítótárat", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Gyorsítótár találatai", "cacheMisses": "Gyorsítótár hiányzik", "hitRate": "Hit Rate", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Gondolkodás engedélyezése", "maxThinkingTokens": "Max gondolkodási jelzők", "enableProxy": "Proxy engedélyezése", @@ -2818,6 +3277,14 @@ "themeLight": "Fény", "themeDark": "Sötét", "themeSystem": "Rendszer", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "API-kulcs szükséges a /models-hoz", "requireAuthModelsDesc": "Bekapcsolt állapotban a /v1/models végpont 404-et ad vissza a nem hitelesített kérésekhez. Megakadályozza, hogy illetéktelen felhasználók felfedezzék a modellt.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Letiltott szolgáltatók", "blockedProvidersDesc": "Adott szolgáltatók elrejtése a /v1/models válaszból. A blokkolt szolgáltatók nem jelennek meg a modelllistában.", "providersBlocked": "{count} szolgáltató(k) blokkolva a /models-ből", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Válassza ki a legutóbb használt fiókot", "costOpt": "Költségopt", "costOptDesc": "A legolcsóbb elérhető fiók előnyben részesítése", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Ragadós határ", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Kombinált stratégia", "priority": "Prioritás", "weighted": "Súlyozott", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max újrapróbálkozás", "retryDelayLabel": "Újrapróbálkozás késleltetése (ms)", "timeoutLabel": "Időtúllépés (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maximális beágyazási mélység", "concurrencyPerModel": "Egyidejűség / Modell", "queueTimeout": "Sor időtúllépése (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Szolgáltatói profilok", "providerProfilesDesc": "Különálló rugalmassági beállítások az OAuth (munkamenet alapú) és az API-kulcs (mérős) szolgáltatók számára. Az alacsonyabb díjkorlátok miatt az OAuth-szolgáltatók szigorúbb küszöbértékeket alkalmaznak.", "oauthProviders": "OAuth-szolgáltatók", @@ -3113,7 +3596,6 @@ "backupCreated": "Biztonsági másolat létrehozva: {file}", "restoreSuccess": "Helyreállítva! {connections} kapcsolatok, {nodes} csomópontok, {combos} kombók, {apiKeys} API-kulcsok.", "importSuccess": "Adatbázis importálva! {connections} kapcsolatok, {nodes} csomópontok, {combos} kombók, {apiKeys} API-kulcsok.", - "justNow": "csak most", "minutesAgo": "{count} perce", "hoursAgo": "{count}órája", "daysAgo": "{count}napja", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Hiba történt az importálás során", "modelPricing": "Modell árképzés", "modelPricingDesc": "Költségdíjak konfigurálása modellenként • Minden díj $/1M tokenben", - "providers": "Szolgáltatók", "registry": "Nyilvántartásba", "priced": "Árú", "searchProvidersModels": "Keressen szolgáltatók vagy modellek között...", @@ -3170,47 +3651,6 @@ "editPricing": "Árak szerkesztése", "viewFullDetails": "Teljes részletek megtekintése", "themeCoral": "Korall", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Formátum konverter", "formatConverterDescription": "Illessze be vagy írja be a JSON-kérelem törzsét. A fordító automatikusan felismeri a forrásformátumot, és konvertálja a célformátumra. Használja ezt a hibakereséshez, hogy az OmniRoute hogyan fordítja le a kéréseket a formátumok között (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Bemenet", "output": "Kimenet", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Hiba: {message}", "requestFailed": "A kérés sikertelen", "noTextExtracted": "(Nincs kivonatolva szöveg)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Megjeleníti a fordítási eseményeket, ahogy az API-hívások az OmniRoute-on keresztül áramlanak. Az események a memóriában lévő pufferből származnak (újraindításkor visszaáll). Használja", "liveMonitorDescriptionSuffix": ", vagy külső API-hívások események generálásához." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Fuss Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "{current}/{total} fut...", "passRate": "áthaladási arány", "summaryBreakdown": "{passed} sikeres · {failed} sikertelen · {total} összesen", "passedIconLabel": "✅ Sikerült", "failedIconLabel": "❌ Nem sikerült", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Tartalmazza: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Várható: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Még nincs eredmény", "testCasesCount": "Tesztesetek ({count})", "noTestCasesDefined": "Nincsenek meghatározva tesztesetek", @@ -3723,6 +4225,16 @@ "tierFree": "Ingyenes", "tierUnknown": "Ismeretlen", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3943,9 +4460,9 @@ "waitingForQoderAuthorization": "Várakozás az Qoder engedélyezésére...", "exchangingCodeForTokens": "Kód cseréje tokenre...", "nodeIncompatibleTitle": "Incompatible Node.js Version", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentáció", "quickStart": "Gyors kezdés", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Jellemzők", "supportedProviders": "Támogatott szolgáltatók", "supportedProvidersToc": "Szolgáltatók", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Állítsa be az ügyfélbázis URL-jét", "quickStartStep4Prefix": "Irányítsa az IDE- vagy API-kliensét", "quickStartStep4Suffix": "Használjon például szolgáltatói előtagot", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Többszolgáltatós útválasztás", "featureRoutingText": "A kérések 30+ AI-szolgáltatóhoz irányíthatók egyetlen OpenAI-kompatibilis végponton keresztül. Támogatja a csevegést, a válaszokat, a hang- és kép API-kat.", "featureCombosTitle": "Kombók és egyensúlyozás", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Használja", "clientClaudeBullet1Middle": "(Claude) ill", "clientClaudeBullet1Suffix": "(Antigravitációs) előtag.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Az IDE-kből vagy külső kliensekből történő tesztelés előtt használja az Irányítópult > Szolgáltatók > Kapcsolat tesztelése menüpontot.", "troubleshootingCircuitBreaker": "Ha a szolgáltató azt mutatja, hogy az áramkör megszakítója nyitva van, várja meg a lehűlést, vagy nézze meg az Egészség oldalt a részletekért.", "troubleshootingOAuth": "OAuth-szolgáltatók esetén hitelesítse újra, ha a tokenek lejárnak. Ellenőrizze a szolgáltatói kártya állapotjelzőjét.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Adatvédelmi szabályzat", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Egyszerű csevegés", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "hoursTracked": "hours tracked", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "semanticCache": "Semantic Cache", - "cacheRate": "Cache Rate", - "lastUpdated": "Last updated", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cacheRateDesc": "of total requests", - "trendHour": "Hour", - "cachedRequests24h": "Cached Requests (24h)", - "activityVolume": "Activity", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "peakCacheRate": "Peak Cache Rate", - "busiestHour": "Busiest Hour", - "entriesLoadError": "Failed to load semantic cache entries.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/id.json b/src/i18n/messages/id.json index 2b554d7928..57c1d31f96 100644 --- a/src/i18n/messages/id.json +++ b/src/i18n/messages/id.json @@ -23,6 +23,7 @@ "active": "Aktif", "inactive": "Tidak aktif", "noData": "Tidak ada data yang tersedia", + "nothingHere": "Nothing here yet", "configure": "Konfigurasikan", "manage": "Kelola", "name": "Nama", @@ -137,7 +138,6 @@ "Failed to reset pricing": "Gagal menyetel ulang harga", "apikey": "Kunci API", "http": "HTTP", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agen", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "dokumen", "issues": "Masalah", "endpoints": "Endpoint", "apiManager": "Manajer API", "logs": "Log", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Catatan Audit", "shutdown": "Matikan", "restart": "Mulai ulang", @@ -705,8 +710,6 @@ "cliToolsShort": "Alat", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evaluasi", "utilization": "Pemanfaatan", "utilizationDescription": "Tren penggunaan kuota penyedia dan pelacakan batas tarif", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kesehatan Kombinasi", "comboHealthDescription": "Kuota tingkat kombinasi, distribusi penggunaan, dan metrik kinerja", "compressionAnalyticsTitle": "Compression Analytics", @@ -1192,11 +1296,13 @@ "continue": "Gunakan saat menjalankan Lanjutkan di IDE dan Anda memerlukan konfigurasi penyedia portabel berbasis JSON.", "opencode": "Gunakan saat Anda lebih suka menjalankan agen terminal-asli dan otomatisasi skrip melalui OpenCode.", "kiro": "Gunakan saat mengintegrasikan Kiro dan mengontrol perutean model secara terpusat dari OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Gunakan ketika lalu lintas Antigravitasi/Kiro harus dicegat melalui MITM dan dialihkan ke OmniRoute.", "copilot": "Gunakan saat Anda menginginkan UX gaya obrolan kopilot sambil menerapkan kunci OmniRoute dan aturan perutean.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE Antigravitasi Google dengan MITM", @@ -1213,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1343,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1397,9 +1506,13 @@ "priorityDesc": "Penggantian berurutan: mencoba model 1 terlebih dahulu, lalu 2, dst.", "weightedDesc": "Mendistribusikan lalu lintas berdasarkan persentase bobot dengan fallback", "roundRobinDesc": "Distribusi melingkar: setiap permintaan diteruskan ke model berikutnya secara bergilir", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Pemilihan acak seragam, lalu kembali ke model lainnya", "leastUsedDesc": "Memilih model dengan permintaan paling sedikit, menyeimbangkan beban dari waktu ke waktu", "costOptimizedDesc": "Rutekan ke model termurah terlebih dahulu berdasarkan harga", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Model", @@ -1408,6 +1521,13 @@ "retryDelay": "Penundaan Coba Lagi (md)", "concurrencyPerModel": "Konkurensi / Model", "queueTimeout": "Batas Waktu Antrian (md)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Biarkan kosong untuk menggunakan default global. Ini mengesampingkan pengaturan per penyedia.", "moveUp": "Naik", "moveDown": "Pindah ke bawah", @@ -1451,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1499,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Siap menabung?", "readinessDescription": "Tinjau daftar periksa sebelum membuat atau memperbarui kombo ini.", "readinessCheckName": "Nama kombo valid", @@ -1516,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1559,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1585,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "incidentMode": "Incident Mode", - "builderLoadingProviders": "Loading providers...", - "builderTitle": "Build a Combo", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "reviewSteps": "Steps", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { - "description": "Final validation before saving", - "label": "Review" + "label": "Review", + "description": "Final validation before saving" } }, - "reviewAdvanced": "Advanced Settings", - "builderComboRefStep": "Add combo reference", - "builderProvider": "Provider", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "weightStability": "Stability", - "builderStageCurrent": "Current stage", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "activeModePack": "Active Mode Pack", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderSelectModel": "Select model", - "reviewSequence": "Model Sequence", - "noExcludedProviders": "No providers are currently excluded.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderSelectProvider": "Select provider", - "budgetCapLabel": "Budget Cap (USD / request)", - "excludedProviders": "Excluded Providers", - "builderStagePending": "Pending", - "reviewNoSteps": "No steps configured", - "reviewStrategy": "Strategy", - "candidatePoolEmpty": "No active providers available yet.", - "weightQuota": "Quota", - "budgetCapPlaceholder": "No limit", - "builderStageLocked": "Locked — complete previous stage first", - "failedReorder": "Failed to reorder models", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "weightCostInv": "Cost", - "builderLegacyEntry": "Legacy entry", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "weightHealth": "Health", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "reviewComboRefs": "Combo References", - "weightTierPriority": "Tier", - "statusOverview": "Status Overview", - "explorationRateLabel": "Exploration Rate", - "emailVisibilityStateOn": "On", - "candidatePoolLabel": "Candidate Pool", - "reorderHandle": "Drag to reorder", - "builderModel": "Model", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "reviewIntelligentTitle": "Intelligent Routing Config", - "reviewProviders": "Providers", - "contextRelaySummaryModel": "Summary Model", - "normalOperation": "Normal Operation", - "strategyRules": "Rules (6-Factor Scoring)", - "filterDeterministic": "Deterministic", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderBrowseCatalog": "Browse catalog", - "contextRelayMaxMessages": "Max Messages For Summary", - "weightTaskFit": "Task Fit", - "builderAddStep": "Add step", - "reviewName": "Name", - "providerScores": "Provider Scores", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderPinnedAccount": "Pinned Account", - "builderAddComboRef": "Add combo reference", - "builderAccount": "Account", - "filterIntelligent": "Intelligent", - "contextRelay": "Context Relay", - "builderFlowTitle": "Combo Builder Flow", "builderStageVisited": "Stage completed", - "modePackLabel": "Mode Pack", - "routerStrategyLabel": "Router Strategy", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderPreview": "Preview", - "emailVisibilityStateOff": "Off", - "filterAll": "All", - "builderComboRef": "Combo Ref", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", - "candidatePoolAllProviders": "All providers", - "reviewAgentFlags": "Agent Flags", - "weightLatencyInv": "Latency", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", "reviewAccounts": "Accounts", - "filterEmptyTitle": "No combos match this strategy filter.", - "modePackUpdated": "Mode pack updated to {pack}.", - "contextRelayHandoffThreshold": "Handoff Threshold" + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Biaya", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Anggaran", "totalCost": "Jumlah Biaya", "breakdown": "Rincian Biaya", "noData": "Tidak ada data biaya", "byModel": "Berdasarkan Model", "byProvider": "Oleh Penyedia", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1720,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Titik Akhir API", @@ -1751,6 +2007,8 @@ "audioTranscriptionDesc": "Transkripsikan file audio ke teks (Bisikan)", "textToSpeech": "Teks ke Ucapan", "textToSpeechDesc": "Ubah teks menjadi ucapan yang terdengar alami", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderasi", "moderationsDesc": "Moderasi konten dan klasifikasi keamanan", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1851,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1886,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2030,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Kesehatan Sistem", "description": "Pemantauan instans OmniRoute Anda secara real-time", @@ -2109,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Batas & Kuota", "rateLimit": "Batas Nilai", @@ -2175,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Selamat datang", @@ -2266,6 +2661,12 @@ "errorCount": "{count} Kesalahan ({code})", "errorCountNoCode": "{count} Kesalahan", "noConnections": "Tidak ada koneksi", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Dengan disabilitas", "enableProvider": "Aktifkan penyedia", "disableProvider": "Nonaktifkan penyedia", @@ -2300,7 +2701,6 @@ "errorOccurred": "Terjadi kesalahan. Silakan coba lagi.", "modelStatus": "Status Model", "showConfiguredOnly": "Configured only", - "searchProviders": "Penyedia pencarian...", "allModelsOperational": "Semua model beroperasi", "modelsWithIssues": "{count} model yang bermasalah", "allModelsNormal": "Semua model merespons secara normal.", @@ -2353,9 +2753,14 @@ "openaiCompatibleDetails": "Detail Kompatibel OpenAI", "messagesApi": "API Pesan", "responsesApi": "API Respons", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Penyelesaian Obrolan", "importingModels": "Mengimpor...", "importFromModels": "Impor dari /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Semua model sudah diimpor", "noNewModelsToImport": "Tidak ada model baru untuk diimpor — semua model sudah ada di registri atau daftar model kustom", "skippingExistingModels": "Melewatkan {count} model yang sudah ada", @@ -2377,6 +2782,7 @@ "importFailed": "Impor gagal", "noNewModelsAdded": "Tidak ada model baru yang ditambahkan.", "adding": "Menambahkan...", + "close": "Close", "importingModelsTitle": "Mengimpor Model", "copyModel": "Salin modelnya", "filterModels": "Filter model…", @@ -2417,6 +2823,11 @@ "configured": "dikonfigurasi", "providerProxyConfigureHint": "Konfigurasikan proxy untuk semua koneksi penyedia ini", "providerProxy": "Proksi Penyedia", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Belum ada koneksi", "addFirstConnectionHint": "Tambahkan koneksi pertama Anda untuk memulai", "addConnection": "Tambahkan Koneksi", @@ -2483,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID Model", "customModelPlaceholder": "misalnya gpt-4.5-turbo", "loading": "Memuat...", @@ -2517,6 +2931,10 @@ "email": "Surel", "healthCheckMinutes": "Pemeriksaan Kesehatan (menit)", "healthCheckHint": "Interval penyegaran token proaktif. 0 = dinonaktifkan.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Gagal menguji koneksi", @@ -2541,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "deselectAllModels": "Deselect all", - "repairEnvFailed": "Failed to repair .env", - "modelsActiveCount": "{active}/{total} active", - "audioSpeech": "Audio Speech", - "selectAllModels": "Select all", - "repairEnvWorking": "Repairing...", - "hideEmails": "Hide all emails", - "repairEnv": "Repair env", - "repairEnvSuccess": "OAuth defaults restored", - "embeddings": "Embeddings", "showEmails": "Show all emails", - "imagesGenerations": "Images Generations", - "noModelsMatch": "No models match \"{filter}\"", - "audioTranscriptions": "Audio Transcriptions", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2570,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2580,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2635,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2672,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Penyedia pencarian...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2710,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Pengaturan", @@ -2743,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Harga", "storage": "Penyimpanan", "policies": "Kebijakan", @@ -2753,6 +3164,46 @@ "enablePassword": "Aktifkan Kata Sandi", "darkMode": "Mode Gelap", "lightMode": "Modus Cahaya", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "sekarang", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Penyedia", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema Sistem", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2760,6 +3211,8 @@ "cacheTTL": "Tembolok TTL", "maxCacheSize": "Ukuran Tembolok Maks", "clearCache": "Hapus Tembolok", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache Hit", "cacheMisses": "Cache Hilang", "hitRate": "Tingkat Hit", @@ -2786,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Aktifkan Berpikir", "maxThinkingTokens": "Token Berpikir Maks", "enableProxy": "Aktifkan Proksi", @@ -2822,6 +3277,14 @@ "themeLight": "Ringan", "themeDark": "Gelap", "themeSystem": "Sistem", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2903,6 +3366,14 @@ "apiEndpointProtection": "Perlindungan Titik Akhir API", "requireAuthModels": "Memerlukan kunci API untuk /models", "requireAuthModelsDesc": "Saat AKTIF, titik akhir /v1/models mengembalikan 404 untuk permintaan yang tidak diautentikasi. Mencegah penemuan model oleh pengguna yang tidak sah.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Penyedia yang Diblokir", "blockedProvidersDesc": "Sembunyikan penyedia tertentu dari respons /v1/models. Penyedia yang diblokir tidak akan muncul dalam daftar model.", "providersBlocked": "{count} penyedia diblokir dari /models", @@ -2931,6 +3402,8 @@ "leastUsedDesc": "Pilih akun yang paling jarang digunakan", "costOpt": "Pilihan Biaya", "costOptDesc": "Lebih suka akun termurah yang tersedia", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Batas Lengket", @@ -3022,6 +3495,8 @@ "comboStrategyAria": "Strategi kombo", "priority": "Prioritas", "weighted": "Tertimbang", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Percobaan Ulang Maks", "retryDelayLabel": "Penundaan Coba Lagi (md)", "timeoutLabel": "Batas waktu (md)", @@ -3042,6 +3517,10 @@ "maxNestingDepth": "Kedalaman Sarang Maks", "concurrencyPerModel": "Konkurensi / Model", "queueTimeout": "Batas Waktu Antrian (md)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profil Penyedia", "providerProfilesDesc": "Pisahkan pengaturan ketahanan untuk penyedia OAuth (berbasis sesi) dan Kunci API (terukur). Penyedia OAuth memiliki ambang batas yang lebih ketat karena batas tarif yang lebih rendah.", "oauthProviders": "Penyedia OAuth", @@ -3117,7 +3596,6 @@ "backupCreated": "Cadangan dibuat: {file}", "restoreSuccess": "Dipulihkan! {connections} koneksi, {nodes} node, {combos} kombo, {apiKeys} kunci API.", "importSuccess": "Basis data diimpor! {connections} koneksi, {nodes} node, {combos} kombo, {apiKeys} kunci API.", - "justNow": "sekarang", "minutesAgo": "{count}m yang lalu", "hoursAgo": "{count}jam yang lalu", "daysAgo": "{count}hari yang lalu", @@ -3132,7 +3610,6 @@ "errorDuringImport": "Terjadi kesalahan saat mengimpor", "modelPricing": "Harga Model", "modelPricingDesc": "Konfigurasikan tarif biaya per model • Semua tarif dalam token $/1 juta", - "providers": "Penyedia", "registry": "Registri", "priced": "Harga", "searchProvidersModels": "Penyedia atau model pencarian...", @@ -3174,47 +3651,6 @@ "editPricing": "Sunting Harga", "viewFullDetails": "Lihat Detail Lengkap", "themeCoral": "Koral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3222,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3250,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3299,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3316,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3356,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3371,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3422,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3469,6 +3929,28 @@ "errorShort": "KESALAHAN", "formatConverter": "Konverter Format", "formatConverterDescription": "Tempel atau ketik isi permintaan JSON. Penerjemah akan secara otomatis mendeteksi format sumber dan mengubahnya ke format target. Gunakan ini untuk men-debug bagaimana OmniRoute menerjemahkan permintaan antar format (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Masukan", "output": "Keluaran", "auto": "Otomatis", @@ -3577,6 +4059,11 @@ "errorMessage": "Kesalahan: {message}", "requestFailed": "Permintaan gagal", "noTextExtracted": "(Tidak ada teks yang diekstraksi)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Menampilkan peristiwa terjemahan saat panggilan API mengalir melalui OmniRoute. Acara berasal dari buffer dalam memori (direset saat restart). Gunakan", "liveMonitorDescriptionSuffix": ", atau panggilan API eksternal untuk menghasilkan peristiwa." }, @@ -3652,14 +4139,25 @@ "passSuffix": "lulus", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Jalankan Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Menjalankan {current}/{total}...", "passRate": "tingkat kelulusan", "summaryBreakdown": "{passed} lulus · {failed} gagal · {total} total", "passedIconLabel": "✅ Lulus", "failedIconLabel": "❌ Gagal", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Berisi: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Diharapkan: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Belum ada hasil", "testCasesCount": "Kasus Uji ({count})", "noTestCasesDefined": "Tidak ada kasus uji yang ditentukan", @@ -3727,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Tidak diketahui", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3769,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3782,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3947,8 +4460,8 @@ "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4036,6 +4549,7 @@ "docs": { "title": "Dokumentasi", "quickStart": "Mulai Cepat", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Fitur", "supportedProviders": "Penyedia yang Didukung", "supportedProvidersToc": "Penyedia", @@ -4072,6 +4586,20 @@ "quickStartStep4Title": "4. Tetapkan URL basis klien", "quickStartStep4Prefix": "Arahkan klien IDE atau API Anda ke", "quickStartStep4Suffix": "Gunakan awalan penyedia, misalnya", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Perutean Multi-Penyedia", "featureRoutingText": "Rutekan permintaan ke 30+ penyedia AI melalui satu titik akhir yang kompatibel dengan OpenAI. Mendukung API obrolan, respons, audio, dan gambar.", "featureCombosTitle": "Kombo dan Penyeimbangan", @@ -4116,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Gunakan", "clientClaudeBullet1Middle": "(Claude) atau", "clientClaudeBullet1Suffix": "Awalan (Antigravitasi).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4159,8 +4699,61 @@ "troubleshootingTestConnection": "Gunakan Dasbor > Penyedia > Uji Koneksi sebelum menguji dari IDE atau klien eksternal.", "troubleshootingCircuitBreaker": "Jika penyedia menunjukkan pemutus sirkuit terbuka, tunggu hingga cooldown atau periksa halaman Kesehatan untuk detailnya.", "troubleshootingOAuth": "Untuk penyedia OAuth, autentikasi ulang jika masa berlaku token habis. Periksa indikator status kartu penyedia.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Kebijakan Privasi", @@ -4264,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4341,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4352,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4359,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "activityVolume": "Activity", - "cacheRateDesc": "of total requests", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "peakCacheRate": "Peak Cache Rate", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "trendHour": "Hour", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "cacheRate": "Cache Rate", - "entriesLoadError": "Failed to load semantic cache entries.", - "cachedRequests24h": "Cached Requests (24h)", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticCache": "Semantic Cache", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "hoursTracked": "hours tracked", - "lastUpdated": "Last updated", - "busiestHour": "Busiest Hour", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4609,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4655,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/in.json b/src/i18n/messages/in.json index 001d49628d..aa1c2b04ec 100644 --- a/src/i18n/messages/in.json +++ b/src/i18n/messages/in.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/it.json b/src/i18n/messages/it.json index bdeb16216a..f0da07454f 100644 --- a/src/i18n/messages/it.json +++ b/src/i18n/messages/it.json @@ -23,6 +23,7 @@ "active": "Attivo", "inactive": "Inattivo", "noData": "Nessun dato disponibile", + "nothingHere": "Nothing here yet", "configure": "Configura", "manage": "Maneggio", "name": "Nome", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Impossibile reimpostare i prezzi", "apikey": "Chiave API", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agenti", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Documenti", "issues": "Problemi", "endpoints": "Endpoint", "apiManager": "Gestore API", "logs": "Registri", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Registro di controllo", "shutdown": "Fermare", "restart": "Ricomincia", @@ -705,8 +710,6 @@ "cliToolsShort": "Strumenti", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Valutazioni", "utilization": "Utilizzo", "utilizationDescription": "Tendenze di utilizzo della quota del provider e monitoraggio dei limiti di frequenza", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Salute Combo", "comboHealthDescription": "Quota a livello combo, distribuzione dell'utilizzo e metriche delle prestazioni", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Ultimo: {date}", "editPermissions": "Modifica autorizzazioni", "deleteKey": "Cancella chiave", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modello", "models": "{count} modelli", "permissionsTitle": "Autorizzazioni: {name}", @@ -1188,11 +1296,13 @@ "continue": "Da utilizzare quando si esegue Continue negli IDE ed è necessaria la configurazione portatile del provider basato su JSON.", "opencode": "Utilizzalo quando preferisci l'esecuzione dell'agente nativo del terminale e l'automazione basata su script tramite OpenCode.", "kiro": "Da utilizzare quando si integra Kiro e si controlla l'instradamento del modello centralmente da OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Da utilizzare quando il traffico Antigravity/Kiro deve essere intercettato tramite MITM e instradato a OmniRoute.", "copilot": "Utilizzalo quando desideri un'esperienza utente in stile chat Copilot applicando al tempo stesso le chiavi OmniRoute e le regole di routing.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE Antigravità di Google con MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Fallback sequenziale: prova prima il modello 1, poi il 2 e così via.", "weightedDesc": "Distribuisce il traffico in base alla percentuale di peso con fallback", "roundRobinDesc": "Distribuzione circolare: ogni richiesta va al modello successivo a rotazione", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Selezione casuale uniforme, quindi fallback sui modelli rimanenti", "leastUsedDesc": "Sceglie il modello con meno richieste, bilanciando il carico nel tempo", "costOptimizedDesc": "Percorsi prima verso il modello più economico in base al prezzo", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modelli", @@ -1404,6 +1521,13 @@ "retryDelay": "Ritardo tentativi (ms)", "concurrencyPerModel": "Concorrenza/modello", "queueTimeout": "Timeout coda (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Lascia vuoto per utilizzare le impostazioni predefinite globali. Questi sovrascrivono le impostazioni per provider.", "moveUp": "Vai su", "moveDown": "Spostati giù", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "when": "Use when long sessions must survive account rotation without losing the working context.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." - }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Pronto per salvare?", "readinessDescription": "Rivedi l'elenco di controllo prima di creare o aggiornare questa combinazione.", "readinessCheckName": "Il nome combinato è valido", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", "reorderHandle": "Drag to reorder", - "builderComboRef": "Combo Ref", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { + "basics": { + "label": "Basics", + "description": "Name and starting template" + }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, - "basics": { - "description": "Name and starting template", - "label": "Basics" - }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" } }, - "budgetCapLabel": "Budget Cap (USD / request)", - "reviewIntelligentTitle": "Intelligent Routing Config", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderProviderFirst": "Pick provider first", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "emailVisibilityStateOff": "Off", - "reviewProviders": "Providers", - "builderAddStep": "Add step", - "candidatePoolAllProviders": "All providers", - "builderBrowseCatalog": "Browse catalog", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "strategyRules": "Rules (6-Factor Scoring)", - "builderTitle": "Build a Combo", - "statusOverview": "Status Overview", - "modePackUpdated": "Mode pack updated to {pack}.", - "reviewNoSteps": "No steps configured", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "builderStageCurrent": "Current stage", - "reviewSequence": "Model Sequence", - "filterDeterministic": "Deterministic", - "reviewStrategy": "Strategy", - "builderPreview": "Preview", - "budgetCapPlaceholder": "No limit", - "candidatePoolEmpty": "No active providers available yet.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderFlowTitle": "Combo Builder Flow", - "weightTierPriority": "Tier", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderComboRefStep": "Add combo reference", - "filterEmptyTitle": "No combos match this strategy filter.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "builderSelectModel": "Select model", - "reviewSteps": "Steps", - "cooldownMinutes": "Cooldown: {minutes}m", - "weightQuota": "Quota", - "activeModePack": "Active Mode Pack", - "explorationRateLabel": "Exploration Rate", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "builderAddComboRef": "Add combo reference", - "builderPinnedAccount": "Pinned Account", - "normalOperation": "Normal Operation", - "failedReorder": "Failed to reorder models", - "reviewAgentFlags": "Agent Flags", - "weightTaskFit": "Task Fit", - "builderModel": "Model", - "reviewComboRefs": "Combo References", - "modePackLabel": "Mode Pack", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderAccount": "Account", - "reviewAdvanced": "Advanced Settings", - "filterAll": "All", - "weightHealth": "Health", - "excludedProviders": "Excluded Providers", - "weightStability": "Stability", - "builderProvider": "Provider", - "candidatePoolLabel": "Candidate Pool", - "weightLatencyInv": "Latency", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "filterIntelligent": "Intelligent", - "builderLegacyEntry": "Legacy entry", - "builderSelectProvider": "Select provider", - "incidentMode": "Incident Mode", - "contextRelaySummaryModel": "Summary Model", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderStageLocked": "Locked — complete previous stage first", - "providerScores": "Provider Scores", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "builderLoadingProviders": "Loading providers...", "builderStageVisited": "Stage completed", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", "reviewName": "Name", - "noExcludedProviders": "No providers are currently excluded.", - "emailVisibilityStateOn": "On", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "contextRelay": "Context Relay", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", "reviewAccounts": "Accounts", - "weightCostInv": "Cost", - "routerStrategyLabel": "Router Strategy", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model." + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costi", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Bilancio", "totalCost": "Costo totale", "breakdown": "Ripartizione dei costi", "noData": "Nessun dato sui costi", "byModel": "Per modello", "byProvider": "Per fornitore", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Endpoint API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Trascrivere file audio in testo (Whisper)", "textToSpeech": "Sintesi vocale da testo", "textToSpeechDesc": "Converti il ​​testo in parlato dal suono naturale", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderazioni", "moderationsDesc": "Moderazione dei contenuti e classificazione della sicurezza", "responsesDesc": "API Responses di OpenAI per Codex e workflow agentici avanzati", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Salute del sistema", "description": "Monitoraggio in tempo reale della tua istanza OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limiti e quote", "rateLimit": "Limite di velocità", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Benvenuto", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Errore ({code})", "errorCountNoCode": "{count} Errore", "noConnections": "Nessuna connessione", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabilitato", "enableProvider": "Abilita fornitore", "disableProvider": "Disabilita fornitore", @@ -2296,7 +2701,6 @@ "errorOccurred": "Si è verificato un errore. Per favore riprova.", "modelStatus": "Stato del modello", "showConfiguredOnly": "Configured only", - "searchProviders": "Cerca fornitori...", "allModelsOperational": "Tutti i modelli operativi", "modelsWithIssues": "{count} modelli con problemi", "allModelsNormal": "Tutti i modelli rispondono normalmente.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Dettagli compatibili con OpenAI", "messagesApi": "API dei messaggi", "responsesApi": "API di risposta", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Completamenti della chat", "importingModels": "Importazione...", "importFromModels": "Importa da /modelli", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Tutti i modelli sono già importati", "noNewModelsToImport": "Nessun nuovo modello da importare — tutti i modelli sono già nel registro o nell'elenco dei modelli personalizzati", "skippingExistingModels": "Salto {count} modelli esistenti", @@ -2373,6 +2782,7 @@ "importFailed": "Importazione non riuscita", "noNewModelsAdded": "Non sono stati aggiunti nuovi modelli.", "adding": "Aggiunta...", + "close": "Close", "importingModelsTitle": "Importazione di modelli", "copyModel": "Copia modello", "filterModels": "Filtra modelli…", @@ -2413,6 +2823,11 @@ "configured": "configurato", "providerProxyConfigureHint": "Configura il proxy per tutte le connessioni di questo provider", "providerProxy": "Procura del fornitore", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Nessuna connessione ancora", "addFirstConnectionHint": "Aggiungi la tua prima connessione per iniziare", "addConnection": "Aggiungi connessione", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID modello", "customModelPlaceholder": "per esempio. gpt-4.5-turbo", "loading": "Caricamento...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "Controllo dello stato (min)", "healthCheckHint": "Intervallo di aggiornamento del token proattivo. 0 = disabilitato.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Impossibile testare la connessione", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "imagesGenerations": "Images Generations", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "noModelsMatch": "No models match \"{filter}\"", - "audioTranscriptions": "Audio Transcriptions", - "deselectAllModels": "Deselect all", - "repairEnvSuccess": "OAuth defaults restored", - "modelsActiveCount": "{active}/{total} active", - "selectAllModels": "Select all", - "audioSpeech": "Audio Speech", - "repairEnv": "Repair env", - "repairEnvFailed": "Failed to repair .env", - "hideEmails": "Hide all emails", - "repairEnvWorking": "Repairing...", - "embeddings": "Embeddings", "showEmails": "Show all emails", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Cerca fornitori...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Impostazioni", @@ -2723,6 +3137,23 @@ "systemPrompt": "Richiesta di sistema", "thinkingBudget": "Pensare al bilancio", "proxy": "Procura", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prezzi", "storage": "Magazzinaggio", "policies": "Politiche", @@ -2733,6 +3164,46 @@ "enablePassword": "Abilita password", "darkMode": "Modalità oscura", "lightMode": "Modalità luce", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "proprio adesso", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Fornitori", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema del sistema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "TTL della cache", "maxCacheSize": "Dimensione massima della cache", "clearCache": "Cancella cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Riscontri nella cache", "cacheMisses": "Mancati cache", "hitRate": "Tasso di successo", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Abilita il pensiero", "maxThinkingTokens": "Gettoni pensiero massimo", "enableProxy": "Abilita proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Leggero", "themeDark": "Buio", "themeSystem": "Sistema", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Protezione endpoint API", "requireAuthModels": "Richiedi la chiave API per /models", "requireAuthModelsDesc": "Quando è attivo, l'endpoint /v1/models restituisce 404 per le richieste non autenticate. Impedisce il rilevamento del modello da parte di utenti non autorizzati.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Provider bloccati", "blockedProvidersDesc": "Nascondi provider specifici dalla risposta /v1/models. I fornitori bloccati non verranno visualizzati negli elenchi dei modelli.", "providersBlocked": "{count} provider bloccati da /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Scegli l'account utilizzato meno di recente", "costOpt": "Opzione costo", "costOptDesc": "Preferisci il conto più economico disponibile", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Limite appiccicoso", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Strategia combinata", "priority": "Priorità", "weighted": "Ponderato", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Numero massimo di tentativi", "retryDelayLabel": "Ritardo tentativi (ms)", "timeoutLabel": "Timeout (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Profondità massima di nidificazione", "concurrencyPerModel": "Concorrenza/modello", "queueTimeout": "Timeout coda (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profili dei fornitori", "providerProfilesDesc": "Impostazioni di resilienza separate per i provider OAuth (basati sulla sessione) e API Key (misurati). I fornitori di OAuth hanno soglie più rigide a causa di limiti di velocità inferiori.", "oauthProviders": "Provider OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Backup creato: {file}", "restoreSuccess": "Restaurato! Connessioni {connections}, nodi {nodes}, combo {combos}, chiavi API {apiKeys}.", "importSuccess": "Database importato! Connessioni {connections}, nodi {nodes}, combo {combos}, chiavi API {apiKeys}.", - "justNow": "proprio adesso", "minutesAgo": "{count}m fa", "hoursAgo": "{count}h fa", "daysAgo": "{count}d fa", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Si è verificato un errore durante l'importazione", "modelPricing": "Prezzi del modello", "modelPricingDesc": "Configura le tariffe per modello • Tutte le tariffe in token da $/1 milione", - "providers": "Fornitori", "registry": "Registro", "priced": "Prezzo", "searchProvidersModels": "Cerca fornitori o modelli...", @@ -3154,47 +3651,6 @@ "editPricing": "Modifica prezzi", "viewFullDetails": "Visualizza i dettagli completi", "themeCoral": "Corallo", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Convertitore di formato", "formatConverterDescription": "Incolla o digita il corpo della richiesta JSON. Il traduttore rileverà automaticamente il formato di origine e lo convertirà nel formato di destinazione. Utilizzalo per eseguire il debug del modo in cui OmniRoute traduce le richieste tra formati (OpenAI ↔ Claude ↔ Gemini ↔ API delle risposte).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Ingresso", "output": "Produzione", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Errore: {message}", "requestFailed": "Richiesta non riuscita", "noTextExtracted": "(Nessun testo estratto)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Mostra gli eventi di traduzione mentre le chiamate API fluiscono attraverso OmniRoute. Gli eventi provengono dal buffer in memoria (si ripristina al riavvio). Utilizzo", "liveMonitorDescriptionSuffix": "o chiamate API esterne per generare eventi." }, @@ -3648,14 +4139,25 @@ "passSuffix": "passaggio", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Esegui valutazione", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "In esecuzione {current}/{total}...", "passRate": "tasso di passaggio", "summaryBreakdown": "{passed} superato · {failed} fallito · {total} totale", "passedIconLabel": "✅Superato", "failedIconLabel": "❌ Fallito", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contiene: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Previsto: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Nessun risultato ancora", "testCasesCount": "Casi di test ({count})", "noTestCasesDefined": "Nessun caso di test definito", @@ -3723,6 +4225,16 @@ "tierFree": "Gratuito", "tierUnknown": "Sconosciuto", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Documentazione", "quickStart": "Avvio rapido", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Caratteristiche", "supportedProviders": "Provider supportati", "supportedProvidersToc": "Fornitori", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Imposta l'URL di base del cliente", "quickStartStep4Prefix": "Punta il tuo client IDE o API a", "quickStartStep4Suffix": "Utilizza il prefisso del provider, ad esempio", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Routing multi-provider", "featureRoutingText": "Instrada le richieste a oltre 30 fornitori di intelligenza artificiale attraverso un singolo endpoint compatibile con OpenAI. Supporta API di chat, risposte, audio e immagini.", "featureCombosTitle": "Combo e bilanciamento", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Utilizzo", "clientClaudeBullet1Middle": "(Claude) o", "clientClaudeBullet1Suffix": "(Antigravità).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Utilizza Dashboard > Provider > Verifica connessione prima di effettuare test da IDE o client esterni.", "troubleshootingCircuitBreaker": "Se un fornitore mostra l'interruttore aperto, attendi il raffreddamento o controlla la pagina Salute per i dettagli.", "troubleshootingOAuth": "Per i provider OAuth, eseguire nuovamente l'autenticazione se i token scadono. Controlla l'indicatore di stato della carta del fornitore.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "politica sulla riservatezza", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "hoursTracked": "hours tracked", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "activityVolume": "Activity", - "peakCacheRate": "Peak Cache Rate", - "trendHour": "Hour", - "cacheRateDesc": "of total requests", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "cacheRate": "Cache Rate", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "busiestHour": "Busiest Hour", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "cachedRequests24h": "Cached Requests (24h)", - "lastUpdated": "Last updated", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCache": "Semantic Cache", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ja.json b/src/i18n/messages/ja.json index 6f20f605ad..506cf845ab 100644 --- a/src/i18n/messages/ja.json +++ b/src/i18n/messages/ja.json @@ -23,6 +23,7 @@ "active": "アクティブ", "inactive": "非アクティブ", "noData": "利用可能なデータがありません", + "nothingHere": "Nothing here yet", "configure": "設定する", "manage": "管理する", "name": "名前", @@ -137,9 +138,8 @@ "Failed to reset pricing": "価格設定のリセットに失敗しました", "apikey": "APIキー", "http": "HTTP", - "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "プレイグラウンド", "searchTools": "Search Tools", "agents": "エージェント", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "ドキュメント", "issues": "問題点", "endpoints": "エンドポイント", "apiManager": "APIマネージャー", "logs": "ログ", + "webhooks": "__MISSING__:Webhooks", "auditLog": "監査ログ", "shutdown": "シャットダウン", "restart": "再起動", @@ -705,8 +710,6 @@ "cliToolsShort": "ツール", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "エヴァルス", "utilization": "活用率", "utilizationDescription": "プロバイダーのクォータ使用傾向とレート制限の追跡", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "コンボ健全性", "comboHealthDescription": "コンボレベルのクォータ、使用分布、パフォーマンスメトリクス", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "最後: {date}", "editPermissions": "権限の編集", "deleteKey": "削除キー", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} モデル", "models": "{count} モデル", "permissionsTitle": "権限: {name}", @@ -1188,11 +1296,13 @@ "continue": "IDE で続行を実行し、移植可能な JSON ベースのプロバイダー構成が必要な場合に使用します。", "opencode": "ターミナルネイティブのエージェントの実行と OpenCode によるスクリプトによる自動化を希望する場合に使用します。", "kiro": "Kiro を統合し、OmniRoute からモデルのルーティングを一元的に制御する場合に使用します。", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Antigravity/Kiro トラフィックを MITM 経由でインターセプトし、OmniRoute にルーティングする必要がある場合に使用します。", "copilot": "OmniRoute キーとルーティング ルールを適用しながら、Copilot チャット スタイルの UX が必要な場合に使用します。", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "MITM を備えた Google Antigravity IDE", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "順次フォールバック: 最初にモデル 1、次にモデル 2 というように試行します。", "weightedDesc": "フォールバックを使用して重量パーセントに基づいてトラフィックを分散します。", "roundRobinDesc": "循環分散: 各リクエストはローテーションで次のモデルに送信されます。", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "均一なランダム選択、その後残りのモデルへのフォールバック", "leastUsedDesc": "リクエストが最も少ないモデルを選択し、時間の経過とともに負荷のバランスをとります", "costOptimizedDesc": "価格に基づいて最初に最も安価なモデルにルーティングします", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "モデル", @@ -1404,6 +1521,13 @@ "retryDelay": "再試行遅延 (ミリ秒)", "concurrencyPerModel": "同時実行性 / モデル", "queueTimeout": "キューのタイムアウト (ミリ秒)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "グローバルなデフォルトを使用するには、空のままにします。これらはプロバイダーごとの設定をオーバーライドします。", "moveUp": "上に移動", "moveDown": "下に移動", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." - }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "保存する準備はできましたか?", "readinessDescription": "このコンボを作成または更新する前に、チェックリストを確認してください。", "readinessCheckName": "コンボ名は有効です", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,12 +1823,19 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "explorationRateLabel": "Exploration Rate", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", "builderFlowTitle": "Combo Builder Flow", "builderStage": { "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" + }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { "label": "Strategy", @@ -1596,110 +1845,89 @@ "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "steps": { - "label": "Steps", - "description": "Provider, model, and account selection" - }, "review": { "label": "Review", "description": "Final validation before saving" } }, - "budgetCapLabel": "Budget Cap (USD / request)", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "builderBrowseCatalog": "Browse catalog", - "builderSelectModel": "Select model", - "emailVisibilityStateOff": "Off", - "noExcludedProviders": "No providers are currently excluded.", - "excludedProviders": "Excluded Providers", - "modePackUpdated": "Mode pack updated to {pack}.", - "statusOverview": "Status Overview", - "builderStageLocked": "Locked — complete previous stage first", - "builderPinnedAccount": "Pinned Account", - "reviewIntelligentTitle": "Intelligent Routing Config", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "reviewStrategy": "Strategy", - "normalOperation": "Normal Operation", - "weightStability": "Stability", - "contextRelaySummaryModel": "Summary Model", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "incidentMode": "Incident Mode", - "candidatePoolEmpty": "No active providers available yet.", - "reviewProviders": "Providers", - "strategyRules": "Rules (6-Factor Scoring)", - "builderAddComboRef": "Add combo reference", - "candidatePoolAllProviders": "All providers", - "contextRelay": "Context Relay", - "filterAll": "All", - "weightTaskFit": "Task Fit", - "weightTierPriority": "Tier", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "weightQuota": "Quota", - "builderComboRef": "Combo Ref", - "weightCostInv": "Cost", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "candidatePoolLabel": "Candidate Pool", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "filterIntelligent": "Intelligent", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderStageCurrent": "Current stage", - "weightHealth": "Health", - "builderComboRefStep": "Add combo reference", - "reviewComboRefs": "Combo References", - "builderPreview": "Preview", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderProvider": "Provider", - "reviewSequence": "Model Sequence", - "filterDeterministic": "Deterministic", - "builderProviderFirst": "Pick provider first", - "modePackLabel": "Mode Pack", - "reviewAccounts": "Accounts", - "builderLoadingProviders": "Loading providers...", - "providerScores": "Provider Scores", - "builderModel": "Model", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "failedReorder": "Failed to reorder models", - "builderLegacyEntry": "Legacy entry", - "routerStrategyLabel": "Router Strategy", - "activeModePack": "Active Mode Pack", - "builderStagePending": "Pending", - "reorderHandle": "Drag to reorder", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewAdvanced": "Advanced Settings", - "weightLatencyInv": "Latency", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "reviewSteps": "Steps", - "budgetCapPlaceholder": "No limit", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderAddStep": "Add step", "builderStageVisited": "Stage completed", - "builderAccount": "Account", - "reviewName": "Name", - "builderSelectProvider": "Select provider", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "filterEmptyTitle": "No combos match this strategy filter.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", "reviewAgentFlags": "Agent Flags", - "emailVisibilityStateOn": "On", - "contextRelayMaxMessages": "Max Messages For Summary", + "reviewSequence": "Model Sequence", "reviewNoSteps": "No steps configured", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity." + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "コスト", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "予算", "totalCost": "総コスト", "breakdown": "コストの内訳", "noData": "コストデータなし", "byModel": "モデル別", "byProvider": "プロバイダー別", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "APIエンドポイント", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "音声ファイルをテキストに変換する (Whisper)", "textToSpeech": "テキスト読み上げ", "textToSpeechDesc": "テキストを自然な音声に変換する", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "モデレーション", "moderationsDesc": "コンテンツの管理と安全性の分類", "responsesDesc": "Codexおよび高度なエージェントワークフロー向けOpenAI Responses API", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "エンドポイント プロキシ", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "システムの健全性", "description": "OmniRoute インスタンスのリアルタイム監視", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "制限と割り当て", "rateLimit": "レート制限", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "ようこそ", @@ -2262,6 +2661,12 @@ "errorCount": "{count} エラー ({code})", "errorCountNoCode": "{count} エラー", "noConnections": "接続がありません", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "障害者", "enableProvider": "プロバイダーを有効にする", "disableProvider": "プロバイダーを無効にする", @@ -2296,7 +2701,6 @@ "errorOccurred": "エラーが発生しました。もう一度試してください。", "modelStatus": "モデルステータス", "showConfiguredOnly": "Configured only", - "searchProviders": "プロバイダーを検索...", "allModelsOperational": "全モデル稼働中", "modelsWithIssues": "{count} モデルに問題があります", "allModelsNormal": "全機種正常に反応しております。", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI互換性の詳細", "messagesApi": "メッセージAPI", "responsesApi": "レスポンスAPI", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "チャットの完了", "importingModels": "インポート中...", "importFromModels": "/models からインポート", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "すべてのモデルは既にインポート済みです", "noNewModelsToImport": "インポートする新しいモデルはありません — すべてのモデルは既にレジストリまたはカスタムモデルリストにあります", "skippingExistingModels": "{count}件の既存モデルをスキップ", @@ -2373,6 +2782,7 @@ "importFailed": "インポートに失敗しました", "noNewModelsAdded": "新しいモデルは追加されませんでした。", "adding": "追加中...", + "close": "Close", "importingModelsTitle": "モデルのインポート", "copyModel": "モデルをコピーする", "filterModels": "モデルを絞り込む…", @@ -2413,6 +2823,11 @@ "configured": "設定済み", "providerProxyConfigureHint": "このプロバイダーのすべての接続に対してプロキシを構成します", "providerProxy": "プロバイダープロキシ", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "まだ接続がありません", "addFirstConnectionHint": "最初の接続を追加して開始します", "addConnection": "接続の追加", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "モデルID", "customModelPlaceholder": "例: gpt-4.5-ターボ", "loading": "読み込み中...", @@ -2513,6 +2931,10 @@ "email": "電子メール", "healthCheckMinutes": "ヘルスチェック (分)", "healthCheckHint": "プロアクティブなトークンの更新間隔。 0 = 無効。", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "接続のテストに失敗しました", @@ -2537,25 +2959,10 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "embeddings": "Embeddings", - "repairEnvSuccess": "OAuth defaults restored", - "audioSpeech": "Audio Speech", - "repairEnvWorking": "Repairing...", - "audioTranscriptions": "Audio Transcriptions", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvFailed": "Failed to repair .env", - "imagesGenerations": "Images Generations", "showEmails": "Show all emails", - "repairEnv": "Repair env", - "deselectAllModels": "Deselect all", - "selectAllModels": "Select all", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "modelsActiveCount": "{active}/{total} active", "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "プロバイダーを検索...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "設定", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "価格設定", "storage": "ストレージ", "policies": "ポリシー", @@ -2749,6 +3164,46 @@ "enablePassword": "パスワードを有効にする", "darkMode": "ダークモード", "lightMode": "ライトモード", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "たった今", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "プロバイダー", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "システムテーマ", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "キャッシュTTL", "maxCacheSize": "最大キャッシュサイズ", "clearCache": "キャッシュのクリア", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "キャッシュヒット", "cacheMisses": "キャッシュミス", "hitRate": "命中率", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "思考を可能にする", "maxThinkingTokens": "最大思考トークン", "enableProxy": "プロキシを有効にする", @@ -2818,6 +3277,14 @@ "themeLight": "ライト", "themeDark": "暗い", "themeSystem": "システム", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "APIエンドポイント保護", "requireAuthModels": "/models の API キーが必要です", "requireAuthModelsDesc": "ON の場合、/v1/models エンドポイントは、認証されていないリクエストに対して 404 を返します。権限のないユーザーによるモデルの発見を防ぎます。", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "ブロックされたプロバイダー", "blockedProvidersDesc": "/v1/models 応答から特定のプロバイダーを非表示にします。ブロックされたプロバイダーはモデルのリストに表示されません。", "providersBlocked": "{count} プロバイダーが /models からブロックされました", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "最も最近使用されていないアカウントを選択する", "costOpt": "コストオプション", "costOptDesc": "利用可能な最も安いアカウントを優先する", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "スティッキー制限", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "コンボ戦略", "priority": "優先順位", "weighted": "加重", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "最大再試行回数", "retryDelayLabel": "再試行遅延 (ミリ秒)", "timeoutLabel": "タイムアウト (ミリ秒)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "最大ネスト深さ", "concurrencyPerModel": "同時実行性 / モデル", "queueTimeout": "キューのタイムアウト (ミリ秒)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "プロバイダープロファイル", "providerProfilesDesc": "OAuth (セッションベース) プロバイダーと API キー (従量制) プロバイダーの個別の復元設定。 OAuth プロバイダーには、レート制限が低いため、より厳しいしきい値が設定されています。", "oauthProviders": "OAuthプロバイダー", @@ -3113,7 +3596,6 @@ "backupCreated": "バックアップが作成されました: {file}", "restoreSuccess": "復元されました！ {connections} 接続、{nodes} ノード、{combos} コンボ、{apiKeys} API キー。", "importSuccess": "データベースがインポートされました! {connections} 接続、{nodes} ノード、{combos} コンボ、{apiKeys} API キー。", - "justNow": "たった今", "minutesAgo": "{count}分前", "hoursAgo": "{count}時間前", "daysAgo": "{count}日前", @@ -3128,7 +3610,6 @@ "errorDuringImport": "インポート中にエラーが発生しました", "modelPricing": "モデルの価格", "modelPricingDesc": "モデルごとにコストレートを設定します。すべてのレートは $/1M トークン単位です。", - "providers": "プロバイダー", "registry": "レジストリ", "priced": "価格付き", "searchProvidersModels": "プロバイダーまたはモデルを検索...", @@ -3170,47 +3651,6 @@ "editPricing": "価格の編集", "viewFullDetails": "詳細を表示", "themeCoral": "コーラル", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "エラー", "formatConverter": "フォーマットコンバーター", "formatConverterDescription": "JSON リクエスト本文を貼り付けるか入力します。トランスレータはソース形式を自動検出し、ターゲット形式に変換します。これを使用して、OmniRoute が形式間でリクエストを変換する方法 (OpenAI ↔ Claude ↔ Gemini ↔ Response API) をデバッグします。", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "入力", "output": "出力", "auto": "自動", @@ -3573,6 +4059,11 @@ "errorMessage": "エラー: {message}", "requestFailed": "リクエストが失敗しました", "noTextExtracted": "(テキストは抽出されません)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "API 呼び出しが OmniRoute を通過する際の翻訳イベントを表示します。イベントはメモリ内バッファから取得されます (再起動時にリセットされます)。使用する", "liveMonitorDescriptionSuffix": "、またはイベントを生成するための外部 API 呼び出し。" }, @@ -3648,14 +4139,25 @@ "passSuffix": "パスする", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "評価の実行", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "{current}/{total} を実行中...", "passRate": "合格率", "summaryBreakdown": "{passed} 成功 · {failed} 失敗 · {total} 合計", "passedIconLabel": "✅ 合格", "failedIconLabel": "❌ 失敗しました", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "内容: 「{term}」", "detailsRegex": "正規表現: {pattern}", "detailsExpected": "予期される内容: 「{expected}」", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "まだ結果はありません", "testCasesCount": "テストケース ({count})", "noTestCasesDefined": "テストケースが定義されていません", @@ -3723,6 +4225,16 @@ "tierFree": "無料", "tierUnknown": "不明", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "オムニルート", @@ -4032,6 +4549,7 @@ "docs": { "title": "ドキュメント", "quickStart": "クイックスタート", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "特長", "supportedProviders": "サポートされているプロバイダー", "supportedProvidersToc": "プロバイダー", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. クライアントベースURLの設定", "quickStartStep4Prefix": "IDE または API クライアントを次のように指定します。", "quickStartStep4Suffix": "たとえば、プロバイダーのプレフィックスを使用します。", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "マルチプロバイダールーティング", "featureRoutingText": "単一の OpenAI 互換エンドポイントを通じて 30 以上の AI プロバイダーにリクエストをルーティングします。チャット、応答、音声、画像 API をサポートします。", "featureCombosTitle": "コンボとバランス調整", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "使用する", "clientClaudeBullet1Middle": "（クロード）または", "clientClaudeBullet1Suffix": "(反重力) 接頭辞。", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "IDE または外部クライアントからテストする前に、[ダッシュボード] > [プロバイダー] > [接続のテスト] を使用します。", "troubleshootingCircuitBreaker": "プロバイダーがサーキット ブレーカーが開いていることを示している場合は、クールダウンするまで待つか、詳細について [ヘルス] ページを確認してください。", "troubleshootingOAuth": "OAuth プロバイダーの場合、トークンの有効期限が切れた場合は再認証します。プロバイダー カードのステータス インジケーターを確認します。", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "プライバシーポリシー", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "cachedRequests24h": "Cached Requests (24h)", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "trendHour": "Hour", - "cacheRate": "Cache Rate", - "hoursTracked": "hours tracked", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "activityVolume": "Activity", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "peakCacheRate": "Peak Cache Rate", - "lastUpdated": "Last updated", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "busiestHour": "Busiest Hour", - "semanticCache": "Semantic Cache", - "cacheRateDesc": "of total requests", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ko.json b/src/i18n/messages/ko.json index b0200c0c6f..79cefdd283 100644 --- a/src/i18n/messages/ko.json +++ b/src/i18n/messages/ko.json @@ -23,6 +23,7 @@ "active": "활성", "inactive": "비활성", "noData": "사용 가능한 데이터가 없습니다.", + "nothingHere": "Nothing here yet", "configure": "구성", "manage": "관리하다", "name": "이름", @@ -138,7 +139,6 @@ "apikey": "API 키", "http": "HTTP", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "플레이그라운드", "searchTools": "Search Tools", "agents": "에이전트", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "문서", "issues": "문제", "endpoints": "엔드포인트", "apiManager": "API 관리자", "logs": "로그", + "webhooks": "__MISSING__:Webhooks", "auditLog": "감사 로그", "shutdown": "종료", "restart": "다시 시작", @@ -705,8 +710,6 @@ "cliToolsShort": "도구", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "평가", "utilization": "활용률", "utilizationDescription": "공급자 할당량 사용 추세 및 속도 제한 추적", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "콤보 건강 상태", "comboHealthDescription": "콤보 수준 할당량, 사용 분포 및 성능 메트릭", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "마지막: {date}", "editPermissions": "권한 편집", "deleteKey": "키 삭제", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} 모델", "models": "{count} 모델", "permissionsTitle": "권한: {name}", @@ -1188,11 +1296,13 @@ "continue": "IDE에서 계속을 실행할 때 사용하고 이식 가능한 JSON 기반 공급자 구성이 필요합니다.", "opencode": "OpenCode를 통해 터미널 기반 에이전트 실행 및 스크립트 자동화를 선호할 때 사용하세요.", "kiro": "Kiro를 통합하고 OmniRoute에서 중앙에서 모델 라우팅을 제어할 때 사용합니다.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Antigravity/Kiro 트래픽이 MITM을 통해 가로채어 OmniRoute로 라우팅되어야 하는 경우에 사용합니다.", "copilot": "OmniRoute 키와 라우팅 규칙을 적용하면서 Copilot 채팅 스타일 UX를 원할 때 사용하세요.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "MITM이 포함된 Google 반중력 IDE", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "순차적 폴백: 모델 1을 먼저 시도한 다음 2 등을 시도합니다.", "weightedDesc": "대체 기능을 사용하여 중량 비율로 트래픽을 분산합니다.", "roundRobinDesc": "순환 배포: 각 요청은 교대로 다음 모델로 이동합니다.", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "균일한 무작위 선택 후 나머지 모델로 대체", "leastUsedDesc": "시간이 지남에 따라 로드 밸런싱을 통해 요청이 가장 적은 모델을 선택합니다.", "costOptimizedDesc": "가격을 기준으로 가장 저렴한 모델로 먼저 라우팅", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "모델", @@ -1404,6 +1521,13 @@ "retryDelay": "재시도 지연(ms)", "concurrencyPerModel": "동시성/모델", "queueTimeout": "대기열 시간 초과(밀리초)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "전역 기본값을 사용하려면 비워 두세요. 이는 공급자별 설정을 재정의합니다.", "moveUp": "위로 이동", "moveDown": "아래로 이동", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "when": "Use when long sessions must survive account rotation without losing the working context." + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "저장할 준비가 되셨나요?", "readinessDescription": "이 콤보를 생성하거나 업데이트하기 전에 체크리스트를 검토하세요.", "readinessCheckName": "콤보 이름이 유효합니다.", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "filterAll": "All", - "builderAddComboRef": "Add combo reference", - "cooldownMinutes": "Cooldown: {minutes}m", - "excludedProviders": "Excluded Providers", "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" - }, - "review": { - "label": "Review", - "description": "Final validation before saving" - }, "basics": { "label": "Basics", "description": "Name and starting template" }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" + }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "builderLoadingProviders": "Loading providers...", - "providerScores": "Provider Scores", - "filterDeterministic": "Deterministic", - "weightCostInv": "Cost", - "builderAddStep": "Add step", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "incidentMode": "Incident Mode", - "builderPinnedAccount": "Pinned Account", - "builderProvider": "Provider", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "weightTierPriority": "Tier", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "builderStageVisited": "Stage completed", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", - "reviewAgentFlags": "Agent Flags", - "builderSelectModel": "Select model", - "normalOperation": "Normal Operation", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", "builderBrowseCatalog": "Browse catalog", - "modePackUpdated": "Mode pack updated to {pack}.", - "activeModePack": "Active Mode Pack", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "noExcludedProviders": "No providers are currently excluded.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "weightLatencyInv": "Latency", - "weightStability": "Stability", - "builderComboRefStep": "Add combo reference", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "statusOverview": "Status Overview", - "reviewSteps": "Steps", - "failedReorder": "Failed to reorder models", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", "builderSelectProvider": "Select provider", "builderModel": "Model", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderStageVisited": "Stage completed", - "weightQuota": "Quota", - "builderStageLocked": "Locked — complete previous stage first", - "reviewNoSteps": "No steps configured", - "candidatePoolLabel": "Candidate Pool", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "reviewName": "Name", + "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", - "reviewIntelligentTitle": "Intelligent Routing Config", - "routerStrategyLabel": "Router Strategy", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "weightTaskFit": "Task Fit", - "builderStageCurrent": "Current stage", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "contextRelayMaxMessages": "Max Messages For Summary", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", "reviewAccounts": "Accounts", "reviewProviders": "Providers", - "builderLegacyEntry": "Legacy entry", - "strategyRules": "Rules (6-Factor Scoring)", - "builderPreview": "Preview", - "candidatePoolAllProviders": "All providers", - "builderComboRef": "Combo Ref", - "builderFlowTitle": "Combo Builder Flow", - "builderTitle": "Build a Combo", - "reviewSequence": "Model Sequence", - "filterIntelligent": "Intelligent", - "filterEmptyTitle": "No combos match this strategy filter.", - "budgetCapPlaceholder": "No limit", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "reviewAdvanced": "Advanced Settings", - "weightHealth": "Health", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "candidatePoolEmpty": "No active providers available yet.", - "explorationRateLabel": "Exploration Rate", - "reorderHandle": "Drag to reorder", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "emailVisibilityStateOff": "Off", - "contextRelaySummaryModel": "Summary Model", - "reviewStrategy": "Strategy", "reviewComboRefs": "Combo References", - "modePackLabel": "Mode Pack", - "contextRelay": "Context Relay", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderAccount": "Account" + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "비용", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "예산", "totalCost": "총 비용", "breakdown": "비용 분석", "noData": "비용 데이터 없음", "byModel": "모델별", "byProvider": "공급자별", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API 엔드포인트", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "오디오 파일을 텍스트로 변환(속삭임)", "textToSpeech": "텍스트 음성 변환", "textToSpeechDesc": "텍스트를 자연스러운 음성으로 변환", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "조정", "moderationsDesc": "콘텐츠 조정 및 안전 분류", "responsesDesc": "Codex 및 고급 에이전트 워크플로용 OpenAI Responses API", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "엔드포인트 프록시", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "시스템 상태", "description": "OmniRoute 인스턴스의 실시간 모니터링", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "한도 및 할당량", "rateLimit": "비율 제한", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "환영합니다", @@ -2262,6 +2661,12 @@ "errorCount": "{count} 오류({code})", "errorCountNoCode": "{count} 오류", "noConnections": "연결 없음", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "장애인", "enableProvider": "공급자 활성화", "disableProvider": "공급자 비활성화", @@ -2296,7 +2701,6 @@ "errorOccurred": "오류가 발생했습니다. 다시 시도해 주세요.", "modelStatus": "모델현황", "showConfiguredOnly": "Configured only", - "searchProviders": "공급자 검색...", "allModelsOperational": "모든 모델 작동 가능", "modelsWithIssues": "문제가 있는 {count} 모델", "allModelsNormal": "모든 모델이 정상적으로 반응하고 있습니다.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI 호환 세부정보", "messagesApi": "메시지 API", "responsesApi": "응답 API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "채팅 완료", "importingModels": "가져오는 중...", "importFromModels": "/models에서 가져오기", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "모든 모델이 이미 가져왔습니다", "noNewModelsToImport": "가져올 새 모델 없음 — 모든 모델이 이미 레지스트리 또는 사용자 정의 모델 목록에 있습니다", "skippingExistingModels": "{count}개의 기존 모델 건너뛰기", @@ -2373,6 +2782,7 @@ "importFailed": "가져오기 실패", "noNewModelsAdded": "새로운 모델이 추가되지 않았습니다.", "adding": "추가 중...", + "close": "Close", "importingModelsTitle": "모델 가져오기", "copyModel": "모델 복사", "filterModels": "모델 필터링…", @@ -2413,6 +2823,11 @@ "configured": "구성된", "providerProxyConfigureHint": "이 공급자의 모든 연결에 대한 프록시 구성", "providerProxy": "공급자 프록시", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "아직 연결이 없습니다.", "addFirstConnectionHint": "시작하려면 첫 번째 연결을 추가하세요.", "addConnection": "연결 추가", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "모델 ID", "customModelPlaceholder": "예를 들어 gpt-4.5-터보", "loading": "로드 중...", @@ -2510,11 +2928,13 @@ "save": "저장", "editConnection": "연결 편집", "accountName": "계정 이름", - "accountConcurrencyCapLabel": "Provider 계정 최대 동시 요청 수", - "accountConcurrencyCapHint": "이 provider 계정의 최대 동시 요청 수입니다. 비워 두거나 0으로 설정하면 제한이 없습니다. provider 자체가 부과하는 제한에 먼저 걸리지 않도록 돕습니다.", "email": "이메일", "healthCheckMinutes": "상태 점검(분)", "healthCheckHint": "사전 토큰 새로 고침 간격. 0 = 비활성화됨.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "연결을 테스트하지 못했습니다.", @@ -2539,33 +2959,21 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "noModelsMatch": "No models match \"{filter}\"", - "embeddings": "Embeddings", - "deselectAllModels": "Deselect all", - "modelsActiveCount": "{active}/{total} active", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnvWorking": "Repairing...", - "imagesGenerations": "Images Generations", - "audioSpeech": "Audio Speech", "showEmails": "Show all emails", - "audioTranscriptions": "Audio Transcriptions", - "selectAllModels": "Select all", - "repairEnvFailed": "Failed to repair .env", "hideEmails": "Hide all emails", - "repairEnv": "Repair env", - "repairEnvSuccess": "OAuth defaults restored", "a": "A", + "accountConcurrencyCapHint": "이 provider 계정의 최대 동시 요청 수입니다. 비워 두거나 0으로 설정하면 제한이 없습니다. provider 자체가 부과하는 제한에 먼저 걸리지 않도록 돕습니다.", + "accountConcurrencyCapLabel": "Provider 계정 최대 동시 요청 수", "accountIdHint": "Account Id Hint", "accountIdLabel": "Account Id Label", "accountIdPlaceholder": "Account Id Placeholder", "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "공급자 검색...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "설정", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "가격", "storage": "저장", "policies": "정책", @@ -2749,6 +3164,46 @@ "enablePassword": "비밀번호 활성화", "darkMode": "다크 모드", "lightMode": "라이트 모드", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "지금 막", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "공급자", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "시스템 테마", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "캐시 TTL", "maxCacheSize": "최대 캐시 크기", "clearCache": "캐시 지우기", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "캐시 적중", "cacheMisses": "캐시 미스", "hitRate": "적중률", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "사고 활성화", "maxThinkingTokens": "맥스 씽킹 토큰", "enableProxy": "프록시 활성화", @@ -2818,6 +3277,14 @@ "themeLight": "빛", "themeDark": "어둠", "themeSystem": "시스템", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API 엔드포인트 보호", "requireAuthModels": "/models에 대한 API 키 필요", "requireAuthModelsDesc": "ON인 경우 /v1/models 엔드포인트는 인증되지 않은 요청에 대해 404를 반환합니다. 승인되지 않은 사용자가 모델을 발견하는 것을 방지합니다.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "차단된 제공업체", "blockedProvidersDesc": "/v1/models 응답에서 특정 공급자를 숨깁니다. 차단된 제공업체는 모델 목록에 표시되지 않습니다.", "providersBlocked": "{count} 공급자가 /models에서 차단되었습니다.", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "최근에 가장 적게 사용한 계정 선택", "costOpt": "비용 선택", "costOptDesc": "가장 저렴한 계정을 선호합니다", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "고정 한도", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "콤보 전략", "priority": "우선순위", "weighted": "가중", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "최대 재시도 횟수", "retryDelayLabel": "재시도 지연(ms)", "timeoutLabel": "시간 초과(밀리초)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "최대 중첩 깊이", "concurrencyPerModel": "동시성/모델", "queueTimeout": "대기열 시간 초과(밀리초)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "공급자 프로필", "providerProfilesDesc": "OAuth(세션 기반) 및 API 키(측정) 공급자에 대한 별도의 복원력 설정입니다. OAuth 공급자는 낮은 비율 제한으로 인해 더 엄격한 기준을 적용합니다.", "oauthProviders": "OAuth 제공자", @@ -3052,8 +3535,6 @@ "defaultSafetyNet": "기본 안전망", "rpm": "RPM", "minGap": "민갭", - "comboConcurrencyLabel": "콤보 라운드로빈 모델별 최대 동시 요청 수", - "comboConcurrencyHint": "Combo 라운드로빈에서 모델별 최대 동시 요청 수입니다. 이 설정은 combo 전략에만 적용됩니다.", "maxConcurrent": "최대 동시", "activeLimiters": "활성 리미터", "noActiveLimiters": "아직 활성 속도 제한기가 없습니다.", @@ -3115,7 +3596,6 @@ "backupCreated": "생성된 백업: {file}", "restoreSuccess": "복원되었습니다! {connections} 연결, {nodes} 노드, {combos} 콤보, {apiKeys} API 키.", "importSuccess": "데이터베이스를 가져왔습니다! {connections} 연결, {nodes} 노드, {combos} 콤보, {apiKeys} API 키.", - "justNow": "지금 막", "minutesAgo": "{count}분 전", "hoursAgo": "{count}시간 전", "daysAgo": "{count}일 전", @@ -3130,7 +3610,6 @@ "errorDuringImport": "가져오는 중에 오류가 발생했습니다.", "modelPricing": "모델 가격", "modelPricingDesc": "모델별 비용 구성 • 모든 비용은 $/1M 토큰 단위", - "providers": "공급자", "registry": "레지스트리", "priced": "가격", "searchProvidersModels": "공급자 또는 모델 검색...", @@ -3172,47 +3651,6 @@ "editPricing": "가격 편집", "viewFullDetails": "전체 세부정보 보기", "themeCoral": "코랄", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3220,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3248,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3297,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3314,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3354,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3369,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3420,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3467,6 +3929,28 @@ "errorShort": "오류", "formatConverter": "형식 변환기", "formatConverterDescription": "JSON 요청 본문을 붙여넣거나 입력하세요. 변환기는 소스 형식을 자동으로 감지하여 대상 형식으로 변환합니다. 이를 사용하여 OmniRoute가 형식(OpenAI ← Claude ⇔ Gemini ⇔ Responses API) 간 요청을 변환하는 방법을 디버깅합니다.", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "입력", "output": "출력", "auto": "자동", @@ -3575,6 +4059,11 @@ "errorMessage": "오류: {message}", "requestFailed": "요청 실패", "noTextExtracted": "(텍스트가 추출되지 않았습니다)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "OmniRoute를 통한 API 호출 흐름으로 번역 이벤트를 표시합니다. 이벤트는 메모리 내 버퍼에서 발생합니다(다시 시작 시 재설정). 사용", "liveMonitorDescriptionSuffix": ", 또는 외부 API 호출을 통해 이벤트를 생성합니다." }, @@ -3650,14 +4139,25 @@ "passSuffix": "통과", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "평가 실행", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "{current}/{total} 실행 중...", "passRate": "합격률", "summaryBreakdown": "{passed} 통과 · {failed} 실패 · 총 {total}", "passedIconLabel": "✅ 합격", "failedIconLabel": "❌ 실패", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "포함: \"{term}\"", "detailsRegex": "정규식: {pattern}", "detailsExpected": "예상: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "아직 결과가 없습니다", "testCasesCount": "테스트 케이스({count})", "noTestCasesDefined": "정의된 테스트 사례가 없습니다.", @@ -3725,6 +4225,16 @@ "tierFree": "무료", "tierUnknown": "알 수 없음", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3767,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3780,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3944,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "옴니루트", @@ -4034,6 +4549,7 @@ "docs": { "title": "문서", "quickStart": "빠른 시작", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "특징", "supportedProviders": "지원되는 제공업체", "supportedProvidersToc": "공급자", @@ -4070,6 +4586,20 @@ "quickStartStep4Title": "4. 클라이언트 기본 URL 설정", "quickStartStep4Prefix": "IDE 또는 API 클라이언트를 다음으로 지정하세요.", "quickStartStep4Suffix": "예를 들어 공급자 접두사를 사용하십시오.", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "다중 공급자 라우팅", "featureRoutingText": "단일 OpenAI 호환 엔드포인트를 통해 30개 이상의 AI 공급자에게 요청을 라우팅합니다. 채팅, 응답, 오디오 및 이미지 API를 지원합니다.", "featureCombosTitle": "콤보와 밸런싱", @@ -4114,6 +4644,18 @@ "clientClaudeBullet1Prefix": "사용", "clientClaudeBullet1Middle": "(클로드) 또는", "clientClaudeBullet1Suffix": "(반중력) 접두사.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "프로토콜: MCP 및 A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4157,8 +4699,61 @@ "troubleshootingTestConnection": "IDE 또는 외부 클라이언트에서 테스트하기 전에 대시보드 > 공급자 > 연결 테스트를 사용하세요.", "troubleshootingCircuitBreaker": "공급자가 회로 차단기를 열었다고 표시하는 경우 대기 시간을 기다리거나 상태 페이지에서 자세한 내용을 확인하세요.", "troubleshootingOAuth": "OAuth 공급자의 경우 토큰이 만료되면 다시 인증하세요. 공급자 카드 상태 표시기를 확인하십시오.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "개인 정보 보호 정책", @@ -4262,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4339,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4350,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4357,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "hoursTracked": "hours tracked", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cacheRateDesc": "of total requests", - "activityVolume": "Activity", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "cacheRate": "Cache Rate", - "entriesLoadError": "Failed to load semantic cache entries.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCache": "Semantic Cache", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "peakCacheRate": "Peak Cache Rate", - "busiestHour": "Busiest Hour", - "trendHour": "Hour", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "lastUpdated": "Last updated", - "cachedRequests24h": "Cached Requests (24h)", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4607,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4653,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/mr.json b/src/i18n/messages/mr.json index a05d8fc744..59ba9e74fd 100644 --- a/src/i18n/messages/mr.json +++ b/src/i18n/messages/mr.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ms.json b/src/i18n/messages/ms.json index 2745bbf818..e400b0b48f 100644 --- a/src/i18n/messages/ms.json +++ b/src/i18n/messages/ms.json @@ -23,6 +23,7 @@ "active": "Aktif", "inactive": "Tidak aktif", "noData": "Tiada data tersedia", + "nothingHere": "Nothing here yet", "configure": "Konfigurasikan", "manage": "Urus", "name": "Nama", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Gagal menetapkan semula harga", "apikey": "Kunci API", "http": "HTTP", - "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Ejen", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumen", "issues": "Isu", "endpoints": "Titik Akhir", "apiManager": "Pengurus API", "logs": "Log", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Log Audit", "shutdown": "Tutup", "restart": "Mulakan semula", @@ -705,8 +710,6 @@ "cliToolsShort": "Alat", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Pemanfaatan", "utilizationDescription": "Tren penggunaan kuota pembekal dan penjejakan had kadar", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kesihatan Combo", "comboHealthDescription": "Kuota peringkat combo, pengagihan penggunaan dan metrik prestasi", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Terakhir: {date}", "editPermissions": "Edit kebenaran", "deleteKey": "Padam kunci", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} model", "permissionsTitle": "Kebenaran: {name}", @@ -1188,11 +1296,13 @@ "continue": "Gunakan semasa menjalankan Teruskan dalam IDE dan anda memerlukan konfigurasi pembekal berasaskan JSON mudah alih.", "opencode": "Gunakan apabila anda lebih suka ejen terminal-native run dan automasi skrip melalui OpenCode.", "kiro": "Gunakan apabila menyepadukan Kiro dan mengawal penghalaan model secara berpusat daripada OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Gunakan apabila trafik Antigraviti/Kiro mesti dipintas melalui MITM dan dihalakan ke OmniRoute.", "copilot": "Gunakan apabila anda mahu Copilot gaya sembang UX sambil menguatkuasakan kekunci OmniRoute dan peraturan penghalaan.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE Antigraviti Google dengan MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Saling berurutan: cuba model 1 dahulu, kemudian 2, dsb.", "weightedDesc": "Mengagihkan trafik mengikut peratusan berat dengan sandaran", "roundRobinDesc": "Pengedaran pekeliling: setiap permintaan pergi ke model seterusnya secara bergilir", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Pemilihan rawak seragam, kemudian sandarkan kepada model yang tinggal", "leastUsedDesc": "Memilih model dengan permintaan paling sedikit, mengimbangi beban dari semasa ke semasa", "costOptimizedDesc": "Laluan ke model termurah dahulu berdasarkan harga", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "model", @@ -1404,6 +1521,13 @@ "retryDelay": "Cuba Semula Kelewatan (ms)", "concurrencyPerModel": "Concurrency / Model", "queueTimeout": "Waktu Beratur (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Biarkan kosong untuk menggunakan lalai global. Ini mengatasi tetapan setiap pembekal.", "moveUp": "Bergerak ke atas", "moveDown": "Bergerak ke bawah", @@ -1447,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1458,9 +1587,29 @@ "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Bersedia untuk menyimpan?", "readinessDescription": "Semak senarai semak sebelum membuat atau mengemas kini kombo ini.", "readinessCheckName": "Nama kombo adalah sah", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "explorationRateLabel": "Exploration Rate", - "contextRelayMaxMessages": "Max Messages For Summary", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "basics": { - "description": "Name and starting template", - "label": "Basics" - }, - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" } }, - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "builderComboRefStep": "Add combo reference", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderFlowTitle": "Combo Builder Flow", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewAccounts": "Accounts", - "builderAddStep": "Add step", - "strategyRules": "Rules (6-Factor Scoring)", - "statusOverview": "Status Overview", - "reviewNoSteps": "No steps configured", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewAgentFlags": "Agent Flags", - "reviewComboRefs": "Combo References", - "budgetCapPlaceholder": "No limit", - "builderStagePending": "Pending", - "modePackUpdated": "Mode pack updated to {pack}.", - "weightLatencyInv": "Latency", - "emailVisibilityStateOff": "Off", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewIntelligentTitle": "Intelligent Routing Config", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "incidentMode": "Incident Mode", - "builderPinnedAccount": "Pinned Account", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderAddComboRef": "Add combo reference", - "budgetCapLabel": "Budget Cap (USD / request)", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "cooldownMinutes": "Cooldown: {minutes}m", - "filterAll": "All", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "reviewProviders": "Providers", - "providerScores": "Provider Scores", - "reviewSequence": "Model Sequence", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "modePackLabel": "Mode Pack", - "normalOperation": "Normal Operation", "builderStageVisited": "Stage completed", - "builderProviderFirst": "Pick provider first", - "builderLegacyEntry": "Legacy entry", - "reorderHandle": "Drag to reorder", - "filterIntelligent": "Intelligent", - "activeModePack": "Active Mode Pack", - "contextRelay": "Context Relay", - "filterEmptyTitle": "No combos match this strategy filter.", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "candidatePoolLabel": "Candidate Pool", - "reviewSteps": "Steps", - "weightHealth": "Health", - "builderTitle": "Build a Combo", - "candidatePoolAllProviders": "All providers", - "builderSelectProvider": "Select provider", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "builderComboRef": "Combo Ref", - "weightTaskFit": "Task Fit", "builderStageCurrent": "Current stage", - "builderBrowseCatalog": "Browse catalog", - "filterDeterministic": "Deterministic", - "builderModel": "Model", + "builderStagePending": "Pending", "builderStageLocked": "Locked — complete previous stage first", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "emailVisibilityStateOn": "On", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "weightTierPriority": "Tier", - "builderAccount": "Account", - "builderSelectModel": "Select model", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "reviewStrategy": "Strategy", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "weightCostInv": "Cost", - "excludedProviders": "Excluded Providers", - "reviewName": "Name", - "weightQuota": "Quota", - "contextRelayHandoffThreshold": "Handoff Threshold", - "candidatePoolEmpty": "No active providers available yet.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", "reviewAdvanced": "Advanced Settings", - "weightStability": "Stability", - "noExcludedProviders": "No providers are currently excluded.", - "routerStrategyLabel": "Router Strategy", - "failedReorder": "Failed to reorder models", - "builderPreview": "Preview" + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kos", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Bajet", "totalCost": "Jumlah Kos", "breakdown": "Pecahan Kos", "noData": "Tiada data kos", "byModel": "Mengikut Model", "byProvider": "Oleh Pembekal", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Titik Akhir API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transkripsikan fail audio kepada teks (Bisikan)", "textToSpeech": "Teks kepada Ucapan", "textToSpeechDesc": "Tukar teks kepada pertuturan yang berbunyi semula jadi", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Kesederhanaan", "moderationsDesc": "Penyederhanaan kandungan dan klasifikasi keselamatan", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Jejak dan kawal tugas menggunakan `tasks/get` dan `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Kesihatan Sistem", "description": "Pemantauan masa nyata bagi tika OmniRoute anda", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Had & Kuota", "rateLimit": "Had Kadar", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Selamat datang", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Ralat ({code})", "errorCountNoCode": "{count} Ralat", "noConnections": "Tiada sambungan", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Dilumpuhkan", "enableProvider": "Dayakan pembekal", "disableProvider": "Lumpuhkan pembekal", @@ -2296,7 +2701,6 @@ "errorOccurred": "Ralat berlaku. Sila cuba lagi.", "modelStatus": "Status Model", "showConfiguredOnly": "Configured only", - "searchProviders": "Cari pembekal...", "allModelsOperational": "Semua model beroperasi", "modelsWithIssues": "{count} model dengan isu", "allModelsNormal": "Semua model bertindak balas secara normal.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Butiran Serasi OpenAI", "messagesApi": "API Messages", "responsesApi": "API Respons", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Selesai Sembang", "importingModels": "Mengimport...", "importFromModels": "Import daripada /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Semua model sudah diimport", "noNewModelsToImport": "Tiada model baru untuk diimport — semua model sudah ada dalam registri atau senarai model tersuai", "skippingExistingModels": "Melangkau {count} model sedia ada", @@ -2373,6 +2782,7 @@ "importFailed": "Import gagal", "noNewModelsAdded": "Tiada model baharu ditambahkan.", "adding": "Menambah...", + "close": "Close", "importingModelsTitle": "Mengimport Model", "copyModel": "Salin model", "filterModels": "Tapis model…", @@ -2413,6 +2823,11 @@ "configured": "dikonfigurasikan", "providerProxyConfigureHint": "Konfigurasikan proksi untuk semua sambungan pembekal ini", "providerProxy": "Proksi Pembekal", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Tiada sambungan lagi", "addFirstConnectionHint": "Tambahkan sambungan pertama anda untuk bermula", "addConnection": "Tambah Sambungan", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID model", "customModelPlaceholder": "cth. gpt-4.5-turbo", "loading": "Memuatkan...", @@ -2513,6 +2931,10 @@ "email": "E-mel", "healthCheckMinutes": "Pemeriksaan Kesihatan (min)", "healthCheckHint": "Selang penyegaran token proaktif. 0 = kurang upaya.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Gagal menguji sambungan", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "noModelsMatch": "No models match \"{filter}\"", - "deselectAllModels": "Deselect all", - "selectAllModels": "Select all", - "repairEnvFailed": "Failed to repair .env", - "audioSpeech": "Audio Speech", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "audioTranscriptions": "Audio Transcriptions", - "embeddings": "Embeddings", - "modelsActiveCount": "{active}/{total} active", - "repairEnvWorking": "Repairing...", - "imagesGenerations": "Images Generations", - "hideEmails": "Hide all emails", - "repairEnvSuccess": "OAuth defaults restored", "showEmails": "Show all emails", - "repairEnv": "Repair env", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Cari pembekal...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "tetapan", @@ -2723,6 +3137,23 @@ "systemPrompt": "Gesaan Sistem", "thinkingBudget": "Belanjawan Berfikir", "proxy": "proksi", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "penentuan harga", "storage": "Penyimpanan", "policies": "dasar", @@ -2733,6 +3164,46 @@ "enablePassword": "Dayakan Kata Laluan", "darkMode": "Mod Gelap", "lightMode": "Mod Cahaya", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "tadi", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Pembekal", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema Sistem", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Saiz Cache Maks", "clearCache": "Kosongkan Cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache Hits", "cacheMisses": "Cache Rindu", "hitRate": "Kadar Hit", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Dayakan Berfikir", "maxThinkingTokens": "Token Pemikiran Maks", "enableProxy": "Dayakan Proksi", @@ -2802,6 +3277,14 @@ "themeLight": "Cahaya", "themeDark": "Gelap", "themeSystem": "Sistem", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Perlindungan Titik Akhir API", "requireAuthModels": "Memerlukan kunci API untuk /models", "requireAuthModelsDesc": "Apabila HIDUP, titik akhir /v1/models mengembalikan 404 untuk permintaan yang tidak disahkan. Menghalang penemuan model oleh pengguna yang tidak dibenarkan.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Penyedia yang disekat", "blockedProvidersDesc": "Sembunyikan pembekal tertentu daripada respons /v1/models. Penyedia yang disekat tidak akan muncul dalam penyenaraian model.", "providersBlocked": "{count} pembekal disekat daripada /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Pilih akaun yang paling kurang digunakan baru-baru ini", "costOpt": "Pilihan Kos", "costOptDesc": "Pilih akaun termurah yang tersedia", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Had Melekit", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Strategi kombo", "priority": "Keutamaan", "weighted": "Ditimbang", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max Cuba Semula", "retryDelayLabel": "Cuba Semula Kelewatan (ms)", "timeoutLabel": "Tamat masa (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Kedalaman Bersarang Maks", "concurrencyPerModel": "Concurrency / Model", "queueTimeout": "Waktu Beratur (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profil Pembekal", "providerProfilesDesc": "Tetapan daya tahan yang berasingan untuk pembekal OAuth (berasaskan sesi) dan Kunci API (bermeter). Pembekal OAuth mempunyai ambang yang lebih ketat disebabkan oleh had kadar yang lebih rendah.", "oauthProviders": "Pembekal OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Sandaran dibuat: {file}", "restoreSuccess": "Dipulihkan! {connections} sambungan, {nodes} nod, {combos} gabungan, {apiKeys} kunci API.", "importSuccess": "Pangkalan data diimport! {connections} sambungan, {nodes} nod, {combos} gabungan, {apiKeys} kunci API.", - "justNow": "tadi", "minutesAgo": "{count}m yang lalu", "hoursAgo": "{count}j lalu", "daysAgo": "{count}h yang lalu", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Ralat berlaku semasa import", "modelPricing": "Harga Model", "modelPricingDesc": "Konfigurasikan kadar kos setiap model • Semua kadar dalam token $/1J", - "providers": "Pembekal", "registry": "Pendaftaran", "priced": "Berharga", "searchProvidersModels": "Cari pembekal atau model...", @@ -3154,47 +3651,6 @@ "editPricing": "Edit Harga", "viewFullDetails": "Lihat Butiran Penuh", "themeCoral": "Koral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Penukar Format", "formatConverterDescription": "Tampal atau taip badan permintaan JSON. Penterjemah akan mengesan format sumber secara automatik dan menukarnya kepada format sasaran. Gunakan ini untuk nyahpepijat cara OmniRoute menterjemah permintaan antara format (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Keluaran", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Ralat: {message}", "requestFailed": "Permintaan gagal", "noTextExtracted": "(Tiada teks diekstrak)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Menunjukkan peristiwa terjemahan semasa panggilan API mengalir melalui OmniRoute. Peristiwa datang daripada penimbal dalam memori (ditetapkan semula semasa dimulakan semula). guna", "liveMonitorDescriptionSuffix": ", atau panggilan API luaran untuk menjana acara." }, @@ -3648,14 +4139,25 @@ "passSuffix": "lulus", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Lari Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Menjalankan {current}/{total}...", "passRate": "kadar lulus", "summaryBreakdown": "{passed} lulus · {failed} gagal · {total} jumlah", "passedIconLabel": "✅ Lulus", "failedIconLabel": "❌ Gagal", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Mengandungi: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Dijangka: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Tiada keputusan lagi", "testCasesCount": "Kes Ujian ({count})", "noTestCasesDefined": "Tiada kes ujian ditentukan", @@ -3723,6 +4225,16 @@ "tierFree": "Percuma", "tierUnknown": "Tidak diketahui", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Menunggu kebenaran Antigraviti...", "waitingForQoderAuthorization": "Menunggu kebenaran Qoder...", "exchangingCodeForTokens": "Bertukar kod untuk token...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentasi", "quickStart": "Mula Pantas", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Ciri-ciri", "supportedProviders": "Pembekal yang Disokong", "supportedProvidersToc": "Pembekal", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Tetapkan URL asas pelanggan", "quickStartStep4Prefix": "Halakan klien IDE atau API anda", "quickStartStep4Suffix": "Gunakan awalan pembekal, sebagai contoh", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Penghalaan Berbilang Penyedia", "featureRoutingText": "Halakan permintaan kepada 30+ pembekal AI melalui satu titik akhir serasi OpenAI. Menyokong sembang, respons, audio dan API imej.", "featureCombosTitle": "Kombo dan Pengimbangan", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "guna", "clientClaudeBullet1Middle": "(Claude) atau", "clientClaudeBullet1Suffix": "(Antigraviti) awalan.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Gunakan Papan Pemuka > Pembekal > Uji Sambungan sebelum menguji daripada IDE atau pelanggan luaran.", "troubleshootingCircuitBreaker": "Jika pembekal menunjukkan pemutus litar terbuka, tunggu masa bertenang atau semak halaman Kesihatan untuk mendapatkan butiran.", "troubleshootingOAuth": "Untuk pembekal OAuth, sahkan semula jika token tamat tempoh. Semak penunjuk status kad pembekal.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Dasar Privasi", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Sembang Mudah", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCache": "Semantic Cache", - "trendHour": "Hour", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "busiestHour": "Busiest Hour", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "hoursTracked": "hours tracked", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "cacheRate": "Cache Rate", - "activityVolume": "Activity", - "cacheRateDesc": "of total requests", - "peakCacheRate": "Peak Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "lastUpdated": "Last updated", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/nl.json b/src/i18n/messages/nl.json index a72d112ff3..937568c659 100644 --- a/src/i18n/messages/nl.json +++ b/src/i18n/messages/nl.json @@ -23,6 +23,7 @@ "active": "Actief", "inactive": "Inactief", "noData": "Geen gegevens beschikbaar", + "nothingHere": "Nothing here yet", "configure": "Configureer", "manage": "Beheer", "name": "Naam", @@ -139,7 +140,6 @@ "http": "HTTP", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Speeltuin", "searchTools": "Search Tools", "agents": "Agenten", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Documenten", "issues": "Problemen", "endpoints": "Eindpunten", "apiManager": "API-beheerder", "logs": "Logboeken", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Auditlogboek", "shutdown": "Afsluiten", "restart": "Opnieuw opstarten", @@ -705,8 +710,6 @@ "cliToolsShort": "Gereedschap", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Benutting", "utilizationDescription": "Trends in quotagebruik van de provider en bijhouden van snelheidslimieten", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Combo-gezondheid", "comboHealthDescription": "Quota op combo-niveau, gebruiksdistributie en prestatiegegevens", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Laatste: {date}", "editPermissions": "Machtigingen bewerken", "deleteKey": "Sleutel verwijderen", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count}-model", "models": "{count} modellen", "permissionsTitle": "Machtigingen: {name}", @@ -1188,11 +1296,13 @@ "continue": "Gebruik dit wanneer u Doorgaan in IDE's uitvoert en u een draagbare, op JSON gebaseerde providerconfiguratie nodig hebt.", "opencode": "Gebruik dit wanneer u de voorkeur geeft aan terminal-native agentruns en scriptautomatisering via OpenCode.", "kiro": "Te gebruiken bij het integreren van Kiro en het centraal beheren van modelrouting vanuit OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Gebruik wanneer Antigravity/Kiro-verkeer moet worden onderschept via MITM en naar OmniRoute moet worden gerouteerd.", "copilot": "Gebruik wanneer u UX in Copilot-chatstijl wilt terwijl u OmniRoute-sleutels en routeringsregels afdwingt.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE met MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sequentiële fallback: probeert eerst model 1, dan 2, etc.", "weightedDesc": "Verdeelt verkeer op basis van gewichtspercentage met terugval", "roundRobinDesc": "Circulaire distributie: elke aanvraag gaat roulerend naar het volgende model", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Uniforme willekeurige selectie en vervolgens terugvallen op de resterende modellen", "leastUsedDesc": "Kiest het model met de minste verzoeken, waarbij de belasting in de loop van de tijd wordt verdeeld", "costOptimizedDesc": "Routes eerst naar het goedkoopste model op basis van prijzen", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modellen", @@ -1404,6 +1521,13 @@ "retryDelay": "Vertraging opnieuw proberen (ms)", "concurrencyPerModel": "Gelijktijdigheid / model", "queueTimeout": "Wachtrijtime-out (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Laat leeg om globale standaardwaarden te gebruiken. Deze overschrijven de instellingen per provider.", "moveUp": "Ga omhoog", "moveDown": "Ga naar beneden", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Klaar om te besparen?", "readinessDescription": "Bekijk de checklist voordat u deze combo maakt of bijwerkt.", "readinessCheckName": "Combinatienaam is geldig", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderTitle": "Build a Combo", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "weightTierPriority": "Tier", - "reviewAccounts": "Accounts", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "weightLatencyInv": "Latency", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "reviewAdvanced": "Advanced Settings", - "reviewName": "Name", - "weightQuota": "Quota", - "modePackLabel": "Mode Pack", - "noExcludedProviders": "No providers are currently excluded.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", "reorderHandle": "Drag to reorder", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "review": { - "description": "Final validation before saving", - "label": "Review" - }, - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, - "basics": { - "label": "Basics", - "description": "Name and starting template" - }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "builderProvider": "Provider", - "reviewNoSteps": "No steps configured", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "reviewIntelligentTitle": "Intelligent Routing Config", - "activeModePack": "Active Mode Pack", - "builderComboRef": "Combo Ref", - "builderComboRefStep": "Add combo reference", - "builderPreview": "Preview", - "reviewStrategy": "Strategy", - "builderStageLocked": "Locked — complete previous stage first", - "budgetCapPlaceholder": "No limit", - "builderProviderFirst": "Pick provider first", - "reviewProviders": "Providers", - "incidentMode": "Incident Mode", - "reviewSteps": "Steps", - "weightStability": "Stability", - "filterDeterministic": "Deterministic", - "budgetCapLabel": "Budget Cap (USD / request)", - "candidatePoolAllProviders": "All providers", - "builderSelectModel": "Select model", - "routerStrategyLabel": "Router Strategy", - "filterIntelligent": "Intelligent", - "builderLegacyEntry": "Legacy entry", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "filterEmptyTitle": "No combos match this strategy filter.", - "providerScores": "Provider Scores", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "candidatePoolEmpty": "No active providers available yet.", - "normalOperation": "Normal Operation", - "contextRelaySummaryModel": "Summary Model", - "builderAccount": "Account", - "failedReorder": "Failed to reorder models", - "reviewSequence": "Model Sequence", "builderStageVisited": "Stage completed", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "excludedProviders": "Excluded Providers", - "builderModel": "Model", - "builderAddComboRef": "Add combo reference", - "builderStagePending": "Pending", - "builderPinnedAccount": "Pinned Account", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "weightCostInv": "Cost", - "weightTaskFit": "Task Fit", - "contextRelay": "Context Relay", - "statusOverview": "Status Overview", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderAddStep": "Add step", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderLoadingProviders": "Loading providers...", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderSelectProvider": "Select provider", - "filterAll": "All", - "builderBrowseCatalog": "Browse catalog", "builderStageCurrent": "Current stage", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "explorationRateLabel": "Exploration Rate", - "builderFlowTitle": "Combo Builder Flow", - "reviewAgentFlags": "Agent Flags", - "emailVisibilityStateOff": "Off", - "strategyRules": "Rules (6-Factor Scoring)", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", "reviewComboRefs": "Combo References", - "candidatePoolLabel": "Candidate Pool", - "emailVisibilityStateOn": "On", - "contextRelayHandoffThreshold": "Handoff Threshold", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "cooldownMinutes": "Cooldown: {minutes}m", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "weightHealth": "Health" + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kosten", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Begroting", "totalCost": "Totale kosten", "breakdown": "Kostenverdeling", "noData": "Geen kostengegevens", "byModel": "Per model", "byProvider": "Door aanbieder", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-eindpunt", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Audiobestanden omzetten naar tekst (Whisper)", "textToSpeech": "Tekst naar spraak", "textToSpeechDesc": "Converteer tekst naar natuurlijk klinkende spraak", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderaties", "moderationsDesc": "Contentmoderatie en veiligheidsclassificatie", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Systeemgezondheid", "description": "Realtime monitoring van uw OmniRoute-instantie", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limieten en quota's", "rateLimit": "Tarieflimiet", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welkom", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Fout ({code})", "errorCountNoCode": "{count} Fout", "noConnections": "Geen verbindingen", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Uitgeschakeld", "enableProvider": "Aanbieder inschakelen", "disableProvider": "Schakel aanbieder uit", @@ -2296,7 +2701,6 @@ "errorOccurred": "Er is een fout opgetreden. Probeer het opnieuw.", "modelStatus": "Modelstatus", "showConfiguredOnly": "Configured only", - "searchProviders": "Zoekaanbieders...", "allModelsOperational": "Alle modellen operationeel", "modelsWithIssues": "{count} model(len) met problemen", "allModelsNormal": "Alle modellen reageren normaal.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-compatibele details", "messagesApi": "Berichten-API", "responsesApi": "Reacties-API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chat-voltooiingen", "importingModels": "Importeren...", "importFromModels": "Importeren uit /modellen", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Alle modellen zijn al geïmporteerd", "noNewModelsToImport": "Geen nieuwe modellen om te importeren — alle modellen staan al in het register of de lijst met aangepaste modellen", "skippingExistingModels": "{count} bestaande modellen overgeslagen", @@ -2373,6 +2782,7 @@ "importFailed": "Importeren is mislukt", "noNewModelsAdded": "Er zijn geen nieuwe modellen toegevoegd.", "adding": "Toevoegen...", + "close": "Close", "importingModelsTitle": "Modellen importeren", "copyModel": "Kopieermodel", "filterModels": "Modellen filteren…", @@ -2413,6 +2823,11 @@ "configured": "geconfigureerd", "providerProxyConfigureHint": "Configureer proxy voor alle verbindingen van deze provider", "providerProxy": "Proxy van aanbieder", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Nog geen verbindingen", "addFirstConnectionHint": "Voeg uw eerste verbinding toe om aan de slag te gaan", "addConnection": "Verbinding toevoegen", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Model-ID", "customModelPlaceholder": "bijv. gpt-4.5-turbo", "loading": "Laden...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "Gezondheidscontrole (min)", "healthCheckHint": "Proactief tokenvernieuwingsinterval. 0 = uitgeschakeld.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Kan de verbinding niet testen", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioTranscriptions": "Audio Transcriptions", - "repairEnvFailed": "Failed to repair .env", - "hideEmails": "Hide all emails", - "repairEnvWorking": "Repairing...", - "embeddings": "Embeddings", - "repairEnv": "Repair env", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "noModelsMatch": "No models match \"{filter}\"", - "selectAllModels": "Select all", - "modelsActiveCount": "{active}/{total} active", - "repairEnvSuccess": "OAuth defaults restored", - "deselectAllModels": "Deselect all", - "imagesGenerations": "Images Generations", - "audioSpeech": "Audio Speech", "showEmails": "Show all emails", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Zoekaanbieders...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Instellingen", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prijzen", "storage": "Opslag", "policies": "Beleid", @@ -2749,6 +3164,46 @@ "enablePassword": "Wachtwoord inschakelen", "darkMode": "Donkere modus", "lightMode": "Lichtmodus", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "zojuist", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Aanbieders", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Systeem Thema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "TTL cachen", "maxCacheSize": "Maximale cachegrootte", "clearCache": "Cache wissen", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache-hits", "cacheMisses": "Cache-missers", "hitRate": "Hitpercentage", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Maak het denken mogelijk", "maxThinkingTokens": "Max Thinking-tokens", "enableProxy": "Schakel proxy in", @@ -2818,6 +3277,14 @@ "themeLight": "Licht", "themeDark": "Donker", "themeSystem": "Systeem", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API-eindpuntbeveiliging", "requireAuthModels": "API-sleutel vereisen voor /models", "requireAuthModelsDesc": "Indien AAN, retourneert het /v1/models eindpunt 404 voor niet-geverifieerde verzoeken. Voorkomt modeldetectie door ongeautoriseerde gebruikers.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Geblokkeerde aanbieders", "blockedProvidersDesc": "Verberg specifieke providers in het antwoord /v1/models. Geblokkeerde aanbieders verschijnen niet in modeloverzichten.", "providersBlocked": "{count} provider(s) geblokkeerd voor /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Kies het minst recent gebruikte account", "costOpt": "Kosten opt", "costOptDesc": "Geef de voorkeur aan het goedkoopste beschikbare account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Kleverige limiet", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Combinatiestrategie", "priority": "Prioriteit", "weighted": "Gewogen", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Maximaal aantal nieuwe pogingen", "retryDelayLabel": "Vertraging opnieuw proberen (ms)", "timeoutLabel": "Time-out (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maximale nestdiepte", "concurrencyPerModel": "Gelijktijdigheid / model", "queueTimeout": "Wachtrijtime-out (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Providerprofielen", "providerProfilesDesc": "Afzonderlijke veerkrachtinstellingen voor OAuth (sessiegebaseerd) en API Key (gemeten) providers. OAuth-providers hanteren strengere drempels vanwege lagere tarieflimieten.", "oauthProviders": "OAuth-providers", @@ -3113,7 +3596,6 @@ "backupCreated": "Back-up gemaakt: {file}", "restoreSuccess": "Hersteld! {connections} verbindingen, {nodes} knooppunten, {combos} combo's, {apiKeys} API-sleutels.", "importSuccess": "Database geïmporteerd! {connections} verbindingen, {nodes} knooppunten, {combos} combo's, {apiKeys} API-sleutels.", - "justNow": "zojuist", "minutesAgo": "{count}m geleden", "hoursAgo": "{count}u geleden", "daysAgo": "{count}d geleden", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Er is een fout opgetreden tijdens het importeren", "modelPricing": "Modelprijzen", "modelPricingDesc": "Kostentarieven per model configureren • Alle tarieven in $/1M tokens", - "providers": "Aanbieders", "registry": "Register", "priced": "Geprijsd", "searchProvidersModels": "Zoekaanbieders of modellen...", @@ -3170,47 +3651,6 @@ "editPricing": "Prijzen bewerken", "viewFullDetails": "Bekijk volledige details", "themeCoral": "Koraal", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Formaatconverter", "formatConverterDescription": "Plak of typ een JSON-aanvraagtekst. De vertaler detecteert automatisch het bronformaat en converteert dit naar het doelformaat. Gebruik dit om fouten op te sporen in de manier waarop OmniRoute verzoeken tussen formaten vertaalt (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Invoer", "output": "Uitvoer", "auto": "Automatisch", @@ -3573,6 +4059,11 @@ "errorMessage": "Fout: {message}", "requestFailed": "Verzoek mislukt", "noTextExtracted": "(Geen tekst geëxtraheerd)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Toont vertaalgebeurtenissen terwijl API-aanroepen door OmniRoute stromen. Gebeurtenissen komen uit de buffer in het geheugen (wordt gereset bij opnieuw opstarten). Gebruik", "liveMonitorDescriptionSuffix": "of externe API-aanroepen om gebeurtenissen te genereren." }, @@ -3648,14 +4139,25 @@ "passSuffix": "passeren", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Voer Eval uit", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "{current}/{total} wordt uitgevoerd...", "passRate": "slagingspercentage", "summaryBreakdown": "{passed} geslaagd · {failed} mislukt · {total} totaal", "passedIconLabel": "✅Geslaagd", "failedIconLabel": "❌ Mislukt", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Bevat: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Verwacht: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Nog geen resultaten", "testCasesCount": "Testgevallen ({count})", "noTestCasesDefined": "Geen testgevallen gedefinieerd", @@ -3723,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Onbekend", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Wachten op toestemming voor anti-zwaartekracht...", "waitingForQoderAuthorization": "Wachten op Qoder-autorisatie...", "exchangingCodeForTokens": "Code uitwisselen voor tokens...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Documentatie", "quickStart": "Snel beginnen", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Kenmerken", "supportedProviders": "Ondersteunde providers", "supportedProvidersToc": "Aanbieders", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Stel de clientbasis-URL in", "quickStartStep4Prefix": "Verwijs naar uw IDE- of API-client", "quickStartStep4Suffix": "Gebruik bijvoorbeeld het providervoorvoegsel", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Routering door meerdere providers", "featureRoutingText": "Routeer verzoeken naar meer dan 30 AI-providers via één enkel OpenAI-compatibel eindpunt. Ondersteunt API's voor chat, reacties, audio en afbeeldingen.", "featureCombosTitle": "Combo's en balanceren", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Gebruik", "clientClaudeBullet1Middle": "(Claude) of", "clientClaudeBullet1Suffix": "(Antizwaartekracht) voorvoegsel.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Gebruik Dashboard > Providers > Verbinding testen voordat u gaat testen vanaf IDE's of externe clients.", "troubleshootingCircuitBreaker": "Als een provider aangeeft dat de stroomonderbreker open is, wacht dan op de cooldown of kijk op de Gezondheidspagina voor meer informatie.", "troubleshootingOAuth": "Voor OAuth-providers geldt dat u opnieuw moet verifiëren als tokens verlopen. Controleer de statusindicator van de providerkaart.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacybeleid", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Eenvoudig chatten", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "hoursTracked": "hours tracked", - "busiestHour": "Busiest Hour", - "lastUpdated": "Last updated", - "activityVolume": "Activity", - "trendHour": "Hour", - "semanticCache": "Semantic Cache", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "entriesLoadError": "Failed to load semantic cache entries.", - "cacheRateDesc": "of total requests", - "cachedRequests24h": "Cached Requests (24h)", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "cacheRate": "Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "peakCacheRate": "Peak Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/no.json b/src/i18n/messages/no.json index 5b5a755318..15eeb4e0f0 100644 --- a/src/i18n/messages/no.json +++ b/src/i18n/messages/no.json @@ -23,6 +23,7 @@ "active": "Aktiv", "inactive": "Inaktiv", "noData": "Ingen data tilgjengelig", + "nothingHere": "Nothing here yet", "configure": "Konfigurer", "manage": "Administrer", "name": "Navn", @@ -139,7 +140,6 @@ "http": "HTTP", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Lekeplass", "searchTools": "Search Tools", "agents": "Agenter", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumenter", "issues": "Problemer", "endpoints": "Endepunkter", "apiManager": "API-behandler", "logs": "Logger", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Revisjonslogg", "shutdown": "Avslutning", "restart": "Start på nytt", @@ -705,8 +710,6 @@ "cliToolsShort": "Verktøy", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Utnyttelse", "utilizationDescription": "Leverandørkvotebrukstrender og hastighetsgrensesporing", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kombohelse", "comboHealthDescription": "Kombonivåkvote, bruksfordeling og ytelsesmålinger", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Siste: {date}", "editPermissions": "Rediger tillatelser", "deleteKey": "Slett nøkkel", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modell", "models": "{count} modeller", "permissionsTitle": "Tillatelser: {name}", @@ -1188,11 +1296,13 @@ "continue": "Bruk når du kjører Continue i IDEer og du trenger bærbar JSON-basert leverandørkonfigurasjon.", "opencode": "Bruk når du foretrekker terminal-native agentkjøringer og skriptautomatisering via OpenCode.", "kiro": "Brukes når du integrerer Kiro og kontrollerer modellruting sentralt fra OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Brukes når Antigravity/Kiro-trafikk må avskjæres gjennom MITM og rutes til OmniRoute.", "copilot": "Bruk når du vil ha Copilot chat-stil UX mens du håndhever OmniRoute-nøkler og rutingsregler.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE med MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekvensiell fallback: prøver modell 1 først, deretter 2 osv.", "weightedDesc": "Fordeler trafikk etter vektprosent med reserve", "roundRobinDesc": "Sirkulær fordeling: hver forespørsel går til neste modell i rotasjon", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Ensartet tilfeldig valg, deretter fallback til gjenværende modeller", "leastUsedDesc": "Velger modellen med færrest forespørsler, og balanserer belastningen over tid", "costOptimizedDesc": "Ruter til den billigste modellen først basert på priser", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modeller", @@ -1404,6 +1521,13 @@ "retryDelay": "Forsinkelse på nytt (ms)", "concurrencyPerModel": "Samtidighet / modell", "queueTimeout": "Tidsavbrudd for kø (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "La stå tomt for å bruke globale standardinnstillinger. Disse overstyrer innstillingene per leverandør.", "moveUp": "Flytt opp", "moveDown": "Flytt ned", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." - }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Klar til å spare?", "readinessDescription": "Se gjennom sjekklisten før du oppretter eller oppdaterer denne kombinasjonen.", "readinessCheckName": "Kombinasjonsnavnet er gyldig", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "reviewComboRefs": "Combo References", - "builderAddComboRef": "Add combo reference", - "reviewAgentFlags": "Agent Flags", - "filterAll": "All", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, - "basics": { - "description": "Name and starting template", - "label": "Basics" } }, - "cooldownMinutes": "Cooldown: {minutes}m", - "builderAccount": "Account", - "candidatePoolLabel": "Candidate Pool", - "builderLegacyEntry": "Legacy entry", - "builderProviderFirst": "Pick provider first", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "incidentMode": "Incident Mode", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "explorationRateLabel": "Exploration Rate", - "contextRelaySummaryModel": "Summary Model", - "noExcludedProviders": "No providers are currently excluded.", - "weightHealth": "Health", - "budgetCapLabel": "Budget Cap (USD / request)", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "builderTitle": "Build a Combo", - "builderFlowTitle": "Combo Builder Flow", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "builderModel": "Model", - "builderStageCurrent": "Current stage", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "weightTaskFit": "Task Fit", - "builderComboRefStep": "Add combo reference", - "emailVisibilityStateOff": "Off", - "normalOperation": "Normal Operation", - "reorderHandle": "Drag to reorder", - "weightCostInv": "Cost", - "activeModePack": "Active Mode Pack", - "candidatePoolAllProviders": "All providers", - "builderStageLocked": "Locked — complete previous stage first", - "emailVisibilityStateOn": "On", - "providerScores": "Provider Scores", - "excludedProviders": "Excluded Providers", - "filterEmptyTitle": "No combos match this strategy filter.", - "reviewSequence": "Model Sequence", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "failedReorder": "Failed to reorder models", - "builderStagePending": "Pending", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "weightStability": "Stability", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "filterIntelligent": "Intelligent", - "builderSelectModel": "Select model", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "strategyRules": "Rules (6-Factor Scoring)", - "builderComboRef": "Combo Ref", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderLoadingProviders": "Loading providers...", - "builderPinnedAccount": "Pinned Account", - "reviewNoSteps": "No steps configured", - "reviewAccounts": "Accounts", - "modePackLabel": "Mode Pack", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "statusOverview": "Status Overview", - "builderProvider": "Provider", - "contextRelay": "Context Relay", - "builderAddStep": "Add step", - "weightQuota": "Quota", - "candidatePoolEmpty": "No active providers available yet.", - "builderBrowseCatalog": "Browse catalog", - "reviewIntelligentTitle": "Intelligent Routing Config", - "contextRelayMaxMessages": "Max Messages For Summary", - "reviewName": "Name", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "modePackUpdated": "Mode pack updated to {pack}.", - "reviewSteps": "Steps", - "weightLatencyInv": "Latency", - "builderPreview": "Preview", - "filterDeterministic": "Deterministic", - "reviewAdvanced": "Advanced Settings", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "budgetCapPlaceholder": "No limit", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderSelectProvider": "Select provider", - "reviewStrategy": "Strategy", - "routerStrategyLabel": "Router Strategy", - "weightTierPriority": "Tier", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "builderStageVisited": "Stage completed", - "reviewProviders": "Providers" + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kostnader", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budsjett", "totalCost": "Total kostnad", "breakdown": "Kostnadsfordeling", "noData": "Ingen kostnadsdata", "byModel": "Etter modell", "byProvider": "Av leverandør", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-endepunkt", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transkribere lydfiler til tekst (Whisper)", "textToSpeech": "Tekst til tale", "textToSpeechDesc": "Konverter tekst til tale med naturlig lyd", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderasjoner", "moderationsDesc": "Innholdsmoderering og sikkerhetsklassifisering", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Spor og kontroller oppgaver ved å bruke `tasks/get` og `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Systemhelse", "description": "Sanntidsovervåking av din OmniRoute-forekomst", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Grenser og kvoter", "rateLimit": "Satsgrense", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Velkommen", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Feil ({code})", "errorCountNoCode": "{count} Feil", "noConnections": "Ingen tilkoblinger", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Deaktivert", "enableProvider": "Aktiver leverandør", "disableProvider": "Deaktiver leverandør", @@ -2296,7 +2701,6 @@ "errorOccurred": "Det oppsto en feil. Vennligst prøv igjen.", "modelStatus": "Modellstatus", "showConfiguredOnly": "Configured only", - "searchProviders": "Søk etter leverandører...", "allModelsOperational": "Alle modeller i drift", "modelsWithIssues": "{count} modell(er) med problemer", "allModelsNormal": "Alle modellene reagerer normalt.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-kompatible detaljer", "messagesApi": "Messages API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chatfullføringer", "importingModels": "Importerer...", "importFromModels": "Importer fra /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Alle modeller er allerede importert", "noNewModelsToImport": "Ingen nye modeller å importere — alle modeller finnes allerede i registeret eller listen over egendefinerte modeller", "skippingExistingModels": "Hopper over {count} eksisterende modeller", @@ -2373,6 +2782,7 @@ "importFailed": "Import mislyktes", "noNewModelsAdded": "Ingen nye modeller ble lagt til.", "adding": "Legger til...", + "close": "Close", "importingModelsTitle": "Importere modeller", "copyModel": "Kopier modell", "filterModels": "Filtrer modeller…", @@ -2413,6 +2823,11 @@ "configured": "konfigurert", "providerProxyConfigureHint": "Konfigurer proxy for alle tilkoblinger til denne leverandøren", "providerProxy": "Leverandørfullmakt", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Ingen tilkoblinger ennå", "addFirstConnectionHint": "Legg til din første tilkobling for å komme i gang", "addConnection": "Legg til tilkobling", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Modell-ID", "customModelPlaceholder": "f.eks. gpt-4.5-turbo", "loading": "Laster inn...", @@ -2513,6 +2931,10 @@ "email": "E-post", "healthCheckMinutes": "Helsesjekk (min)", "healthCheckHint": "Proaktivt token-oppdateringsintervall. 0 = deaktivert.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Kunne ikke teste tilkoblingen", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "audioSpeech": "Audio Speech", - "repairEnv": "Repair env", - "hideEmails": "Hide all emails", - "repairEnvWorking": "Repairing...", - "repairEnvFailed": "Failed to repair .env", - "repairEnvSuccess": "OAuth defaults restored", - "selectAllModels": "Select all", - "audioTranscriptions": "Audio Transcriptions", - "imagesGenerations": "Images Generations", - "embeddings": "Embeddings", - "noModelsMatch": "No models match \"{filter}\"", - "deselectAllModels": "Deselect all", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Søk etter leverandører...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Innstillinger", @@ -2723,6 +3137,23 @@ "systemPrompt": "Systemmelding", "thinkingBudget": "Tenker budsjett", "proxy": "Fullmakt", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prissetting", "storage": "Oppbevaring", "policies": "Retningslinjer", @@ -2733,6 +3164,46 @@ "enablePassword": "Aktiver passord", "darkMode": "Mørk modus", "lightMode": "Lysmodus", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "akkurat nå", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Leverandører", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Systemtema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Maks cachestørrelse", "clearCache": "Tøm buffer", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cache-treff", "cacheMisses": "Cache Misses", "hitRate": "Trefffrekvens", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Aktiver tenkning", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Aktiver proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Lys", "themeDark": "Mørkt", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "API-endepunktbeskyttelse", "requireAuthModels": "Krev API-nøkkel for /modeller", "requireAuthModelsDesc": "Når PÅ, returnerer /v1/models-endepunktet 404 for uautentiserte forespørsler. Forhindrer modelloppdagelse av uautoriserte brukere.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blokkerte leverandører", "blockedProvidersDesc": "Skjul spesifikke leverandører fra /v1/models-svaret. Blokkerte leverandører vil ikke vises i modelloppføringer.", "providersBlocked": "{count} leverandør(er) blokkert fra /modeller", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Velg minst nylig brukte konto", "costOpt": "Kostnad Opt", "costOptDesc": "Foretrekker den billigste tilgjengelige kontoen", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Kombinasjonsstrategi", "priority": "Prioritet", "weighted": "Vektet", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max prøver på nytt", "retryDelayLabel": "Forsinkelse på nytt (ms)", "timeoutLabel": "Tidsavbrudd (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Maks hekkedybde", "concurrencyPerModel": "Samtidighet / modell", "queueTimeout": "Tidsavbrudd for kø (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Leverandørprofiler", "providerProfilesDesc": "Separate innstillinger for motstandskraft for OAuth (øktbasert) og API Key (målt) leverandører. OAuth-leverandører har strengere terskler på grunn av lavere takstgrenser.", "oauthProviders": "OAuth-leverandører", @@ -3097,7 +3596,6 @@ "backupCreated": "Sikkerhetskopi opprettet: {file}", "restoreSuccess": "Gjenopprettet! {connections} tilkoblinger, {nodes} noder, {combos} kombinasjoner, {apiKeys} API-nøkler.", "importSuccess": "Database importert! {connections} tilkoblinger, {nodes} noder, {combos} kombinasjoner, {apiKeys} API-nøkler.", - "justNow": "akkurat nå", "minutesAgo": "{count}m siden", "hoursAgo": "{count}t siden", "daysAgo": "{count}d siden", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Det oppstod en feil under import", "modelPricing": "Modellprising", "modelPricingDesc": "Konfigurer kostnadssatser per modell • Alle priser i $/1M tokens", - "providers": "Leverandører", "registry": "Register", "priced": "Priset", "searchProvidersModels": "Søk etter leverandører eller modeller...", @@ -3154,47 +3651,6 @@ "editPricing": "Rediger priser", "viewFullDetails": "Se alle detaljer", "themeCoral": "Korall", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "FEIL", "formatConverter": "Formatkonvertering", "formatConverterDescription": "Lim inn eller skriv inn en JSON-forespørselstekst. Oversetteren vil automatisk oppdage kildeformatet og konvertere det til målformatet. Bruk denne til å feilsøke hvordan OmniRoute oversetter forespørsler mellom formater (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Inndata", "output": "Utgang", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Feil: {message}", "requestFailed": "Forespørselen mislyktes", "noTextExtracted": "(Ingen tekst er trukket ut)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Viser oversettelseshendelser når API-anrop flyter gjennom OmniRoute. Hendelser kommer fra bufferen i minnet (tilbakestilles ved omstart). Bruk", "liveMonitorDescriptionSuffix": ", eller eksterne API-kall for å generere hendelser." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Kjør Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Kjører {current}/{total}...", "passRate": "bestått rate", "summaryBreakdown": "{passed} bestått · {failed} mislyktes · {total} totalt", "passedIconLabel": "✅ Bestått", "failedIconLabel": "❌ Mislyktes", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Inneholder: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Forventet: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Ingen resultater ennå", "testCasesCount": "Testtilfeller ({count})", "noTestCasesDefined": "Ingen testtilfeller definert", @@ -3723,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Ukjent", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Venter på antigravity-autorisasjon...", "waitingForQoderAuthorization": "Venter på Qoder-autorisasjon...", "exchangingCodeForTokens": "Utveksler kode for tokens...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentasjon", "quickStart": "Rask start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funksjoner", "supportedProviders": "Støttede leverandører", "supportedProvidersToc": "Leverandører", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Angi klientbase-URL", "quickStartStep4Prefix": "Pek IDE- eller API-klienten din til", "quickStartStep4Suffix": "Bruk for eksempel leverandørprefiks", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Ruting for flere leverandører", "featureRoutingText": "Rut forespørsler til 30+ AI-leverandører gjennom ett enkelt OpenAI-kompatibelt endepunkt. Støtter chat, svar, lyd og bilde-APIer.", "featureCombosTitle": "Kombinasjoner og balansering", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Bruk", "clientClaudeBullet1Middle": "(Claude) eller", "clientClaudeBullet1Suffix": "(Antigravity) prefiks.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Bruk Dashboard > Leverandører > Test tilkobling før du tester fra IDE-er eller eksterne klienter.", "troubleshootingCircuitBreaker": "Hvis en leverandør viser at strømbryteren er åpen, vent på nedkjøling eller sjekk helsesiden for detaljer.", "troubleshootingOAuth": "For OAuth-leverandører, autentiser på nytt hvis tokens utløper. Sjekk leverandørkortets statusindikator.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Personvernerklæring", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Enkel chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "busiestHour": "Busiest Hour", - "cachedRequests24h": "Cached Requests (24h)", - "activityVolume": "Activity", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "peakCacheRate": "Peak Cache Rate", - "cacheRate": "Cache Rate", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticCache": "Semantic Cache", - "lastUpdated": "Last updated", - "trendHour": "Hour", - "cacheRateDesc": "of total requests", - "hoursTracked": "hours tracked", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/phi.json b/src/i18n/messages/phi.json index 35e1d22574..6e204ad13b 100644 --- a/src/i18n/messages/phi.json +++ b/src/i18n/messages/phi.json @@ -23,6 +23,7 @@ "active": "Aktibo", "inactive": "Hindi aktibo", "noData": "Walang available na data", + "nothingHere": "Nothing here yet", "configure": "I-configure", "manage": "Pamahalaan", "name": "Pangalan", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Nabigong i-reset ang pagpepresyo", "apikey": "API Key", "http": "HTTP", - "checkSystemStatus": "Check System Status", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Mga Agent", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Docs", "issues": "Mga isyu", "endpoints": "Mga Endpoint", "apiManager": "Tagapamahala ng API", "logs": "Mga log", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Log ng Audit", "shutdown": "Pagsara", "restart": "I-restart", @@ -705,8 +710,6 @@ "cliToolsShort": "Mga Tool", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Paggamit", "utilizationDescription": "Mga trend sa paggamit ng quota ng provider at pagsubaybay sa rate limit", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kalusugan ng Combo", "comboHealthDescription": "Quota sa antas ng combo, pamamahagi ng paggamit, at mga metrics ng pagganap", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Huli: {date}", "editPermissions": "I-edit ang mga pahintulot", "deleteKey": "Tanggalin ang susi", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modelo", "models": "{count} na mga modelo", "permissionsTitle": "Mga Pahintulot: {name}", @@ -1188,11 +1296,13 @@ "continue": "Gamitin kapag nagpapatakbo ng Magpatuloy sa mga IDE at kailangan mo ng portable JSON-based na configuration ng provider.", "opencode": "Gamitin kapag mas gusto mo ang terminal-native agent run at scripted automation sa pamamagitan ng OpenCode.", "kiro": "Gamitin kapag isinasama ang Kiro at kinokontrol ang pagruruta ng modelo sa gitna mula sa OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Gamitin kapag ang trapiko ng Antigravity/Kiro ay dapat ma-intercept sa MITM at iruta sa OmniRoute.", "copilot": "Gamitin kapag gusto mong Copilot chat style UX habang ipinapatupad ang mga OmniRoute key at mga panuntunan sa pagruruta.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE na may MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sequential fallback: subukan muna ang modelo 1, pagkatapos ay 2, atbp.", "weightedDesc": "Namamahagi ng trapiko ayon sa porsyento ng timbang na may fallback", "roundRobinDesc": "Paikot na pamamahagi: ang bawat kahilingan ay mapupunta sa susunod na modelo sa pag-ikot", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Uniform random selection, pagkatapos ay fallback sa natitirang mga modelo", "leastUsedDesc": "Pinipili ang modelo na may kaunting mga kahilingan, binabalanse ang pagkarga sa paglipas ng panahon", "costOptimizedDesc": "Mga ruta muna sa pinakamurang modelo batay sa pagpepresyo", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Mga modelo", @@ -1404,6 +1521,13 @@ "retryDelay": "Subukan muli ang Pagkaantala (ms)", "concurrencyPerModel": "Concurrency / Modelo", "queueTimeout": "Queue Timeout (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Iwanang walang laman upang gumamit ng mga pandaigdigang default. Ino-override ng mga ito ang mga setting ng bawat provider.", "moveUp": "Umakyat", "moveDown": "Ilipat pababa", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "when": "Use when long sessions must survive account rotation without losing the working context.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." - }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Handa nang makatipid?", "readinessDescription": "Suriin ang checklist bago gawin o i-update ang combo na ito.", "readinessCheckName": "May bisa ang combo name", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,33 +1823,23 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "contextRelaySummaryModel": "Summary Model", - "filterIntelligent": "Intelligent", - "normalOperation": "Normal Operation", - "strategyRules": "Rules (6-Factor Scoring)", - "providerScores": "Provider Scores", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderStageLocked": "Locked — complete previous stage first", - "weightLatencyInv": "Latency", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "emailVisibilityStateOn": "On", "emailVisibilityStateOff": "Off", - "statusOverview": "Status Overview", - "incidentMode": "Incident Mode", - "reviewName": "Name", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderProvider": "Provider", - "builderStageCurrent": "Current stage", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { + "basics": { + "label": "Basics", + "description": "Name and starting template" + }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", @@ -1616,90 +1848,86 @@ "review": { "label": "Review", "description": "Final validation before saving" - }, - "basics": { - "label": "Basics", - "description": "Name and starting template" } }, - "failedReorder": "Failed to reorder models", - "reorderHandle": "Drag to reorder", - "builderAddStep": "Add step", - "reviewComboRefs": "Combo References", - "builderPreview": "Preview", - "builderLegacyEntry": "Legacy entry", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "filterAll": "All", - "contextRelay": "Context Relay", - "modePackLabel": "Mode Pack", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "excludedProviders": "Excluded Providers", - "builderFlowTitle": "Combo Builder Flow", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", - "cooldownMinutes": "Cooldown: {minutes}m", - "reviewAgentFlags": "Agent Flags", - "weightHealth": "Health", - "builderModel": "Model", - "filterEmptyTitle": "No combos match this strategy filter.", - "reviewSteps": "Steps", - "budgetCapPlaceholder": "No limit", - "filterDeterministic": "Deterministic", - "modePackUpdated": "Mode pack updated to {pack}.", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderAccount": "Account", - "reviewNoSteps": "No steps configured", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "builderComboRef": "Combo Ref", - "routerStrategyLabel": "Router Strategy", - "builderPinnedAccount": "Pinned Account", - "reviewSequence": "Model Sequence", - "reviewStrategy": "Strategy", - "builderSelectProvider": "Select provider", - "candidatePoolAllProviders": "All providers", - "reviewIntelligentTitle": "Intelligent Routing Config", - "builderBrowseCatalog": "Browse catalog", - "weightTaskFit": "Task Fit", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "builderStagePending": "Pending", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "weightCostInv": "Cost", - "builderLoadingProviders": "Loading providers...", - "builderComboRefStep": "Add combo reference", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "weightStability": "Stability", - "candidatePoolLabel": "Candidate Pool", - "noExcludedProviders": "No providers are currently excluded.", - "weightTierPriority": "Tier", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewProviders": "Providers", - "builderSelectModel": "Select model", - "builderAddComboRef": "Add combo reference", - "reviewAccounts": "Accounts", - "builderProviderFirst": "Pick provider first", - "explorationRateLabel": "Exploration Rate", - "activeModePack": "Active Mode Pack", - "builderTitle": "Build a Combo", - "emailVisibilityStateOn": "On", "builderStageVisited": "Stage completed", - "candidatePoolEmpty": "No active providers available yet.", - "weightQuota": "Quota", - "reviewAdvanced": "Advanced Settings" + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Mga gastos", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Badyet", "totalCost": "Kabuuang Gastos", "breakdown": "Pagkakasira ng Gastos", "noData": "Walang data ng gastos", "byModel": "Sa pamamagitan ng Modelo", "byProvider": "Sa pamamagitan ng Provider", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Endpoint ng API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "I-transcribe ang mga audio file sa text (Bulong)", "textToSpeech": "Text to Speech", "textToSpeechDesc": "I-convert ang teksto sa natural na tunog na pananalita", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Mga moderation", "moderationsDesc": "Pag-moderate ng nilalaman at pag-uuri ng kaligtasan", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Subaybayan at kontrolin ang mga gawain gamit ang `tasks/get` at `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Kalusugan ng System", "description": "Real-time na pagsubaybay sa iyong OmniRoute instance", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Mga Limitasyon at Quota", "rateLimit": "Hangganan ng Rate", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Maligayang pagdating", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "Walang koneksyon", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Hindi pinagana", "enableProvider": "Paganahin ang provider", "disableProvider": "Huwag paganahin ang provider", @@ -2296,7 +2701,6 @@ "errorOccurred": "May naganap na error. Pakisubukang muli.", "modelStatus": "Katayuan ng Modelo", "showConfiguredOnly": "Configured only", - "searchProviders": "Maghanap ng mga provider...", "allModelsOperational": "Ang lahat ng mga modelo ay gumagana", "modelsWithIssues": "{count} (mga) modelong may mga isyu", "allModelsNormal": "Ang lahat ng mga modelo ay tumutugon nang normal.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Mga Detalye ng Tugma sa OpenAI", "messagesApi": "Messages API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Mga Pagkumpleto ng Chat", "importingModels": "Ini-import...", "importFromModels": "Mag-import mula sa /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Lahat ng mga modelo ay nai-import na", "noNewModelsToImport": "Walang bagong modelo na i-import — lahat ng mga modelo ay nasa registry o custom na listahan na", "skippingExistingModels": "Pinapalampas ang {count} na umiiral na mga modelo", @@ -2373,6 +2782,7 @@ "importFailed": "Nabigo ang pag-import", "noNewModelsAdded": "Walang naidagdag na mga bagong modelo.", "adding": "Idinaragdag...", + "close": "Close", "importingModelsTitle": "Pag-import ng mga Modelo", "copyModel": "Kopyahin ang modelo", "filterModels": "I-filter ang mga modelo…", @@ -2413,6 +2823,11 @@ "configured": "naka-configure", "providerProxyConfigureHint": "I-configure ang proxy para sa lahat ng koneksyon ng provider na ito", "providerProxy": "Proxy ng Provider", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Wala pang koneksyon", "addFirstConnectionHint": "Idagdag ang iyong unang koneksyon upang makapagsimula", "addConnection": "Magdagdag ng Koneksyon", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Model ID", "customModelPlaceholder": "hal. gpt-4.5-turbo", "loading": "Naglo-load...", @@ -2513,6 +2931,10 @@ "email": "Email", "healthCheckMinutes": "Health Check (min)", "healthCheckHint": "Proactive token refresh interval. 0 = hindi pinagana.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Nabigong subukan ang koneksyon", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "hideEmails": "Hide all emails", - "imagesGenerations": "Images Generations", - "audioSpeech": "Audio Speech", - "repairEnvSuccess": "OAuth defaults restored", - "audioTranscriptions": "Audio Transcriptions", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", - "repairEnv": "Repair env", - "embeddings": "Embeddings", - "selectAllModels": "Select all", - "deselectAllModels": "Deselect all", - "repairEnvWorking": "Repairing...", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Maghanap ng mga provider...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Mga setting", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pagpepresyo", "storage": "Imbakan", "policies": "Mga patakaran", @@ -2749,6 +3164,46 @@ "enablePassword": "Paganahin ang Password", "darkMode": "Dark Mode", "lightMode": "Light Mode", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "ngayon lang", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Mga provider", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema ng System", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "I-cache ang TTL", "maxCacheSize": "Max na Laki ng Cache", "clearCache": "I-clear ang Cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Mga Cache Hit", "cacheMisses": "Nakakamiss ang cache", "hitRate": "Hit Rate", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Paganahin ang Pag-iisip", "maxThinkingTokens": "Max Thinking Token", "enableProxy": "Paganahin ang Proxy", @@ -2818,6 +3277,14 @@ "themeLight": "Liwanag", "themeDark": "Madilim", "themeSystem": "Sistema", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "Proteksyon ng Endpoint ng API", "requireAuthModels": "Mangailangan ng API key para sa /models", "requireAuthModelsDesc": "Kapag NAKA-ON, ang /v1/models endpoint ay nagbabalik ng 404 para sa mga hindi napatotohanang kahilingan. Pinipigilan ang pagtuklas ng modelo ng mga hindi awtorisadong user.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Mga Naka-block na Provider", "blockedProvidersDesc": "Itago ang mga partikular na provider mula sa tugon ng /v1/models. Hindi lalabas ang mga naka-block na provider sa mga listahan ng modelo.", "providersBlocked": "{count} provider (mga) na-block mula sa /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Pumili ng hindi bababa sa kamakailang ginamit na account", "costOpt": "Cost Opt", "costOptDesc": "Mas gusto ang pinakamurang available na account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Malagkit na Limitasyon", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Diskarte ng combo", "priority": "Priyoridad", "weighted": "Natimbang", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max na muling sumusubok", "retryDelayLabel": "Subukan muli ang Pagkaantala (ms)", "timeoutLabel": "Timeout (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Max Nesting Depth", "concurrencyPerModel": "Concurrency / Modelo", "queueTimeout": "Queue Timeout (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Mga Profile ng Provider", "providerProfilesDesc": "Paghiwalayin ang mga setting ng resilience para sa OAuth (session-based) at API Key (metered) provider. Ang mga provider ng OAuth ay may mas mahigpit na mga limitasyon dahil sa mas mababang mga limitasyon sa rate.", "oauthProviders": "Mga Provider ng OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "Nagawa ang backup: {file}", "restoreSuccess": "Naibalik! {connections} na mga koneksyon, {nodes} node, {combos} combo, {apiKeys} API key.", "importSuccess": "Na-import ang database! {connections} na mga koneksyon, {nodes} node, {combos} combo, {apiKeys} API key.", - "justNow": "ngayon lang", "minutesAgo": "{count}m ang nakalipas", "hoursAgo": "{count}h ang nakalipas", "daysAgo": "{count}d ang nakalipas", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Nagkaroon ng error habang nag-import", "modelPricing": "Pagpepresyo ng Modelo", "modelPricingDesc": "I-configure ang mga rate ng gastos sa bawat modelo • Lahat ng mga rate sa $/1M token", - "providers": "Mga provider", "registry": "Pagpapatala", "priced": "Napresyohan", "searchProvidersModels": "Maghanap ng mga provider o modelo...", @@ -3170,47 +3651,6 @@ "editPricing": "I-edit ang Pagpepresyo", "viewFullDetails": "Tingnan ang Buong Detalye", "themeCoral": "Coral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Converter ng Format", "formatConverterDescription": "Mag-paste o mag-type ng JSON request body. Awtomatikong ide-detect ng translator ang source format at iko-convert ito sa target na format. Gamitin ito para i-debug kung paano isinasalin ng OmniRoute ang mga kahilingan sa pagitan ng mga format (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Nabigo ang kahilingan", "noTextExtracted": "(Walang na-extract na text)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Nagpapakita ng mga kaganapan sa pagsasalin habang dumadaloy ang mga tawag sa API sa pamamagitan ng OmniRoute. Ang mga kaganapan ay nagmumula sa in-memory na buffer (nagre-reset sa pag-restart). Gamitin", "liveMonitorDescriptionSuffix": ", o mga external na API call para makabuo ng mga event." }, @@ -3648,14 +4139,25 @@ "passSuffix": "pumasa", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Patakbuhin mo si Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Tumatakbo {current}/{total}...", "passRate": "rate ng pagpasa", "summaryBreakdown": "{passed} nakapasa · {failed} nabigo · {total} kabuuan", "passedIconLabel": "✅ Nakapasa", "failedIconLabel": "❌ Nabigo", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Naglalaman ng: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Inaasahan: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Wala pang resulta", "testCasesCount": "Mga Test Case ({count})", "noTestCasesDefined": "Walang tinukoy na mga kaso ng pagsubok", @@ -3723,6 +4225,16 @@ "tierFree": "Libre", "tierUnknown": "Hindi alam", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3943,9 +4460,9 @@ "waitingForQoderAuthorization": "Naghihintay ng awtorisasyon ng Qoder...", "exchangingCodeForTokens": "Pagpapalit ng code para sa mga token...", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentasyon", "quickStart": "Mabilis na Pagsisimula", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Mga tampok", "supportedProviders": "Mga Sinusuportahang Provider", "supportedProvidersToc": "Mga provider", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Itakda ang client base URL", "quickStartStep4Prefix": "Ituro ang iyong IDE o API client sa", "quickStartStep4Suffix": "Gamitin ang prefix ng provider, halimbawa", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Pagruruta ng Multi-Provider", "featureRoutingText": "Iruta ang mga kahilingan sa 30+ AI provider sa pamamagitan ng isang endpoint na katugma sa OpenAI. Sinusuportahan ang chat, mga tugon, audio, at image API.", "featureCombosTitle": "Combos at Balanse", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Gamitin", "clientClaudeBullet1Middle": "(Claude) o", "clientClaudeBullet1Suffix": "(Antigravity) prefix.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Mga Protocol: MCP at A2A", "protocolsDescription": "Ang OmniRoute ay naglalantad ng dalawang operational protocol bilang karagdagan sa mga OpenAI-compatible na API: MCP para sa tool execution at A2A para sa agent-to-agent na daloy ng trabaho.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Gamitin ang Dashboard > Mga Provider > Subukan ang Koneksyon bago subukan mula sa mga IDE o external na kliyente.", "troubleshootingCircuitBreaker": "Kung ipinapakita ng provider na bukas ang circuit breaker, hintayin ang cooldown o tingnan ang page ng Health para sa mga detalye.", "troubleshootingOAuth": "Para sa mga provider ng OAuth, muling i-authenticate kung mag-e-expire ang mga token. Suriin ang tagapagpahiwatig ng katayuan ng provider card.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Patakaran sa Privacy", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simpleng Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "lastUpdated": "Last updated", - "semanticCache": "Semantic Cache", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "activityVolume": "Activity", - "peakCacheRate": "Peak Cache Rate", - "busiestHour": "Busiest Hour", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cachedRequests24h": "Cached Requests (24h)", - "cacheRateDesc": "of total requests", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "hoursTracked": "hours tracked", - "cacheRate": "Cache Rate", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "entriesLoadError": "Failed to load semantic cache entries.", - "trendHour": "Hour", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/pl.json b/src/i18n/messages/pl.json index 05ac37dde6..1a027a1839 100644 --- a/src/i18n/messages/pl.json +++ b/src/i18n/messages/pl.json @@ -23,6 +23,7 @@ "active": "Aktywny", "inactive": "Nieaktywny", "noData": "Brak dostępnych danych", + "nothingHere": "Nothing here yet", "configure": "Skonfiguruj", "manage": "Zarządzaj", "name": "Imię", @@ -138,7 +139,6 @@ "apikey": "Klucz API", "http": "HTTP", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Plac zabaw", "searchTools": "Search Tools", "agents": "Agenci", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokumenty", "issues": "Problemy", "endpoints": "Punkty końcowe", "apiManager": "Menedżer API", "logs": "Dzienniki", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Dziennik audytu", "shutdown": "Wyłączenie", "restart": "Uruchom ponownie", @@ -705,8 +710,6 @@ "cliToolsShort": "Narzędzia", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Ewaluacje", "utilization": "Wykorzystanie", "utilizationDescription": "Trendy wykorzystania kwoty dostawcy i śledzenie limitów szybkości", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Zdrowie Kombinacji", "comboHealthDescription": "Kwota na poziomie kombinacji, dystrybucja użycia i metryki wydajności", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Ostatni: {date}", "editPermissions": "Edytuj uprawnienia", "deleteKey": "Usuń klucz", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "Model {count}", "models": "{count} modele", "permissionsTitle": "Uprawnienia: {name}", @@ -1188,11 +1296,13 @@ "continue": "Użyj podczas uruchamiania Kontynuuj w środowiskach IDE, jeśli potrzebujesz przenośnej konfiguracji dostawcy opartej na formacie JSON.", "opencode": "Użyj, jeśli wolisz uruchamianie agentów natywnych w terminalu i automatyzację skryptów za pośrednictwem OpenCode.", "kiro": "Użyj podczas integracji Kiro i centralnego sterowania routingiem modeli z OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Użyj, gdy ruch antygrawitacyjny/Kiro musi zostać przechwycony przez MITM i skierowany do OmniRoute.", "copilot": "Użyj, jeśli chcesz mieć UX w stylu czatu Copilot, jednocześnie wymuszając klucze OmniRoute i reguły routingu.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE z MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekwencyjne działanie awaryjne: najpierw wypróbowuje model 1, potem 2 itd.", "weightedDesc": "Rozdziela ruch według procentu wagi z rezerwą", "roundRobinDesc": "Dystrybucja kołowa: każde żądanie trafia do następnego modelu w rotacji", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Jednolity wybór losowy, a następnie powrót do pozostałych modeli", "leastUsedDesc": "Wybiera model z najmniejszą liczbą żądań, równoważąc obciążenie w czasie", "costOptimizedDesc": "Najpierw wybiera najtańszy model na podstawie ceny", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modele", @@ -1404,6 +1521,13 @@ "retryDelay": "Opóźnienie ponownej próby (ms)", "concurrencyPerModel": "Współbieżność/model", "queueTimeout": "Limit czasu kolejki (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Pozostaw puste, aby użyć globalnych ustawień domyślnych. Zastępują one ustawienia poszczególnych dostawców.", "moveUp": "Przesuń się w górę", "moveDown": "Przesuń w dół", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", + "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Gotowy do zapisania?", "readinessDescription": "Przed utworzeniem lub aktualizacją tej kombinacji przejrzyj listę kontrolną.", "readinessCheckName": "Nazwa kombinacji jest prawidłowa", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "budgetCapLabel": "Budget Cap (USD / request)", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "modePackUpdated": "Mode pack updated to {pack}.", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "reviewSteps": "Steps", - "reviewAccounts": "Accounts", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", "reorderHandle": "Drag to reorder", - "contextRelaySummaryModel": "Summary Model", - "filterAll": "All", - "activeModePack": "Active Mode Pack", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "providerScores": "Provider Scores", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "strategy": { - "label": "Strategy", - "description": "Routing behavior and advanced settings" - }, "basics": { "label": "Basics", "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" + }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { - "description": "Final validation before saving", - "label": "Review" + "label": "Review", + "description": "Final validation before saving" } }, - "reviewAgentFlags": "Agent Flags", - "filterIntelligent": "Intelligent", - "builderLoadingProviders": "Loading providers...", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "excludedProviders": "Excluded Providers", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "weightLatencyInv": "Latency", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderLegacyEntry": "Legacy entry", - "weightTaskFit": "Task Fit", - "weightQuota": "Quota", - "builderSelectModel": "Select model", - "filterEmptyTitle": "No combos match this strategy filter.", - "builderProviderFirst": "Pick provider first", - "reviewName": "Name", - "builderStageLocked": "Locked — complete previous stage first", - "builderProvider": "Provider", - "budgetCapPlaceholder": "No limit", "builderStageVisited": "Stage completed", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderTitle": "Build a Combo", - "builderAccount": "Account", - "weightHealth": "Health", - "contextRelayMaxMessages": "Max Messages For Summary", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "weightTierPriority": "Tier", - "emailVisibilityStateOn": "On", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderComboRefStep": "Add combo reference", - "reviewStrategy": "Strategy", - "builderSelectProvider": "Select provider", - "filterDeterministic": "Deterministic", - "reviewComboRefs": "Combo References", - "builderAddComboRef": "Add combo reference", - "reviewIntelligentTitle": "Intelligent Routing Config", - "modePackLabel": "Mode Pack", - "builderBrowseCatalog": "Browse catalog", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "builderAddStep": "Add step", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "weightStability": "Stability", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", "builderStageCurrent": "Current stage", - "failedReorder": "Failed to reorder models", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "reviewProviders": "Providers", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "noExcludedProviders": "No providers are currently excluded.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "cooldownMinutes": "Cooldown: {minutes}m", - "statusOverview": "Status Overview", - "contextRelayHandoffThreshold": "Handoff Threshold", - "builderPreview": "Preview", "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", "builderModel": "Model", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "strategyRules": "Rules (6-Factor Scoring)", - "candidatePoolAllProviders": "All providers", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", "reviewSequence": "Model Sequence", "reviewNoSteps": "No steps configured", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "weightCostInv": "Cost", - "incidentMode": "Incident Mode", - "candidatePoolLabel": "Candidate Pool", - "candidatePoolEmpty": "No active providers available yet.", - "normalOperation": "Normal Operation", - "builderFlowTitle": "Combo Builder Flow", - "contextRelay": "Context Relay", - "explorationRateLabel": "Exploration Rate", - "emailVisibilityStateOff": "Off", - "builderComboRef": "Combo Ref", - "builderPinnedAccount": "Pinned Account", - "routerStrategyLabel": "Router Strategy" + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Koszty", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budżet", "totalCost": "Całkowity koszt", "breakdown": "Podział kosztów", "noData": "Brak danych o kosztach", "byModel": "Według modelu", "byProvider": "Przez Dostawcę", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Punkt końcowy interfejsu API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transkrypcja plików audio na tekst (szeptem)", "textToSpeech": "Tekst na mowę", "textToSpeechDesc": "Konwertuj tekst na naturalnie brzmiącą mowę", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderacje", "moderationsDesc": "Moderowanie treści i klasyfikacja bezpieczeństwa", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Stan systemu", "description": "Monitorowanie w czasie rzeczywistym Twojej instancji OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limity i kwoty", "rateLimit": "Limit stawki", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Witamy", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Błąd ({code})", "errorCountNoCode": "{count} Błąd", "noConnections": "Brak połączeń", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Niepełnosprawny", "enableProvider": "Włącz dostawcę", "disableProvider": "Wyłącz dostawcę", @@ -2296,7 +2701,6 @@ "errorOccurred": "Wystąpił błąd. Spróbuj ponownie.", "modelStatus": "Stan modelu", "showConfiguredOnly": "Configured only", - "searchProviders": "Wyszukaj dostawców...", "allModelsOperational": "Wszystkie modele sprawne", "modelsWithIssues": "{count} modele z problemami", "allModelsNormal": "Wszystkie modele reagują normalnie.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Szczegóły zgodności z OpenAI", "messagesApi": "Interfejs API wiadomości", "responsesApi": "API odpowiedzi", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Zakończenia czatu", "importingModels": "Importowanie...", "importFromModels": "Importuj z /modele", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Wszystkie modele są już zaimportowane", "noNewModelsToImport": "Brak nowych modeli do zaimportowania — wszystkie modele są już w rejestrze lub na liście modeli niestandardowych", "skippingExistingModels": "Pomijanie {count} istniejących modeli", @@ -2373,6 +2782,7 @@ "importFailed": "Import nie powiódł się", "noNewModelsAdded": "Nie dodano żadnych nowych modeli.", "adding": "Dodawanie...", + "close": "Close", "importingModelsTitle": "Importowanie modeli", "copyModel": "Skopiuj model", "filterModels": "Filtruj modele…", @@ -2413,6 +2823,11 @@ "configured": "skonfigurowany", "providerProxyConfigureHint": "Skonfiguruj serwer proxy dla wszystkich połączeń tego dostawcy", "providerProxy": "Pełnomocnik dostawcy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Nie ma jeszcze żadnych połączeń", "addFirstConnectionHint": "Aby rozpocząć, dodaj swoje pierwsze połączenie", "addConnection": "Dodaj połączenie", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Identyfikator modelu", "customModelPlaceholder": "np. gpt-4.5-turbo", "loading": "Ładowanie...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "Kontrola stanu (min)", "healthCheckHint": "Proaktywny interwał odświeżania tokenu. 0 = wyłączone.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Nie udało się przetestować połączenia", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioTranscriptions": "Audio Transcriptions", - "repairEnvWorking": "Repairing...", - "hideEmails": "Hide all emails", - "modelsActiveCount": "{active}/{total} active", - "embeddings": "Embeddings", - "selectAllModels": "Select all", "showEmails": "Show all emails", - "audioSpeech": "Audio Speech", - "deselectAllModels": "Deselect all", - "repairEnv": "Repair env", - "repairEnvFailed": "Failed to repair .env", - "imagesGenerations": "Images Generations", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnvSuccess": "OAuth defaults restored", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Wyszukaj dostawców...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Ustawienia", @@ -2723,6 +3137,23 @@ "systemPrompt": "Monit systemowy", "thinkingBudget": "Myślący budżet", "proxy": "Pełnomocnik", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Ceny", "storage": "Przechowywanie", "policies": "Zasady", @@ -2733,6 +3164,46 @@ "enablePassword": "Włącz hasło", "darkMode": "Tryb ciemny", "lightMode": "Tryb światła", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "właśnie teraz", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Dostawcy", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Temat systemu", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Pamięć podręczna TTL", "maxCacheSize": "Maksymalny rozmiar pamięci podręcznej", "clearCache": "Wyczyść pamięć podręczną", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Trafienia w pamięci podręcznej", "cacheMisses": "Brak pamięci podręcznej", "hitRate": "Współczynnik trafień", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Włącz myślenie", "maxThinkingTokens": "Żetony Max Thinking", "enableProxy": "Włącz serwer proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Światło", "themeDark": "Ciemny", "themeSystem": "Systemu", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Ochrona punktów końcowych API", "requireAuthModels": "Wymagaj klucza API dla /models", "requireAuthModelsDesc": "Po włączeniu punkt końcowy /v1/models zwraca 404 dla nieuwierzytelnionych żądań. Zapobiega odkrywaniu modelu przez nieautoryzowanych użytkowników.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Zablokowani dostawcy", "blockedProvidersDesc": "Ukryj określonych dostawców w odpowiedzi /v1/models. Zablokowani dostawcy nie będą wyświetlani na listach modeli.", "providersBlocked": "{count} dostawcy zablokowani w /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Wybierz ostatnio używane konto", "costOpt": "Opcja kosztowa", "costOptDesc": "Preferuj najtańsze dostępne konto", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Lepki limit", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Strategia kombinacji", "priority": "Priorytet", "weighted": "Ważona", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Maksymalna liczba ponownych prób", "retryDelayLabel": "Opóźnienie ponownej próby (ms)", "timeoutLabel": "Limit czasu (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Maksymalna głębokość zagnieżdżenia", "concurrencyPerModel": "Współbieżność/model", "queueTimeout": "Limit czasu kolejki (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profile dostawców", "providerProfilesDesc": "Oddzielne ustawienia odporności dla dostawców OAuth (opartych na sesji) i kluczy API (mierzonych). Dostawcy protokołu OAuth mają bardziej rygorystyczne progi ze względu na niższe limity stawek.", "oauthProviders": "Dostawcy protokołu OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Utworzono kopię zapasową: {file}", "restoreSuccess": "Przywrócony! {connections} połączenia, {nodes} węzły, {combos} kombinacje, {apiKeys} klucze API.", "importSuccess": "Baza danych zaimportowana! {connections} połączenia, {nodes} węzły, {combos} kombinacje, {apiKeys} klucze API.", - "justNow": "właśnie teraz", "minutesAgo": "{count}m temu", "hoursAgo": "{count}h temu", "daysAgo": "{count}d temu", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Wystąpił błąd podczas importu", "modelPricing": "Ceny modeli", "modelPricingDesc": "Konfiguruj stawki kosztów dla każdego modelu • Wszystkie stawki w tokenach $/1M", - "providers": "Dostawcy", "registry": "Rejestr", "priced": "Wyceniony", "searchProvidersModels": "Wyszukaj dostawców lub modele...", @@ -3154,47 +3651,6 @@ "editPricing": "Edytuj ceny", "viewFullDetails": "Zobacz pełne szczegóły", "themeCoral": "Koral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "BŁĄD", "formatConverter": "Konwerter formatów", "formatConverterDescription": "Wklej lub wpisz treść żądania JSON. Tłumacz automatycznie wykryje format źródłowy i przekonwertuje go na format docelowy. Użyj tego, aby debugować sposób, w jaki OmniRoute tłumaczy żądania między formatami (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Wejście", "output": "Wyjście", "auto": "Automat", @@ -3573,6 +4059,11 @@ "errorMessage": "Błąd: {message}", "requestFailed": "Żądanie nie powiodło się", "noTextExtracted": "(Nie wyodrębniono tekstu)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Pokazuje zdarzenia związane z tłumaczeniem podczas przepływu wywołań API przez OmniRoute. Zdarzenia pochodzą z bufora w pamięci (resetują się przy ponownym uruchomieniu). Użyj", "liveMonitorDescriptionSuffix": "lub zewnętrzne wywołania API w celu wygenerowania zdarzeń." }, @@ -3648,14 +4139,25 @@ "passSuffix": "przejść", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Uruchom Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Uruchamiam {current}/{total}...", "passRate": "wskaźnik zdawalności", "summaryBreakdown": "{passed} zaliczony · {failed} nieudany · {total} łącznie", "passedIconLabel": "✅ Zdane", "failedIconLabel": "❌ Nie udało się", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Zawiera: „{term}”", "detailsRegex": "Wyrażenie regularne: {pattern}", "detailsExpected": "Oczekiwano: „{expected}”", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Jeszcze żadnych wyników", "testCasesCount": "Przypadki testowe ({count})", "noTestCasesDefined": "Nie zdefiniowano przypadków testowych", @@ -3723,6 +4225,16 @@ "tierFree": "Bezpłatny", "tierUnknown": "Nieznany", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentacja", "quickStart": "Szybki start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funkcje", "supportedProviders": "Obsługiwani dostawcy", "supportedProvidersToc": "Dostawcy", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Ustaw podstawowy adres URL klienta", "quickStartStep4Prefix": "Wskaż klienta IDE lub API", "quickStartStep4Suffix": "Użyj na przykład prefiksu dostawcy", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Routing wielu dostawców", "featureRoutingText": "Kieruj żądania do ponad 30 dostawców AI za pośrednictwem jednego punktu końcowego kompatybilnego z OpenAI. Obsługuje interfejsy API czatu, odpowiedzi, dźwięku i obrazu.", "featureCombosTitle": "Kombinacje i balansowanie", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Użyj", "clientClaudeBullet1Middle": "(Claude) lub", "clientClaudeBullet1Suffix": "Przedrostek (Antygrawitacja).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Użyj Panelu sterowania > Dostawcy > Testuj połączenie przed testowaniem z IDE lub klientów zewnętrznych.", "troubleshootingCircuitBreaker": "Jeśli dostawca pokazuje, że wyłącznik jest otwarty, poczekaj na ochłodzenie lub sprawdź stronę Zdrowie, aby uzyskać szczegółowe informacje.", "troubleshootingOAuth": "W przypadku dostawców OAuth należy ponownie uwierzytelnić, jeśli tokeny wygasną. Sprawdź wskaźnik stanu karty dostawcy.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Polityka prywatności", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "cacheRate": "Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "activityVolume": "Activity", - "hoursTracked": "hours tracked", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "semanticCache": "Semantic Cache", - "cacheRateDesc": "of total requests", - "cachedRequests24h": "Cached Requests (24h)", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "lastUpdated": "Last updated", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "trendHour": "Hour", - "busiestHour": "Busiest Hour", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "peakCacheRate": "Peak Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/pt-BR.json b/src/i18n/messages/pt-BR.json index 948ecf47c1..1ba4beb70a 100644 --- a/src/i18n/messages/pt-BR.json +++ b/src/i18n/messages/pt-BR.json @@ -23,6 +23,7 @@ "active": "Ativo", "inactive": "Inativo", "noData": "Nenhum dado disponível", + "nothingHere": "Nothing here yet", "configure": "Configurar", "manage": "Gerenciar", "name": "Nome", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Falha ao redefinir o preço", "apikey": "Chave de API", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Selecione o modelo", "combos": "Combos", "noModelsFound": "Nenhum modelo encontrado", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agentes", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memória", "skills": "Habilidades", "docs": "Documentação", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "Gerenciador API", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Log de Auditoria", "shutdown": "Desligar", "restart": "Reiniciar", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Avaliações", "utilization": "Utilização", "utilizationDescription": "Tendências de uso de cota do provedor e rastreamento de limites de taxa", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Saúde do Combo", "comboHealthDescription": "Cota em nível de combo, distribuição de uso e métricas de desempenho", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Último: {date}", "editPermissions": "Editar permissões", "deleteKey": "Excluir chave", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modelo", "models": "{count} modelos", "permissionsTitle": "Permissões: {name}", @@ -1177,32 +1285,6 @@ "kiloManualConfiguration": "Configuração manual do Kilo Code", "whenToUseLabel": "Quando usar", "openToolDocs": "Abrir documentos de ferramentas", - "toolCategories": "Categorias de Ferramentas", - "toolCategoriesDesc": "Agrupe CLIs pelo modo como o OmniRoute os configura ou intercepta para deixar esta página mais fácil de escanear.", - "autoConfiguredTab": "Auto-configurados", - "guidedClientsTab": "Clientes guiados", - "mitmClientsTab": "Clientes MITM", - "customCliTab": "Custom CLI", - "allToolsTab": "Todas as ferramentas", - "visibleToolsCount": "{count} ferramentas visíveis", - "customCliBuilderTitle": "Builder para CLI OpenAI-compatible", - "customCliBuilderDescription": "Gera variáveis de ambiente e blocos JSON para qualquer CLI ou SDK que aceite base URL, chave de API e model ID compatíveis com OpenAI.", - "customCliNameLabel": "Nome do CLI", - "customCliNamePlaceholder": "ex.: CLI do time", - "customCliDefaultModelLabel": "Modelo padrão", - "customCliDefaultModelHelp": "Use qualquer model ID ou combo do OmniRoute. A maioria dos CLIs OpenAI-compatible só precisa da base URL /v1 e de uma string de modelo.", - "customCliKeyHelper": "Em instalações locais o OmniRoute pode usar sk_omniroute. No modo cloud, escolha uma das suas management API keys.", - "customCliAliasMappingsLabel": "Mapeamentos de alias", - "customCliAliasMappingsHelp": "Aliases opcionais para wrappers ou arquivos de configuração que precisem de nomes curtos e estáveis.", - "customCliAliasPlaceholder": "ex.: review", - "customCliTargetModelLabel": "Modelo de destino", - "customCliAddAlias": "Adicionar alias", - "customCliNoMappings": "Ainda não há aliases. Adicione um se seus scripts ou wrappers usam nomes curtos estáveis.", - "customCliNoModels": "Conecte ao menos um provider para popular os seletores de modelo.", - "customCliEndpointHintLabel": "Como apontar o endpoint", - "customCliEndpointHint": "Aponte qualquer cliente OpenAI-compatible para a base URL /v1 do OmniRoute. O endpoint bruto de chat completions é {endpoint}. Use o bloco JSON quando a ferramenta pedir um objeto de provider, ou o script quando ela ler variáveis OPENAI_*.", - "customCliEnvBlockTitle": "Snippet de env / shell", - "customCliJsonBlockTitle": "Bloco JSON do provider", "toolUseCases": { "claude": "Use quando desejar fluxos de trabalho de planejamento robustos e refatorações longas de vários arquivos com Claude Code.", "codex": "Use quando sua equipe estiver padronizada em fluxos OpenAI Codex CLI e autenticação baseada em perfil.", @@ -1213,12 +1295,13 @@ "cursor": "Use ao codificar no Cursor e você precisar de modelos personalizados compatíveis com OpenAI por meio do OmniRoute.", "continue": "Use ao executar Continue em IDEs e você precisar de uma configuração de provedor portátil baseada em JSON.", "opencode": "Use quando preferir execuções de agentes nativos de terminal e automação com script via OpenCode.", - "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", "kiro": "Use ao integrar o Kiro e controlar o roteamento do modelo centralmente no OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Use quando o tráfego Antigravity/Kiro deve ser interceptado através do MITM e roteado para OmniRoute.", "copilot": "Use quando desejar UX no estilo de bate-papo do Copilot enquanto impõe chaves OmniRoute e regras de roteamento.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", + "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", "qwen": "Use quando precisar do Alibaba Qwen Code CLI para tarefas de programação.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", "custom": "Use quando seu CLI ou SDK não estiver hardcoded no OmniRoute, mas ainda aceitar base URL, chave de API e model string compatíveis com OpenAI." }, "toolDescriptions": { @@ -1232,11 +1315,12 @@ "cursor": "Editor de código com IA Cursor", "continue": "Assistente de IA Continue", "opencode": "OpenCode AI coding agent (Terminal)", - "amp": "CLI do assistente de codificação Sourcegraph Amp", "kiro": "Amazon Kiro — IDE com IA", "windsurf": "Windsurf — Editor de Código com IA", "copilot": "GitHub Copilot — Assistente de IA", "qwen": "Alibaba Qwen Code CLI", + "amp": "CLI do assistente de codificação Sourcegraph Amp", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", "custom": "Gerador genérico de configuração para CLI ou SDK OpenAI-compatible" }, "guides": { @@ -1361,7 +1445,15 @@ } } } - } + }, + "autoConfiguredTab": "Auto-configurados", + "toolCategoriesDesc": "Agrupe CLIs pelo modo como o OmniRoute os configura ou intercepta para deixar esta página mais fácil de escanear.", + "allToolsTab": "Todas as ferramentas", + "guidedClientsTab": "Clientes guiados", + "mitmClientsTab": "Clientes MITM", + "customCliTab": "Custom CLI", + "toolCategories": "Categorias de Ferramentas", + "visibleToolsCount": "{count} ferramentas visíveis" }, "combos": { "title": "Combos", @@ -1419,6 +1511,8 @@ "randomDesc": "Seleção aleatória uniforme, depois fallback para modelos restantes", "leastUsedDesc": "Escolhe o modelo com menos requisições, equilibrando carga ao longo do tempo", "costOptimizedDesc": "Roteia para o modelo mais barato primeiro baseado em preços", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Aleatório Estrito", "strictRandomDesc": "Baralho embaralhado — usa cada modelo uma vez antes de reembaralhar", "models": "Modelos", @@ -1477,20 +1571,45 @@ "avoid": "A base de preços está ausente ou desatualizada.", "example": "Jobs em lote ou segundo plano focados em menor custo." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Você quer distribuição perfeitamente uniforme — cada modelo é usado uma vez antes de repetir.", "avoid": "Os modelos têm qualidade ou latência muito diferentes e a ordem importa.", "example": "Múltiplas contas do mesmo modelo para distribuir uso de forma equilibrada." }, "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1525,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin é mais útil com pelo menos 2 modelos.", "warningCostOptimizedPartialPricing": "Apenas {priced} de {total} modelos têm preço. O roteamento pode ficar parcialmente orientado a custo.", "warningCostOptimizedNoPricing": "Não há dados de preço para este combo. Custo-otimizado pode rotear de forma inesperada.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Pronto para salvar?", "readinessDescription": "Revise a lista de verificação antes de criar ou atualizar este combo.", "readinessCheckName": "O nome do combo é válido", @@ -1542,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe básico", @@ -1585,12 +1748,61 @@ "tip2": "Mantenha um fallback de qualidade para prompts difíceis.", "tip3": "Use para jobs em lote/background onde custo é o KPI principal." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Distribuição estritamente uniforme", "description": "Cada modelo é usado exatamente uma vez antes de reembaralhar o baralho.", "tip1": "Ideal para múltiplas contas do mesmo modelo.", "tip2": "Garante que nenhuma conta é repetida antes de todas serem usadas.", "tip3": "Combine com health checks para pular contas indisponíveis sem quebrar o ciclo." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1611,16 +1823,12 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderPreview": "Preview", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "strategy": { - "label": "Strategy", - "description": "Routing behavior and advanced settings" - }, - "review": { - "description": "Final validation before saving", - "label": "Review" - }, "basics": { "label": "Basics", "description": "Name and starting template" @@ -1629,98 +1837,88 @@ "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "routerStrategyLabel": "Router Strategy", - "emailVisibilityStateOn": "On", - "reviewAdvanced": "Advanced Settings", - "reviewComboRefs": "Combo References", - "weightStability": "Stability", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderComboRefStep": "Add combo reference", - "builderStageCurrent": "Current stage", "builderStageVisited": "Stage completed", - "builderAccount": "Account", - "explorationRateLabel": "Exploration Rate", - "excludedProviders": "Excluded Providers", - "weightLatencyInv": "Latency", - "reorderHandle": "Drag to reorder", - "builderTitle": "Build a Combo", - "builderProviderFirst": "Pick provider first", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "statusOverview": "Status Overview", - "filterEmptyTitle": "No combos match this strategy filter.", - "builderStageLocked": "Locked — complete previous stage first", - "builderPinnedAccount": "Pinned Account", - "budgetCapLabel": "Budget Cap (USD / request)", - "modePackUpdated": "Mode pack updated to {pack}.", - "incidentMode": "Incident Mode", - "providerScores": "Provider Scores", - "noExcludedProviders": "No providers are currently excluded.", - "normalOperation": "Normal Operation", - "reviewProviders": "Providers", - "builderSelectModel": "Select model", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "builderFlowTitle": "Combo Builder Flow", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "filterIntelligent": "Intelligent", - "weightTierPriority": "Tier", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "filterDeterministic": "Deterministic", - "builderSelectProvider": "Select provider", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "budgetCapPlaceholder": "No limit", - "builderAddStep": "Add step", - "builderLegacyEntry": "Legacy entry", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "filterAll": "All", - "candidatePoolEmpty": "No active providers available yet.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "builderComboRef": "Combo Ref", - "builderLoadingProviders": "Loading providers...", - "emailVisibilityStateOff": "Off", - "reviewSequence": "Model Sequence", - "reviewSteps": "Steps", - "candidatePoolLabel": "Candidate Pool", - "reviewAgentFlags": "Agent Flags", - "cooldownMinutes": "Cooldown: {minutes}m", - "modePackLabel": "Mode Pack", - "reviewName": "Name", - "weightHealth": "Health", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "activeModePack": "Active Mode Pack", - "reviewStrategy": "Strategy", - "candidatePoolAllProviders": "All providers", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "reviewIntelligentTitle": "Intelligent Routing Config", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "failedReorder": "Failed to reorder models", - "builderBrowseCatalog": "Browse catalog", - "weightTaskFit": "Task Fit", - "builderProvider": "Provider", - "reviewAccounts": "Accounts", - "strategyRules": "Rules (6-Factor Scoring)", - "weightCostInv": "Cost", - "builderAddComboRef": "Add combo reference", - "weightQuota": "Quota", - "reviewNoSteps": "No steps configured", - "builderModel": "Model", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo." + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Custos", "pageDescription": "Acompanhe gasto por provedor, monitore orçamentos e gerencie preços sincronizados.", - "budget": "Orçamento", "overview": "Visão Geral", - "overviewTitle": "Visão Geral de Custos", - "overviewDescription": "Gasto global em todas as API keys, provedores e modelos usando analytics de uso em tempo real.", - "overviewLoadFailed": "Falha ao carregar a visão geral de custos", + "budget": "Orçamento", "totalCost": "Custo Total", "breakdown": "Detalhamento de Custos", "noData": "Sem dados de custo", @@ -1730,20 +1928,55 @@ "range30d": "30D", "range90d": "90D", "rangeAll": "Tudo", - "spendToday": "Gasto Hoje", - "spend7d": "Gasto 7D", "spend30d": "Gasto 30D", - "selectedWindow": "Janela Selecionada", - "requestsInWindow": "Requisições", - "activeProviders": "Provedores Ativos", "activeModels": "Modelos Ativos", + "selectedWindow": "Janela Selecionada", + "activeProviders": "Provedores Ativos", + "overviewTitle": "Visão Geral de Custos", + "spend7d": "Gasto 7D", "avgCostPerRequest": "Custo Médio / Requisição", - "costTrend": "Tendência Diária de Custo", + "noCostDataDescription": "Passe tráfego pelo OmniRoute ou sincronize preços para preencher este dashboard.", + "spendToday": "Gasto Hoje", + "overviewLoadFailed": "Falha ao carregar a visão geral de custos", + "overviewDescription": "Gasto global em todas as API keys, provedores e modelos usando analytics de uso em tempo real.", "providerShare": "Gasto por Provedor", "topProviders": "Principais Provedores", - "topModels": "Principais Modelos", + "costTrend": "Tendência Diária de Custo", "noCostDataTitle": "Ainda não há gasto registrado", - "noCostDataDescription": "Passe tráfego pelo OmniRoute ou sincronize preços para preencher este dashboard." + "topModels": "Principais Modelos", + "requestsInWindow": "Requisições", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Endpoint da API", @@ -1768,14 +2001,14 @@ "embeddingsDesc": "Embeddings de texto para busca e pipelines RAG", "imageGeneration": "Geração de Imagens", "imageDesc": "Gerar imagens a partir de prompts de texto", - "videoGeneration": "Geração de Vídeo", - "videoDesc": "Gerar vídeos via ComfyUI, Stable Diffusion WebUI e provedores compatíveis", "rerank": "Rerank", "rerankDesc": "Reordenar documentos por relevância a uma consulta", "audioTranscription": "Transcrição de Áudio", "audioTranscriptionDesc": "Transcrever arquivos de áudio para texto (Whisper)", "textToSpeech": "Texto para Fala", "textToSpeechDesc": "Converter texto em fala natural", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderações", "moderationsDesc": "Moderação de conteúdo e classificação de segurança", "responsesDesc": "API Responses do OpenAI para Codex e fluxos de trabalho agênticos avançados", @@ -1876,8 +2109,8 @@ "a2aQuickStartStep3": "Acompanhe e controle tarefas com `tasks/get` e `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", + "videoGeneration": "Geração de Vídeo", + "videoDesc": "Gerar vídeos via ComfyUI, Stable Diffusion WebUI e provedores compatíveis", "tailscaleRequestFailed": "Failed to load Tailscale status", "tailscaleEnableFailed": "Falha ao habilitar o Tailscale Funnel", "tailscaleWaitingForLogin": "Conclua o login do Tailscale na aba aberta do navegador. O OmniRoute tentará novamente de forma automática.", @@ -2090,11 +2323,11 @@ "content": "Conteúdo", "created": "Criado", "actions": "Ações", + "delete": "Delete", "factual": "Factual", "episodic": "Episódica", "procedural": "Procedural", "semantic": "Semântica", - "delete": "Delete", "a": "A" }, "skills": { @@ -2193,17 +2426,83 @@ "running": "executando", "runningCount": "{count} executando", "ok": "OK", - "limitExhausted": "Esgotado", - "learnedFromHeaders": "Aprendido a partir dos headers do provedor", - "remainingOfLimit": "{remaining} / {limit} RPM restantes", - "throttleStatus": "Acelerador: {value}", - "lastHeaderUpdate": "Atualização do header: há {age}", "activeLockouts": "Bloqueios Ativos", "resetConfirm": "Resetar todos os circuit breakers para estado saudável? Isso limpará todos os contadores de falha e restaurará todos os provedores ao status operacional.", "resetAllTitle": "Resetar todos os circuit breakers para estado saudável", "resetting": "Resetando...", "resetAll": "Resetar Tudo", - "until": "Até {time}" + "until": "Até {time}", + "limitExhausted": "Esgotado", + "learnedFromHeaders": "Aprendido a partir dos headers do provedor", + "remainingOfLimit": "{remaining} / {limit} RPM restantes", + "throttleStatus": "Acelerador: {value}", + "lastHeaderUpdate": "Atualização do header: há {age}" + }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." }, "limits": { "title": "Limites e Cotas", @@ -2220,11 +2519,8 @@ "auditLog": "Log de Auditoria", "console": "Console", "auditLogDesc": "Ações administrativas e eventos de segurança", - "runningRequests": "Requisições em Execução", - "runningRequestsDesc": "Requisições ainda em voo entre provedores e contas, com previews sanitizados dos payloads.", "loading": "Carregando...", "refresh": "Atualizar", - "activeCount": "{count} ativas", "filterByAction": "Filtrar por ação...", "filterByActor": "Filtrar por ator...", "filterEntriesAria": "Filtrar entradas do log de auditoria", @@ -2237,13 +2533,31 @@ "search": "Buscar", "timestamp": "Data/Hora", "action": "Ação", - "status": "Status", "actor": "Ator", "target": "Alvo", - "resourceType": "Tipo de Recurso", "details": "Detalhes", "ipAddress": "Endereço IP", + "notAvailable": "—", + "noEntries": "Nenhuma entrada de log de auditoria encontrada", + "previous": "Anterior", + "next": "Próximo", + "providerWarningTitle": "Aviso de provedor capturado", + "viewDetails": "Ver Detalhes", + "eventMetadata": "Metadados do Evento", + "eventPayload": "Payload do Evento", "requestId": "Request ID", + "providerWarningDesc": "Esta requisição terminou com um aviso do provedor ou alerta do sanitizador em vez de uma falha dura.", + "a": "A", + "offset": "Offset", + "limit": "Limit", + "status": "Status", + "resourceType": "Tipo de Recurso", + "totalEntries": "{count} eventos no total", + "tab": "Tab", + "auditModalSubtitle": "Ator: {actor} • Alvo: {target}", + "close": "Fechar", + "runningRequests": "Requisições em Execução", + "runningRequestsDesc": "Requisições ainda em voo entre provedores e contas, com previews sanitizados dos payloads.", "model": "Modelo", "provider": "Provedor", "account": "Conta", @@ -2251,37 +2565,22 @@ "count": "Qtd.", "payloads": "Payloads", "viewPayloads": "Ver Payloads", + "activeCount": "{count} ativas", "clientPayload": "Requisição do Cliente", "upstreamPayload": "Requisição Upstream", "upstreamNotSentYet": "Requisição upstream ainda não foi enviada", "runningRequestDetailMeta": "Conta: {account} • Tempo: {elapsed}", - "viewDetails": "Ver Detalhes", - "providerWarningTitle": "Aviso de provedor capturado", - "providerWarningDesc": "Esta requisição terminou com um aviso do provedor ou alerta do sanitizador em vez de uma falha dura.", - "eventMetadata": "Metadados do Evento", - "eventPayload": "Payload do Evento", - "auditModalSubtitle": "Ator: {actor} • Alvo: {target}", - "totalEntries": "{count} eventos no total", - "close": "Fechar", - "notAvailable": "—", - "noEntries": "Nenhuma entrada de log de auditoria encontrada", - "previous": "Anterior", - "next": "Próximo", - "a": "A", - "offset": "Offset", - "limit": "Limit", - "tab": "Tab", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Bem-vindo", @@ -2352,11 +2651,6 @@ "oauthProviders": "Provedores OAuth", "freeProviders": "Provedores Gratuitos", "apiKeyProviders": "Provedores por Chave de API", - "llmProviders": "Provedores LLM", - "localProviders": "Local / Self-Hosted", - "upstreamProxyProviders": "Proxy Upstream", - "aggregatorsGateways": "Agregadores / Gateways", - "imageProviders": "Geração de Imagem", "compatibleProviders": "Provedores Compatíveis por Chave de API", "testAll": "Testar Todos", "testAllOAuth": "Testar todas as conexões OAuth", @@ -2367,6 +2661,12 @@ "errorCount": "{count} Erro ({code})", "errorCountNoCode": "{count} Erro", "noConnections": "Sem conexões", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "Plano gratuito", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Desativado", "enableProvider": "Ativar provedor", "disableProvider": "Desativar provedor", @@ -2401,13 +2701,6 @@ "errorOccurred": "Ocorreu um erro. Tente novamente.", "modelStatus": "Status dos Modelos", "showConfiguredOnly": "Configured only", - "searchProviders": "Buscar provedores...", - "searchProvidersHeading": "Provedores de Busca", - "audioProvidersHeading": "Provedores de Áudio", - "webCookieProviders": "Provedores Web / Cookie", - "ccCompatibleLabel": "CC Compatível", - "addCcCompatible": "Adicionar CC Compatível", - "configuredCount": "{configured} de {total} configurados", "allModelsOperational": "Todos os modelos operacionais", "modelsWithIssues": "{count} modelo(s) com problemas", "allModelsNormal": "Todos os modelos estão respondendo normalmente.", @@ -2429,17 +2722,6 @@ "noActiveConnectionsInGroup": "Nenhuma conexão ativa encontrada para este grupo.", "allTestsPassed": "Todos os {total} testes passaram", "testSummary": "{passed}/{total} passaram, {failed} falharam", - "expirationBannerExpired": "{count} conexão(ões) de provedor expirada(s)", - "expirationBannerExpiringSoon": "{count} conexão(ões) de provedor expirando em breve", - "expirationBannerExpiredDesc": "Ação imediata necessária. Conexões expiradas falharão permanentemente.", - "expirationBannerExpiringSoonDesc": "Revise e renove as conexões prestes a expirar para evitar interrupções.", - "zedImportButton": "Importar do Zed", - "zedImporting": "Importando...", - "zedImportNone": "Nenhuma credencial OAuth suportada encontrada no Zed IDE.", - "zedImportHint": "Importar credenciais do Zed IDE", - "zedImportSuccess": "Importadas {count} credencial(is) do Zed IDE ({providers}).", - "zedImportFailed": "Falha ao importar do Zed IDE.", - "zedImportNetworkError": "Erro de rede ao tentar importar do Zed.", "nameLabel": "Nome", "prefixLabel": "Prefixo", "baseUrlLabel": "URL Base", @@ -2471,9 +2753,14 @@ "openaiCompatibleDetails": "Detalhes Compatível OpenAI", "messagesApi": "API de Mensagens", "responsesApi": "API de Respostas", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chat Completions", "importingModels": "Importando...", "importFromModels": "Importar de /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Todos os modelos já foram importados", "noNewModelsToImport": "Nenhum modelo novo para importar — todos os modelos já estão no registro ou na lista de modelos personalizados", "skippingExistingModels": "Ignorando {count} modelos existentes", @@ -2495,6 +2782,7 @@ "importFailed": "Falha na importação", "noNewModelsAdded": "Nenhum novo modelo foi adicionado.", "adding": "Adicionando...", + "close": "Close", "importingModelsTitle": "Importando Modelos", "copyModel": "Copiar modelo", "filterModels": "Filtrar modelos...", @@ -2535,6 +2823,11 @@ "configured": "configurado", "providerProxyConfigureHint": "Configurar proxy para todas as conexões deste provedor", "providerProxy": "Proxy do Provedor", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Ainda não há conexões", "addFirstConnectionHint": "Adicione sua primeira conexão para começar", "addConnection": "Adicionar Conexão", @@ -2601,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID do Modelo", "customModelPlaceholder": "ex.: gpt-4.5-turbo", "loading": "Carregando...", @@ -2616,7 +2912,6 @@ "modelRemovedSuccess": "Modelo removido com sucesso", "failedDeleteModelTryAgain": "Falha ao excluir modelo. Tente novamente.", "compatibleModelsDescription": "Adicione modelos compatíveis com {type} manualmente ou importe-os do endpoint /models.", - "ccCompatibleModelsDescription": "Os modelos disponíveis de CC Compatível espelham a lista do provedor OAuth Claude Code.", "anthropicCompatibleModelPlaceholder": "claude-3-opus-20240229", "openaiCompatibleModelPlaceholder": "gpt-4o", "apiKeyValidationFailed": "A validação da chave de API falhou. Verifique sua chave e tente novamente.", @@ -2667,152 +2962,169 @@ "statusDeactivated": "Desativado (Manual)", "statusBanned": "Banido / Sandbox Violation", "statusCreditsExhausted": "Saldo Insuficiente", - "modelsImported": "{count} models imported", - "close": "Close", - "embeddings": "Embeddings", - "audioSpeech": "Audio Speech", - "imagesGenerations": "Images Generations", - "repairEnv": "Repair env", - "repairEnvFailed": "Failed to repair .env", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", "showEmails": "Show all emails", - "repairEnvWorking": "Repairing...", - "repairEnvSuccess": "OAuth defaults restored", "hideEmails": "Hide all emails", - "audioTranscriptions": "Audio Transcriptions", - "upstreamProxyManagedTitle": "Gerenciado via Configurações de Proxy Upstream", - "upstreamProxyManagedDescription": "CLIProxyAPI é configurado como uma camada de proxy upstream, não como uma conexão direta de provedor. Gerencie o binário/runtime em CLI Tools e habilite o roteamento por proxy em cada provedor pelos controles de proxy do provedor.", - "openCliTools": "Abrir CLI Tools", - "openSettings": "Abrir Configurações", - "searchProvider": "Provedor de Busca", - "searchProviderDesc": "Este provedor é usado para busca web via POST /v1/search. Nenhuma configuração de modelo é necessária depois que uma chave de API estiver conectada.", - "perplexitySearchSharedKeyInfo": "Usa a mesma chave de API do Perplexity (provedor de chat). Se você já configurou o Perplexity, não é necessário setup adicional.", - "googlePseInfo": "O Google Programmable Search exige dois valores: sua chave de API e o Search Engine ID (cx) do painel do Programmable Search Engine.", - "searxngInfo": "SearXNG é self-hosted. Configure aqui a URL base da instância. A chave de API é opcional e pode ficar em branco para instâncias públicas ou sem autenticação. A validação de URLs locais/privadas exige OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true.", - "tokenExpiredTitle": "Token expirado: {date}", - "tokenExpiredBadge": "Expirado", - "tokenExpiresSoonTitle": "Token expira em {minutes}m", - "claudeExtraUsageToggleTitle": "Alternar bloqueio de extra usage do Claude", - "claudeExtraUsageShort": "Bloquear Extra", - "cpaModeEnabledTitle": "Usando CLIProxyAPI para uma emulação mais profunda do Claude Code (uTLS, multi-conta, perfis de dispositivo)", - "cpaModeDisabledTitle": "Habilitar backend CLIProxyAPI para emulação OAuth mais profunda do Claude Code", - "codex5hToggleTitle": "Alternar política de limite 5h do Codex", - "codexWeeklyToggleTitle": "Alternar política de limite semanal do Codex", - "weeklyShort": "Semanal", - "toggleOnShort": "ON", - "toggleOffShort": "OFF", - "refreshOauthTokenTitle": "Atualizar token OAuth manualmente", - "tokenShort": "Token", - "supportedEndpointsLabel": "Endpoints Suportados", - "supportedEndpointChat": "Chat", - "supportedEndpointEmbeddings": "Embeddings", - "supportedEndpointImages": "Imagens", - "supportedEndpointAudio": "Áudio", - "apiFormatLabel": "Formato da API", - "imagesShortLabel": "Imagens", - "audioShortLabel": "Áudio", - "searchEngineIdLabel": "Search Engine ID (cx)", - "searchEngineIdHint": "Obrigatório. Encontre isso na visão geral do seu Programmable Search Engine.", - "searchEngineIdRequired": "O Search Engine ID (cx) do Programmable Search Engine é obrigatório.", - "ccCompatibleContext1mLabel": "Contexto 1M CC Compatível", - "ccCompatibleContext1mDescription": "Quando habilitado, esta conexão adiciona `anthropic-beta: context-1m-2025-08-07`.", - "ccCompatibleValidationHint": "A validação usa a bridge estrita compatível com Claude Code para este provedor.", - "ccCompatibleDetailsTitle": "Detalhes CC Compatível", - "customUserAgentLabel": "User-Agent Customizado", - "customUserAgentHint": "Override opcional enviado upstream como cabeçalho User-Agent desta conexão.", - "routingTagsLabel": "Tags de Roteamento", - "routingTagsPlaceholder": "fast, cheap, eu-region", - "routingTagsHint": "Tags separadas por vírgula, comparadas com request metadata.tags para roteamento por tags.", - "excludedModelsLabel": "Modelos Excluídos", - "excludedModelsPlaceholder": "gpt-5*, claude-opus-*, gemini-*-pro*", - "excludedModelsHint": "Padrões wildcard separados por vírgula. Esta conexão será ignorada para modelos correspondentes.", - "consoleApiKeyOracleLabel": "Chave de API do Console (Oracle)", - "consoleApiKeyOraclePlaceholder": "Chave de API do Console Alibaba", - "consoleApiKeyOracleHint": "Obrigatório para consulta de cota. Não compartilhe.", - "validationModelIdLabel": "ID do Modelo (opcional)", - "validationModelIdPlaceholder": "ex.: grok-3 ou meta-llama/Llama-3.1-8B-Instruct", - "validationModelIdHint": "Usado como fallback se a listagem de modelos não estiver disponível.", - "regionLabel": "Região", - "regionHint": "ex.: us-central1 ou europe-west4. Modelos partner usam a região global automaticamente.", + "a": "A", + "accountConcurrencyCapHint": "Account Concurrency Cap Hint", + "accountConcurrencyCapLabel": "Account Concurrency Cap Label", + "accountIdHint": "Encontre isso na URL do dashboard da Cloudflare ou nas configurações.", "accountIdLabel": "Account ID", "accountIdPlaceholder": "Cloudflare Account ID", - "accountIdHint": "Encontre isso na URL do dashboard da Cloudflare ou nas configurações.", - "apiRegionLabel": "Região da API", + "addAnotherApiKey": "Adicionar outra chave de API...", + "addCcCompatible": "Adicionar CC Compatível", + "aggregatorsGateways": "Agregadores / Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", + "apiFormatLabel": "Formato da API", + "apiKeyOptionalHint": "Opcional. Deixe em branco se sua instância SearXNG não exigir autenticação.", + "apiKeyOptionalLabel": "Chave de API (opcional)", + "apiRegionChina": "China Continental (open.bigmodel.cn)", "apiRegionHint": "Selecione a região do endpoint para acesso à API e rastreamento de cota.", "apiRegionInternational": "Internacional (api.z.ai)", - "apiRegionChina": "China Continental (open.bigmodel.cn)", - "extraApiKeysLabel": "Chaves de API Extras", - "extraApiKeysHint": "Rotação round-robin — opcional", - "extraApiKeyMasked": "Chave {index}: {prefix}••••{suffix}", - "removeThisKey": "Remover esta chave", - "addAnotherApiKey": "Adicionar outra chave de API...", - "totalKeysRotating": "{count} chaves no total — rotacionando em round-robin a cada request.", - "tagGroupLabel": "Tag / Grupo", - "tagGroupPlaceholder": "ex.: personal, work, team-a", - "tagGroupHint": "Usado para agrupar contas na visão do provedor.", - "defaultThinkingStrengthLabel": "Intensidade de raciocínio padrão", - "deleteAllExtraApiKeys": "Excluir todas", - "defaultThinkingStrengthHint": "Usada quando o cliente não envia reasoning effort e o modo global Thinking Budget está em passthrough.", - "maxConcurrentWholeNumberError": "Max concurrent deve ser um número inteiro maior ou igual a 0.", - "codexFastServiceTierLabel": "Codex Fast Service Tier", - "codexFastServiceTierDescription": "Quando habilitado, injeta `service_tier=priority` para esta conexão se o cliente não definir o tier.", - "openaiResponsesStoreLabel": "OpenAI Responses Store", - "openaiResponsesStoreDescription": "Preserva `store`, `previous_response_id` e adiciona um `session_id` estável como fallback para sessões longas do Codex. Habilite apenas quando a conta upstream aceitar Responses armazenadas.", + "apiRegionLabel": "Região da API", + "apikey": "Apikey", + "audio": "Audio", + "audioProvidersHeading": "Provedores de Áudio", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", + "audioShortLabel": "Áudio", + "azureOpenAiBaseUrlHint": "Obrigatório: cole o endpoint do seu recurso Azure OpenAI. O OmniRoute adicionará /openai/deployments/{model}/chat/completions?api-version=....", + "bailianBaseUrlHint": "Opcional: URL base customizada para o provedor bailian-coding-plan.", + "blackboxWebCookieHint": "Cole o cookie __Secure-authjs.session-token de app.blackbox.ai. Um cabeçalho de cookie completo também funciona.", + "blackboxWebCookiePlaceholder": "Cole o valor de __Secure-authjs.session-token", + "blockClaudeExtraUsageDescription": "Quando habilitado, o OmniRoute marca esta conta do Claude Code como indisponível assim que a API de usage reporta `extra_usage.queued`, para que o fallback troque para outra conta antes de continuar com cobranças extras pay-as-you-go.", "blockClaudeExtraUsageLabel": "Bloquear Claude Extra Usage", "bulkPasteAdded": "{count, plural, one {1 chave adicionada} other {# chaves adicionadas}}", "bulkPasteDuplicatesIgnored": "{count, plural, one {1 duplicata ignorada} other {# duplicatas ignoradas}}", "bulkPasteHint": "Cole uma chave de API por linha. Linhas vazias são ignoradas e chaves duplicadas são puladas.", - "blockClaudeExtraUsageDescription": "Quando habilitado, o OmniRoute marca esta conta do Claude Code como indisponível assim que a API de usage reporta `extra_usage.queued`, para que o fallback troque para outra conta antes de continuar com cobranças extras pay-as-you-go.", - "hideEmail": "Ocultar e-mail", - "showEmail": "Mostrar e-mail", - "vertexServiceAccountPlaceholder": "Cole o JSON da Service Account aqui", - "personalAccessTokenLabel": "Personal Access Token", - "sessionCookieLabel": "Cookie de Sessão", - "qoderPatPlaceholder": "Cole seu Personal Access Token do Qoder", - "qoderPatHint": "Fluxo suportado: PAT via qodercli. OAuth pelo navegador continua experimental.", - "grokWebCookiePlaceholder": "Cole o valor do cookie sso do grok.com", - "grokWebCookieHint": "Cole o cookie sso do grok.com. Um valor completo `sso=...` também funciona.", - "perplexityWebCookiePlaceholder": "Cole o valor de __Secure-next-auth.session-token", - "perplexityWebCookieHint": "Cole o cookie __Secure-next-auth.session-token do perplexity.ai.", - "blackboxWebCookiePlaceholder": "Cole o valor de __Secure-authjs.session-token", - "blackboxWebCookieHint": "Cole o cookie __Secure-authjs.session-token de app.blackbox.ai. Um cabeçalho de cookie completo também funciona.", - "museSparkWebCookiePlaceholder": "Cole o valor de abra_sess", - "museSparkWebCookieHint": "Cole o cookie abra_sess do meta.ai. Um cabeçalho de cookie completo também funciona.", - "apiKeyOptionalLabel": "Chave de API (opcional)", - "apiKeyOptionalHint": "Opcional. Deixe em branco se sua instância SearXNG não exigir autenticação.", - "localProviderApiKeyOptionalHint": "Opcional. Deixe em branco se o endpoint {provider} não exigir autenticação.", - "ccCompatibleNamePlaceholder": "Produção CC Compatível", - "ccCompatibleNameHint": "Nome de exibição para este provedor.", - "ccCompatiblePrefixPlaceholder": "cc", - "ccCompatiblePrefixHint": "Usado para aliases como prefix/model-id.", - "ccCompatibleBaseUrlPlaceholder": "https://example.com/v1", "ccCompatibleBaseUrlHint": "URL base do site compatível com CC. Não inclua /messages.", + "ccCompatibleBaseUrlPlaceholder": "https://example.com/v1", "ccCompatibleChatPathHint": "O padrão é o caminho estrito de messages compatível com Claude Code.", + "ccCompatibleContext1mDescription": "Quando habilitado, esta conexão adiciona `anthropic-beta: context-1m-2025-08-07`.", + "ccCompatibleContext1mLabel": "Contexto 1M CC Compatível", + "ccCompatibleDetailsTitle": "Detalhes CC Compatível", + "ccCompatibleLabel": "CC Compatível", + "ccCompatibleModelsDescription": "Os modelos disponíveis de CC Compatível espelham a lista do provedor OAuth Claude Code.", + "ccCompatibleNameHint": "Nome de exibição para este provedor.", + "ccCompatibleNamePlaceholder": "Produção CC Compatível", + "ccCompatiblePrefixHint": "Usado para aliases como prefix/model-id.", + "ccCompatiblePrefixPlaceholder": "cc", + "ccCompatibleValidationHint": "A validação usa a bridge estrita compatível com Claude Code para este provedor.", + "claudeExtraUsageShort": "Bloquear Extra", + "claudeExtraUsageToggleTitle": "Alternar bloqueio de extra usage do Claude", + "codex5hToggleTitle": "Alternar política de limite 5h do Codex", + "codexFastServiceTierDescription": "Quando habilitado, injeta `service_tier=priority` para esta conexão se o cliente não definir o tier.", + "codexFastServiceTierLabel": "Codex Fast Service Tier", + "codexWeeklyToggleTitle": "Alternar política de limite semanal do Codex", "compatUpstreamHeaderNamePlaceholder": "Authentication", "compatUpstreamHeaderValuePlaceholder": "•••", - "azureOpenAiBaseUrlHint": "Obrigatório: cole o endpoint do seu recurso Azure OpenAI. O OmniRoute adicionará /openai/deployments/{model}/chat/completions?api-version=....", - "bailianBaseUrlHint": "Opcional: URL base customizada para o provedor bailian-coding-plan.", - "xiaomiMimoBaseUrlHint": "Opcional: URL base token-plan do Xiaomi MiMo. Exemplos: https://token-plan-ams.xiaomimimo.com/v1, https://token-plan-sgp.xiaomimimo.com/v1, https://token-plan-cn.xiaomimimo.com/v1. O app adicionará /chat/completions.", - "herokuBaseUrlHint": "Obrigatório: cole a URL base do Heroku Inference. O app adicionará /v1/chat/completions.", - "databricksBaseUrlHint": "Obrigatório: cole a URL base do serving-endpoints do Databricks. O app adicionará /chat/completions.", - "snowflakeBaseUrlHint": "Obrigatório: cole a URL base da conta Snowflake. O app adicionará /api/v2/cortex/inference:complete.", - "searxngBaseUrlHint": "Obrigatório: cole a URL base da sua instância SearXNG. O app usará /search e request format=json. URLs locais/privadas exigem OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true para validação no dashboard.", - "localProviderBaseUrlHint": "Obrigatório: cole a URL base OpenAI-compatible /v1 do seu {provider} (padrão: {baseUrl}). URLs locais/privadas exigem OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true para validação no dashboard.", - "a": "A", - "accountConcurrencyCapHint": "Account Concurrency Cap Hint", - "accountConcurrencyCapLabel": "Account Concurrency Cap Label", - "apikey": "Apikey", - "audio": "Audio", "compatible": "Compatible", + "configuredCount": "{configured} de {total} configurados", + "consoleApiKeyOracleHint": "Obrigatório para consulta de cota. Não compartilhe.", + "consoleApiKeyOracleLabel": "Chave de API do Console (Oracle)", + "consoleApiKeyOraclePlaceholder": "Chave de API do Console Alibaba", + "cpaModeDisabledTitle": "Habilitar backend CLIProxyAPI para emulação OAuth mais profunda do Claude Code", + "cpaModeEnabledTitle": "Usando CLIProxyAPI para uma emulação mais profunda do Claude Code (uTLS, multi-conta, perfis de dispositivo)", + "customUserAgentHint": "Override opcional enviado upstream como cabeçalho User-Agent desta conexão.", + "customUserAgentLabel": "User-Agent Customizado", + "databricksBaseUrlHint": "Obrigatório: cole a URL base do serving-endpoints do Databricks. O app adicionará /chat/completions.", + "defaultThinkingStrengthHint": "Usada quando o cliente não envia reasoning effort e o modo global Thinking Budget está em passthrough.", + "defaultThinkingStrengthLabel": "Intensidade de raciocínio padrão", + "deleteAllExtraApiKeys": "Excluir todas", + "excludedModelsHint": "Padrões wildcard separados por vírgula. Esta conexão será ignorada para modelos correspondentes.", + "excludedModelsLabel": "Modelos Excluídos", + "excludedModelsPlaceholder": "gpt-5*, claude-opus-*, gemini-*-pro*", + "expirationBannerExpired": "{count} conexão(ões) de provedor expirada(s)", + "expirationBannerExpiredDesc": "Ação imediata necessária. Conexões expiradas falharão permanentemente.", + "expirationBannerExpiringSoon": "{count} conexão(ões) de provedor expirando em breve", + "expirationBannerExpiringSoonDesc": "Revise e renove as conexões prestes a expirar para evitar interrupções.", + "extraApiKeyMasked": "Chave {index}: {prefix}••••{suffix}", + "extraApiKeysHint": "Rotação round-robin — opcional", + "extraApiKeysLabel": "Chaves de API Extras", + "googlePseInfo": "O Google Programmable Search exige dois valores: sua chave de API e o Search Engine ID (cx) do painel do Programmable Search Engine.", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "grokWebCookieHint": "Cole o cookie sso do grok.com. Um valor completo `sso=...` também funciona.", + "grokWebCookiePlaceholder": "Cole o valor do cookie sso do grok.com", + "herokuBaseUrlHint": "Obrigatório: cole a URL base do Heroku Inference. O app adicionará /v1/chat/completions.", + "hideEmail": "Ocultar e-mail", + "imageProviders": "Geração de Imagem", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", + "imagesShortLabel": "Imagens", + "llmProviders": "Provedores LLM", + "localProviderApiKeyOptionalHint": "Opcional. Deixe em branco se o endpoint {provider} não exigir autenticação.", + "localProviderBaseUrlHint": "Obrigatório: cole a URL base OpenAI-compatible /v1 do seu {provider} (padrão: {baseUrl}). URLs locais/privadas exigem OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true para validação no dashboard.", + "localProviders": "Local / Self-Hosted", + "maxConcurrentWholeNumberError": "Max concurrent deve ser um número inteiro maior ou igual a 0.", + "museSparkWebCookieHint": "Cole o cookie abra_sess do meta.ai. Um cabeçalho de cookie completo também funciona.", + "museSparkWebCookiePlaceholder": "Cole o valor de abra_sess", "oauth": "Oauth", + "openCliTools": "Abrir CLI Tools", + "openSettings": "Abrir Configurações", + "openaiResponsesStoreDescription": "Preserva `store`, `previous_response_id` e adiciona um `session_id` estável como fallback para sessões longas do Codex. Habilite apenas quando a conta upstream aceitar Responses armazenadas.", + "openaiResponsesStoreLabel": "OpenAI Responses Store", + "perplexitySearchSharedKeyInfo": "Usa a mesma chave de API do Perplexity (provedor de chat). Se você já configurou o Perplexity, não é necessário setup adicional.", + "perplexityWebCookieHint": "Cole o cookie __Secure-next-auth.session-token do perplexity.ai.", + "perplexityWebCookiePlaceholder": "Cole o valor de __Secure-next-auth.session-token", + "personalAccessTokenLabel": "Personal Access Token", + "qoderPatHint": "Fluxo suportado: PAT via qodercli. OAuth pelo navegador continua experimental.", + "qoderPatPlaceholder": "Cole seu Personal Access Token do Qoder", + "refreshOauthTokenTitle": "Atualizar token OAuth manualmente", + "regionHint": "ex.: us-central1 ou europe-west4. Modelos partner usam a região global automaticamente.", + "regionLabel": "Região", + "removeThisKey": "Remover esta chave", + "routingTagsHint": "Tags separadas por vírgula, comparadas com request metadata.tags para roteamento por tags.", + "routingTagsLabel": "Tags de Roteamento", + "routingTagsPlaceholder": "fast, cheap, eu-region", "search": "Search", + "searchEngineIdHint": "Obrigatório. Encontre isso na visão geral do seu Programmable Search Engine.", + "searchEngineIdLabel": "Search Engine ID (cx)", + "searchEngineIdRequired": "O Search Engine ID (cx) do Programmable Search Engine é obrigatório.", + "searchProvider": "Provedor de Busca", + "searchProviderDesc": "Este provedor é usado para busca web via POST /v1/search. Nenhuma configuração de modelo é necessária depois que uma chave de API estiver conectada.", + "searchProviders": "Buscar provedores...", + "searchProvidersHeading": "Provedores de Busca", + "searxngBaseUrlHint": "Obrigatório: cole a URL base da sua instância SearXNG. O app usará /search e request format=json. URLs locais/privadas exigem OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true para validação no dashboard.", + "searxngInfo": "SearXNG é self-hosted. Configure aqui a URL base da instância. A chave de API é opcional e pode ficar em branco para instâncias públicas ou sem autenticação. A validação de URLs locais/privadas exige OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true.", + "sessionCookieLabel": "Cookie de Sessão", + "showEmail": "Mostrar e-mail", + "snowflakeBaseUrlHint": "Obrigatório: cole a URL base da conta Snowflake. O app adicionará /api/v2/cortex/inference:complete.", + "supportedEndpointAudio": "Áudio", + "supportedEndpointChat": "Chat", + "supportedEndpointEmbeddings": "Embeddings", + "supportedEndpointImages": "Imagens", + "supportedEndpointsLabel": "Endpoints Suportados", + "tagGroupHint": "Usado para agrupar contas na visão do provedor.", + "tagGroupLabel": "Tag / Grupo", + "tagGroupPlaceholder": "ex.: personal, work, team-a", "testModel": "Test Model", "testingModel": "Testing Model", + "toggleOffShort": "OFF", + "toggleOnShort": "ON", + "tokenExpiredBadge": "Expirado", + "tokenExpiredTitle": "Token expirado: {date}", + "tokenExpiresSoonTitle": "Token expira em {minutes}m", + "tokenShort": "Token", + "totalKeysRotating": "{count} chaves no total — rotacionando em round-robin a cada request.", "unhideModel": "Unhide Model", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "upstreamProxyProviders": "Proxy Upstream", + "validationModelIdHint": "Usado como fallback se a listagem de modelos não estiver disponível.", + "validationModelIdLabel": "ID do Modelo (opcional)", + "validationModelIdPlaceholder": "ex.: grok-3 ou meta-llama/Llama-3.1-8B-Instruct", + "vertexServiceAccountPlaceholder": "Cole o JSON da Service Account aqui", + "webCookieProviders": "Provedores Web / Cookie", + "weeklyShort": "Semanal", + "xiaomiMimoBaseUrlHint": "Opcional: URL base token-plan do Xiaomi MiMo. Exemplos: https://token-plan-ams.xiaomimimo.com/v1, https://token-plan-sgp.xiaomimimo.com/v1, https://token-plan-cn.xiaomimimo.com/v1. O app adicionará /chat/completions.", + "zedImportButton": "Importar do Zed", + "zedImportFailed": "Falha ao importar do Zed IDE.", + "zedImportHint": "Importar credenciais do Zed IDE", + "zedImportNetworkError": "Erro de rede ao tentar importar do Zed.", + "zedImportNone": "Nenhuma credencial OAuth suportada encontrada no Zed IDE.", + "zedImportSuccess": "Importadas {count} credencial(is) do Zed IDE ({providers}).", + "zedImporting": "Importando..." }, "settings": { "title": "Configurações", @@ -2841,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Preços", "storage": "Armazenamento", "policies": "Políticas", @@ -2851,6 +3164,46 @@ "enablePassword": "Ativar Senha", "darkMode": "Modo Escuro", "lightMode": "Modo Claro", + "memoryTitle": "Memória", + "memoryDesc": "Memória conversacional persistente entre sessões", + "memoryEnabled": "Ativar Memória", + "memoryEnabledDesc": "Quando ativado, injetará o contexto passado relevante de forma dinâmica.", + "maxTokens": "Tokens Máximos", + "retentionDays": "Retenção", + "recent": "Recente", + "recentDesc": "Janela cronológica", + "semantic": "Semântica", + "semanticDesc": "Busca vetorial", + "hybrid": "Híbrido", + "hybridDesc": "Recente + Semântico", + "skillsTitle": "Skills A2A", + "skillsDesc": "Ferramentas auto-executáveis", + "skillsEnabled": "Ativar Skills", + "skillsEnabledDesc": "Permite aos agentes executar consultas e gerar arquivos.", + "skillsComingSoon": "Marketplace em breve.", + "memorySkillsTitle": "Memória e Skills", + "memorySkillsDesc": "Contexto persistente e capacidades A2A", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "agora mesmo", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Provedores", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema do Sistema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2858,6 +3211,8 @@ "cacheTTL": "TTL do Cache", "maxCacheSize": "Tamanho Máximo do Cache", "clearCache": "Limpar Cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Acertos de Cache", "cacheMisses": "Erros de Cache", "hitRate": "Taxa de Acerto", @@ -2880,10 +3235,12 @@ "timeoutMs": "Timeout (ms)", "enableSystemPrompt": "Ativar Prompt do Sistema", "systemPromptText": "Texto do Prompt do Sistema", - "autoDisableBannedAccounts": "Auto-Disable Banned Accounts", - "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", - "autoDisableThreshold": "Ban Threshold", - "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "autoDisableBannedAccounts": "Auto-desativar contas banidas", + "autoDisableDescription": "Marca permanentemente conexões de provedor como desativadas quando retornam sinais terminais de banimento (ex.: HTTP 403 'verify your account'). Isso remove a conexão da rotação de combos.", + "autoDisableThreshold": "Limite de banimento", + "autoDisableThresholdDesc": "Quantidade de sinais consecutivos de banimento antes da desativação permanente.", + "resilienceStructureTitle": "Estrutura de resiliência", + "resilienceStructureDesc": "Esta página configura apenas o comportamento. O estado ao vivo de circuit breaker aparece na página Saúde. Controle de retry específico por combo e slot de round-robin continuam nas configurações de combos.", "enableThinking": "Ativar Raciocínio", "maxThinkingTokens": "Máximo de Tokens de Raciocínio", "enableProxy": "Ativar Proxy", @@ -2891,7 +3248,6 @@ "pricingRates": "Formato de Taxas de Preço", "currentPricing": "Visão Geral de Preços Atual", "loadingPricing": "Carregando dados de preços...", - "pricingLoadFailed": "Falha ao carregar dados de preços", "noPricing": "Nenhum dado de preço disponível", "input": "Entrada", "output": "Saída", @@ -2899,29 +3255,6 @@ "reasoning": "Raciocínio", "cacheCreation": "Criação de Cache", "customPricing": "Preços Personalizados", - "pricingSyncTitle": "Sincronização de Preços", - "pricingSyncDescription": "Dispare o sync do LiteLLM, inspecione o status e diferencie preços sincronizados de overrides manuais.", - "pricingSyncStatus": "Status da Sincronização", - "syncEnabled": "Sincronização periódica ativada", - "syncDisabled": "Somente sync manual", - "syncedModels": "Modelos Sincronizados", - "clearSyncedPricing": "Limpar Sync", - "clearSyncedPricingConfirm": "Limpar todos os dados de preços sincronizados via LiteLLM?", - "clearSyncedPricingSuccess": "Dados sincronizados de preços removidos", - "clearSyncedPricingFailed": "Falha ao limpar dados sincronizados de preços", - "clearSyncedPricingFailedWithReason": "Falha ao limpar dados sincronizados de preços: {reason}", - "pricingSourceUser": "Override", - "pricingSourceModelsDev": "models.dev", - "pricingSourceLiteLLM": "LiteLLM", - "pricingSourceDefault": "Padrão", - "pricingSavedProvider": "Preços salvos para {provider}", - "pricingSaveFailedWithReason": "Falha ao salvar preços: {reason}", - "pricingResetProvider": "Preços resetados para {provider}", - "pricingResetFailedWithReason": "Falha ao resetar preços: {reason}", - "pricingSyncSuccess": "Preços sincronizados para {count} modelos", - "pricingSyncFailed": "Falha na sincronização de preços", - "pricingSyncFailedWithReason": "Falha na sincronização de preços: {reason}", - "unknownError": "Erro desconhecido", "databaseSize": "Tamanho do Banco de Dados", "backupDb": "Backup do Banco de Dados", "restoreDb": "Restaurar Banco de Dados", @@ -2944,6 +3277,14 @@ "themeLight": "Claro", "themeDark": "Escuro", "themeSystem": "Sistema", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -3025,6 +3366,14 @@ "apiEndpointProtection": "Proteção de Endpoint da API", "requireAuthModels": "Exigir chave de API para /models", "requireAuthModelsDesc": "Quando ATIVADO, o endpoint /v1/models retorna 404 para requisições não autenticadas. Impede descoberta de modelos por usuários não autorizados.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Provedores Bloqueados", "blockedProvidersDesc": "Ocultar provedores específicos da resposta /v1/models. Provedores bloqueados não aparecerão nas listagens de modelos.", "providersBlocked": "{count} provedor(es) bloqueado(s) do /models", @@ -3053,6 +3402,8 @@ "leastUsedDesc": "Escolher a conta usada menos recentemente", "costOpt": "Custo Otimizado", "costOptDesc": "Preferir conta mais barata disponível", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Aleatório Estrito", "strictRandomDesc": "Baralho embaralhado — usa cada conta uma vez antes de reembaralhar", "stickyLimit": "Limite Fixo", @@ -3245,7 +3596,6 @@ "backupCreated": "Backup criado: {file}", "restoreSuccess": "Restaurado! {connections} conexões, {nodes} nós, {combos} combos, {apiKeys} chaves de API.", "importSuccess": "Banco importado! {connections} conexões, {nodes} nós, {combos} combos, {apiKeys} chaves de API.", - "justNow": "agora mesmo", "minutesAgo": "{count}m atrás", "hoursAgo": "{count}h atrás", "daysAgo": "{count}d atrás", @@ -3260,7 +3610,6 @@ "errorDuringImport": "Ocorreu um erro durante a importação", "modelPricing": "Preços de Modelos", "modelPricingDesc": "Configure taxas de custo por modelo • Todas as taxas em $/1M tokens", - "providers": "Provedores", "registry": "Registro", "priced": "Com Preço", "searchProvidersModels": "Buscar provedores ou modelos...", @@ -3304,57 +3653,17 @@ "themeCoral": "Coral", "adaptiveVolumeRouting": "Roteamento de Volume Adaptativo", "adaptiveVolumeRoutingDesc": "Escala conexões dinamicamente com base no volume e pressão na taxa de transferência.", - "days": "Dias", - "lkgp": "Modo LKGP", - "lkgpDesc": "Último Provedor Bom Conhecido (Resiliência previsível)", - "memoryTitle": "Memória", - "memoryDesc": "Memória conversacional persistente entre sessões", - "memoryEnabled": "Ativar Memória", - "memoryEnabledDesc": "Quando ativado, injetará o contexto passado relevante de forma dinâmica.", - "maxTokens": "Tokens Máximos", - "retentionDays": "Retenção", - "recent": "Recente", - "recentDesc": "Janela cronológica", - "semantic": "Semântica", - "semanticDesc": "Busca vetorial", - "hybrid": "Híbrido", - "hybridDesc": "Recente + Semântico", - "skillsTitle": "Skills A2A", - "skillsDesc": "Ferramentas auto-executáveis", - "skillsEnabled": "Ativar Skills", - "skillsEnabledDesc": "Permite aos agentes executar consultas e gerar arquivos.", - "skillsComingSoon": "Marketplace em breve.", - "memorySkillsTitle": "Memória e Skills", - "memorySkillsDesc": "Contexto persistente e capacidades A2A", - "purgeExpiredLogs": "Purgar Logs Expirados", - "purgeLogsFailed": "Falha ao purgar logs", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", "lkgpToggleDesc": "When enabled, the router remembers which provider last served a successful response and tries it first on subsequent requests.", "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Dias", + "lkgp": "Modo LKGP", + "lkgpDesc": "Último Provedor Bom Conhecido (Resiliência previsível)", "maintenance": "Maintenance", + "purgeExpiredLogs": "Purgar Logs Expirados", + "purgeLogsFailed": "Falha ao purgar logs", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3377,13 +3686,37 @@ "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", "overview": "Overview", + "unknownError": "Erro desconhecido", + "pricingSourceLiteLLM": "LiteLLM", + "clearSyncedPricingConfirm": "Limpar todos os dados de preços sincronizados via LiteLLM?", + "clearSyncedPricingFailed": "Falha ao limpar dados sincronizados de preços", + "pricingSourceUser": "Override", "pageDescription": "Page Description", + "pricingSyncStatus": "Status da Sincronização", "whitelist": "Whitelist", + "syncDisabled": "Somente sync manual", + "pricingLoadFailed": "Falha ao carregar dados de preços", + "pricingSyncDescription": "Dispare o sync do LiteLLM, inspecione o status e diferencie preços sincronizados de overrides manuais.", + "clearSyncedPricingSuccess": "Dados sincronizados de preços removidos", + "clearSyncedPricingFailedWithReason": "Falha ao limpar dados sincronizados de preços: {reason}", + "pricingSourceDefault": "Padrão", + "pricingSyncSuccess": "Preços sincronizados para {count} modelos", "enableSyncError": "Enable Sync Error", + "syncEnabled": "Sincronização periódica ativada", "blacklist": "Blacklist", + "pricingSourceModelsDev": "models.dev", + "syncedModels": "Modelos Sincronizados", "budget": "Budget", + "pricingSyncTitle": "Sincronização de Preços", + "pricingResetFailedWithReason": "Falha ao resetar preços: {reason}", "tab": "Tab", + "pricingSavedProvider": "Preços salvos para {provider}", + "pricingSyncFailed": "Falha na sincronização de preços", + "pricingSaveFailedWithReason": "Falha ao salvar preços: {reason}", + "pricingResetProvider": "Preços resetados para {provider}", "nextSync": "Next Sync", + "pricingSyncFailedWithReason": "Falha na sincronização de preços: {reason}", + "clearSyncedPricing": "Limpar Sync", "compressionTitle": "Prompt Compression", "compressionDesc": "Reduce token usage by compressing prompts before sending to providers", "compressionMode": "Compression Mode", @@ -3429,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3469,7 +3803,11 @@ "qdrantCleanupDesc": "Remove pontos expirados e antigos, baseado em", "searching": "Buscando...", "cleaning": "Limpando...", - "cleanNow": "Limpar agora" + "cleanNow": "Limpar agora", + "optional": "Opcional", + "current": "Atual", + "remove": "Remover", + "search": "Buscar" }, "contextRtk": { "title": "Motor RTK", @@ -3559,12 +3897,10 @@ "realtime": "Atividade de Tradução em Tempo Real", "chatTester": "Testador de Chat", "testBench": "Bancada de Testes", - "streamTransformer": "Transformer de Stream", "liveMonitor": "Monitor ao Vivo", "modeDescriptionPlayground": "Cole qualquer corpo de requisição de API e veja como o OmniRoute traduz entre formatos de provedores (OpenAI ↔ Claude ↔ Gemini ↔ Responses API)", "modeDescriptionChatTester": "Envie requisições reais de chat pelo OmniRoute e inspecione o ciclo completo: entrada, requisição traduzida, resposta do provedor e saída traduzida.", "modeDescriptionTestBench": "Execute cenários predefinidos e compare compatibilidade entre provedores e modelos.", - "modeDescriptionStreamTransformer": "Transforme SSE de Chat Completions em SSE da Responses API e inspecione os eventos emitidos.", "modeDescriptionLiveMonitor": "Acompanhe eventos de tradução em tempo real conforme as requisições passam pelo OmniRoute.", "modeDescriptionFallback": "Depure, teste e visualize como o OmniRoute traduz requisições de API entre provedores.", "recentTranslations": "Traduções Recentes", @@ -3593,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Conversor de Formato", "formatConverterDescription": "Cole ou digite um corpo de requisição JSON. O tradutor detectará automaticamente o formato de origem e converterá para o formato de destino. Use isso para depurar como o OmniRoute traduz requisições entre formatos (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Entrada", "output": "Saída", "auto": "Auto", @@ -3621,17 +3979,13 @@ "scenarioThinking": "Raciocínio", "scenarioSystemPrompt": "Prompt de Sistema", "scenarioStreaming": "Streaming", - "scenarioVision": "Visão", - "scenarioSchemaCoercion": "Coerção de Schema", "templateNames": { "simple-chat": "Chat Simples", "tool-calling": "Chamada de Ferramenta", "multi-turn": "Multiturno", "thinking": "Raciocínio", "system-prompt": "Prompt de Sistema", - "streaming": "Streaming", - "vision": "Visão", - "schema-coercion": "Coerção de Schema" + "streaming": "Streaming" }, "templateDescriptions": { "simple-chat": "Mensagem de texto básica", @@ -3639,9 +3993,7 @@ "multi-turn": "Conversa com histórico", "thinking": "Raciocínio estendido", "system-prompt": "Instruções de sistema complexas", - "streaming": "Requisição de streaming SSE", - "vision": "Requisição multimodal com entrada de imagem", - "schema-coercion": "Schema estrito de ferramenta para validar sanitização" + "streaming": "Requisição de streaming SSE" }, "templatePayloads": { "simpleChat": { @@ -3668,16 +4020,6 @@ }, "streaming": { "prompt": "Conte uma história curta sobre um robô aprendendo a pintar." - }, - "vision": { - "system": "Você é um assistente visual. Descreva imagens com observações concretas e concisas.", - "userPrompt": "Descreva a imagem e destaque objetos ou cores notáveis.", - "imageUrl": "https://images.unsplash.com/photo-1516117172878-fd2c41f4a759?auto=format&fit=crop&w=1200&q=80" - }, - "schemaCoercion": { - "userPrompt": "Verifique o clima em Tóquio e inclua detalhes por hora.", - "toolDescription": "Consultar detalhes do clima para uma cidade", - "cityDescription": "Nome da cidade para consulta" } }, "openaiCompatibleLabel": "Compatível com OpenAI", @@ -3703,27 +4045,6 @@ "send": "Enviar", "clientRequest": "Requisição do Cliente", "clientRequestDescription": "O corpo de requisição como seu cliente enviaria", - "streamTransformerTitle": "Transformer de Stream para Responses", - "streamTransformerDescription": "Cole um stream SSE de chat completions, passe-o pelo transformer de Responses do OmniRoute e inspecione os eventos response.* emitidos antes de integrar um cliente.", - "rawChatSseInput": "SSE bruto de chat completions", - "transformToResponses": "Transformar para Responses", - "loadTextSample": "Carregar exemplo de texto", - "loadToolSample": "Carregar exemplo com tool call", - "transformedResponsesSse": "SSE transformado da Responses API", - "transformedEvents": "Eventos transformados", - "uniqueEventTypes": "Tipos únicos de evento", - "inputLines": "Linhas de entrada", - "outputLines": "Linhas de saída", - "transformedEventTimeline": "Linha do tempo dos eventos transformados", - "transformerTimelineHint": "Execute o transformer para inspecionar em ordem os eventos response.output_* emitidos.", - "eventType": "Tipo de evento", - "eventPreview": "Prévia", - "comboRouted": "Roteadas por combo", - "uniqueEndpoints": "Endpoints únicos", - "routeDetails": "Rota", - "comboBadge": "Combo", - "routeEndpointLabel": "Endpoint", - "routeConnectionLabel": "Conn", "formatDetected": "Formato Detectado", "formatDetectedDescription": "O OmniRoute detecta automaticamente o formato da API a partir da estrutura da requisição", "openaiIntermediate": "Intermediário OpenAI", @@ -3738,6 +4059,11 @@ "errorMessage": "Erro: {message}", "requestFailed": "Falha na requisição", "noTextExtracted": "(Nenhum texto extraído)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Mostra eventos de tradução conforme chamadas de API passam pelo OmniRoute. Os eventos vêm do buffer em memória (reinicia ao reiniciar o servidor). Use", "liveMonitorDescriptionSuffix": ", ou chamadas de API externas para gerar eventos." }, @@ -3756,23 +4082,11 @@ "thisMonth": "Este Mês", "setLimits": "Definir Limites", "dailyLimitUsd": "Limite diário (USD)", - "weeklyLimitUsd": "Limite semanal (USD)", "monthlyLimitUsd": "Limite mensal (USD)", "warningThresholdPercent": "Limite de aviso (%)", "dailyLimitPlaceholder": "ex.: 5.00", - "weeklyLimitPlaceholder": "ex.: 25.00", "monthlyLimitPlaceholder": "ex.: 50.00", "warningThresholdPlaceholder": "80", - "activePeriodSpend": "Gasto do período ativo", - "intervalLabel": "Intervalo", - "resetInterval": "Intervalo de reset", - "resetTimeUtc": "Horário do reset (UTC)", - "nextResetUtc": "Próximo reset (UTC): {value}", - "weeklyLimitSummary": "Limite semanal: {value}", - "notConfigured": "Não configurado", - "daily": "Diário", - "weekly": "Semanal", - "monthly": "Mensal", "saveLimits": "Salvar limites", "budgetOk": "Orçamento OK — {remaining} restantes", "budgetExceeded": "Orçamento excedido — requisições podem ser bloqueadas", @@ -3804,45 +4118,6 @@ "evaluateStepDescription": "As respostas são comparadas com os critérios esperados. Veja aprovado/reprovado por caso com métricas de latência e feedback detalhado.", "evalSuites": "Suítes de Avaliação", "evalSuitesHint": "Clique em uma suíte para ver os casos de teste e execute para avaliar seus endpoints de LLM", - "suiteBuilderNewSuite": "New Suite", - "suiteBuilderCreateTitle": "Criar Suíte Customizada de Eval", - "suiteBuilderEditTitle": "Editar Suíte Customizada de Eval", - "suiteBuilderNameLabel": "Nome da Suíte", - "suiteBuilderNamePlaceholder": "Suíte de regressão de suporte ao cliente", - "suiteBuilderDescriptionLabel": "Descrição", - "suiteBuilderDescriptionPlaceholder": "Explique o que esta suíte valida e por que ela importa.", - "suiteBuilderCasesTitle": "Test Cases", - "suiteBuilderCasesHint": "Cada caso envia um prompt real pelo OmniRoute e valida a resposta com contains, exact ou regex.", - "suiteBuilderAddCase": "Add Case", - "suiteBuilderCaseCardTitle": "Test Case", - "suiteBuilderCaseCardHint": "Defina um prompt e uma asserção para esta checagem de regressão.", - "suiteBuilderCaseNameLabel": "Nome do Caso", - "suiteBuilderCaseNamePlaceholder": "Resposta sobre política de reembolso", - "suiteBuilderCaseModelLabel": "Model (optional)", - "suiteBuilderCaseModelPlaceholder": "gpt-4o-mini", - "suiteBuilderCaseTagsLabel": "Tags", - "suiteBuilderCaseTagsPlaceholder": "support, regression, billing", - "suiteBuilderCaseTagsHint": "Tags separadas por vírgula e armazenadas com o caso.", - "suiteBuilderCaseStrategyLabel": "Validation Strategy", - "suiteBuilderCaseSystemPromptLabel": "Prompt de Sistema", - "suiteBuilderCaseSystemPromptPlaceholder": "Instrução de sistema opcional para este caso.", - "suiteBuilderCaseUserPromptLabel": "Prompt do Usuário", - "suiteBuilderCaseUserPromptPlaceholder": "Escreva a entrada exata do usuário para repetir durante o eval.", - "suiteBuilderCaseExpectedLabel": "Expected Value", - "suiteBuilderCaseExpectedPlaceholder": "Texto ou regex que deve aparecer na resposta do modelo.", - "suiteBuilderCreateAction": "Create Suite", - "suiteBuilderCreated": "Suíte customizada criada", - "suiteBuilderUpdated": "Suíte customizada atualizada", - "suiteBuilderDeleted": "Suíte customizada removida", - "suiteBuilderDeleteConfirm": "Excluir a suíte customizada \"{name}\"?", - "suiteBuilderSaveFailed": "Falha ao salvar a suíte customizada", - "suiteBuilderDeleteFailed": "Falha ao excluir a suíte customizada", - "suiteBuilderNameRequired": "O nome da suíte é obrigatório", - "suiteBuilderCasesRequired": "Adicione pelo menos um caso antes de salvar", - "suiteBuilderCaseInvalid": "O caso {index} está incompleto. Preencha nome, modelo, prompt e valor esperado.", - "suiteBuilderCustomBadge": "Custom", - "suiteBuilderBuiltInBadge": "Padrão", - "suiteBuilderUpdatedAt": "Updated", "evalsLoading": "Carregando suítes de avaliação...", "noEvalSuitesFound": "Nenhuma suíte de avaliação encontrada", "noEvalSuitesDescription": "As suítes de avaliação podem ser definidas via API ou em código. Elas testam saídas de modelos contra resultados esperados usando estratégias como contains, regex, correspondência exata e funções customizadas.", @@ -3864,14 +4139,25 @@ "passSuffix": "de aprovação", "casesCount": "{count, plural, one {# caso} other {# casos}}", "runEval": "Executar avaliação", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Executando {current}/{total}...", "passRate": "taxa de aprovação", "summaryBreakdown": "{passed} aprovados · {failed} falharam · {total} total", "passedIconLabel": "✅ Aprovado", "failedIconLabel": "❌ Falhou", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contém: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Esperado: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Sem resultados ainda", "testCasesCount": "Casos de Teste ({count})", "noTestCasesDefined": "Nenhum caso de teste definido", @@ -3887,47 +4173,6 @@ "modelComparison": "Comparação de Modelos", "regressionDetection": "Detecção de Regressão", "latencyBenchmarks": "Benchmarks de Latência", - "evalControlsTitle": "Alvos de Execução", - "evalControlsHint": "Escolha um modelo ou combo, compare opcionalmente dois alvos e persista o histórico no SQLite.", - "evalTarget": "Target", - "evalTargetHint": "Os padrões da suíte preservam o modelo configurado em cada caso de teste.", - "evalCompareTarget": "Compare Target", - "evalCompareOptional": "Sem alvo de comparação", - "evalCompareHint": "Comparação lado a lado opcional usando a mesma suíte.", - "evalApiKey": "Chave de API do Proxy", - "evalApiKeyAuto": "Usar sessão do dashboard / sem chave", - "evalApiKeyHint": "Usada somente quando seu endpoint `/v1` exige bearer token.", - "targetSuiteDefaults": "Padrões da suíte", - "targetTypeCombo": "Combo", - "targetTypeModel": "Modelo", - "scorecardTitle": "Scorecard", - "scorecardHint": "Últimas taxas de aprovação armazenadas para execuções e alvos recentes.", - "scorecardSuites": "Suites", - "scorecardCases": "Cases", - "scorecardPassed": "Passed", - "scorecardPassRate": "Taxa Geral de Aprovação", - "recentRunsTitle": "Recent Runs", - "recentRunsHint": "O histórico sobrevive ao refresh e agora registra comparações combo-aware.", - "historyEmpty": "Ainda não há execuções persistidas", - "historyLatency": "{value}ms de latência média", - "historyColumnSuiteName": "Suíte", - "historyColumnTarget": "Alvo", - "historyColumnPassRate": "Taxa de Aprovação", - "historyColumnAvgLatencyMs": "Latência Média", - "historyColumnCreatedAt": "Executado Em", - "runEvalRunning": "Executando...", - "runCompletedWithScore": "Execução concluída com {score}% de aprovação", - "compareCompletedWithScore": "Comparação concluída. A execução principal terminou com {score}% de aprovação", - "notifySelectDifferentCompareTarget": "Escolha um alvo de comparação diferente", - "notifyEvalRunFailedWithReason": "Falha na execução da avaliação: {reason}", - "notifyEvalLoadFailed": "Falha ao carregar os dados do dashboard de evals", - "targetComparisonTitle": "Comparação de Alvos", - "targetComparisonHint": "A mesma suíte foi executada contra múltiplos alvos.", - "suiteLatestRuns": "Latest Runs", - "suiteLatestRunsHint": "As execuções armazenadas continuam disponíveis após atualizar a página.", - "errorBadge": "Erro", - "resultErrorLabel": "Erro", - "actualOutputLabel": "Actual Output", "modelLockouts": "Bloqueios de Modelo", "noLockouts": "Nenhum modelo bloqueado", "activeSessions": "Sessões Ativas", @@ -3979,11 +4224,113 @@ "tierPlus": "Plus", "tierFree": "Free", "tierUnknown": "Desconhecido", + "suiteBuilderSaveFailed": "Falha ao salvar a suíte customizada", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", + "scorecardTitle": "Scorecard", + "evalApiKey": "Chave de API do Proxy", + "scorecardPassRate": "Taxa Geral de Aprovação", + "targetTypeModel": "Modelo", + "actualOutputLabel": "Actual Output", + "evalTargetHint": "Os padrões da suíte preservam o modelo configurado em cada caso de teste.", + "suiteBuilderDeleted": "Suíte customizada removida", + "suiteBuilderCaseCardHint": "Defina um prompt e uma asserção para esta checagem de regressão.", + "nextResetUtc": "Próximo reset (UTC): {value}", + "scorecardHint": "Últimas taxas de aprovação armazenadas para execuções e alvos recentes.", + "suiteLatestRunsHint": "As execuções armazenadas continuam disponíveis após atualizar a página.", "saving": "Saving", + "suiteBuilderCaseModelLabel": "Model (optional)", + "evalControlsTitle": "Alvos de Execução", + "suiteBuilderEditTitle": "Editar Suíte Customizada de Eval", + "suiteBuilderCaseStrategyLabel": "Validation Strategy", + "notifySelectDifferentCompareTarget": "Escolha um alvo de comparação diferente", + "recentRunsHint": "O histórico sobrevive ao refresh e agora registra comparações combo-aware.", + "evalCompareHint": "Comparação lado a lado opcional usando a mesma suíte.", + "suiteBuilderCaseInvalid": "O caso {index} está incompleto. Preencha nome, modelo, prompt e valor esperado.", + "historyEmpty": "Ainda não há execuções persistidas", + "suiteBuilderUpdated": "Suíte customizada atualizada", + "resetInterval": "Intervalo de reset", + "suiteBuilderCreateTitle": "Criar Suíte Customizada de Eval", + "activePeriodSpend": "Gasto do período ativo", + "evalApiKeyHint": "Usada somente quando seu endpoint `/v1` exige bearer token.", + "evalCompareOptional": "Sem alvo de comparação", + "suiteBuilderDeleteFailed": "Falha ao excluir a suíte customizada", + "suiteBuilderCaseSystemPromptPlaceholder": "Instrução de sistema opcional para este caso.", + "scorecardCases": "Cases", + "runCompletedWithScore": "Execução concluída com {score}% de aprovação", + "suiteBuilderCustomBadge": "Custom", + "targetSuiteDefaults": "Padrões da suíte", + "suiteBuilderDeleteConfirm": "Excluir a suíte customizada \"{name}\"?", + "suiteBuilderNameLabel": "Nome da Suíte", + "scorecardSuites": "Suites", + "evalCompareTarget": "Compare Target", + "suiteBuilderCaseModelPlaceholder": "gpt-4o-mini", + "evalControlsHint": "Escolha um modelo ou combo, compare opcionalmente dois alvos e persista o histórico no SQLite.", + "recentRunsTitle": "Recent Runs", + "suiteBuilderCaseSystemPromptLabel": "Prompt de Sistema", + "suiteBuilderCaseExpectedPlaceholder": "Texto ou regex que deve aparecer na resposta do modelo.", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", + "suiteBuilderNamePlaceholder": "Suíte de regressão de suporte ao cliente", + "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", + "evalTarget": "Target", + "suiteBuilderCaseNameLabel": "Nome do Caso", + "weeklyLimitUsd": "Limite semanal (USD)", + "suiteBuilderCaseUserPromptPlaceholder": "Escreva a entrada exata do usuário para repetir durante o eval.", + "suiteBuilderNameRequired": "O nome da suíte é obrigatório", + "suiteBuilderCaseUserPromptLabel": "Prompt do Usuário", + "daily": "Diário", + "resultErrorLabel": "Erro", + "suiteBuilderBuiltInBadge": "Padrão", + "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", + "weeklyLimitPlaceholder": "ex.: 25.00", + "suiteBuilderCaseTagsHint": "Tags separadas por vírgula e armazenadas com o caso.", + "notifyEvalRunFailedWithReason": "Falha na execução da avaliação: {reason}", + "weekly": "Semanal", + "runEvalRunning": "Executando...", "delete": "Delete", + "resetTimeUtc": "Horário do reset (UTC)", + "evalApiKeyAuto": "Usar sessão do dashboard / sem chave", + "suiteBuilderDescriptionPlaceholder": "Explique o que esta suíte valida e por que ela importa.", + "targetComparisonTitle": "Comparação de Alvos", "save": "Save", + "suiteBuilderCreated": "Suíte customizada criada", + "suiteLatestRuns": "Latest Runs", + "suiteBuilderCaseExpectedLabel": "Expected Value", + "historyLatency": "{value}ms de latência média", + "suiteBuilderCaseTagsPlaceholder": "support, regression, billing", + "targetTypeCombo": "Combo", + "scorecardPassed": "Passed", + "suiteBuilderCaseTagsLabel": "Tags", + "suiteBuilderNewSuite": "New Suite", + "notifyEvalLoadFailed": "Falha ao carregar os dados do dashboard de evals", + "notConfigured": "Não configurado", + "suiteBuilderCaseNamePlaceholder": "Resposta sobre política de reembolso", + "intervalLabel": "Intervalo", + "suiteBuilderCreateAction": "Create Suite", + "suiteBuilderCasesHint": "Cada caso envia um prompt real pelo OmniRoute e valida a resposta com contains, exact ou regex.", + "suiteBuilderUpdatedAt": "Updated", + "errorBadge": "Erro", + "suiteBuilderCasesTitle": "Test Cases", "edit": "Edit", + "monthly": "Mensal", + "suiteBuilderCasesRequired": "Adicione pelo menos um caso antes de salvar", + "weeklyLimitSummary": "Limite semanal: {value}", + "suiteBuilderDescriptionLabel": "Descrição", + "targetComparisonHint": "A mesma suíte foi executada contra múltiplos alvos.", + "compareCompletedWithScore": "Comparação concluída. A execução principal terminou com {score}% de aprovação", "staleQuotaTooltip": "Last refresh failed — showing cached data" }, "modals": { @@ -4113,8 +4460,8 @@ "waitingForQoderAuthorization": "Aguardando autorização do Qoder...", "exchangingCodeForTokens": "Trocando código por tokens...", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4202,13 +4549,13 @@ "docs": { "title": "Documentação", "quickStart": "Início Rápido", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Recursos", "supportedProviders": "Provedores Suportados", "supportedProvidersToc": "Provedores", "commonUseCases": "Casos de Uso Comuns", "clientCompatibility": "Compatibilidade de Clientes", "protocolsToc": "Protocolos", - "mcpToolsToc": "Ferramentas MCP", "apiReference": "Referência da API", "managementApiReference": "Management API Reference", "managementApiDescription": "Automation endpoints for proxy registry, scope assignments, and legacy proxy migration.", @@ -4239,26 +4586,30 @@ "quickStartStep4Title": "4. Defina a URL base do cliente", "quickStartStep4Prefix": "Aponte sua IDE ou cliente de API para", "quickStartStep4Suffix": "Use prefixo de provedor, por exemplo", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Roteamento Multi-Provedor", "featureRoutingText": "Roteie requisições para mais de 30 provedores de IA por um único endpoint compatível com OpenAI. Suporta APIs de chat, responses, áudio e imagem.", "featureCombosTitle": "Combos e Balanceamento", "featureCombosText": "Crie combos de modelos com cadeias de fallback e estratégias de balanceamento: round-robin, prioridade, aleatório, menos usado e otimizado por custo.", - "featureAutoComboTitle": "Roteamento AutoCombo", - "featureAutoComboText": "Use roteamento por intenção, fallback emergencial, seleção por contexto e perfis de resiliência sem mudar o payload do cliente.", - "featureSearchTitle": "APIs de Busca, Rerank e Multimodal", - "featureSearchText": "Exponha endpoints de search, rerank, moderação, imagem, vídeo, música, voz e transcrição atrás da mesma base URL do OmniRoute.", "featureUsageTitle": "Rastreamento de Uso e Custo", "featureUsageText": "Contagem de tokens em tempo real, cálculo de custo por provedor/modelo e detalhamento de uso por chave de API e conta.", "featureAnalyticsTitle": "Painel de Analytics", "featureAnalyticsText": "Análises visuais com gráficos de requisições, tokens, erros, latência, custos e popularidade de modelos ao longo do tempo.", "featureHealthTitle": "Monitoramento de Saúde", "featureHealthText": "Health checks em tempo real, status de provedores, estados de circuit breaker e detecção automática de rate limit com backoff exponencial.", - "featureMemoryTitle": "Memória e Handoffs de Contexto", - "featureMemoryText": "Persista fatos reutilizáveis, injete contexto recuperado nas requisições e carregue contexto entre sessões e fluxos de agentes.", - "featureSkillsTitle": "Skills e Execução de Ferramentas", - "featureSkillsText": "Execute skills registradas, intercepte tool calls e exponha a execução por dashboard, MCP e fluxos de agentes.", - "featureAcpTitle": "Workers ACP e Agentes Locais", - "featureAcpText": "Detecte binários locais que o OmniRoute pode iniciar como workers ACP e coordene-os pelas telas de Agents e CLI Tools.", "featureCliTitle": "Ferramentas CLI", "featureCliText": "Gerencie configurações de IDE, exporte/importe backups, descubra perfis de codex e configure opções pelo painel.", "featureSecurityTitle": "Segurança e Políticas", @@ -4317,60 +4668,20 @@ "protocolA2aStep1": "Leia `/.well-known/agent.json` para descoberta do agente.", "protocolA2aStep2": "Envie `message/send` ou `message/stream` para `POST /a2a`.", "protocolA2aStep3": "Gerencie ciclo de vida das tarefas com `tasks/get` e `tasks/cancel`.", - "protocolAcpTitle": "ACP (Workers do Agent Communication Protocol)", - "protocolAcpDesc": "Use workers locais com ACP quando o OmniRoute deve iniciar e supervisionar um binário local em vez de encaminhar por HTTP.", - "protocolAcpStep1": "Abra Painel -> Agents para verificar quais binários locais estão instalados e disponíveis como workers.", - "protocolAcpStep2": "Use Painel -> CLI Tools quando você precisa de configuração de cliente em vez de spawn de worker.", - "protocolAcpStep3": "Combine workers ACP com logs de auditoria e health para entender o que o OmniRoute iniciou e por quê.", "protocolTroubleshootingTitle": "Troubleshooting de protocolos", "protocolTroubleshooting1": "Se o status MCP estiver offline, verifique se o processo stdio está rodando e atualizando o heartbeat.", "protocolTroubleshooting2": "Se tarefas A2A ficarem em `working`, inspecione `/api/a2a/tasks/:id` e os eventos de stream até estado terminal.", "protocolTroubleshooting3": "Use `/dashboard/mcp` e `/dashboard/a2a` para controles operacionais e visibilidade de auditoria.", "endpointChatNote": "Endpoint de chat compatível com OpenAI (padrão).", "endpointResponsesNote": "Endpoint da API Responses (Codex, o-series).", - "endpointCompletionsNote": "Endpoint legado de completions para clientes que ainda enviam payloads de text-completions.", "endpointModelsNote": "Catálogo de modelos para todos os provedores conectados.", "endpointAudioNote": "Transcrição de áudio (Deepgram, AssemblyAI).", "endpointSpeechNote": "Geração de texto para fala (ElevenLabs, OpenAI TTS).", "endpointEmbeddingsNote": "Geração de incorporação de texto (OpenAI, Cohere, Voyage).", - "endpointModerationsNote": "Moderação e scoring de segurança de conteúdo em provedores compatíveis.", - "endpointRerankNote": "Reranking de documentos para retrieval e pós-processamento de busca.", - "endpointSearchNote": "Busca web unificada com fallback de provedor, analytics e rastreamento de custo.", - "endpointSearchAnalyticsNote": "Telemetria de busca e analytics de provedores do pipeline unificado de search.", "endpointImagesNote": "Geração de imagens (NanoBanana).", - "endpointVideoNote": "Geração de vídeo para backends compatíveis com ComfyUI e SD WebUI.", - "endpointMusicNote": "Geração de música via integrações de workflow do ComfyUI.", - "endpointMessagesNote": "Endpoint de compatibilidade estilo Anthropic Messages para clientes que falam payload nativo de mensagens.", - "endpointCountTokensNote": "Helper de contagem de tokens para planejar requisições antes da execução.", - "endpointFilesNote": "Upload de arquivos e armazenamento de artefatos para batches e workflows maiores.", - "endpointBatchesNote": "Criação e consulta de jobs em lote para execução enfileirada.", - "endpointWsNote": "Caminho compatível com upgrade WebSocket para clientes de protocolo em tempo real.", "endpointRewriteChatNote": "Auxiliar de reescrita para clientes sem /v1.", "endpointRewriteResponsesNote": "Auxiliar de reescrita para Responses sem /v1.", "endpointRewriteModelsNote": "Auxiliar de reescrita para descoberta de modelos sem /v1.", - "mcpToolsTitle": "Catálogo de Ferramentas MCP", - "mcpToolsDescription": "O OmniRoute entrega {count} ferramentas MCP agrupadas entre roteamento, operações, cache, memória e skills.", - "mcpToolsCount": "{count} ferramentas documentadas", - "mcpToolsRoutingTitle": "Roteamento e Catálogo", - "mcpToolsRoutingDesc": "Leia o health do runtime, inspecione combos, confira cotas, descubra modelos e chame web search a partir de clientes MCP.", - "mcpToolsOperationsTitle": "Operações e Controle", - "mcpToolsOperationsDesc": "Simule roteamento, troque estratégias, teste combos, sincronize pricing, inspecione sessão e diagnostique problemas de runtime.", - "mcpToolsCacheTitle": "Controles de Cache", - "mcpToolsCacheDesc": "Inspecione hit rates e limpe o estado do cache sem sair do cliente MCP.", - "mcpToolsMemoryTitle": "Memória", - "mcpToolsMemoryDesc": "Busque, adicione e limpe entradas persistidas de memória do OmniRoute na mesma superfície de protocolo.", - "mcpToolsSkillsTitle": "Skills", - "mcpToolsSkillsDesc": "Liste skills habilitadas, ative, execute e inspecione histórico de execuções a partir do MCP.", - "mgmtProvidersListNote": "Lista conexões de provedores configuradas e o status atual de cada uma.", - "mgmtProvidersCreateNote": "Cria uma nova conexão gerenciada de provedor a partir do plano de controle do dashboard.", - "mgmtProvidersUpdateNote": "Atualiza credenciais, metadados e flags operacionais de um provedor.", - "mgmtProvidersDeleteNote": "Remove uma conexão de provedor do runtime e do roteamento.", - "mgmtProvidersTestNote": "Executa um teste real de conexão contra a conta de provedor selecionada.", - "mgmtProvidersModelsNote": "Descobre, faz cache ou inspeciona modelos expostos por uma conexão específica.", - "mgmtSettingsGetNote": "Lê as configurações principais de runtime usadas pelo dashboard e pelo roteador.", - "mgmtSettingsUpdateNote": "Atualiza configurações compartilhadas de runtime sem editar arquivos de ambiente manualmente.", - "mgmtPayloadRulesGetNote": "Lê a configuração de normalização de payload e payload rules específicas por provedor.", - "mgmtPayloadRulesUpdateNote": "Atualiza as regras de rewrite de payload antes do dispatch para o provedor.", "mgmtProxiesListNote": "List saved proxy registry items (supports pagination).", "mgmtProxiesCreateNote": "Create a reusable proxy item in the registry.", "mgmtProxiesHealthNote": "Get 24h/rolling health metrics per saved proxy from proxy logs.", @@ -4388,8 +4699,61 @@ "troubleshootingTestConnection": "Use Painel > Provedores > Testar Conexão antes de testar por IDEs ou clientes externos.", "troubleshootingCircuitBreaker": "Se um provedor mostrar circuit breaker aberto, aguarde o cooldown ou verifique a página Health para detalhes.", "troubleshootingOAuth": "Para provedores OAuth, autentique novamente se os tokens expirarem. Verifique o indicador de status no card do provedor.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "Endpoint legado de completions para clientes que ainda enviam payloads de text-completions.", + "endpointModerationsNote": "Moderação e scoring de segurança de conteúdo em provedores compatíveis.", + "endpointRerankNote": "Reranking de documentos para retrieval e pós-processamento de busca.", + "endpointSearchNote": "Busca web unificada com fallback de provedor, analytics e rastreamento de custo.", + "endpointSearchAnalyticsNote": "Telemetria de busca e analytics de provedores do pipeline unificado de search.", + "endpointVideoNote": "Geração de vídeo para backends compatíveis com ComfyUI e SD WebUI.", + "endpointMusicNote": "Geração de música via integrações de workflow do ComfyUI.", + "endpointMessagesNote": "Endpoint de compatibilidade estilo Anthropic Messages para clientes que falam payload nativo de mensagens.", + "endpointCountTokensNote": "Helper de contagem de tokens para planejar requisições antes da execução.", + "endpointFilesNote": "Upload de arquivos e armazenamento de artefatos para batches e workflows maiores.", + "endpointBatchesNote": "Criação e consulta de jobs em lote para execução enfileirada.", + "endpointWsNote": "Caminho compatível com upgrade WebSocket para clientes de protocolo em tempo real.", + "mgmtProvidersListNote": "Lista conexões de provedores configuradas e o status atual de cada uma.", + "mgmtProvidersCreateNote": "Cria uma nova conexão gerenciada de provedor a partir do plano de controle do dashboard.", + "mgmtProvidersUpdateNote": "Atualiza credenciais, metadados e flags operacionais de um provedor.", + "mgmtProvidersDeleteNote": "Remove uma conexão de provedor do runtime e do roteamento.", + "mgmtProvidersTestNote": "Executa um teste real de conexão contra a conta de provedor selecionada.", + "mgmtProvidersModelsNote": "Descobre, faz cache ou inspeciona modelos expostos por uma conexão específica.", + "mgmtSettingsGetNote": "Lê as configurações principais de runtime usadas pelo dashboard e pelo roteador.", + "mgmtSettingsUpdateNote": "Atualiza configurações compartilhadas de runtime sem editar arquivos de ambiente manualmente.", + "mgmtPayloadRulesGetNote": "Lê a configuração de normalização de payload e payload rules específicas por provedor.", + "mgmtPayloadRulesUpdateNote": "Atualiza as regras de rewrite de payload antes do dispatch para o provedor.", + "mcpToolsTitle": "Catálogo de Ferramentas MCP", + "mcpToolsDescription": "O OmniRoute entrega {count} ferramentas MCP agrupadas entre roteamento, operações, cache, memória e skills.", + "mcpToolsCount": "{count} ferramentas documentadas", + "mcpToolsToc": "Ferramentas MCP", + "mcpToolsRoutingTitle": "Roteamento e Catálogo", + "mcpToolsRoutingDesc": "Leia o health do runtime, inspecione combos, confira cotas, descubra modelos e chame web search a partir de clientes MCP.", + "mcpToolsOperationsTitle": "Operações e Controle", + "mcpToolsOperationsDesc": "Simule roteamento, troque estratégias, teste combos, sincronize pricing, inspecione sessão e diagnostique problemas de runtime.", + "mcpToolsCacheTitle": "Controles de Cache", + "mcpToolsCacheDesc": "Inspecione hit rates e limpe o estado do cache sem sair do cliente MCP.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "Memória", + "mcpToolsMemoryDesc": "Busque, adicione e limpe entradas persistidas de memória do OmniRoute na mesma superfície de protocolo.", + "mcpToolsSkillsTitle": "Skills", + "mcpToolsSkillsDesc": "Liste skills habilitadas, ative, execute e inspecione histórico de execuções a partir do MCP.", + "featureAutoComboTitle": "Roteamento AutoCombo", + "featureAutoComboText": "Use roteamento por intenção, fallback emergencial, seleção por contexto e perfis de resiliência sem mudar o payload do cliente.", + "featureSearchTitle": "APIs de Busca, Rerank e Multimodal", + "featureSearchText": "Exponha endpoints de search, rerank, moderação, imagem, vídeo, música, voz e transcrição atrás da mesma base URL do OmniRoute.", + "featureMemoryTitle": "Memória e Handoffs de Contexto", + "featureMemoryText": "Persista fatos reutilizáveis, injete contexto recuperado nas requisições e carregue contexto entre sessões e fluxos de agentes.", + "featureSkillsTitle": "Skills e Execução de Ferramentas", + "featureSkillsText": "Execute skills registradas, intercepte tool calls e exponha a execução por dashboard, MCP e fluxos de agentes.", + "featureAcpTitle": "Workers ACP e Agentes Locais", + "featureAcpText": "Detecte binários locais que o OmniRoute pode iniciar como workers ACP e coordene-os pelas telas de Agents e CLI Tools.", + "protocolAcpTitle": "ACP (Workers do Agent Communication Protocol)", + "protocolAcpDesc": "Use workers locais com ACP quando o OmniRoute deve iniciar e supervisionar um binário local em vez de encaminhar por HTTP.", + "protocolAcpStep1": "Abra Painel -> Agents para verificar quais binários locais estão instalados e disponíveis como workers.", + "protocolAcpStep2": "Use Painel -> CLI Tools quando você precisa de configuração de cliente em vez de spawn de worker.", + "protocolAcpStep3": "Combine workers ACP com logs de auditoria e health para entender o que o OmniRoute iniciou e por quê." }, "legal": { "privacyPolicy": "Política de Privacidade", @@ -4454,15 +4818,6 @@ "agents": { "title": "Agentes CLI", "description": "Descubra agentes CLI instalados no seu sistema. Adicione agentes customizados para auto-detecção.", - "architectureTitle": "Fluxo de execução ACP", - "architectureDescription": "Esta tela é para binários que o OmniRoute inicia localmente como workers. O OmniRoute detecta o binário, faz o spawn e o usa como endpoint final de execução.", - "cliToolsRedirectTitle": "Procurando configuração de cliente?", - "cliToolsRedirectDesc": "Use CLI Tools quando quiser que seu editor ou cliente de terminal chame o OmniRoute por HTTP em vez de ser iniciado localmente.", - "cliToolsRedirectCta": "Ir para CLI Tools", - "flowOmniRoute": "OmniRoute", - "flowSpawn": "Inicia worker", - "flowLocalBinary": "Binário local", - "flowExecute": "Executa tarefa", "refresh": "Atualizar", "installed": "Instalado", "notFound": "Não encontrado", @@ -4472,15 +4827,16 @@ "addCustomAgent": "Adicionar Agente Customizado", "addCustomAgentDesc": "Registre qualquer ferramenta CLI para detecção. Ela será verificada automaticamente ao atualizar.", "agentName": "Nome do Agente", - "agentNamePlaceholder": "ex.: Meu Worker Customizado", "binaryName": "Nome do Binário", - "binaryNamePlaceholder": "ex.: meu-worker", "versionCommand": "Comando de Versão", - "versionCommandPlaceholder": "ex.: meu-worker --version", "spawnArgs": "Argumentos", - "spawnArgsPlaceholder": "ex.: --quiet, --json", "addAgent": "Adicionar Agente", "scanning": "Scanning system for CLI agents...", + "opencodeIntegration": "OpenCode Integration", + "opencodeDetected": "opencode {version} detected", + "opencodeDesc": "Generate a ready-to-use {configFile} with your OmniRoute base URL and all available models — drop it in your project root and run {command}.", + "downloadConfig": "Download {file}", + "downloaded": "Downloaded!", "setupGuideTitle": "Setup guide", "openCliTools": "Open CLI Tools", "setupGuideDetectCliTitle": "Detect installed CLIs", @@ -4489,11 +4845,75 @@ "setupGuideCustomAgentDesc": "Use Add Custom Agent when your CLI is not in the built-in list. Provide binary name and version command.", "setupGuideCommandMissingTitle": "Fix 'command not found'", "setupGuideCommandMissingDesc": "Ensure the CLI command exists in PATH, open a new terminal session, and rerun Refresh.", - "opencodeIntegration": "OpenCode Integration", - "opencodeDetected": "opencode {version} detected", - "opencodeDesc": "Generate a ready-to-use {configFile} with your OmniRoute base URL and all available models — drop it in your project root and run {command}.", - "downloadConfig": "Download {file}", - "downloaded": "Downloaded!" + "cliToolsRedirectTitle": "Procurando configuração de cliente?", + "cliToolsRedirectDesc": "Use CLI Tools quando quiser que seu editor ou cliente de terminal chame o OmniRoute por HTTP em vez de ser iniciado localmente.", + "spawnArgsPlaceholder": "ex.: --quiet, --json", + "binaryNamePlaceholder": "ex.: meu-worker", + "versionCommandPlaceholder": "ex.: meu-worker --version", + "architectureTitle": "Fluxo de execução ACP", + "flowLocalBinary": "Binário local", + "flowOmniRoute": "OmniRoute", + "agentNamePlaceholder": "ex.: Meu Worker Customizado", + "architectureDescription": "Esta tela é para binários que o OmniRoute inicia localmente como workers. O OmniRoute detecta o binário, faz o spawn e o usa como endpoint final de execução.", + "flowExecute": "Executa tarefa", + "flowSpawn": "Inicia worker", + "cliToolsRedirectCta": "Ir para CLI Tools", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Bate-papo simples", @@ -4570,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4581,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4588,19 +5020,27 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", @@ -4609,122 +5049,254 @@ "deduplicatedRequests": "Requisições Desduplicadas", "savedCalls": "Chamadas API Poupadas", "totalProcessed": "Total Processado", - "peakCached": "Peak cached", - "entriesLoadError": "Failed to load semantic cache entries.", - "peakCacheRate": "Peak Cache Rate", - "semanticCache": "Semantic Cache", - "busiestHour": "Busiest Hour", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "activityVolume": "Activity", - "cachedRequests24h": "Cached Requests (24h)", - "cacheRate": "Cache Rate", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "lastUpdated": "Last updated", - "hoursTracked": "hours tracked", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "trendHour": "Hour", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cacheRateDesc": "of total requests", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" + }, + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" + }, + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4783,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4829,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/pt.json b/src/i18n/messages/pt.json index ebe95cadcb..edc6ea8c8d 100644 --- a/src/i18n/messages/pt.json +++ b/src/i18n/messages/pt.json @@ -23,6 +23,7 @@ "active": "Ativo", "inactive": "Inativo", "noData": "Não há dados disponíveis", + "nothingHere": "Nothing here yet", "configure": "Configurar", "manage": "Gerenciar", "name": "Nome", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Falha ao redefinir o preço", "apikey": "Chave de API", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agentes", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memória", "skills": "Habilidades", "docs": "Documentos", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "Gerenciador de APIs", "logs": "Registros", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Registro de auditoria", "shutdown": "Desligamento", "restart": "Reiniciar", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Escolha um tema predefinido ou crie o seu próprio com uma única cor", @@ -826,6 +926,10 @@ "evals": "Avaliações", "utilization": "Utilização", "utilizationDescription": "Tendências de uso de quota do provedor e rastreamento de limites de taxa", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Saúde do Combo", "comboHealthDescription": "Quota ao nível do combo, distribuição de uso e métricas de desempenho", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Último: {date}", "editPermissions": "Editar permissões", "deleteKey": "Excluir chave", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "Modelo {count}", "models": "{count} modelos", "permissionsTitle": "Permissões: {name}", @@ -1188,11 +1296,13 @@ "continue": "Use ao executar Continue em IDEs e você precisar de uma configuração de provedor portátil baseada em JSON.", "opencode": "Use quando preferir execuções de agentes nativos de terminal e automação com script via OpenCode.", "kiro": "Use ao integrar o Kiro e controlar o roteamento do modelo centralmente no OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Use quando o tráfego Antigravity/Kiro deve ser interceptado através do MITM e roteado para OmniRoute.", "copilot": "Use quando desejar UX no estilo de bate-papo do Copilot enquanto impõe chaves OmniRoute e regras de roteamento.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE antigravidade do Google com MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Fallback sequencial: tenta primeiro o modelo 1, depois o 2, etc.", "weightedDesc": "Distribui o tráfego por porcentagem de peso com substituto", "roundRobinDesc": "Distribuição circular: cada solicitação vai para o próximo modelo em rotação", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Seleção aleatória uniforme e, em seguida, retorno aos modelos restantes", "leastUsedDesc": "Escolhe o modelo com menos solicitações, equilibrando a carga ao longo do tempo", "costOptimizedDesc": "Rotas para o modelo mais barato primeiro com base no preço", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Aleatório Estrito", "strictRandomDesc": "Baralho embaralhado — usa cada modelo uma vez antes de reembaralhar", "models": "Modelos", @@ -1404,6 +1521,13 @@ "retryDelay": "Atraso de nova tentativa (ms)", "concurrencyPerModel": "Simultaneidade/Modelo", "queueTimeout": "Tempo limite da fila (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Deixe em branco para usar padrões globais. Eles substituem as configurações por provedor.", "moveUp": "Subir", "moveDown": "Mover para baixo", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Pronto para salvar?", "readinessDescription": "Revise a lista de verificação antes de criar ou atualizar este combo.", "readinessCheckName": "O nome do combo é válido", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderModel": "Model", - "incidentMode": "Incident Mode", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "weightCostInv": "Cost", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "review": { - "description": "Final validation before saving", - "label": "Review" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" - }, - "basics": { - "description": "Name and starting template", - "label": "Basics" + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "builderComboRef": "Combo Ref", - "budgetCapLabel": "Budget Cap (USD / request)", - "filterEmptyTitle": "No combos match this strategy filter.", - "builderTitle": "Build a Combo", - "failedReorder": "Failed to reorder models", - "builderAddComboRef": "Add combo reference", - "builderProviderFirst": "Pick provider first", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "filterIntelligent": "Intelligent", - "filterAll": "All", - "weightStability": "Stability", - "builderSelectProvider": "Select provider", - "modePackLabel": "Mode Pack", - "cooldownMinutes": "Cooldown: {minutes}m", - "reorderHandle": "Drag to reorder", - "normalOperation": "Normal Operation", - "candidatePoolEmpty": "No active providers available yet.", - "excludedProviders": "Excluded Providers", + "builderStageVisited": "Stage completed", "builderStageCurrent": "Current stage", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "contextRelaySummaryModel": "Summary Model", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewNoSteps": "No steps configured", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "activeModePack": "Active Mode Pack", - "builderAccount": "Account", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderStageLocked": "Locked — complete previous stage first", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "noExcludedProviders": "No providers are currently excluded.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "candidatePoolAllProviders": "All providers", - "strategyRules": "Rules (6-Factor Scoring)", - "filterDeterministic": "Deterministic", "builderStagePending": "Pending", - "weightHealth": "Health", - "budgetCapPlaceholder": "No limit", - "reviewSteps": "Steps", - "emailVisibilityStateOn": "On", - "weightLatencyInv": "Latency", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "reviewSequence": "Model Sequence", - "builderFlowTitle": "Combo Builder Flow", - "explorationRateLabel": "Exploration Rate", - "reviewAdvanced": "Advanced Settings", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "statusOverview": "Status Overview", - "reviewAccounts": "Accounts", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", "builderPreview": "Preview", "builderAddStep": "Add step", - "emailVisibilityStateOff": "Off", - "reviewComboRefs": "Combo References", - "reviewAgentFlags": "Agent Flags", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", "builderComboRefStep": "Add combo reference", - "builderLegacyEntry": "Legacy entry", - "reviewProviders": "Providers", - "providerScores": "Provider Scores", - "builderStageVisited": "Stage completed", - "weightQuota": "Quota", - "candidatePoolLabel": "Candidate Pool", - "contextRelay": "Context Relay", - "builderBrowseCatalog": "Browse catalog", - "reviewIntelligentTitle": "Intelligent Routing Config", - "builderLoadingProviders": "Loading providers...", - "routerStrategyLabel": "Router Strategy", - "weightTierPriority": "Tier", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "reviewName": "Name", - "contextRelayHandoffThreshold": "Handoff Threshold", - "reviewStrategy": "Strategy", - "weightTaskFit": "Task Fit", "builderPinnedAccount": "Pinned Account", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderSelectModel": "Select model" + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Custos", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Orçamento", "totalCost": "Custo total", "breakdown": "Divisão de custos", "noData": "Sem dados de custo", "byModel": "Por modelo", "byProvider": "Por provedor", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Ponto final da API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transcrever arquivos de áudio para texto (Whisper)", "textToSpeech": "Texto para fala", "textToSpeechDesc": "Converta texto em fala com som natural", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderações", "moderationsDesc": "Moderação de conteúdo e classificação de segurança", "responsesDesc": "API Responses do OpenAI para Codex e fluxos de trabalho agênticos avançados", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1883,6 +2143,7 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", "ngrokTitle": "Túnel ngrok", "ngrokRunning": "Rodando", "ngrokStarting": "Iniciando", @@ -2062,11 +2323,11 @@ "content": "Conteúdo", "created": "Criado", "actions": "Ações", + "delete": "Delete", "factual": "Factual", "episodic": "Episódica", "procedural": "Procedural", "semantic": "Semântica", - "delete": "Delete", "a": "A" }, "skills": { @@ -2177,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limites e cotas", "rateLimit": "Limite de taxa", @@ -2243,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Bem vindo", @@ -2334,6 +2661,12 @@ "errorCount": "{count} Erro ({code})", "errorCountNoCode": "{count} Erro", "noConnections": "Sem conexões", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "Plano gratuito", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Desativado", "enableProvider": "Habilitar provedor", "disableProvider": "Desativar provedor", @@ -2368,7 +2701,6 @@ "errorOccurred": "Ocorreu um erro. Por favor, tente novamente.", "modelStatus": "Status do modelo", "showConfiguredOnly": "Configured only", - "searchProviders": "Pesquisar fornecedores...", "allModelsOperational": "Todos os modelos operacionais", "modelsWithIssues": "{count} modelo(s) com problemas", "allModelsNormal": "Todos os modelos estão respondendo normalmente.", @@ -2421,9 +2753,14 @@ "openaiCompatibleDetails": "Detalhes compatíveis com OpenAI", "messagesApi": "API de mensagens", "responsesApi": "API de respostas", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Conclusões de bate-papo", "importingModels": "Importando...", "importFromModels": "Importar de /modelos", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Todos os modelos já foram importados", "noNewModelsToImport": "Nenhum modelo novo para importar — todos os modelos já estão no registo ou na lista de modelos personalizados", "skippingExistingModels": "A ignorar {count} modelos existentes", @@ -2445,6 +2782,7 @@ "importFailed": "Falha na importação", "noNewModelsAdded": "Nenhum novo modelo foi adicionado.", "adding": "Adicionando...", + "close": "Close", "importingModelsTitle": "Importando Modelos", "copyModel": "Copiar modelo", "filterModels": "Filtrar modelos...", @@ -2485,6 +2823,11 @@ "configured": "configurado", "providerProxyConfigureHint": "Configure o proxy para todas as conexões deste provedor", "providerProxy": "Proxy do provedor", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Ainda não há conexões", "addFirstConnectionHint": "Adicione sua primeira conexão para começar", "addConnection": "Adicionar conexão", @@ -2551,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID do modelo", "customModelPlaceholder": "por exemplo gpt-4.5-turbo", "loading": "Carregando...", @@ -2616,19 +2962,8 @@ "statusDeactivated": "Desativado (Manual)", "statusBanned": "Banido / Sandbox Violation", "statusCreditsExhausted": "Saldo Insuficiente", - "modelsImported": "{count} models imported", - "close": "Close", - "repairEnv": "Repair env", - "repairEnvWorking": "Repairing...", - "audioSpeech": "Audio Speech", - "hideEmails": "Hide all emails", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "audioTranscriptions": "Audio Transcriptions", - "imagesGenerations": "Images Generations", "showEmails": "Show all emails", - "embeddings": "Embeddings", - "repairEnvFailed": "Failed to repair .env", - "repairEnvSuccess": "OAuth defaults restored", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2638,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2648,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2703,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2740,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Pesquisar fornecedores...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2778,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Configurações", @@ -2795,6 +3137,23 @@ "systemPrompt": "Alerta do sistema", "thinkingBudget": "Pensando no orçamento", "proxy": "Procurador", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Preços", "storage": "Armazenamento", "policies": "Políticas", @@ -2805,6 +3164,46 @@ "enablePassword": "Habilitar senha", "darkMode": "Modo escuro", "lightMode": "Modo claro", + "memoryTitle": "Memória", + "memoryDesc": "Memória conversacional persistente entre sessões", + "memoryEnabled": "Ativar Memória", + "memoryEnabledDesc": "Quando ativado, injetará o contexto passado relevante de forma dinâmica.", + "maxTokens": "Tokens Máximos", + "retentionDays": "Retenção", + "recent": "Recente", + "recentDesc": "Janela cronológica", + "semantic": "Semântica", + "semanticDesc": "Busca vetorial", + "hybrid": "Híbrido", + "hybridDesc": "Recente + Semântico", + "skillsTitle": "Skills A2A", + "skillsDesc": "Ferramentas auto-executáveis", + "skillsEnabled": "Ativar Skills", + "skillsEnabledDesc": "Permite aos agentes executar consultas e gerar arquivos.", + "skillsComingSoon": "Marketplace em breve.", + "memorySkillsTitle": "Memória e Skills", + "memorySkillsDesc": "Contexto persistente e capacidades A2A", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "agora mesmo", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Provedores", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema do sistema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2812,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Tamanho máximo do cache", "clearCache": "Limpar Cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Acessos de cache", "cacheMisses": "Perdas de cache", "hitRate": "Taxa de acerto", @@ -2834,10 +3235,12 @@ "timeoutMs": "Tempo limite (ms)", "enableSystemPrompt": "Habilitar prompt do sistema", "systemPromptText": "Texto de prompt do sistema", - "autoDisableBannedAccounts": "Auto-Disable Banned Accounts", - "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", - "autoDisableThreshold": "Ban Threshold", - "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "autoDisableBannedAccounts": "Auto-desativar contas banidas", + "autoDisableDescription": "Marca permanentemente conexões de provedor como desativadas quando retornam sinais terminais de banimento (ex.: HTTP 403 'verify your account'). Isso remove a conexão da rotação de combos.", + "autoDisableThreshold": "Limite de banimento", + "autoDisableThresholdDesc": "Quantidade de sinais consecutivos de banimento antes da desativação permanente.", + "resilienceStructureTitle": "Estrutura de resiliência", + "resilienceStructureDesc": "Esta página configura apenas o comportamento. O estado ao vivo de circuit breaker aparece na página Saúde. Controle de retry específico por combo e slot de round-robin continuam nas configurações de combos.", "enableThinking": "Habilite o pensamento", "maxThinkingTokens": "Tokens de pensamento máximo", "enableProxy": "Habilitar proxy", @@ -2874,6 +3277,14 @@ "themeLight": "Luz", "themeDark": "Escuro", "themeSystem": "Sistema", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2955,6 +3366,14 @@ "apiEndpointProtection": "Proteção de endpoint de API", "requireAuthModels": "Exigir chave de API para /models", "requireAuthModelsDesc": "Quando ativado, o endpoint /v1/models retorna 404 para solicitações não autenticadas. Impede a descoberta de modelos por usuários não autorizados.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Provedores bloqueados", "blockedProvidersDesc": "Oculte provedores específicos da resposta /v1/models. Os provedores bloqueados não aparecerão nas listagens de modelos.", "providersBlocked": "{count} provedor(es) bloqueado(s) em /models", @@ -2983,6 +3402,8 @@ "leastUsedDesc": "Escolha a conta usada menos recentemente", "costOpt": "Opção de custo", "costOptDesc": "Prefira a conta mais barata disponível", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Limite pegajoso", @@ -3074,6 +3495,8 @@ "comboStrategyAria": "Estratégia combinada", "priority": "Prioridade", "weighted": "Ponderado", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Máximo de tentativas", "retryDelayLabel": "Atraso de nova tentativa (ms)", "timeoutLabel": "Tempo limite (ms)", @@ -3094,6 +3517,10 @@ "maxNestingDepth": "Profundidade máxima de aninhamento", "concurrencyPerModel": "Simultaneidade/Modelo", "queueTimeout": "Tempo limite da fila (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Perfis de Provedores", "providerProfilesDesc": "Configurações de resiliência separadas para provedores OAuth (baseado em sessão) e chave de API (medida). Os provedores OAuth têm limites mais rígidos devido aos limites de taxas mais baixos.", "oauthProviders": "Provedores OAuth", @@ -3169,7 +3596,6 @@ "backupCreated": "Backup criado: {file}", "restoreSuccess": "Restaurado! {connections} conexões, {nodes} nós, {combos} combos, {apiKeys} chaves de API.", "importSuccess": "Banco de dados importado! {connections} conexões, {nodes} nós, {combos} combos, {apiKeys} chaves de API.", - "justNow": "agora mesmo", "minutesAgo": "{count}m atrás", "hoursAgo": "{count}h atrás", "daysAgo": "{count}d atrás", @@ -3184,7 +3610,6 @@ "errorDuringImport": "Ocorreu um erro durante a importação", "modelPricing": "Preço do modelo", "modelPricingDesc": "Configurar taxas de custo por modelo • Todas as taxas em tokens de US$/1 milhão", - "providers": "Provedores", "registry": "Registro", "priced": "Preço", "searchProvidersModels": "Pesquise fornecedores ou modelos...", @@ -3228,59 +3653,17 @@ "themeCoral": "Coral", "adaptiveVolumeRouting": "Roteamento de Volume Adaptativo", "adaptiveVolumeRoutingDesc": "Escala conexões dinamicamente com base no volume e pressão na taxa de transferência.", - "days": "Dias", - "lkgp": "Modo LKGP", - "lkgpDesc": "Último Provedor Bom Conhecido (Resiliência previsível)", - "memoryTitle": "Memória", - "memoryDesc": "Memória conversacional persistente entre sessões", - "memoryEnabled": "Ativar Memória", - "memoryEnabledDesc": "Quando ativado, injetará o contexto passado relevante de forma dinâmica.", - "maxTokens": "Tokens Máximos", - "retentionDays": "Retenção", - "recent": "Recente", - "recentDesc": "Janela cronológica", - "semantic": "Semântica", - "semanticDesc": "Busca vetorial", - "hybrid": "Híbrido", - "hybridDesc": "Recente + Semântico", - "skillsTitle": "Skills A2A", - "skillsDesc": "Ferramentas auto-executáveis", - "skillsEnabled": "Ativar Skills", - "skillsEnabledDesc": "Permite aos agentes executar consultas e gerar arquivos.", - "skillsComingSoon": "Marketplace em breve.", - "memorySkillsTitle": "Memória e Skills", - "memorySkillsDesc": "Contexto persistente e capacidades A2A", - "purgeExpiredLogs": "Purgar Logs Expirados", - "purgeLogsFailed": "Falha ao purgar logs", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", "lkgpToggleDesc": "When enabled, the router remembers which provider last served a successful response and tries it first on subsequent requests.", "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Dias", + "lkgp": "Modo LKGP", + "lkgpDesc": "Último Provedor Bom Conhecido (Resiliência previsível)", "maintenance": "Maintenance", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", + "purgeExpiredLogs": "Purgar Logs Expirados", + "purgeLogsFailed": "Falha ao purgar logs", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3302,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3383,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Memoria vetorial)", "qdrantDesc": "Opcional. Indexa memorias semanticas em um banco vetorial externo para busca mais rapida.", "qdrantStatusActive": "Ativo", @@ -3439,7 +3803,11 @@ "qdrantCleanupDesc": "Remove pontos expirados e antigos, baseado em", "searching": "Buscando...", "cleaning": "Limpando...", - "cleanNow": "Limpar agora" + "cleanNow": "Limpar agora", + "optional": "Opcional", + "current": "Atual", + "remove": "Remover", + "search": "Buscar" }, "contextRtk": { "title": "RTK Engine", @@ -3454,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3505,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3552,6 +3929,28 @@ "errorShort": "ERRO", "formatConverter": "Conversor de formato", "formatConverterDescription": "Cole ou digite um corpo de solicitação JSON. O tradutor detectará automaticamente o formato de origem e o converterá para o formato de destino. Use isto para depurar como o OmniRoute traduz solicitações entre formatos (OpenAI ↔ Claude ↔ Gemini ↔ API de respostas).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Entrada", "output": "Saída", "auto": "Automático", @@ -3660,6 +4059,11 @@ "errorMessage": "Erro: {message}", "requestFailed": "Falha na solicitação", "noTextExtracted": "(Nenhum texto extraído)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Mostra eventos de tradução à medida que as chamadas de API fluem pelo OmniRoute. Os eventos vêm do buffer na memória (redefinições na reinicialização). Usar", "liveMonitorDescriptionSuffix": "ou chamadas de API externas para gerar eventos." }, @@ -3735,14 +4139,25 @@ "passSuffix": "passar", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Executar avaliação", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Executando {current}/{total}...", "passRate": "taxa de aprovação", "summaryBreakdown": "{passed} aprovado · {failed} reprovado · {total} total", "passedIconLabel": "✅ Aprovado", "failedIconLabel": "❌ Falhou", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contém: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Esperado: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Ainda não há resultados", "testCasesCount": "Casos de teste ({count})", "noTestCasesDefined": "Nenhum caso de teste definido", @@ -3810,6 +4225,16 @@ "tierFree": "Grátis", "tierUnknown": "Desconhecido", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3852,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3865,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4029,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Waiting for Antigravity authorization...", "waitingForQoderAuthorization": "Waiting for Qoder authorization...", "exchangingCodeForTokens": "Exchanging code for tokens...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4119,6 +4549,7 @@ "docs": { "title": "Documentação", "quickStart": "Início rápido", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Recursos", "supportedProviders": "Provedores Suportados", "supportedProvidersToc": "Provedores", @@ -4155,6 +4586,20 @@ "quickStartStep4Title": "4. Defina o URL da base do cliente", "quickStartStep4Prefix": "Aponte seu cliente IDE ou API para", "quickStartStep4Suffix": "Use o prefixo do provedor, por exemplo", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Roteamento multiprovedor", "featureRoutingText": "Encaminhe solicitações para mais de 30 provedores de IA por meio de um único endpoint compatível com OpenAI. Suporta APIs de chat, respostas, áudio e imagem.", "featureCombosTitle": "Combos e Balanceamento", @@ -4199,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Usar", "clientClaudeBullet1Middle": "(Cláudio) ou", "clientClaudeBullet1Suffix": "Prefixo (antigravidade).", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4242,8 +4699,61 @@ "troubleshootingTestConnection": "Use Painel > Provedores > Testar conexão antes de testar em IDEs ou clientes externos.", "troubleshootingCircuitBreaker": "Se um provedor mostrar o disjuntor aberto, aguarde o resfriamento ou verifique a página de integridade para obter detalhes.", "troubleshootingOAuth": "Para provedores OAuth, autentique novamente se os tokens expirarem. Verifique o indicador de status do cartão do provedor.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Política de Privacidade", @@ -4347,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4424,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4435,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4442,19 +5020,27 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", @@ -4463,122 +5049,254 @@ "deduplicatedRequests": "Requisições Desduplicadas", "savedCalls": "Chamadas API Poupadas", "totalProcessed": "Total Processado", - "peakCached": "Peak cached", - "lastUpdated": "Last updated", - "cacheRateDesc": "of total requests", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "cacheRate": "Cache Rate", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "activityVolume": "Activity", - "busiestHour": "Busiest Hour", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "hoursTracked": "hours tracked", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCache": "Semantic Cache", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "peakCacheRate": "Peak Cache Rate", - "trendHour": "Hour", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" + }, + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" + }, + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4637,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4683,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ro.json b/src/i18n/messages/ro.json index 5c510d65e7..51b4a5fb30 100644 --- a/src/i18n/messages/ro.json +++ b/src/i18n/messages/ro.json @@ -23,6 +23,7 @@ "active": "Activ", "inactive": "Inactiv", "noData": "Nu există date disponibile", + "nothingHere": "Nothing here yet", "configure": "Configurați", "manage": "Gestionează", "name": "Nume", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Nu s-a resetat prețul", "apikey": "Cheia API", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agenți", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Docs", "issues": "Probleme", "endpoints": "Puncte finale", "apiManager": "Manager API", "logs": "Bușteni", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Jurnal de audit", "shutdown": "Închidere", "restart": "Reporniți", @@ -705,8 +710,6 @@ "cliToolsShort": "Instrumente", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evaluări", "utilization": "Utilizare", "utilizationDescription": "Tendințe de utilizare a cotelor furnizorului și urmărirea limitelor de rată", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Sănătatea Combo-ului", "comboHealthDescription": "Cotă la nivel de combo, distribuția utilizării și metricile de performanță", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Ultima: {date}", "editPermissions": "Editați permisiunile", "deleteKey": "Șterge cheia", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} modele", "permissionsTitle": "Permisiuni: {name}", @@ -1188,11 +1296,13 @@ "continue": "Utilizați atunci când rulați Continue în IDE-uri și aveți nevoie de o configurație portabilă a furnizorului bazată pe JSON.", "opencode": "Utilizați atunci când preferați rulările de agent nativ terminal și automatizarea prin script prin OpenCode.", "kiro": "Utilizați atunci când integrați Kiro și controlați rutarea modelului central din OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Utilizați atunci când traficul Antigravity/Kiro trebuie interceptat prin MITM și direcționat către OmniRoute.", "copilot": "Utilizați atunci când doriți UX în stilul de chat Copilot, în timp ce aplicați cheile și regulile de rutare OmniRoute.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE cu MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Secvenţială alternativă: încearcă mai întâi modelul 1, apoi 2 etc.", "weightedDesc": "Distribuie traficul în procente de greutate cu rezervă", "roundRobinDesc": "Distribuție circulară: fiecare cerere trece la următorul model în rotație", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Selectare aleatorie uniformă, apoi revenire la modelele rămase", "leastUsedDesc": "Alege modelul cu cele mai puține solicitări, echilibrând sarcina în timp", "costOptimizedDesc": "Rute către cel mai ieftin model mai întâi pe baza prețului", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modele", @@ -1404,6 +1521,13 @@ "retryDelay": "Întârziere reîncercare (ms)", "concurrencyPerModel": "Concurență / Model", "queueTimeout": "Timp de așteptare la coadă (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Lăsați gol pentru a utiliza setările implicite globale. Acestea înlocuiesc setările pentru fiecare furnizor.", "moveUp": "Mișcă-te în sus", "moveDown": "Deplasați-vă în jos", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, - "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." - }, "p2c": { - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, + "context-relay": { + "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Sunteți gata să economisiți?", "readinessDescription": "Examinați lista de verificare înainte de a crea sau a actualiza această combinație.", "readinessCheckName": "Numele combinației este valid", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "budgetCapPlaceholder": "No limit", + "emailVisibilityStateOn": "On", "emailVisibilityStateOff": "Off", - "weightHealth": "Health", - "builderSelectProvider": "Select provider", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "reviewProviders": "Providers", - "reviewNoSteps": "No steps configured", - "normalOperation": "Normal Operation", - "reviewStrategy": "Strategy", - "weightTaskFit": "Task Fit", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "builderModel": "Model", - "builderLoadingProviders": "Loading providers...", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderPreview": "Preview", - "filterEmptyTitle": "No combos match this strategy filter.", - "filterDeterministic": "Deterministic", - "builderFlowTitle": "Combo Builder Flow", - "candidatePoolAllProviders": "All providers", "reorderHandle": "Drag to reorder", - "providerScores": "Provider Scores", - "builderBrowseCatalog": "Browse catalog", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "review": { - "description": "Final validation before saving", - "label": "Review" - }, - "strategy": { - "label": "Strategy", - "description": "Routing behavior and advanced settings" - }, "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "reviewIntelligentTitle": "Intelligent Routing Config", - "weightCostInv": "Cost", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "reviewAdvanced": "Advanced Settings", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "reviewName": "Name", - "builderStageCurrent": "Current stage", - "statusOverview": "Status Overview", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "candidatePoolEmpty": "No active providers available yet.", - "weightLatencyInv": "Latency", - "excludedProviders": "Excluded Providers", - "contextRelay": "Context Relay", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderProvider": "Provider", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderAccount": "Account", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "candidatePoolLabel": "Candidate Pool", - "reviewComboRefs": "Combo References", - "activeModePack": "Active Mode Pack", "builderStageVisited": "Stage completed", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "reviewAccounts": "Accounts", - "budgetCapLabel": "Budget Cap (USD / request)", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderAddStep": "Add step", - "routerStrategyLabel": "Router Strategy", - "weightTierPriority": "Tier", - "incidentMode": "Incident Mode", - "builderLegacyEntry": "Legacy entry", - "builderComboRefStep": "Add combo reference", - "filterIntelligent": "Intelligent", - "reviewSteps": "Steps", - "builderSelectModel": "Select model", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "builderProviderFirst": "Pick provider first", - "builderTitle": "Build a Combo", - "strategyRules": "Rules (6-Factor Scoring)", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderAddComboRef": "Add combo reference", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", - "explorationRateLabel": "Exploration Rate", - "noExcludedProviders": "No providers are currently excluded.", - "failedReorder": "Failed to reorder models", - "weightQuota": "Quota", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "cooldownMinutes": "Cooldown: {minutes}m", - "emailVisibilityStateOn": "On", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewAgentFlags": "Agent Flags", - "modePackLabel": "Mode Pack", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "filterAll": "All", "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", "builderComboRef": "Combo Ref", - "weightStability": "Stability", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", "reviewSequence": "Model Sequence", - "builderPinnedAccount": "Pinned Account" + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costuri", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Buget", "totalCost": "Costul total", "breakdown": "Defalcarea costurilor", "noData": "Fără date de cost", "byModel": "După model", "byProvider": "Prin Furnizor", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transcrie fișiere audio în text (Șoaptă)", "textToSpeech": "Text to Speech", "textToSpeechDesc": "Transformați textul în vorbire cu sunet natural", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderații", "moderationsDesc": "Moderarea conținutului și clasificarea siguranței", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Sănătatea sistemului", "description": "Monitorizarea în timp real a instanței dvs. OmniRoute", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limite și cote", "rateLimit": "Limită de rată", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Bun venit", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Eroare ({code})", "errorCountNoCode": "{count} Eroare", "noConnections": "Fără conexiuni", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Dezactivat", "enableProvider": "Activați furnizorul", "disableProvider": "Dezactivați furnizorul", @@ -2296,7 +2701,6 @@ "errorOccurred": "A apărut o eroare. Vă rugăm să încercați din nou.", "modelStatus": "Stare model", "showConfiguredOnly": "Configured only", - "searchProviders": "Căutați furnizori...", "allModelsOperational": "Toate modelele sunt operaționale", "modelsWithIssues": "{count} model(e) cu probleme", "allModelsNormal": "Toate modelele răspund normal.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Detalii compatibile cu OpenAI", "messagesApi": "Messages API", "responsesApi": "API de răspunsuri", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Finalizări de chat", "importingModels": "Se importă...", "importFromModels": "Import din /modele", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Toate modelele sunt deja importate", "noNewModelsToImport": "Niciun model nou de importat — toate modelele sunt deja în registru sau în lista de modele personalizate", "skippingExistingModels": "Se omit {count} modele existente", @@ -2373,6 +2782,7 @@ "importFailed": "Importul nu a reușit", "noNewModelsAdded": "Nu au fost adăugate modele noi.", "adding": "Se adaugă...", + "close": "Close", "importingModelsTitle": "Importul modelelor", "copyModel": "Copiați modelul", "filterModels": "Filtrează modelele…", @@ -2413,6 +2823,11 @@ "configured": "configurat", "providerProxyConfigureHint": "Configurați proxy pentru toate conexiunile acestui furnizor", "providerProxy": "Proxy de furnizor", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Încă nu există conexiuni", "addFirstConnectionHint": "Adăugați prima conexiune pentru a începe", "addConnection": "Adăugați o conexiune", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID model", "customModelPlaceholder": "de ex. gpt-4.5-turbo", "loading": "Se încarcă...", @@ -2513,6 +2931,10 @@ "email": "E-mail", "healthCheckMinutes": "Verificare de sănătate (min)", "healthCheckHint": "Interval proactiv de reîmprospătare a simbolului. 0 = dezactivat.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Nu s-a testat conexiunea", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "imagesGenerations": "Images Generations", - "embeddings": "Embeddings", - "repairEnv": "Repair env", - "selectAllModels": "Select all", - "audioSpeech": "Audio Speech", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "hideEmails": "Hide all emails", - "deselectAllModels": "Deselect all", - "audioTranscriptions": "Audio Transcriptions", "showEmails": "Show all emails", - "repairEnvWorking": "Repairing...", - "repairEnvFailed": "Failed to repair .env", - "modelsActiveCount": "{active}/{total} active", - "repairEnvSuccess": "OAuth defaults restored", - "noModelsMatch": "No models match \"{filter}\"", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Căutați furnizori...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Setări", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prețuri", "storage": "Depozitare", "policies": "Politici", @@ -2749,6 +3164,46 @@ "enablePassword": "Activați parola", "darkMode": "Modul întunecat", "lightMode": "Modul de lumină", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "tocmai acum", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Furnizorii", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Tema sistemului", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Dimensiunea maximă a memoriei cache", "clearCache": "Goliți memoria cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Hits în cache", "cacheMisses": "Cache Misses", "hitRate": "Rata de lovituri", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Activați gândirea", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Activați proxy", @@ -2818,6 +3277,14 @@ "themeLight": "Lumină", "themeDark": "Întuneric", "themeSystem": "Sistem", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Necesită cheia API pentru /models", "requireAuthModelsDesc": "Când este ACTIVAT, punctul final /v1/models returnează 404 pentru solicitările neautentificate. Previne descoperirea modelului de către utilizatori neautorizați.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Furnizori blocați", "blockedProvidersDesc": "Ascundeți anumiți furnizori din răspunsul /v1/models. Furnizorii blocați nu vor apărea în listele de modele.", "providersBlocked": "{count} furnizor(i) blocat(i) de la /modele", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Alegeți contul cel mai puțin utilizat recent", "costOpt": "Cost Opt", "costOptDesc": "Prefer cel mai ieftin cont disponibil", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Limită lipicioasă", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Strategie combinată", "priority": "Prioritate", "weighted": "ponderat", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Reîncercări maxime", "retryDelayLabel": "Întârziere reîncercare (ms)", "timeoutLabel": "Timeout (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Adâncimea maximă de cuibărire", "concurrencyPerModel": "Concurență / Model", "queueTimeout": "Timp de așteptare la coadă (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profiluri de furnizor", "providerProfilesDesc": "Setări separate de rezistență pentru furnizorii OAuth (bazat pe sesiune) și API Key (contorizat). Furnizorii OAuth au praguri mai stricte din cauza limitelor mai mici ale ratei.", "oauthProviders": "Furnizori OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "Backup creat: {file}", "restoreSuccess": "Restaurat! {connections} conexiuni, {nodes} noduri, {combos} combo, {apiKeys} chei API.", "importSuccess": "Baza de date importată! {connections} conexiuni, {nodes} noduri, {combos} combo, {apiKeys} chei API.", - "justNow": "tocmai acum", "minutesAgo": "{count}m în urmă", "hoursAgo": "acum {count}h", "daysAgo": "acum {count}d", @@ -3128,7 +3610,6 @@ "errorDuringImport": "A apărut o eroare în timpul importului", "modelPricing": "Prețul modelului", "modelPricingDesc": "Configurați tarifele de cost pe model • Toate tarifele în jetoane $/1M", - "providers": "Furnizorii", "registry": "Registrul", "priced": "Preț", "searchProvidersModels": "Căutați furnizori sau modele...", @@ -3170,47 +3651,6 @@ "editPricing": "Editați prețul", "viewFullDetails": "Vezi detalii complete", "themeCoral": "Coral", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Convertor de format", "formatConverterDescription": "Lipiți sau introduceți un corp de solicitare JSON. Traducătorul va detecta automat formatul sursă și îl va converti în formatul țintă. Utilizați aceasta pentru a depana modul în care OmniRoute traduce cererile între formate (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Intrare", "output": "Ieșire", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Eroare: {message}", "requestFailed": "Solicitarea a eșuat", "noTextExtracted": "(Niciun text extras)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Afișează evenimentele de traducere pe măsură ce apelurile API circulă prin OmniRoute. Evenimentele provin din buffer-ul din memorie (resetează la repornire). Utilizați", "liveMonitorDescriptionSuffix": ", sau apeluri API externe pentru a genera evenimente." }, @@ -3648,14 +4139,25 @@ "passSuffix": "trece", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Rulați Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Se rulează {current}/{total}...", "passRate": "rata de promovare", "summaryBreakdown": "{passed} a trecut · {failed} a eșuat · {total} total", "passedIconLabel": "✅ A trecut", "failedIconLabel": "❌ A eșuat", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Conține: „{term}”", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Așteptată: „{expected}”", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Niciun rezultat încă", "testCasesCount": "Cazuri de testare ({count})", "noTestCasesDefined": "Nu au fost definite cazuri de testare", @@ -3723,6 +4225,16 @@ "tierFree": "Gratuit", "tierUnknown": "Necunoscut", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,9 +4459,9 @@ "waitingForAntigravityAuthorization": "Se așteaptă autorizația antigravitație...", "waitingForQoderAuthorization": "Se așteaptă autorizarea Qoder...", "exchangingCodeForTokens": "Se schimbă codul pentru jetoane...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "Documentare", "quickStart": "Pornire rapidă", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Caracteristici", "supportedProviders": "Furnizori acceptați", "supportedProvidersToc": "Furnizorii", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Setați adresa URL a bazei de clienți", "quickStartStep4Prefix": "Îndreptați-vă clientul IDE sau API către", "quickStartStep4Suffix": "Utilizați prefixul furnizorului, de exemplu", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Rutare cu mai mulți furnizori", "featureRoutingText": "Dirijați cererile către peste 30 de furnizori de AI printr-un singur punct final compatibil cu OpenAI. Acceptă API-uri de chat, răspunsuri, audio și imagine.", "featureCombosTitle": "Combo și echilibrare", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Utilizați", "clientClaudeBullet1Middle": "(Claude) sau", "clientClaudeBullet1Suffix": "(antigravitație) prefix.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Utilizați Tabloul de bord > Furnizori > Testați conexiunea înainte de a testa de la IDE-uri sau clienți externi.", "troubleshootingCircuitBreaker": "Dacă un furnizor arată întrerupătorul deschis, așteptați răcirea sau verificați pagina Sănătate pentru detalii.", "troubleshootingOAuth": "Pentru furnizorii OAuth, re-autentificați-vă dacă tokenurile expiră. Verificați indicatorul de stare a cardului furnizorului.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Politica de confidențialitate", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Chat simplu", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "entriesLoadError": "Failed to load semantic cache entries.", - "busiestHour": "Busiest Hour", - "hoursTracked": "hours tracked", - "lastUpdated": "Last updated", - "cacheRate": "Cache Rate", - "activityVolume": "Activity", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "cacheRateDesc": "of total requests", - "trendHour": "Hour", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cachedRequests24h": "Cached Requests (24h)", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticCache": "Semantic Cache", - "peakCacheRate": "Peak Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ru.json b/src/i18n/messages/ru.json index f5e7c2c66c..ffa9c981ea 100644 --- a/src/i18n/messages/ru.json +++ b/src/i18n/messages/ru.json @@ -23,6 +23,7 @@ "active": "Активный", "inactive": "Неактивный", "noData": "Нет доступных данных", + "nothingHere": "Nothing here yet", "configure": "Настроить", "manage": "Управление", "name": "Имя", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Не удалось сбросить цены.", "apikey": "API-ключ", "http": "HTTP", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Площадка", "searchTools": "Инструменты поиска", "agents": "Агенты", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Память", + "skills": "Навыки", "docs": "Документы", "issues": "Проблемы", "endpoints": "Конечные точки", "apiManager": "Менеджер API", "logs": "Журналы", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Журнал аудита", "shutdown": "Выключить", "restart": "Перезапуск", @@ -705,8 +710,6 @@ "cliToolsShort": "Инструменты", "cache": "Кэш", "cacheShort": "Кэш", - "memory": "Память", - "skills": "Навыки", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Темы", "description": "Выбери готовую тему или создай свою из одного цвета", @@ -826,6 +926,10 @@ "evals": "Оценки", "utilization": "Использование", "utilizationDescription": "Тенденции использования квоты поставщика и отслеживание ограничений скорости", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Здоровье комбо", "comboHealthDescription": "Квота на уровне комбо, распределение использования и метрики производительности", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Последний: {date}", "editPermissions": "Редактировать разрешения", "deleteKey": "Удалить ключ", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} модель", "models": "{count} модели", "permissionsTitle": "Разрешения: {name}", @@ -1188,11 +1296,13 @@ "continue": "Используйте при запуске Продолжить в IDE, если вам нужна переносимая конфигурация поставщика на основе JSON.", "opencode": "Используйте, если вы предпочитаете запускать собственные агенты терминала и автоматизировать скрипты через OpenCode.", "kiro": "Используйте при интеграции Kiro и централизованном управлении маршрутизацией модели из OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Используйте, когда трафик Антигравитации/Киро необходимо перехватить через MITM и направить в OmniRoute.", "copilot": "Используйте его, если вам нужен пользовательский интерфейс в стиле чата Copilot, одновременно обеспечивая соблюдение ключей OmniRoute и правил маршрутизации.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE с MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Редактор кода Windsurf с ИИ", "copilot": "Ассистент GitHub Copilot с ИИ", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1334,35 +1446,12 @@ } } }, - "guides.opencode.steps.1.title": "Установите OpenCode", - "guides.opencode.steps.1.desc": "Установите через npm: npm install -g opencode-ai", - "guides.opencode.steps.2.title": "API-ключ", - "guides.opencode.steps.3.title": "Задайте базовый URL", - "guides.opencode.steps.3.desc": "opencode config set baseUrl {baseUrl}", - "guides.opencode.steps.4.title": "Выберите модель", - "guides.opencode.steps.5.title": "Используйте вариант мышления", - "guides.opencode.steps.5.desc": "Для thinking-моделей запускайте с --variant high/low/max (пример команды ниже).", - "guides.kiro.steps.1.title": "Откройте настройки Kiro", - "guides.kiro.steps.1.desc": "Перейдите в Настройки → Поставщик ИИ", - "guides.kiro.steps.2.title": "Базовый URL", - "guides.kiro.steps.2.desc": "Вставьте URL вашего эндпоинта OmniRoute", - "guides.kiro.steps.3.title": "API-ключ", - "guides.kiro.steps.4.title": "Выберите модель", - "guides.windsurf.steps.1.title": "Откройте настройки ИИ", - "guides.windsurf.steps.1.desc": "Нажмите значок настроек ИИ в Windsurf или откройте Настройки", - "guides.windsurf.steps.2.title": "Добавьте кастомного провайдера", - "guides.windsurf.steps.2.desc": "Выберите \"Add custom provider\" (совместимый с OpenAI)", - "guides.windsurf.steps.3.title": "Базовый URL", - "guides.windsurf.steps.3.desc": "http://127.0.0.1:20128/v1", - "guides.windsurf.steps.4.title": "API-ключ", - "guides.windsurf.steps.4.desc": "Выберите ключ API OmniRoute", - "guides.windsurf.steps.5.title": "Выберите модель", - "guides.windsurf.steps.5.desc": "Выберите модель из выпадающего списка", "autoConfiguredTab": "Auto Configured Tab", "toolCategoriesDesc": "Tool Categories Desc", "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1417,9 +1506,13 @@ "priorityDesc": "Последовательный откат: сначала пробуется модель 1, затем 2 и т. д.", "weightedDesc": "Распределяет трафик по весовому проценту с резервным вариантом", "roundRobinDesc": "Круговое распределение: каждый запрос переходит к следующей модели по очереди.", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Равномерный случайный выбор, затем возврат к оставшимся моделям", "leastUsedDesc": "Выбирает модель с наименьшим количеством запросов, балансируя нагрузку с течением времени.", "costOptimizedDesc": "Маршруты к самой дешевой модели в первую очередь на основе цены", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Строгий случайный", "strictRandomDesc": "Перемешивание колоды - каждая модель используется по одному разу перед новым перемешиванием", "models": "Модели", @@ -1428,6 +1521,13 @@ "retryDelay": "Задержка повтора (мс)", "concurrencyPerModel": "Параллелизм/модель", "queueTimeout": "Тайм-аут очереди (мс)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Оставьте пустым, чтобы использовать глобальные значения по умолчанию. Они переопределяют настройки каждого провайдера.", "moveUp": "Вверх", "moveDown": "Двигаться вниз", @@ -1471,20 +1571,45 @@ "avoid": "Данные о ценах отсутствуют или устарели.", "example": "Фоновые или пакетные задачи, где важнее низкая стоимость." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Используйте, когда нужен идеально ровный spread - каждая модель используется один раз перед повтором.", "avoid": "Избегайте, когда модели отличаются по качеству или задержке и важен порядок.", "example": "Пример: несколько аккаунтов одной модели для равномерного распределения использования." }, + "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." }, - "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1519,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round robin наиболее полезен минимум с 2 моделями.", "warningCostOptimizedPartialPricing": "Только у {priced} из {total} моделей есть цены. Маршрутизация может быть лишь частично чувствительна к стоимости.", "warningCostOptimizedNoPricing": "Для этого комбо не найдены данные о ценах. Оптимизация по стоимости может маршрутизировать неожиданно.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Готовы сохранить?", "readinessDescription": "Прежде чем создавать или обновлять эту комбинацию, просмотрите контрольный список.", "readinessCheckName": "Имя комбинации действительно", @@ -1536,6 +1667,44 @@ "applyRecommendations": "Применить рекомендации", "recommendationsUpdated": "Рекомендации обновлены для {strategy}.", "recommendationsApplied": "Рекомендации применены к этому комбо.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Базовая отказоустойчивая схема", @@ -1579,12 +1748,61 @@ "tip2": "Держите качественный резерв для сложных запросов.", "tip3": "Подходит для пакетных и фоновых задач, где стоимость - главный KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Распределение по перемешиванию", "description": "Каждая модель используется ровно один раз за цикл перед повторным перемешиванием.", "tip1": "Используйте минимум 2 модели для осмысленного распределения.", "tip2": "Лучше всего работает с моделями схожей производительности.", "tip3": "Идеально для балансировки нагрузки между несколькими API-аккаунтами." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Бесплатный стек ($0)", @@ -1605,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "cooldownMinutes": "Cooldown: {minutes}m", - "contextRelaySummaryModel": "Summary Model", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "weightCostInv": "Cost", - "strategyRules": "Rules (6-Factor Scoring)", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { "basics": { "label": "Basics", "description": "Name and starting template" }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" + }, "strategy": { "label": "Strategy", "description": "Routing behavior and advanced settings" }, "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { "label": "Review", "description": "Final validation before saving" } }, - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "reviewComboRefs": "Combo References", - "builderSelectModel": "Select model", - "builderAddComboRef": "Add combo reference", - "emailVisibilityStateOn": "On", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "reviewName": "Name", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "activeModePack": "Active Mode Pack", - "modePackUpdated": "Mode pack updated to {pack}.", - "filterAll": "All", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "budgetCapLabel": "Budget Cap (USD / request)", - "filterDeterministic": "Deterministic", - "weightHealth": "Health", - "builderPinnedAccount": "Pinned Account", - "reviewAgentFlags": "Agent Flags", - "reviewAccounts": "Accounts", - "reviewNoSteps": "No steps configured", - "reorderHandle": "Drag to reorder", - "weightTaskFit": "Task Fit", - "incidentMode": "Incident Mode", - "weightQuota": "Quota", - "modePackLabel": "Mode Pack", - "builderPreview": "Preview", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "candidatePoolLabel": "Candidate Pool", - "builderAddStep": "Add step", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "reviewSteps": "Steps", - "weightLatencyInv": "Latency", - "filterEmptyTitle": "No combos match this strategy filter.", - "explorationRateLabel": "Exploration Rate", - "noExcludedProviders": "No providers are currently excluded.", - "weightStability": "Stability", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", "builderStageVisited": "Stage completed", - "candidatePoolEmpty": "No active providers available yet.", - "reviewIntelligentTitle": "Intelligent Routing Config", - "builderTitle": "Build a Combo", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderAccount": "Account", - "builderStageLocked": "Locked — complete previous stage first", - "reviewAdvanced": "Advanced Settings", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "failedReorder": "Failed to reorder models", - "routerStrategyLabel": "Router Strategy", - "candidatePoolAllProviders": "All providers", - "statusOverview": "Status Overview", - "builderModel": "Model", - "builderProvider": "Provider", - "emailVisibilityStateOff": "Off", - "reviewStrategy": "Strategy", - "providerScores": "Provider Scores", - "builderComboRef": "Combo Ref", "builderStageCurrent": "Current stage", - "budgetCapPlaceholder": "No limit", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "normalOperation": "Normal Operation", - "builderLegacyEntry": "Legacy entry", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderProviderFirst": "Pick provider first", - "contextRelay": "Context Relay", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "contextRelayMaxMessages": "Max Messages For Summary", - "weightTierPriority": "Tier", - "reviewSequence": "Model Sequence", - "builderBrowseCatalog": "Browse catalog", - "contextRelayHandoffThreshold": "Handoff Threshold", - "reviewProviders": "Providers", - "builderFlowTitle": "Combo Builder Flow", "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", "builderLoadingProviders": "Loading providers...", - "excludedProviders": "Excluded Providers", - "builderComboRefStep": "Add combo reference", "builderSelectProvider": "Select provider", - "filterIntelligent": "Intelligent", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "advancedWeightsTitle": "Advanced: Scoring Weights" + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Затраты", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Бюджет", "totalCost": "Общая стоимость", "breakdown": "Распределение затрат", "noData": "Нет данных о стоимости", "byModel": "По модели", "byProvider": "По поставщику", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1740,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Конечная точка API", @@ -1771,6 +2007,8 @@ "audioTranscriptionDesc": "Транскрипция аудиофайлов в текст (шепотом)", "textToSpeech": "Преобразование текста в речь", "textToSpeechDesc": "Преобразование текста в естественно звучащую речь", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Модерации", "moderationsDesc": "Модерация контента и классификация безопасности", "responsesDesc": "OpenAI Responses API для Codex и продвинутых агентных рабочих процессов", @@ -1871,8 +2109,6 @@ "a2aQuickStartStep3": "Отслеживайте и управляйте задачами через `tasks/get` и `tasks/cancel`.", "completionsLegacy": "Завершения (устар.)", "completionsLegacyDesc": "Устаревшие текстовые завершения OpenAI — поддерживают и строку prompt, и массив messages", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1906,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Прокси конечных точек", @@ -2050,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Память", + "description": "Постоянная кросс-сессионная память для диалогов", + "memories": "Память", + "totalEntries": "Всего записей", + "tokensUsed": "Использовано токенов", + "hitRate": "Коэффициент попадания", + "loading": "Загрузка...", + "noMemories": "Записей памяти не найдено", + "search": "Поиск", + "allTypes": "Все типы", + "export": "Экспорт", + "import": "Импорт", + "addMemory": "Добавить запись памяти", + "type": "Тип", + "key": "Ключ", + "content": "Содержимое", + "created": "Создано", + "actions": "Действия", + "delete": "Delete", + "factual": "Фактическая", + "episodic": "Эпизодическая", + "procedural": "Процедурная", + "semantic": "Семантическая", + "a": "A" + }, + "skills": { + "title": "Навыки", + "description": "Инструменты для моделей", + "skillsTab": "Навыки", + "executionsTab": "Выполнения", + "sandboxTab": "Песочница", + "loading": "Загрузка...", + "noSkills": "Навыки не найдены", + "noExecutions": "Выполнений не найдено", + "enabled": "Включено", + "disabled": "Отключено", + "version": "Версия", + "tableDescription": "Описание", + "skill": "Навык", + "status": "Статус", + "duration": "Длительность", + "time": "Время", + "sandboxConfig": "Конфигурация песочницы", + "cpuLimit": "Лимит CPU", + "cpuLimitDesc": "Максимальное число ядер или доля CPU, доступная песочнице.", + "memoryLimit": "Лимит памяти", + "memoryLimitDesc": "Максимальный объём памяти, доступный песочнице.", + "timeout": "Тайм-аут", + "timeoutDesc": "Максимальная длительность выполнения до принудительного завершения.", + "networkAccess": "Доступ к сети", + "networkAccessDesc": "Разрешить навыку сетевые запросы.", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Здоровье системы", "description": "Мониторинг вашего экземпляра OmniRoute в режиме реального времени", @@ -2129,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Лимиты и квоты", "rateLimit": "Ограничение скорости", @@ -2195,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Добро пожаловать", @@ -2286,6 +2661,12 @@ "errorCount": "{count} Ошибка ({code})", "errorCountNoCode": "{count} Ошибка", "noConnections": "Нет соединений", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Отключено", "enableProvider": "Включить провайдера", "disableProvider": "Отключить провайдера", @@ -2320,7 +2701,6 @@ "errorOccurred": "Произошла ошибка. Пожалуйста, попробуйте еще раз.", "modelStatus": "Статус модели", "showConfiguredOnly": "Только настроенные", - "searchProviders": "Поиск поставщиков...", "allModelsOperational": "Все модели в рабочем состоянии", "modelsWithIssues": "{count} модели с проблемами", "allModelsNormal": "Все модели реагируют нормально.", @@ -2373,9 +2753,14 @@ "openaiCompatibleDetails": "Подробности совместимости с OpenAI", "messagesApi": "API сообщений", "responsesApi": "API ответов", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Завершения чата", "importingModels": "Импорт...", "importFromModels": "Импорт из /модели", + "modelsImported": "{count} моделей импортировано", "allModelsAlreadyImported": "Все модели уже импортированы", "noNewModelsToImport": "Нет новых моделей для импорта — все модели уже есть в реестре или списке пользовательских моделей", "skippingExistingModels": "Пропуск {count} существующих моделей", @@ -2397,6 +2782,7 @@ "importFailed": "Импорт не удался", "noNewModelsAdded": "Новых моделей не добавлялось.", "adding": "Добавление...", + "close": "Закрыть", "importingModelsTitle": "Импорт моделей", "copyModel": "Копировать модель", "filterModels": "Фильтровать модели…", @@ -2421,7 +2807,6 @@ "importSuccessCount": "{count, plural, one {# model} other {# models}} успешно импортирован!", "noNewModelsAddedExisting": "Новых моделей не добавлялось (все уже есть).", "importDoneCount": "✓ Готово! {count, plural, one {# model imported.} other {# models imported.}}", - "modelsImported": "{count} моделей импортировано", "unexpectedErrorOccurred": "Произошла непредвиденная ошибка", "connectionCountLabel": "{count, plural, one {# соединение} few {# соединения} many {# соединений} other {# соединения}}", "messagesPath": "сообщения", @@ -2430,7 +2815,6 @@ "add": "Добавить", "edit": "Редактировать", "delete": "Удалить", - "close": "Закрыть", "anthropic": "антропный", "openai": "ОпенАИ", "singleConnectionPerCompatible": "Для каждого совместимого узла разрешено только одно соединение. Добавьте еще один узел, если вам нужно больше соединений.", @@ -2461,9 +2845,6 @@ "statusUnavailable": "недоступен", "statusFailed": "не удалось", "statusError": "ошибка", - "statusDeactivated": "Отключено (вручную)", - "statusBanned": "Заблокировано / нарушение песочницы", - "statusCreditsExhausted": "Недостаточно баланса / квота исчерпана", "oauthAccount": "Учетная запись OAuth", "errorTypeRuntime": "Локальная среда выполнения", "errorTypeUpstreamAuth": "Авторизация восходящего потока", @@ -2513,6 +2894,9 @@ "compatUpstreamAddRow": "Добавить заголовок", "compatUpstreamRemoveRow": "Удалить строку", "compatBadgeUpstreamHeaders": "Заголовки", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Идентификатор модели", "customModelPlaceholder": "например gpt-4.5-турбо", "loading": "Загрузка...", @@ -2547,6 +2931,10 @@ "email": "электронная почта", "healthCheckMinutes": "Проверка здоровья (мин)", "healthCheckHint": "Интервал обновления упреждающего токена. 0 = отключено.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Среда", "groupPlaceholder": "например eKaizen, Personal", "failedTestConnection": "Не удалось проверить соединение", @@ -2571,16 +2959,11 @@ "modelsPathLabel": "Путь эндпоинта моделей", "modelsPathPlaceholder": "/models", "modelsPathHint": "Пользовательский путь моделей для проверки (например, /v4/models)", + "statusDeactivated": "Отключено (вручную)", + "statusBanned": "Заблокировано / нарушение песочницы", + "statusCreditsExhausted": "Недостаточно баланса / квота исчерпана", "showEmails": "Show all emails", - "deselectAllModels": "Deselect all", - "embeddings": "Embeddings", "hideEmails": "Hide all emails", - "audioSpeech": "Audio Speech", - "imagesGenerations": "Images Generations", - "noModelsMatch": "No models match \"{filter}\"", - "modelsActiveCount": "{active}/{total} active", - "audioTranscriptions": "Audio Transcriptions", - "selectAllModels": "Select all", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2590,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2600,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2655,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2692,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Поиск поставщиков...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2730,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Настройки", @@ -2763,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Цены", "storage": "Хранение", "policies": "Политика", @@ -2773,6 +3164,46 @@ "enablePassword": "Включить пароль", "darkMode": "Темный режим", "lightMode": "Светлый режим", + "memoryTitle": "Память", + "memoryDesc": "Постоянная кросс-сессионная память для диалогов", + "memoryEnabled": "Включить память", + "memoryEnabledDesc": "Когда включено, OmniRoute будет внедрять релевантный прошлый контекст.", + "maxTokens": "Макс. токенов", + "retentionDays": "Срок хранения", + "recent": "Недавнее", + "recentDesc": "Хронологическое окно", + "semantic": "Семантическое", + "semanticDesc": "Векторный поиск", + "hybrid": "Гибридное", + "hybridDesc": "Недавнее + семантическое", + "skillsTitle": "Навыки", + "skillsDesc": "Инструменты для моделей", + "skillsEnabled": "Включить навыки", + "skillsEnabledDesc": "Позволяет агентам вызывать функции.", + "skillsComingSoon": "Маркетплейс навыков скоро появится.", + "memorySkillsTitle": "Память и навыки", + "memorySkillsDesc": "Постоянный контекст и возможности", + "modelsDevTitle": "База моделей", + "modelsDevDesc": "Автосинхронизация цен, возможностей и спецификаций из models.dev", + "modelsDevEnabled": "Включить синхронизацию models.dev", + "modelsDevEnabledDesc": "Получать цены, возможности и спецификации моделей из открытой базы models.dev", + "modelsDevInterval": "Интервал синхронизации", + "syncNow": "Синхронизировать сейчас", + "syncing": "Синхронизация...", + "lastSync": "Последняя синхронизация", + "never": "Никогда", + "justNow": "только что", + "modelsDevStats": "Статистика синхронизации", + "modelsDevStatsDesc": "Текущее покрытие данных models.dev", + "providers": "Провайдеры", + "modelsWithPricing": "Модели с ценами", + "capabilities": "Возможности", + "lastSyncCount": "Количество при последней синхронизации", + "lastSyncFull": "Последняя полная синхронизация", + "modelsDevInfo": "Как это работает", + "modelsDevInfoDesc": "models.dev - это открытая база спецификаций AI-моделей, поддерживаемая командой SST/OpenCode. Она предоставляет цены, возможности, ограничения контекста и модальности для более чем 4 000 моделей от более чем 100 провайдеров.", + "modelsDevInfoResolution": "Порядок выбора цены (сначала самый приоритетный):", + "modelsDevInfoOrder": "Переопределение пользователя → models.dev → LiteLLM → Жёстко заданное значение по умолчанию", "systemTheme": "Системная тема", "debugToggle": "Включить режим отладки", "sidebarVisibilityToggle": "Показывать элементы боковой панели", @@ -2780,24 +3211,12 @@ "cacheTTL": "Срок жизни кэша", "maxCacheSize": "Максимальный размер кэша", "clearCache": "Очистить кэш", + "cacheCleared": "Кэш успешно очищен", + "clearCacheFailed": "Не удалось очистить кэш", "cacheHits": "Попадания в кэш", "cacheMisses": "Промахи в кэше", "hitRate": "Скорость попадания", "cacheEntries": "Записи кэша", - "adaptiveVolumeRouting": "Адаптивная маршрутизация по объёму", - "adaptiveVolumeRoutingDesc": "Динамически масштабируйте соединения на основе объёма нагрузки и давления пропускной способности.", - "cacheCleared": "Кэш успешно очищен", - "clearCacheFailed": "Не удалось очистить кэш", - "clearLkgpCache": "Очистить кэш LKGP", - "lkgpToggleTitle": "Последний известный хороший провайдер (LKGP)", - "lkgpToggleDesc": "Когда включено, маршрутизатор запоминает, какой провайдер последним отдал успешный ответ, и сначала пытается использовать его в следующих запросах.", - "lkgp": "Режим LKGP", - "lkgpDesc": "Последний известный хороший провайдер (предсказуемая устойчивость)", - "lkgpCacheCleared": "Кэш LKGP успешно очищен", - "lkgpCacheClearFailed": "Не удалось очистить кэш LKGP", - "maintenance": "Обслуживание", - "purgeExpiredLogs": "Удалить просроченные журналы", - "purgeLogsFailed": "Не удалось удалить журналы", "cacheSettings": "Настройки кэша", "semanticCache": "Семантический кэш", "maxEntries": "Макс. записей", @@ -2820,6 +3239,8 @@ "autoDisableDescription": "Навсегда помечать соединения провайдера как отключённые, если они возвращают сигнал окончательной блокировки (например, HTTP 403 'verify your account'). Это убирает их из ротации комбо.", "autoDisableThreshold": "Порог блокировки", "autoDisableThresholdDesc": "Количество подряд идущих сигналов блокировки, необходимых перед постоянным отключением.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Включить мышление", "maxThinkingTokens": "Максимальное количество жетонов мышления", "enableProxy": "Включить прокси", @@ -2856,6 +3277,14 @@ "themeLight": "Свет", "themeDark": "Темный", "themeSystem": "Система", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Скрывать элементы боковой панели", "sidebarVisibilityDesc": "Скрывайте любые элементы навигации боковой панели, чтобы уменьшить визуальный шум.", "sidebarVisibilityHint": "Любой раздел боковой панели скрывается автоматически, когда...", @@ -2937,6 +3366,14 @@ "apiEndpointProtection": "Защита конечных точек API", "requireAuthModels": "Требовать ключ API для /models", "requireAuthModelsDesc": "Если включено, конечная точка /v1/models возвращает 404 для неаутентифицированных запросов. Предотвращает обнаружение модели неавторизованными пользователями.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Заблокированные провайдеры", "blockedProvidersDesc": "Скройте конкретных поставщиков из ответа /v1/models. Заблокированные поставщики не будут отображаться в списках моделей.", "providersBlocked": "Поставщик(и) {count} заблокирован в /models", @@ -2965,6 +3402,8 @@ "leastUsedDesc": "Выберите наименее использованную учетную запись", "costOpt": "Опция стоимости", "costOptDesc": "Предпочитаю самый дешевый доступный аккаунт", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Строгий случайный", "strictRandomDesc": "Перемешивание колоды — каждый аккаунт используется один раз перед повторным перемешиванием", "stickyLimit": "Липкий лимит", @@ -3056,6 +3495,8 @@ "comboStrategyAria": "Комбо-стратегия", "priority": "Приоритет", "weighted": "Взвешенный", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Макс. повторов", "retryDelayLabel": "Задержка повтора (мс)", "timeoutLabel": "Тайм-аут (мс)", @@ -3076,6 +3517,10 @@ "maxNestingDepth": "Максимальная глубина вложения", "concurrencyPerModel": "Параллелизм/модель", "queueTimeout": "Тайм-аут очереди (мс)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Профили поставщиков", "providerProfilesDesc": "Отдельные настройки устойчивости для поставщиков OAuth (на основе сеанса) и API-ключей (измеренного). Поставщики OAuth имеют более строгие пороговые значения из-за более низких ограничений скорости.", "oauthProviders": "Поставщики OAuth", @@ -3151,7 +3596,6 @@ "backupCreated": "Резервная копия создана: {file}", "restoreSuccess": "Восстановлено! {connections} соединений, {nodes} узлов, {combos} комбинаций, {apiKeys} ключей API.", "importSuccess": "База данных импортирована! {connections} соединений, {nodes} узлов, {combos} комбинаций, {apiKeys} ключей API.", - "justNow": "только что", "minutesAgo": "{count} мин назад", "hoursAgo": "{count}ч назад", "daysAgo": "{count}дн назад", @@ -3166,7 +3610,6 @@ "errorDuringImport": "Во время импорта произошла ошибка", "modelPricing": "Цены на модели", "modelPricingDesc": "Настройка ставок стоимости для каждой модели • Все ставки указаны в токенах $/1 млн.", - "providers": "Провайдеры", "registry": "Реестр", "priced": "Цена", "searchProvidersModels": "Поиск поставщиков или моделей...", @@ -3208,47 +3651,19 @@ "editPricing": "Изменить цену", "viewFullDetails": "Посмотреть полную информацию", "themeCoral": "Коралл", - "modelsDevTitle": "База моделей", - "modelsDevDesc": "Автосинхронизация цен, возможностей и спецификаций из models.dev", - "modelsDevEnabled": "Включить синхронизацию models.dev", - "modelsDevEnabledDesc": "Получать цены, возможности и спецификации моделей из открытой базы models.dev", - "modelsDevInterval": "Интервал синхронизации", - "syncNow": "Синхронизировать сейчас", - "syncing": "Синхронизация...", - "lastSync": "Последняя синхронизация", - "never": "Никогда", - "modelsDevStats": "Статистика синхронизации", - "modelsDevStatsDesc": "Текущее покрытие данных models.dev", - "modelsWithPricing": "Модели с ценами", - "capabilities": "Возможности", - "lastSyncCount": "Количество при последней синхронизации", - "lastSyncFull": "Последняя полная синхронизация", - "modelsDevInfo": "Как это работает", - "modelsDevInfoDesc": "models.dev - это открытая база спецификаций AI-моделей, поддерживаемая командой SST/OpenCode. Она предоставляет цены, возможности, ограничения контекста и модальности для более чем 4 000 моделей от более чем 100 провайдеров.", - "modelsDevInfoResolution": "Порядок выбора цены (сначала самый приоритетный):", - "modelsDevInfoOrder": "Переопределение пользователя → models.dev → LiteLLM → Жёстко заданное значение по умолчанию", - "memoryTitle": "Память", - "memoryDesc": "Постоянная кросс-сессионная память для диалогов", - "memoryEnabled": "Включить память", - "memoryEnabledDesc": "Когда включено, OmniRoute будет внедрять релевантный прошлый контекст.", - "maxTokens": "Макс. токенов", - "retentionDays": "Срок хранения", - "recent": "Недавнее", - "recentDesc": "Хронологическое окно", - "semantic": "Семантическое", - "semanticDesc": "Векторный поиск", - "hybrid": "Гибридное", - "hybridDesc": "Недавнее + семантическое", - "skillsTitle": "Навыки", - "skillsDesc": "Инструменты для моделей", - "skillsEnabled": "Включить навыки", - "skillsEnabledDesc": "Позволяет агентам вызывать функции.", - "skillsComingSoon": "Маркетплейс навыков скоро появится.", - "memorySkillsTitle": "Память и навыки", - "memorySkillsDesc": "Постоянный контекст и возможности", + "adaptiveVolumeRouting": "Адаптивная маршрутизация по объёму", + "adaptiveVolumeRoutingDesc": "Динамически масштабируйте соединения на основе объёма нагрузки и давления пропускной способности.", + "lkgpToggleTitle": "Последний известный хороший провайдер (LKGP)", + "lkgpToggleDesc": "Когда включено, маршрутизатор запоминает, какой провайдер последним отдал успешный ответ, и сначала пытается использовать его в следующих запросах.", + "clearLkgpCache": "Очистить кэш LKGP", + "lkgpCacheCleared": "Кэш LKGP успешно очищен", + "lkgpCacheClearFailed": "Не удалось очистить кэш LKGP", "days": "Дни", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", + "lkgp": "Режим LKGP", + "lkgpDesc": "Последний известный хороший провайдер (предсказуемая устойчивость)", + "maintenance": "Обслуживание", + "purgeExpiredLogs": "Удалить просроченные журналы", + "purgeLogsFailed": "Не удалось удалить журналы", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3270,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3319,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3336,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3376,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3391,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3442,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3489,6 +3929,28 @@ "errorShort": "ОШИБКА", "formatConverter": "Конвертер форматов", "formatConverterDescription": "Вставьте или введите тело запроса JSON. Переводчик автоматически определит исходный формат и преобразует его в целевой формат. Используйте это для отладки того, как OmniRoute преобразует запросы между форматами (OpenAI ↔ Claude ↔ Gemini ↔ API ответов).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Ввод", "output": "Выход", "auto": "Авто", @@ -3597,6 +4059,11 @@ "errorMessage": "Ошибка: {message}", "requestFailed": "Запрос не выполнен", "noTextExtracted": "(текст не извлечен)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Показывает события перевода, когда вызовы API проходят через OmniRoute. События поступают из буфера в памяти (сбрасывается при перезапуске). Использование", "liveMonitorDescriptionSuffix": "или внешние вызовы API для генерации событий." }, @@ -3672,14 +4139,25 @@ "passSuffix": "успеха", "casesCount": "{count, plural, one {# случай} few {# случая} many {# случаев} other {# случая}}", "runEval": "Запустить оценку", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Запуск {current}/{total}...", "passRate": "проходной балл", "summaryBreakdown": "{passed} пройден · {failed} не пройден · всего {total}", "passedIconLabel": "✅ Пройдено", "failedIconLabel": "❌ Не удалось", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Содержит: «{term}»", "detailsRegex": "Регулярное выражение: {pattern}", "detailsExpected": "Ожидается: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Пока нет результатов", "testCasesCount": "Тестовые примеры ({count})", "noTestCasesDefined": "Тестовые примеры не определены", @@ -3747,6 +4225,16 @@ "tierFree": "Бесплатно", "tierUnknown": "Неизвестно", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3789,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3802,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3966,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Ожидание авторизации Antigravity...", "waitingForQoderAuthorization": "Ожидание авторизации Qoder...", "exchangingCodeForTokens": "Обмен кода на токены...", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "ОмниРоут", @@ -4056,6 +4549,7 @@ "docs": { "title": "Документация", "quickStart": "Быстрый старт", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Особенности", "supportedProviders": "Поддерживаемые провайдеры", "supportedProvidersToc": "Провайдеры", @@ -4092,6 +4586,20 @@ "quickStartStep4Title": "4. Установите URL-адрес клиентской базы.", "quickStartStep4Prefix": "Направьте свой клиент IDE или API на", "quickStartStep4Suffix": "Используйте префикс провайдера, например", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Маршрутизация между несколькими провайдерами", "featureRoutingText": "Направляйте запросы более чем 30 поставщикам ИИ через единую конечную точку, совместимую с OpenAI. Поддерживает API чата, ответов, аудио и изображений.", "featureCombosTitle": "Комбинации и балансировка", @@ -4136,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Использование", "clientClaudeBullet1Middle": "(Клод) или", "clientClaudeBullet1Suffix": "(Антигравитация) приставка.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Протоколы: MCP и A2A", "protocolsDescription": "OmniRoute предоставляет два операционных протокола помимо OpenAI-совместимых API: MCP для выполнения инструментов и A2A для рабочих процессов агент-к-агенту.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4179,8 +4699,61 @@ "troubleshootingTestConnection": "Используйте «Панель мониторинга» > «Поставщики» > «Проверить соединение» перед тестированием из IDE или внешних клиентов.", "troubleshootingCircuitBreaker": "Если поставщик услуг показывает, что автоматический выключатель разомкнут, дождитесь охлаждения или посетите страницу «Здоровье» для получения подробной информации.", "troubleshootingOAuth": "Для поставщиков OAuth выполните повторную аутентификацию, если срок действия токенов истечет. Проверьте индикатор состояния карты провайдера.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Политика конфиденциальности", @@ -4284,62 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" }, - "memory": { - "title": "Память", - "description": "Постоянная кросс-сессионная память для диалогов", - "memories": "Память", - "totalEntries": "Всего записей", - "tokensUsed": "Использовано токенов", - "hitRate": "Коэффициент попадания", - "loading": "Загрузка...", - "noMemories": "Записей памяти не найдено", - "search": "Поиск", - "allTypes": "Все типы", - "export": "Экспорт", - "import": "Импорт", - "addMemory": "Добавить запись памяти", - "type": "Тип", - "key": "Ключ", - "content": "Содержимое", - "created": "Создано", - "actions": "Действия", - "factual": "Фактическая", - "episodic": "Эпизодическая", - "procedural": "Процедурная", - "semantic": "Семантическая", - "delete": "Delete", - "a": "A" - }, - "skills": { - "title": "Навыки", - "description": "Инструменты для моделей", - "skillsTab": "Навыки", - "executionsTab": "Выполнения", - "sandboxTab": "Песочница", - "loading": "Загрузка...", - "noSkills": "Навыки не найдены", - "noExecutions": "Выполнений не найдено", - "enabled": "Включено", - "disabled": "Отключено", - "version": "Версия", - "tableDescription": "Описание", - "skill": "Навык", - "status": "Статус", - "duration": "Длительность", - "time": "Время", - "sandboxConfig": "Конфигурация песочницы", - "cpuLimit": "Лимит CPU", - "cpuLimitDesc": "Максимальное число ядер или доля CPU, доступная песочнице.", - "memoryLimit": "Лимит памяти", - "memoryLimitDesc": "Максимальный объём памяти, доступный песочнице.", - "timeout": "Тайм-аут", - "timeoutDesc": "Максимальная длительность выполнения до принудительного завершения.", - "networkAccess": "Доступ к сети", - "networkAccessDesc": "Разрешить навыку сетевые запросы.", - "mode": "Mode", - "q": "Q" + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Простой чат", @@ -4416,8 +4990,14 @@ "unavailable": "Кэш недоступен", "unavailableDesc": "Не удалось получить статистику кэша. Убедитесь, что сервер запущен.", "promptCache": "Кэш промптов (на стороне провайдера)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Запросы из кэша", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Коэффициент попадания в кэш", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Кэшированные токены", "cacheCreationTokens": "Токены создания кэша", "cacheMetrics": "Метрики кэша промптов", @@ -4427,6 +5007,12 @@ "cacheReuseRatio": "Коэффициент повторного использования кэша", "cacheReuseRatioDesc": "Кэшированные токены / Все входные токены", "estCostSaved": "Примерная экономия", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "запр.", "inputShort": "Вх.", "cachedShort": "В кэше", @@ -4434,143 +5020,283 @@ "resetting": "Сброс...", "resetMetrics": "Сбросить метрики", "byProvider": "Разбивка по провайдерам", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Провайдер", "requests": "Запросы", "inputTokens": "Входные токены", "cachedTokensCol": "Кэш.", "cacheCreation": "Создание", "trend24h": "Тренд кэша (24ч)", + "peakCached": "Пик кэша", "cached": "В кэше", "overview": "Обзор", "entries": "Записи", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Поиск записей...", "search": "Поиск", "loading": "Загрузка...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "Записи кэша не найдены", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Сигнатура", "model": "Модель", "created": "Создано", "expires": "Истекает", "actions": "Действия", "deduplicatedRequests": "Дедуплицированные запросы", - "peakCached": "Пик кэша", "savedCalls": "Сэкономленные API-запросы", "totalProcessed": "Всего запросов обработано", - "trendHour": "Hour", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "busiestHour": "Busiest Hour", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "activityVolume": "Activity", - "semanticCache": "Semantic Cache", - "peakCacheRate": "Peak Cache Rate", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "hoursTracked": "hours tracked", - "cacheRate": "Cache Rate", - "lastUpdated": "Last updated", - "cachedRequests24h": "Cached Requests (24h)", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cacheRateDesc": "of total requests", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" + }, + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" + }, + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4629,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4675,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/sk.json b/src/i18n/messages/sk.json index 5a0666bf2f..646552c467 100644 --- a/src/i18n/messages/sk.json +++ b/src/i18n/messages/sk.json @@ -23,6 +23,7 @@ "active": "Aktívne", "inactive": "Neaktívne", "noData": "Nie sú k dispozícii žiadne údaje", + "nothingHere": "Nothing here yet", "configure": "Konfigurovať", "manage": "Spravovať", "name": "Meno", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Cenu sa nepodarilo resetovať", "apikey": "API kľúč", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Ihrisko", "searchTools": "Search Tools", "agents": "Agenti", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Docs", "issues": "Problémy", "endpoints": "Koncové body", "apiManager": "API Manager", "logs": "Denníky", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Vypnutie", "restart": "Reštartujte", @@ -705,8 +710,6 @@ "cliToolsShort": "Nástroje", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Využitie", "utilizationDescription": "Trendy využitia kvót poskytovateľa a sledovanie limitov rýchlosti", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Zdravie Combo", "comboHealthDescription": "Kvóta na úrovni combo, distribúcia používania a metríky výkonu", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Naposledy: {date}", "editPermissions": "Upraviť povolenia", "deleteKey": "Tlačidlo Delete", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} modelov", "permissionsTitle": "Povolenia: {name}", @@ -1188,11 +1296,13 @@ "continue": "Použite pri spustení Continue in IDE a potrebujete prenosnú konfiguráciu poskytovateľa založenú na JSON.", "opencode": "Použite, ak uprednostňujete spúšťanie natívneho agenta a skriptovanú automatizáciu cez OpenCode.", "kiro": "Použite pri integrácii Kiro a centrálnom riadení smerovania modelu z OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Použite, keď musí byť premávka Antigravity/Kiro zachytená cez MITM a nasmerovaná na OmniRoute.", "copilot": "Použite, keď chcete UX v štýle chatu Copilot pri presadzovaní kľúčov OmniRoute a pravidiel smerovania.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE s MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekvenčný núdzový postup: najprv vyskúša model 1, potom 2 atď.", "weightedDesc": "Rozdeľuje návštevnosť podľa hmotnostného percenta so záložnou možnosťou", "roundRobinDesc": "Kruhová distribúcia: každá požiadavka prechádza na ďalší model v rotácii", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Jednotný náhodný výber, potom návrat k zostávajúcim modelom", "leastUsedDesc": "Vyberie model s najmenším počtom požiadaviek, čím vyrovná zaťaženie v priebehu času", "costOptimizedDesc": "Najprv sa presmeruje na najlacnejší model na základe ceny", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modelky", @@ -1404,6 +1521,13 @@ "retryDelay": "Oneskorenie opätovného pokusu (ms)", "concurrencyPerModel": "Súbežnosť / Model", "queueTimeout": "Časový limit fronty (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Ak chcete použiť globálne predvolené hodnoty, nechajte prázdne. Tieto prepíšu nastavenia jednotlivých poskytovateľov.", "moveUp": "Posunúť sa hore", "moveDown": "Presuňte sa nadol", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Ste pripravení uložiť?", "readinessDescription": "Pred vytvorením alebo aktualizáciou tejto kombinácie skontrolujte kontrolný zoznam.", "readinessCheckName": "Názov kombinácie je platný", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "weightLatencyInv": "Latency", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "review": { - "description": "Final validation before saving", - "label": "Review" + "basics": { + "label": "Basics", + "description": "Name and starting template" + }, + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" }, - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" - }, - "basics": { - "label": "Basics", - "description": "Name and starting template" + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "activeModePack": "Active Mode Pack", - "reviewAgentFlags": "Agent Flags", - "advancedWeightsTitle": "Advanced: Scoring Weights", + "builderStageVisited": "Stage completed", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", "builderSelectModel": "Select model", "builderProviderFirst": "Pick provider first", - "weightStability": "Stability", - "candidatePoolLabel": "Candidate Pool", - "strategyRules": "Rules (6-Factor Scoring)", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "weightQuota": "Quota", - "builderFlowTitle": "Combo Builder Flow", - "contextRelaySummaryModel": "Summary Model", - "reviewName": "Name", - "providerScores": "Provider Scores", - "noExcludedProviders": "No providers are currently excluded.", - "builderModel": "Model", - "emailVisibilityStateOff": "Off", - "reviewIntelligentTitle": "Intelligent Routing Config", - "cooldownMinutes": "Cooldown: {minutes}m", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "builderAddStep": "Add step", - "reviewSteps": "Steps", - "reviewNoSteps": "No steps configured", - "incidentMode": "Incident Mode", - "reviewProviders": "Providers", - "budgetCapPlaceholder": "No limit", - "filterAll": "All", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewAdvanced": "Advanced Settings", - "builderStagePending": "Pending", - "filterDeterministic": "Deterministic", - "weightCostInv": "Cost", - "filterIntelligent": "Intelligent", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderProvider": "Provider", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "contextRelay": "Context Relay", - "candidatePoolEmpty": "No active providers available yet.", - "statusOverview": "Status Overview", - "weightHealth": "Health", - "filterEmptyTitle": "No combos match this strategy filter.", - "weightTaskFit": "Task Fit", - "builderTitle": "Build a Combo", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderStageVisited": "Stage completed", - "builderBrowseCatalog": "Browse catalog", - "builderStageLocked": "Locked — complete previous stage first", - "reorderHandle": "Drag to reorder", - "builderLegacyEntry": "Legacy entry", - "modePackLabel": "Mode Pack", - "builderComboRefStep": "Add combo reference", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewComboRefs": "Combo References", - "failedReorder": "Failed to reorder models", - "emailVisibilityStateOn": "On", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "builderComboRef": "Combo Ref", - "modePackUpdated": "Mode pack updated to {pack}.", - "candidatePoolAllProviders": "All providers", - "routerStrategyLabel": "Router Strategy", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", "builderAccount": "Account", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "explorationRateLabel": "Exploration Rate", - "reviewStrategy": "Strategy", - "budgetCapLabel": "Budget Cap (USD / request)", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "builderLoadingProviders": "Loading providers...", - "builderAddComboRef": "Add combo reference", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "weightTierPriority": "Tier", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "excludedProviders": "Excluded Providers", - "reviewAccounts": "Accounts", - "builderSelectProvider": "Select provider", - "normalOperation": "Normal Operation", "builderPreview": "Preview", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "reviewSequence": "Model Sequence", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", "builderPinnedAccount": "Pinned Account", - "builderStageCurrent": "Current stage", - "contextRelayHandoffThreshold": "Handoff Threshold" + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "náklady", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Rozpočet", "totalCost": "Celkové náklady", "breakdown": "Rozdelenie nákladov", "noData": "Žiadne údaje o nákladoch", "byModel": "Podľa modelu", "byProvider": "Poskytovateľom", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Koncový bod API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Prepis zvukových súborov na text (Whisper)", "textToSpeech": "Text na reč", "textToSpeechDesc": "Prevod textu na prirodzene znejúcu reč", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderovania", "moderationsDesc": "Moderovanie obsahu a klasifikácia bezpečnosti", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Zdravie systému", "description": "Monitorovanie vašej inštancie OmniRoute v reálnom čase", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limity a kvóty", "rateLimit": "Limit sadzby", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Vitajte", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Chyba ({code})", "errorCountNoCode": "{count} Chyba", "noConnections": "Žiadne spojenia", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Zakázané", "enableProvider": "Povoliť poskytovateľa", "disableProvider": "Zakázať poskytovateľa", @@ -2296,7 +2701,6 @@ "errorOccurred": "Vyskytla sa chyba. Skúste to znova.", "modelStatus": "Stav modelu", "showConfiguredOnly": "Configured only", - "searchProviders": "Hľadať poskytovateľov...", "allModelsOperational": "Všetky modely funkčné", "modelsWithIssues": "{count} modelov s problémami", "allModelsNormal": "Všetky modely reagujú normálne.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Podrobnosti kompatibilné s OpenAI", "messagesApi": "Správy API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Dokončenia četu", "importingModels": "Importuje sa...", "importFromModels": "Importovať z /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Všetky modely sú už importované", "noNewModelsToImport": "Žiadne nové modely na import — všetky modely sú už v registri alebo v zozname vlastných modelov", "skippingExistingModels": "Preskakujem {count} existujúcich modelov", @@ -2373,6 +2782,7 @@ "importFailed": "Import zlyhal", "noNewModelsAdded": "Neboli pridané žiadne nové modely.", "adding": "Pridáva sa...", + "close": "Close", "importingModelsTitle": "Importovanie modelov", "copyModel": "Kopírovať model", "filterModels": "Filtrovať modely…", @@ -2413,6 +2823,11 @@ "configured": "nakonfigurovaný", "providerProxyConfigureHint": "Nakonfigurujte proxy pre všetky pripojenia tohto poskytovateľa", "providerProxy": "Proxy poskytovateľa", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Zatiaľ žiadne spojenia", "addFirstConnectionHint": "Začnite pridaním prvého pripojenia", "addConnection": "Pridať pripojenie", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID modelu", "customModelPlaceholder": "napr. gpt-4.5-turbo", "loading": "Načítava sa...", @@ -2513,6 +2931,10 @@ "email": "Email", "healthCheckMinutes": "Kontrola stavu (min)", "healthCheckHint": "Interval proaktívneho obnovenia tokenu. 0 = vypnuté.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Nepodarilo sa otestovať pripojenie", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioTranscriptions": "Audio Transcriptions", - "imagesGenerations": "Images Generations", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvFailed": "Failed to repair .env", - "deselectAllModels": "Deselect all", "showEmails": "Show all emails", - "repairEnv": "Repair env", - "modelsActiveCount": "{active}/{total} active", "hideEmails": "Hide all emails", - "repairEnvSuccess": "OAuth defaults restored", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnvWorking": "Repairing...", - "selectAllModels": "Select all", - "embeddings": "Embeddings", - "audioSpeech": "Audio Speech", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Hľadať poskytovateľov...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Nastavenia", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Stanovenie cien", "storage": "Skladovanie", "policies": "zásady", @@ -2749,6 +3164,46 @@ "enablePassword": "Povoliť heslo", "darkMode": "Tmavý režim", "lightMode": "Svetelný režim", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "práve teraz", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Poskytovatelia", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Téma systému", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Maximálna veľkosť vyrovnávacej pamäte", "clearCache": "Vymazať vyrovnávaciu pamäť", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Zásahy do vyrovnávacej pamäte", "cacheMisses": "Cache Misses", "hitRate": "Miera prístupu", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Povoliť myslenie", "maxThinkingTokens": "Maximálne žetóny myslenia", "enableProxy": "Povoliť server proxy", @@ -2818,6 +3277,14 @@ "themeLight": "Svetlo", "themeDark": "Tmavý", "themeSystem": "Systém", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Vyžadovať kľúč API pre /models", "requireAuthModelsDesc": "Keď je zapnuté, koncový bod /v1/models vráti 404 pre neoverené požiadavky. Zabraňuje objaveniu modelu neoprávnenými používateľmi.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blokovaní poskytovatelia", "blockedProvidersDesc": "Skryť konkrétnych poskytovateľov v odpovedi /v1/models. Blokovaní poskytovatelia sa nezobrazia v zoznamoch modelov.", "providersBlocked": "{count} poskytovatelia blokovaní z /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Vyberte najmenej nedávno používaný účet", "costOpt": "Opt", "costOptDesc": "Uprednostnite najlacnejší dostupný účet", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Kombinovaná stratégia", "priority": "Priorita", "weighted": "Vážené", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Maximálny počet opakovaní", "retryDelayLabel": "Oneskorenie opätovného pokusu (ms)", "timeoutLabel": "Časový limit (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maximálna hĺbka vnorenia", "concurrencyPerModel": "Súbežnosť / Model", "queueTimeout": "Časový limit fronty (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Profily poskytovateľov", "providerProfilesDesc": "Samostatné nastavenia odolnosti pre poskytovateľov OAuth (na základe relácie) a kľúča API (merané). Poskytovatelia OAuth majú prísnejšie limity kvôli nižším limitom sadzieb.", "oauthProviders": "Poskytovatelia OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "Záloha vytvorená: {file}", "restoreSuccess": "Obnovené! {connections} pripojenia, {nodes} uzly, {combos} kombá, {apiKeys} kľúče API.", "importSuccess": "Databáza bola importovaná! {connections} pripojenia, {nodes} uzly, {combos} kombá, {apiKeys} kľúče API.", - "justNow": "práve teraz", "minutesAgo": "Pred {count}m", "hoursAgo": "pred {count}h", "daysAgo": "Pred {count}d", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Počas importu sa vyskytla chyba", "modelPricing": "Modelové ceny", "modelPricingDesc": "Konfigurácia nákladových sadzieb na model • Všetky sadzby v tokenoch $/1 milión", - "providers": "Poskytovatelia", "registry": "Registratúra", "priced": "Cena", "searchProvidersModels": "Hľadať poskytovateľov alebo modely...", @@ -3170,47 +3651,6 @@ "editPricing": "Upraviť ceny", "viewFullDetails": "Zobraziť úplné podrobnosti", "themeCoral": "Korál", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Prevodník formátov", "formatConverterDescription": "Prilepte alebo zadajte telo požiadavky JSON. Prekladateľ automaticky rozpozná zdrojový formát a prevedie ho do cieľového formátu. Použite toto na ladenie spôsobu, akým OmniRoute prekladá požiadavky medzi formátmi (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Vstup", "output": "Výstup", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Chyba: {message}", "requestFailed": "Žiadosť zlyhala", "noTextExtracted": "(Žiadny extrahovaný text)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Zobrazuje udalosti prekladu, keď volania rozhrania API prechádzajú cez OmniRoute. Udalosti pochádzajú z vyrovnávacej pamäte v pamäti (resetuje sa pri reštarte). Použite", "liveMonitorDescriptionSuffix": "alebo externé volania API na generovanie udalostí." }, @@ -3648,14 +4139,25 @@ "passSuffix": "prejsť", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Spustite Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Spustený {current}/{total}...", "passRate": "úspešnosť", "summaryBreakdown": "{passed} úspešné · {failed} neúspešné · celkom {total}", "passedIconLabel": "✅ Prešlo", "failedIconLabel": "❌ Nepodarilo sa", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Obsahuje: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Očakáva sa: „{expected}“", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Zatiaľ žiadne výsledky", "testCasesCount": "Testovacie prípady ({count})", "noTestCasesDefined": "Nie sú definované žiadne testovacie prípady", @@ -3723,6 +4225,16 @@ "tierFree": "Zadarmo", "tierUnknown": "Neznámy", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,8 +4459,8 @@ "waitingForAntigravityAuthorization": "Čaká sa na antigravitačné povolenie...", "waitingForQoderAuthorization": "Čaká sa na autorizáciu Qoder...", "exchangingCodeForTokens": "Výmena kódu za tokeny...", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleTitle": "Incompatible Node.js Version", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentácia", "quickStart": "Rýchly štart", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Vlastnosti", "supportedProviders": "Podporovaní poskytovatelia", "supportedProvidersToc": "Poskytovatelia", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Nastavte adresu URL klientskej základne", "quickStartStep4Prefix": "Nasmerujte svojho klienta IDE alebo API na", "quickStartStep4Suffix": "Použite napríklad predponu poskytovateľa", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Smerovanie viacerých poskytovateľov", "featureRoutingText": "Smerujte požiadavky na 30+ poskytovateľov AI cez jeden koncový bod kompatibilný s OpenAI. Podporuje chat, odpovede, audio a obrazové API.", "featureCombosTitle": "Kombinácie a vyváženie", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Použite", "clientClaudeBullet1Middle": "(Claude) alebo", "clientClaudeBullet1Suffix": "(antigravitačná) predpona.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Pred testovaním z IDE alebo externých klientov použite Dashboard > Providers > Test Connection.", "troubleshootingCircuitBreaker": "Ak poskytovateľ zobrazí istič otvorený, počkajte na vychladnutie alebo skontrolujte stránku Zdravie, kde nájdete podrobnosti.", "troubleshootingOAuth": "V prípade poskytovateľov OAuth znova overte, ak platnosť tokenov vyprší. Skontrolujte indikátor stavu karty poskytovateľa.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Zásady ochrany osobných údajov", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Jednoduchý chat", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "activityVolume": "Activity", - "cacheRateDesc": "of total requests", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "entriesLoadError": "Failed to load semantic cache entries.", - "peakCacheRate": "Peak Cache Rate", - "trendHour": "Hour", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "busiestHour": "Busiest Hour", - "cachedRequests24h": "Cached Requests (24h)", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "hoursTracked": "hours tracked", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "lastUpdated": "Last updated", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "cacheRate": "Cache Rate", - "semanticCache": "Semantic Cache", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/sv.json b/src/i18n/messages/sv.json index 4819a48984..453568ad97 100644 --- a/src/i18n/messages/sv.json +++ b/src/i18n/messages/sv.json @@ -23,6 +23,7 @@ "active": "Aktiv", "inactive": "Inaktiv", "noData": "Inga data tillgängliga", + "nothingHere": "Nothing here yet", "configure": "Konfigurera", "manage": "Hantera", "name": "Namn", @@ -138,7 +139,6 @@ "apikey": "API-nyckel", "http": "HTTP", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Lekplats", "searchTools": "Search Tools", "agents": "Agenter", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokument", "issues": "frågor", "endpoints": "Ändpunkter", "apiManager": "API-hanterare", "logs": "Loggar", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Revisionslogg", "shutdown": "Avstängning", "restart": "Starta om", @@ -705,8 +710,6 @@ "cliToolsShort": "Verktyg", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Evals", "utilization": "Användning", "utilizationDescription": "Leverantörskvotanvändningstrender och hastighetsgränsuppföljning", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kombohälsa", "comboHealthDescription": "Kombonivåkvot, användningsfördelning och prestandamått", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Senaste: {date}", "editPermissions": "Redigera behörigheter", "deleteKey": "Ta bort nyckel", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} modell", "models": "{count} modeller", "permissionsTitle": "Behörigheter: {name}", @@ -1188,11 +1296,13 @@ "continue": "Använd när du kör Continue i IDE och du behöver portabel JSON-baserad leverantörskonfiguration.", "opencode": "Använd när du föredrar terminalbaserade agentkörningar och skriptautomation via OpenCode.", "kiro": "Använd när du integrerar Kiro och styr modelldirigering centralt från OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Använd när Antigravity/Kiro-trafik måste avlyssnas genom MITM och dirigeras till OmniRoute.", "copilot": "Använd när du vill ha Copilot chattstil UX samtidigt som du upprätthåller OmniRoute-nycklar och routingregler.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE med MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sekventiell reserv: provar modell 1 först, sedan 2 osv.", "weightedDesc": "Fördelar trafik efter viktprocent med reserv", "roundRobinDesc": "Cirkulär distribution: varje begäran går till nästa modell i rotation", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Enhetligt slumpmässigt urval, sedan fallback till återstående modeller", "leastUsedDesc": "Väljer modellen med minst förfrågningar, balanserar belastningen över tiden", "costOptimizedDesc": "Rutter till den billigaste modellen först baserat på prissättning", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Modeller", @@ -1404,6 +1521,13 @@ "retryDelay": "Försök igen fördröjning (ms)", "concurrencyPerModel": "Samtidighet / Modell", "queueTimeout": "Timeout för kö (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Lämna tomt om du vill använda globala standardinställningar. Dessa åsidosätter inställningarna per leverantör.", "moveUp": "Flytta uppåt", "moveDown": "Flytta ner", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin är mest användbar med minst 2 modeller.", "warningCostOptimizedPartialPricing": "Endast {priced} av {total} modeller har prissättning. Rutning kan vara delvis kostnadsmedveten.", "warningCostOptimizedNoPricing": "Inga prisuppgifter hittades för denna kombination. Kostnadsoptimerad kan väga oväntat.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Redo att spara?", "readinessDescription": "Granska checklistan innan du skapar eller uppdaterar den här kombinationen.", "readinessCheckName": "Kombinationsnamnet är giltigt", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "builderModel": "Model", - "builderComboRefStep": "Add combo reference", - "filterIntelligent": "Intelligent", - "builderSelectModel": "Select model", - "reviewStrategy": "Strategy", - "weightCostInv": "Cost", - "weightQuota": "Quota", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", "builderFlowTitle": "Combo Builder Flow", - "weightTaskFit": "Task Fit", - "reviewNoSteps": "No steps configured", "builderStage": { - "review": { - "description": "Final validation before saving", - "label": "Review" - }, - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" - }, "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "strategyRules": "Rules (6-Factor Scoring)", - "builderSelectProvider": "Select provider", - "excludedProviders": "Excluded Providers", - "builderTitle": "Build a Combo", - "builderAccount": "Account", - "reviewIntelligentTitle": "Intelligent Routing Config", - "builderBrowseCatalog": "Browse catalog", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderStageLocked": "Locked — complete previous stage first", - "reviewComboRefs": "Combo References", - "weightTierPriority": "Tier", - "routerStrategyLabel": "Router Strategy", - "candidatePoolEmpty": "No active providers available yet.", - "builderAddStep": "Add step", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "filterEmptyTitle": "No combos match this strategy filter.", - "contextRelay": "Context Relay", - "reviewSteps": "Steps", - "providerScores": "Provider Scores", - "contextRelayMaxMessages": "Max Messages For Summary", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "weightLatencyInv": "Latency", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "budgetCapLabel": "Budget Cap (USD / request)", - "normalOperation": "Normal Operation", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "reviewName": "Name", - "contextRelaySummaryModel": "Summary Model", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "cooldownMinutes": "Cooldown: {minutes}m", - "statusOverview": "Status Overview", - "emailVisibilityStateOn": "On", - "modePackLabel": "Mode Pack", - "failedReorder": "Failed to reorder models", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "incidentMode": "Incident Mode", - "builderStagePending": "Pending", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderStageCurrent": "Current stage", - "noExcludedProviders": "No providers are currently excluded.", - "reorderHandle": "Drag to reorder", - "activeModePack": "Active Mode Pack", - "builderPinnedAccount": "Pinned Account", - "modePackUpdated": "Mode pack updated to {pack}.", - "builderPreview": "Preview", - "weightStability": "Stability", - "candidatePoolLabel": "Candidate Pool", "builderStageVisited": "Stage completed", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "reviewSequence": "Model Sequence", - "weightHealth": "Health", - "reviewProviders": "Providers", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "filterAll": "All", - "builderProviderFirst": "Pick provider first", - "candidatePoolAllProviders": "All providers", - "emailVisibilityStateOff": "Off", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "explorationRateLabel": "Exploration Rate", - "builderComboRef": "Combo Ref", "builderLoadingProviders": "Loading providers...", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewAgentFlags": "Agent Flags", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "budgetCapPlaceholder": "No limit", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderLegacyEntry": "Legacy entry", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "reviewAdvanced": "Advanced Settings", - "reviewAccounts": "Accounts", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", "builderAddComboRef": "Add combo reference", - "filterDeterministic": "Deterministic" + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Kostnader", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Budget", "totalCost": "Total kostnad", "breakdown": "Kostnadsfördelning", "noData": "Inga kostnadsdata", "byModel": "Efter modell", "byProvider": "Av leverantör", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API-slutpunkt", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Transkribera ljudfiler till text (Viska)", "textToSpeech": "Text till tal", "textToSpeechDesc": "Konvertera text till naturligt klingande tal", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderationer", "moderationsDesc": "Innehållsmoderering och säkerhetsklassificering", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Systemhälsa", "description": "Realtidsövervakning av din OmniRoute-instans", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Gränser och kvoter", "rateLimit": "Prisgräns", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Välkommen", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Fel ({code})", "errorCountNoCode": "{count} Fel", "noConnections": "Inga anslutningar", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Inaktiverad", "enableProvider": "Aktivera leverantör", "disableProvider": "Inaktivera leverantör", @@ -2296,7 +2701,6 @@ "errorOccurred": "Ett fel uppstod. Försök igen.", "modelStatus": "Modellstatus", "showConfiguredOnly": "Configured only", - "searchProviders": "Sök efter leverantörer...", "allModelsOperational": "Alla modeller i drift", "modelsWithIssues": "{count} modell(er) med problem", "allModelsNormal": "Alla modeller svarar normalt.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI-kompatibla detaljer", "messagesApi": "Messages API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Chattavslut", "importingModels": "Importerar...", "importFromModels": "Importera från /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Alla modeller är redan importerade", "noNewModelsToImport": "Inga nya modeller att importera — alla modeller finns redan i registret eller listan över anpassade modeller", "skippingExistingModels": "Hoppar över {count} befintliga modeller", @@ -2373,6 +2782,7 @@ "importFailed": "Importen misslyckades", "noNewModelsAdded": "Inga nya modeller tillkom.", "adding": "Lägger till...", + "close": "Close", "importingModelsTitle": "Importera modeller", "copyModel": "Kopiera modell", "filterModels": "Filtrera modeller…", @@ -2413,6 +2823,11 @@ "configured": "konfigurerad", "providerProxyConfigureHint": "Konfigurera proxy för alla anslutningar från denna leverantör", "providerProxy": "Leverantörs proxy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Inga anslutningar än", "addFirstConnectionHint": "Lägg till din första anslutning för att komma igång", "addConnection": "Lägg till anslutning", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Modell ID", "customModelPlaceholder": "t.ex. gpt-4.5-turbo", "loading": "Laddar...", @@ -2513,6 +2931,10 @@ "email": "E-post", "healthCheckMinutes": "Hälsokontroll (min)", "healthCheckHint": "Proaktivt uppdateringsintervall för token. 0 = inaktiverad.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Det gick inte att testa anslutningen", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "embeddings": "Embeddings", - "modelsActiveCount": "{active}/{total} active", - "imagesGenerations": "Images Generations", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "noModelsMatch": "No models match \"{filter}\"", - "selectAllModels": "Select all", - "repairEnvWorking": "Repairing...", - "audioTranscriptions": "Audio Transcriptions", - "hideEmails": "Hide all emails", - "audioSpeech": "Audio Speech", - "repairEnvFailed": "Failed to repair .env", - "repairEnv": "Repair env", - "repairEnvSuccess": "OAuth defaults restored", "showEmails": "Show all emails", - "deselectAllModels": "Deselect all", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Sök efter leverantörer...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Inställningar", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Prissättning", "storage": "Förvaring", "policies": "Policyer", @@ -2749,6 +3164,46 @@ "enablePassword": "Aktivera lösenord", "darkMode": "Mörkt läge", "lightMode": "Ljusläge", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "just nu", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Leverantörer", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Systemtema", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Cache TTL", "maxCacheSize": "Max cachestorlek", "clearCache": "Rensa cache", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Cacheträffar", "cacheMisses": "Cache missar", "hitRate": "Träfffrekvens", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Aktivera tänkande", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Aktivera proxy", @@ -2818,6 +3277,14 @@ "themeLight": "Ljus", "themeDark": "Mörkt", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API-ändpunktsskydd", "requireAuthModels": "Kräv API-nyckel för /modeller", "requireAuthModelsDesc": "När PÅ, returnerar /v1/models-slutpunkten 404 för oautentiserade förfrågningar. Förhindrar modellupptäckt av obehöriga användare.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blockerade leverantörer", "blockedProvidersDesc": "Dölj specifika leverantörer från /v1/models-svaret. Blockerade leverantörer visas inte i modelllistorna.", "providersBlocked": "{count} leverantör(er) blockerade från /modeller", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Välj minst senast använda konto", "costOpt": "Kostnad Opt", "costOptDesc": "Föredrar billigaste tillgängliga konto", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Kombinationsstrategi", "priority": "Prioritet", "weighted": "Viktad", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Max försöker igen", "retryDelayLabel": "Försök igen fördröjning (ms)", "timeoutLabel": "Timeout (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Max häckningsdjup", "concurrencyPerModel": "Samtidighet / Modell", "queueTimeout": "Timeout för kö (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Leverantörsprofiler", "providerProfilesDesc": "Separata inställningar för motståndskraft för OAuth (sessionsbaserad) och API Key (mätad) leverantörer. OAuth-leverantörer har strängare trösklar på grund av lägre prisgränser.", "oauthProviders": "OAuth-leverantörer", @@ -3113,7 +3596,6 @@ "backupCreated": "Säkerhetskopiering skapad: {file}", "restoreSuccess": "Återställd! {connections} anslutningar, {nodes} noder, {combos} kombinationer, {apiKeys} API-nycklar.", "importSuccess": "Databas importerad! {connections} anslutningar, {nodes} noder, {combos} kombinationer, {apiKeys} API-nycklar.", - "justNow": "just nu", "minutesAgo": "{count}m sedan", "hoursAgo": "{count}h sedan", "daysAgo": "{count}d sedan", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Ett fel uppstod under importen", "modelPricing": "Modellprissättning", "modelPricingDesc": "Konfigurera kostnadssatser per modell • Alla priser i $/1M tokens", - "providers": "Leverantörer", "registry": "Registret", "priced": "Prissatt", "searchProvidersModels": "Sök efter leverantörer eller modeller...", @@ -3170,47 +3651,6 @@ "editPricing": "Redigera prissättning", "viewFullDetails": "Visa fullständiga detaljer", "themeCoral": "Korall", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Formatomvandlare", "formatConverterDescription": "Klistra in eller skriv en JSON-begäran. Översättaren kommer att automatiskt upptäcka källformatet och konvertera det till målformatet. Använd detta för att felsöka hur OmniRoute översätter förfrågningar mellan format (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Ingång", "output": "Utgång", "auto": "Auto", @@ -3573,6 +4059,11 @@ "errorMessage": "Fel: {message}", "requestFailed": "Begäran misslyckades", "noTextExtracted": "(Ingen text extraherad)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Visar översättningshändelser när API-anrop flyter genom OmniRoute. Händelser kommer från minnesbufferten (återställs vid omstart). Använd", "liveMonitorDescriptionSuffix": ", eller externa API-anrop för att generera händelser." }, @@ -3648,14 +4139,25 @@ "passSuffix": "passera", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Kör Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Kör {current}/{total}...", "passRate": "genomslagsfrekvens", "summaryBreakdown": "{passed} godkänd · {failed} misslyckades · {total} totalt", "passedIconLabel": "✅ Godkänd", "failedIconLabel": "❌ Misslyckades", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Innehåller: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Förväntat: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Inga resultat ännu", "testCasesCount": "Testfall ({count})", "noTestCasesDefined": "Inga testfall definierade", @@ -3723,6 +4225,16 @@ "tierFree": "Gratis", "tierUnknown": "Okänd", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Väntar på antigravitationstillstånd...", "waitingForQoderAuthorization": "Väntar på Qoder-auktorisering...", "exchangingCodeForTokens": "Byter ut kod för tokens...", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleTitle": "Incompatible Node.js Version", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release" + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokumentation", "quickStart": "Snabbstart", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Funktioner", "supportedProviders": "Leverantörer som stöds", "supportedProvidersToc": "Leverantörer", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Ställ in klientbasens URL", "quickStartStep4Prefix": "Peka din IDE- eller API-klient till", "quickStartStep4Suffix": "Använd till exempel leverantörsprefix", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Routing för flera leverantörer", "featureRoutingText": "Dirigera förfrågningar till 30+ AI-leverantörer via en enda OpenAI-kompatibel slutpunkt. Stöder chatt, svar, ljud och bild-API:er.", "featureCombosTitle": "Kombinationer och balansering", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Använd", "clientClaudeBullet1Middle": "(Claude) eller", "clientClaudeBullet1Suffix": "(Antigravitation) prefix.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Använd Dashboard > Leverantörer > Testa anslutning innan du testar från IDE:er eller externa klienter.", "troubleshootingCircuitBreaker": "Om en leverantör visar att strömbrytaren är öppen, vänta på nedkylning eller kolla Health-sidan för detaljer.", "troubleshootingOAuth": "För OAuth-leverantörer, autentisera på nytt om tokens löper ut. Kontrollera leverantörskortets statusindikator.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Sekretesspolicy", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Enkel chatt", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "semanticCache": "Semantic Cache", - "cacheRateDesc": "of total requests", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "lastUpdated": "Last updated", - "trendHour": "Hour", - "hoursTracked": "hours tracked", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "busiestHour": "Busiest Hour", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "activityVolume": "Activity", - "cacheRate": "Cache Rate", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "cachedRequests24h": "Cached Requests (24h)", - "peakCacheRate": "Peak Cache Rate", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/sw.json b/src/i18n/messages/sw.json index 001d49628d..aa1c2b04ec 100644 --- a/src/i18n/messages/sw.json +++ b/src/i18n/messages/sw.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ta.json b/src/i18n/messages/ta.json index da7cff7a34..33d14d538c 100644 --- a/src/i18n/messages/ta.json +++ b/src/i18n/messages/ta.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/te.json b/src/i18n/messages/te.json index 834dfe46e8..48c3728cab 100644 --- a/src/i18n/messages/te.json +++ b/src/i18n/messages/te.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/th.json b/src/i18n/messages/th.json index 8776c4f00a..1085ad5766 100644 --- a/src/i18n/messages/th.json +++ b/src/i18n/messages/th.json @@ -23,6 +23,7 @@ "active": "ใช้งานอยู่", "inactive": "ไม่ได้ใช้งาน", "noData": "ไม่มีข้อมูล", + "nothingHere": "Nothing here yet", "configure": "กำหนดค่า", "manage": "จัดการ", "name": "ชื่อ", @@ -138,7 +139,6 @@ "apikey": "คีย์ API", "http": "HTTP", "goToDashboard": "Go to Dashboard", - "nothingHere": "Nothing here yet", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "เอเจนต์", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "เอกสาร", "issues": "ประเด็นต่างๆ", "endpoints": "จุดปลายทาง", "apiManager": "ผู้จัดการ API", "logs": "บันทึก", + "webhooks": "__MISSING__:Webhooks", "auditLog": "บันทึกการตรวจสอบ", "shutdown": "ปิดเครื่อง", "restart": "รีสตาร์ท", @@ -705,8 +710,6 @@ "cliToolsShort": "เครื่องมือ", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "ธีมส์", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "เอวาลส์", "utilization": "การใช้งาน", "utilizationDescription": "แนวโน้มการใช้โควต้าของผู้ให้บริการและการติดตามขีดจำกัดอัตรา", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "สุขภาพคอมโบ", "comboHealthDescription": "โควต้าระดับคอมโบ การกระจายการใช้งาน และตัวชั่งวัดประสิทธิภาพ", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "ล่าสุด: {date}", "editPermissions": "แก้ไขสิทธิ์", "deleteKey": "ลบคีย์", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} โมเดล", "models": "{count} โมเดล", "permissionsTitle": "สิทธิ์: {name}", @@ -1188,11 +1296,13 @@ "continue": "ใช้เมื่อเรียกใช้ดำเนินการต่อใน IDE และคุณต้องกำหนดค่าผู้ให้บริการที่ใช้ JSON แบบพกพา", "opencode": "ใช้เมื่อคุณต้องการเรียกใช้ Terminal-Native Agent และใช้สคริปต์อัตโนมัติผ่าน OpenCode", "kiro": "ใช้เมื่อรวม Kiro และควบคุมการกำหนดเส้นทางโมเดลจากส่วนกลางจาก OmniRoute", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "ใช้เมื่อต้องสกัดกั้นการรับส่งข้อมูล Antigravity/Kiro ผ่าน MITM และกำหนดเส้นทางไปยัง OmniRoute", "copilot": "ใช้เมื่อคุณต้องการ UX รูปแบบการแชทของ Copilot ในขณะที่บังคับใช้คีย์ OmniRoute และกฎการกำหนดเส้นทาง", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google ต้านแรงโน้มถ่วง IDE พร้อม MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "ทางเลือกสำรองตามลำดับ: ลองใช้โมเดล 1 ก่อน จากนั้นจึงใช้ 2 เป็นต้น", "weightedDesc": "กระจายการรับส่งข้อมูลตามเปอร์เซ็นต์น้ำหนักพร้อมทางเลือกสำรอง", "roundRobinDesc": "การกระจายแบบวงกลม: แต่ละคำขอจะส่งไปยังโมเดลถัดไปที่หมุนเวียนกัน", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "การเลือกแบบสุ่มแบบสม่ำเสมอ จากนั้นจึงย้อนกลับไปยังโมเดลที่เหลือ", "leastUsedDesc": "เลือกโมเดลที่มีคำขอน้อยที่สุด โดยจะปรับสมดุลการโหลดเมื่อเวลาผ่านไป", "costOptimizedDesc": "กำหนดเส้นทางไปยังรุ่นที่ถูกที่สุดก่อนตามราคา", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "โมเดล", @@ -1404,6 +1521,13 @@ "retryDelay": "ความล่าช้าในการลองอีกครั้ง (มิลลิวินาที)", "concurrencyPerModel": "เห็นพ้องต้องกัน / รุ่น", "queueTimeout": "คิวหมดเวลา (มิลลิวินาที)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "เว้นว่างไว้เพื่อใช้ค่าเริ่มต้นสากล เหล่านี้จะแทนที่การตั้งค่าต่อผู้ให้บริการ", "moveUp": "เลื่อนขึ้น", "moveDown": "เลื่อนลง", @@ -1447,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1454,13 +1583,33 @@ }, "p2c": { "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "พร้อมที่จะบันทึกแล้วหรือยัง?", "readinessDescription": "ตรวจสอบรายการตรวจสอบก่อนที่จะสร้างหรืออัปเดตคำสั่งผสมนี้", "readinessCheckName": "ชื่อคำสั่งผสมถูกต้อง", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "reviewIntelligentTitle": "Intelligent Routing Config", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", "failedReorder": "Failed to reorder models", - "candidatePoolLabel": "Candidate Pool", - "routerStrategyLabel": "Router Strategy", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" - }, "basics": { - "description": "Name and starting template", - "label": "Basics" + "label": "Basics", + "description": "Name and starting template" }, - "review": { - "description": "Final validation before saving", - "label": "Review" + "steps": { + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" }, "intelligent": { "label": "Smart Routing", "description": "Auto-routing candidate pool, presets, and scoring" + }, + "review": { + "label": "Review", + "description": "Final validation before saving" } }, - "candidatePoolEmpty": "No active providers available yet.", - "emailVisibilityStateOn": "On", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "reviewAccounts": "Accounts", - "contextRelayHandoffThreshold": "Handoff Threshold", - "filterDeterministic": "Deterministic", - "reviewComboRefs": "Combo References", - "weightTierPriority": "Tier", - "reviewSequence": "Model Sequence", - "builderProviderFirst": "Pick provider first", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "reviewAgentFlags": "Agent Flags", "builderStageVisited": "Stage completed", - "reviewName": "Name", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderLegacyEntry": "Legacy entry", - "builderAccount": "Account", + "builderStageCurrent": "Current stage", "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", "builderLoadingProviders": "Loading providers...", - "builderPreview": "Preview", - "builderTitle": "Build a Combo", - "modePackUpdated": "Mode pack updated to {pack}.", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "budgetCapPlaceholder": "No limit", - "reviewNoSteps": "No steps configured", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewStrategy": "Strategy", - "excludedProviders": "Excluded Providers", - "modePackLabel": "Mode Pack", - "reorderHandle": "Drag to reorder", - "weightTaskFit": "Task Fit", - "reviewSteps": "Steps", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "builderModel": "Model", - "explorationRateLabel": "Exploration Rate", - "reviewProviders": "Providers", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "builderPinnedAccount": "Pinned Account", - "providerScores": "Provider Scores", - "builderAddStep": "Add step", - "contextRelaySummaryModel": "Summary Model", - "strategyRules": "Rules (6-Factor Scoring)", - "weightCostInv": "Cost", - "statusOverview": "Status Overview", - "filterAll": "All", - "budgetCapLabel": "Budget Cap (USD / request)", - "weightQuota": "Quota", - "normalOperation": "Normal Operation", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "contextRelay": "Context Relay", - "incidentMode": "Incident Mode", - "builderBrowseCatalog": "Browse catalog", "builderSelectProvider": "Select provider", + "builderModel": "Model", "builderSelectModel": "Select model", - "noExcludedProviders": "No providers are currently excluded.", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "reviewAdvanced": "Advanced Settings", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "weightHealth": "Health", - "builderStageLocked": "Locked — complete previous stage first", - "builderComboRefStep": "Add combo reference", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", "builderComboRef": "Combo Ref", - "builderFlowTitle": "Combo Builder Flow", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "builderStageCurrent": "Current stage", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "emailVisibilityStateOff": "Off", - "activeModePack": "Active Mode Pack", "builderAddComboRef": "Add combo reference", - "cooldownMinutes": "Cooldown: {minutes}m", - "filterEmptyTitle": "No combos match this strategy filter.", - "contextRelayMaxMessages": "Max Messages For Summary", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "candidatePoolAllProviders": "All providers", - "filterIntelligent": "Intelligent", - "weightLatencyInv": "Latency", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "weightStability": "Stability" + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "ค่าใช้จ่าย", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "งบประมาณ", "totalCost": "ต้นทุนรวม", "breakdown": "การแจกแจงต้นทุน", "noData": "ไม่มีข้อมูลค่าใช้จ่าย", "byModel": "โดยรุ่น", "byProvider": "โดยผู้ให้บริการ", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "จุดสิ้นสุด API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "ถอดเสียงไฟล์เสียงเป็นข้อความ (กระซิบ)", "textToSpeech": "ข้อความเป็นคำพูด", "textToSpeechDesc": "แปลงข้อความเป็นคำพูดที่ฟังดูเป็นธรรมชาติ", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "การกลั่นกรอง", "moderationsDesc": "การกลั่นกรองเนื้อหาและการจำแนกความปลอดภัย", "responsesDesc": "OpenAI Responses API สำหรับ Codex และเวิร์กโฟลว์เอเจนต์ขั้นสูง", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "สุขภาพของระบบ", "description": "การตรวจสอบอินสแตนซ์ OmniRoute ของคุณแบบเรียลไทม์", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "ขีดจำกัดและโควต้า", "rateLimit": "ขีดจำกัดอัตรา", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "ยินดีต้อนรับ", @@ -2262,6 +2661,12 @@ "errorCount": "{count} ข้อผิดพลาด ({code})", "errorCountNoCode": "{count} เกิดข้อผิดพลาด", "noConnections": "ไม่มีการเชื่อมต่อ", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "ปิดการใช้งาน", "enableProvider": "เปิดใช้งานผู้ให้บริการ", "disableProvider": "ปิดการใช้งานผู้ให้บริการ", @@ -2296,7 +2701,6 @@ "errorOccurred": "เกิดข้อผิดพลาด โปรดลองอีกครั้ง", "modelStatus": "สถานะโมเดล", "showConfiguredOnly": "Configured only", - "searchProviders": "ค้นหาผู้ให้บริการ...", "allModelsOperational": "ใช้งานได้ทุกรุ่น", "modelsWithIssues": "{count} โมเดลที่มีปัญหา", "allModelsNormal": "ทุกรุ่นตอบสนองได้ปกติ", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "รายละเอียดที่เข้ากันได้กับ OpenAI", "messagesApi": "API ข้อความ", "responsesApi": "API การตอบสนอง", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "เสร็จสิ้นการแชท", "importingModels": "กำลังนำเข้า...", "importFromModels": "นำเข้าจาก /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "นำเข้าโมเดลทั้งหมดแล้ว", "noNewModelsToImport": "ไม่มีโมเดลใหม่ที่จะนำเข้า — โมเดลทั้งหมดมีอยู่แล้วในรีจิสทรีหรือรายการโมเดลที่กำหนดเอง", "skippingExistingModels": "ข้าม {count} โมเดลที่มีอยู่", @@ -2373,6 +2782,7 @@ "importFailed": "การนำเข้าล้มเหลว", "noNewModelsAdded": "ไม่มีการเพิ่มโมเดลใหม่", "adding": "กำลังเพิ่ม...", + "close": "Close", "importingModelsTitle": "การนำเข้าโมเดล", "copyModel": "คัดลอกโมเดล", "filterModels": "กรองโมเดล…", @@ -2413,6 +2823,11 @@ "configured": "กำหนดค่าแล้ว", "providerProxyConfigureHint": "กำหนดค่าพร็อกซีสำหรับการเชื่อมต่อทั้งหมดของผู้ให้บริการรายนี้", "providerProxy": "พร็อกซีของผู้ให้บริการ", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "ยังไม่มีการเชื่อมต่อ", "addFirstConnectionHint": "เพิ่มการเชื่อมต่อครั้งแรกของคุณเพื่อเริ่มต้น", "addConnection": "เพิ่มการเชื่อมต่อ", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "รหัสรุ่น", "customModelPlaceholder": "เช่น gpt-4.5-เทอร์โบ", "loading": "กำลังโหลด...", @@ -2513,6 +2931,10 @@ "email": "อีเมล", "healthCheckMinutes": "ตรวจสุขภาพ (ขั้นต่ำ)", "healthCheckHint": "ช่วงเวลาการรีเฟรชโทเค็นเชิงรุก 0 = ปิดการใช้งาน", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "ทดสอบการเชื่อมต่อไม่สำเร็จ", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "repairEnvWorking": "Repairing...", - "noModelsMatch": "No models match \"{filter}\"", - "audioSpeech": "Audio Speech", - "selectAllModels": "Select all", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnvSuccess": "OAuth defaults restored", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", "showEmails": "Show all emails", - "deselectAllModels": "Deselect all", - "repairEnv": "Repair env", - "embeddings": "Embeddings", - "audioTranscriptions": "Audio Transcriptions", "hideEmails": "Hide all emails", - "imagesGenerations": "Images Generations", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "ค้นหาผู้ให้บริการ...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "การตั้งค่า", @@ -2723,6 +3137,23 @@ "systemPrompt": "พร้อมท์ระบบ", "thinkingBudget": "คิดงบประมาณ", "proxy": "หนังสือมอบฉันทะ", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "ราคา", "storage": "ที่เก็บของ", "policies": "นโยบาย", @@ -2733,6 +3164,46 @@ "enablePassword": "เปิดใช้งานรหัสผ่าน", "darkMode": "โหมดมืด", "lightMode": "โหมดแสง", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "แค่ตอนนี้", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "ผู้ให้บริการ", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "ธีมของระบบ", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "แคช TTL", "maxCacheSize": "ขนาดแคชสูงสุด", "clearCache": "ล้างแคช", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "การเข้าชมแคช", "cacheMisses": "แคชพลาด", "hitRate": "อัตราการเข้าชม", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "เปิดใช้งานการคิด", "maxThinkingTokens": "โทเค็นการคิดสูงสุด", "enableProxy": "เปิดใช้งานพร็อกซี", @@ -2802,6 +3277,14 @@ "themeLight": "เบา", "themeDark": "มืด", "themeSystem": "ระบบ", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "การป้องกันปลายทาง API", "requireAuthModels": "ต้องใช้คีย์ API สำหรับ /models", "requireAuthModelsDesc": "เมื่อเปิด ตำแหน่งข้อมูล /v1/models จะส่งคืน 404 สำหรับคำขอที่ไม่ได้รับการรับรองความถูกต้อง ป้องกันการค้นพบโมเดลโดยผู้ใช้ที่ไม่ได้รับอนุญาต", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "ผู้ให้บริการที่ถูกบล็อก", "blockedProvidersDesc": "ซ่อนผู้ให้บริการเฉพาะจากการตอบกลับ /v1/models ผู้ให้บริการที่ถูกบล็อกจะไม่ปรากฏในรายการโมเดล", "providersBlocked": "{count} ผู้ให้บริการถูกบล็อกจาก /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "เลือกบัญชีที่ใช้ล่าสุดน้อยที่สุด", "costOpt": "การเลือกใช้ต้นทุน", "costOptDesc": "ต้องการบัญชีที่ถูกที่สุด", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "ขีด จำกัด เหนียว", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "กลยุทธ์คอมโบ", "priority": "ลำดับความสำคัญ", "weighted": "ถ่วงน้ำหนัก", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "ลองใหม่สูงสุด", "retryDelayLabel": "ความล่าช้าในการลองอีกครั้ง (มิลลิวินาที)", "timeoutLabel": "หมดเวลา (มิลลิวินาที)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "ความลึกของการซ้อนสูงสุด", "concurrencyPerModel": "เห็นพ้องต้องกัน / รุ่น", "queueTimeout": "คิวหมดเวลา (มิลลิวินาที)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "โปรไฟล์ผู้ให้บริการ", "providerProfilesDesc": "แยกการตั้งค่าความยืดหยุ่นสำหรับผู้ให้บริการ OAuth (ตามเซสชัน) และคีย์ API (แบบมิเตอร์) ผู้ให้บริการ OAuth มีเกณฑ์ที่เข้มงวดมากขึ้นเนื่องจากมีขีดจำกัดอัตราที่ต่ำกว่า", "oauthProviders": "ผู้ให้บริการ OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "สร้างข้อมูลสำรองแล้ว: {file}", "restoreSuccess": "ฟื้นแล้ว! การเชื่อมต่อ {connections}, โหนด {nodes}, คอมโบ {combos}, คีย์ {apiKeys} API", "importSuccess": "นำเข้าฐานข้อมูลแล้ว! การเชื่อมต่อ {connections}, โหนด {nodes}, คอมโบ {combos}, คีย์ {apiKeys} API", - "justNow": "แค่ตอนนี้", "minutesAgo": "{count}นาทีที่แล้ว", "hoursAgo": "{count}ชม. ที่แล้ว", "daysAgo": "{count}d ที่แล้ว", @@ -3112,7 +3610,6 @@ "errorDuringImport": "เกิดข้อผิดพลาดระหว่างการนำเข้า", "modelPricing": "ราคารุ่น", "modelPricingDesc": "กำหนดอัตราต้นทุนต่อรุ่น • อัตราทั้งหมดในโทเค็น $/1M", - "providers": "ผู้ให้บริการ", "registry": "ทะเบียน", "priced": "ราคา", "searchProvidersModels": "ค้นหาผู้ให้บริการหรือรุ่น...", @@ -3154,47 +3651,6 @@ "editPricing": "แก้ไขราคา", "viewFullDetails": "ดูรายละเอียดทั้งหมด", "themeCoral": "คอรัล", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ผิดพลาด", "formatConverter": "ตัวแปลงรูปแบบ", "formatConverterDescription": "วางหรือพิมพ์เนื้อหาคำขอ JSON นักแปลจะตรวจจับรูปแบบต้นฉบับโดยอัตโนมัติและแปลงเป็นรูปแบบเป้าหมาย ใช้สิ่งนี้เพื่อแก้ไขวิธีที่ OmniRoute แปลคำขอระหว่างรูปแบบต่างๆ (OpenAI ↔ Claude ↔ Gemini ↔ Responses API)", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "อินพุต", "output": "เอาท์พุต", "auto": "อัตโนมัติ", @@ -3573,6 +4059,11 @@ "errorMessage": "ข้อผิดพลาด: {message}", "requestFailed": "คำขอล้มเหลว", "noTextExtracted": "(ไม่มีการแยกข้อความ)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "แสดงเหตุการณ์การแปลเมื่อมีการเรียก API ไหลผ่าน OmniRoute เหตุการณ์มาจากบัฟเฟอร์ในหน่วยความจำ (รีเซ็ตเมื่อรีสตาร์ท) ใช้", "liveMonitorDescriptionSuffix": "หรือการเรียก API ภายนอกเพื่อสร้างเหตุการณ์" }, @@ -3648,14 +4139,25 @@ "passSuffix": "ผ่าน", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "วิ่งเอวาล", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "กำลังรัน {current}/{total}...", "passRate": "อัตราการผ่าน", "summaryBreakdown": "{passed} ผ่านไป · {failed} ล้มเหลว · รวม {total}", "passedIconLabel": "✅ผ่าน", "failedIconLabel": "❌ล้มเหลว", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "ประกอบด้วย: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "ต้องการ: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "ยังไม่มีผลลัพธ์", "testCasesCount": "กรณีทดสอบ ({count})", "noTestCasesDefined": "ไม่มีการกำหนดกรณีทดสอบ", @@ -3723,6 +4225,16 @@ "tierFree": "ฟรี", "tierUnknown": "ไม่ทราบ", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "กำลังรอการอนุญาตต้านแรงโน้มถ่วง...", "waitingForQoderAuthorization": "กำลังรอการอนุญาตจาก Qoder...", "exchangingCodeForTokens": "การเปลี่ยนรหัสเป็นโทเค็น...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", + "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleTitle": "Incompatible Node.js Version" + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "เอกสารประกอบ", "quickStart": "เริ่มต้นอย่างรวดเร็ว", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "คุณสมบัติ", "supportedProviders": "ผู้ให้บริการที่รองรับ", "supportedProvidersToc": "ผู้ให้บริการ", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. ตั้งค่า URL ฐานลูกค้า", "quickStartStep4Prefix": "ชี้ IDE หรือไคลเอ็นต์ API ของคุณไปที่", "quickStartStep4Suffix": "ใช้คำนำหน้าผู้ให้บริการ เป็นต้น", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "การกำหนดเส้นทางผู้ให้บริการหลายราย", "featureRoutingText": "กำหนดเส้นทางคำขอไปยังผู้ให้บริการ AI กว่า 30 รายผ่านจุดสิ้นสุดที่เข้ากันได้กับ OpenAI จุดเดียว รองรับ API การแชท การตอบกลับ เสียง และรูปภาพ", "featureCombosTitle": "คอมโบและการปรับสมดุล", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "ใช้", "clientClaudeBullet1Middle": "(คลอดด์) หรือ", "clientClaudeBullet1Suffix": "(ต้านแรงโน้มถ่วง) คำนำหน้า", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "ใช้แดชบอร์ด > ผู้ให้บริการ > ทดสอบการเชื่อมต่อ ก่อนการทดสอบจาก IDE หรือไคลเอนต์ภายนอก", "troubleshootingCircuitBreaker": "หากผู้ให้บริการแสดงเซอร์กิตเบรกเกอร์เปิดอยู่ ให้รอคูลดาวน์หรือตรวจสอบหน้าสุขภาพเพื่อดูรายละเอียด", "troubleshootingOAuth": "สำหรับผู้ให้บริการ OAuth ให้ตรวจสอบสิทธิ์อีกครั้งหากโทเค็นหมดอายุ ตรวจสอบตัวบ่งชี้สถานะบัตรผู้ให้บริการ", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "นโยบายความเป็นส่วนตัว", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "แชทง่ายๆ", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "hoursTracked": "hours tracked", - "cacheRateDesc": "of total requests", - "busiestHour": "Busiest Hour", - "entriesLoadError": "Failed to load semantic cache entries.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "semanticCache": "Semantic Cache", - "cachedRequests24h": "Cached Requests (24h)", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "trendHour": "Hour", - "peakCacheRate": "Peak Cache Rate", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "activityVolume": "Activity", - "cacheRate": "Cache Rate", - "lastUpdated": "Last updated", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/tr.json b/src/i18n/messages/tr.json index 8bc0fb18d9..bcdcf044c2 100644 --- a/src/i18n/messages/tr.json +++ b/src/i18n/messages/tr.json @@ -23,6 +23,7 @@ "active": "Aktif", "inactive": "Etkin değil", "noData": "Veri yok", + "nothingHere": "Nothing here yet", "configure": "Yapılandır", "manage": "Yönet", "name": "İsim", @@ -137,7 +138,6 @@ "Failed to reset pricing": "Fiyatlandırma sıfırlanamadı", "apikey": "API Anahtarı", "http": "HTTP", - "nothingHere": "Nothing here yet", "goToDashboard": "Go to Dashboard", "checkSystemStatus": "Check System Status", "selectModel": "Select Model", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Oyun Alanı", "searchTools": "Arama Araçları", "agents": "Ajanlar", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Dokümanlar", "issues": "Sorunlar", "endpoints": "Uç noktalar", "apiManager": "API Yöneticisi", "logs": "Günlükler", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Denetim Günlüğü", "shutdown": "Kapat", "restart": "Yeniden başlat", @@ -705,8 +710,6 @@ "cliToolsShort": "Araçlar", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Temalar", "description": "Hazır bir tema seçin veya tek bir renkle kendi temanızı oluşturun", @@ -826,6 +926,10 @@ "evals": "Değerlendirmeler", "utilization": "Kullanım", "utilizationDescription": "Sağlayıcı kota kullanım trendleri ve hız limiti takibi", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Kombo Sağlığı", "comboHealthDescription": "Kombo düzeyinde kota, kullanım dağılımı ve performans metrikleri", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Son: {date}", "editPermissions": "İzinleri düzenle", "deleteKey": "Anahtarı sil", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} adet model", "models": "{count} adet model", "permissionsTitle": "İzinler: {name}", @@ -1188,11 +1296,13 @@ "continue": "IDE'lerde Continue çalıştırırken taşınabilir, JSON tabanlı sağlayıcı yapılandırmasına ihtiyaç duyduğunuzda kullanın.", "opencode": "Terminal yerel ajan çalıştırmaları ve OpenCode ile betik tabanlı otomasyon tercih ettiğinizde kullanın.", "kiro": "Kiro'yu entegre ederken model yönlendirmesini OmniRoute üzerinden merkezi olarak yönetmek istediğinizde kullanın.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Antigravity/Kiro trafiğinin MITM üzerinden yakalanıp OmniRoute'a yönlendirilmesi gerektiğinde kullanın.", "copilot": "OmniRoute anahtarları ve yönlendirme kuralları uygulanırken Copilot sohbet tarzı bir UX istediğinizde kullanın.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "MITM ile Google Antigravity IDE", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Sıralı yedekleme: önce model 1, sonra model 2, ardından diğerleri denenir.", "weightedDesc": "Trafiği ağırlık yüzdelerine göre dağıtır ve hata durumunda yedek modele düşer.", "roundRobinDesc": "Döngüsel dağıtım: her istek sıradaki modele yönlendirilir.", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Eşit olasılıklı rastgele seçim yapar, ardından kalan modellere yedeklenir.", "leastUsedDesc": "En az istek alan modeli seçerek yükü zaman içinde dengeler.", "costOptimizedDesc": "Fiyatlandırmaya göre önce en ucuz modele yönlendirir.", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Kesin Rastgele", "strictRandomDesc": "Karıştırma destesi: yeniden karıştırmadan önce her modeli bir kez kullanır.", "models": "Modeller", @@ -1404,6 +1521,13 @@ "retryDelay": "Yeniden Deneme Gecikmesi (ms)", "concurrencyPerModel": "Eşzamanlılık / Model", "queueTimeout": "Kuyruk Zaman Aşımı (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Genel varsayılanları kullanmak için boş bırakın. Bunlar, sağlayıcı başına ayarları geçersiz kılar.", "moveUp": "Yukarı taşı", "moveDown": "Aşağı taşı", @@ -1447,20 +1571,45 @@ "avoid": "Fiyatlandırma verileri eksik veya güncel değil.", "example": "Düşük maliyetin öncelikli olduğu arka plan veya toplu işler." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { "when": "Use when long sessions must survive account rotation without losing the working context.", - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests." + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin en az 2 modelle en iyi sonucu verir.", "warningCostOptimizedPartialPricing": "{total} modelin yalnızca {priced} tanesinde fiyat bilgisi var. Yönlendirme kısmen maliyet odaklı olabilir.", "warningCostOptimizedNoPricing": "Bu kombo için fiyatlandırma verisi bulunamadı. Maliyet odaklı yönlendirme beklenmedik davranabilir.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Kaydetmeye hazır mısınız?", "readinessDescription": "Bu komboyu oluşturmadan veya güncellemeden önce kontrol listesini gözden geçirin.", "readinessCheckName": "Kombo adı geçerli", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Önerileri Uygula", "recommendationsUpdated": "{strategy} için öneriler güncellendi.", "recommendationsApplied": "Öneriler bu komboya uygulandı.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Güvenli temel strateji", @@ -1555,12 +1748,61 @@ "tip2": "Zor istemler için kaliteli bir yedek bulundurun.", "tip3": "Maliyetin ana KPI olduğu toplu/arka plan işlerinde kullanın." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Ücretsiz Yığın ($0)", @@ -1581,11 +1823,15 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "intelligentPanelTitle": "Intelligent Routing Dashboard", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { - "intelligent": { - "label": "Smart Routing", - "description": "Auto-routing candidate pool, presets, and scoring" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", @@ -1595,111 +1841,93 @@ "label": "Strategy", "description": "Routing behavior and advanced settings" }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" + }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "basics": { - "description": "Name and starting template", - "label": "Basics" } }, - "builderSelectProvider": "Select provider", - "candidatePoolAllProviders": "All providers", - "budgetCapPlaceholder": "No limit", - "builderStagePending": "Pending", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", "builderStageVisited": "Stage completed", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "reviewSequence": "Model Sequence", - "weightTaskFit": "Task Fit", - "builderComboRef": "Combo Ref", - "weightStability": "Stability", - "explorationRateLabel": "Exploration Rate", - "reviewComboRefs": "Combo References", - "reviewAgentFlags": "Agent Flags", - "builderPreview": "Preview", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "candidatePoolLabel": "Candidate Pool", - "budgetCapLabel": "Budget Cap (USD / request)", - "builderLoadingProviders": "Loading providers...", - "reviewIntelligentTitle": "Intelligent Routing Config", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "activeModePack": "Active Mode Pack", - "failedReorder": "Failed to reorder models", - "builderAddComboRef": "Add combo reference", - "routerStrategyLabel": "Router Strategy", - "candidatePoolEmpty": "No active providers available yet.", - "noExcludedProviders": "No providers are currently excluded.", - "builderTitle": "Build a Combo", - "builderComboRefStep": "Add combo reference", - "incidentMode": "Incident Mode", - "builderPinnedAccount": "Pinned Account", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "emailVisibilityStateOff": "Off", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "weightTierPriority": "Tier", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderProviderFirst": "Pick provider first", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderAddStep": "Add step", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewSteps": "Steps", - "builderProvider": "Provider", - "weightQuota": "Quota", - "filterEmptyTitle": "No combos match this strategy filter.", - "cooldownMinutes": "Cooldown: {minutes}m", - "filterAll": "All", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "contextRelayMaxMessages": "Max Messages For Summary", - "normalOperation": "Normal Operation", - "statusOverview": "Status Overview", - "excludedProviders": "Excluded Providers", - "contextRelay": "Context Relay", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "filterDeterministic": "Deterministic", - "reviewNoSteps": "No steps configured", - "weightCostInv": "Cost", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "reorderHandle": "Drag to reorder", - "builderLegacyEntry": "Legacy entry", - "modePackLabel": "Mode Pack", - "reviewProviders": "Providers", - "builderStageLocked": "Locked — complete previous stage first", - "contextRelaySummaryModel": "Summary Model", - "builderSelectModel": "Select model", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "strategyRules": "Rules (6-Factor Scoring)", - "reviewAccounts": "Accounts", - "weightHealth": "Health", - "reviewAdvanced": "Advanced Settings", "builderStageCurrent": "Current stage", - "reviewStrategy": "Strategy", - "filterIntelligent": "Intelligent", - "weightLatencyInv": "Latency", - "builderFlowTitle": "Combo Builder Flow", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", "builderBrowseCatalog": "Browse catalog", + "builderProvider": "Provider", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", "builderModel": "Model", - "modePackUpdated": "Mode pack updated to {pack}.", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", "builderAccount": "Account", - "emailVisibilityStateOn": "On", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", "reviewName": "Name", - "providerScores": "Provider Scores" + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Maliyetler", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Bütçe", "totalCost": "Toplam Maliyet", "breakdown": "Maliyet Dağılımı", "noData": "Maliyet verisi yok", "byModel": "Modele göre", "byProvider": "Sağlayıcıya göre", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Uç Noktası", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Ses dosyalarını metne dönüştürün (Whisper)", "textToSpeech": "Metinden Konuşma", "textToSpeechDesc": "Metni doğal sesli konuşmaya dönüştürün", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Moderasyonlar", "moderationsDesc": "İçerik denetimi ve güvenlik sınıflandırması", "responsesDesc": "Codex ve gelişmiş aracılı iş akışları için OpenAI Responses API'si", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Görevleri `tasks/get` ve `tasks/cancel` ile izleyin ve yönetin.", "completionsLegacy": "Tamamlamalar (Eski)", "completionsLegacyDesc": "Eski OpenAI metin tamamlamaları — hem bilgi istemi dizesini hem de mesaj dizisi biçimini kabul eder", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Uç Nokta Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Sistem Sağlığı", "description": "OmniRoute örneğinizin gerçek zamanlı izlenmesi", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limitler ve Kotalar", "rateLimit": "Hız Limiti", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Hoş geldiniz", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Hata ({code})", "errorCountNoCode": "{count} Hata", "noConnections": "Bağlantı yok", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Devre dışı", "enableProvider": "Sağlayıcıyı etkinleştir", "disableProvider": "Sağlayıcıyı devre dışı bırak", @@ -2296,7 +2701,6 @@ "errorOccurred": "Bir hata oluştu. Lütfen tekrar deneyin.", "modelStatus": "Model Durumu", "showConfiguredOnly": "Configured only", - "searchProviders": "Sağlayıcı ara...", "allModelsOperational": "Tüm modeller çalışır durumda", "modelsWithIssues": "{count} modelde sorun var", "allModelsNormal": "Tüm modeller normal şekilde yanıt veriyor.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "OpenAI Uyumlu Ayrıntılar", "messagesApi": "Mesajlar API'si", "responsesApi": "Yanıtlar API'si", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Sohbet Tamamlamaları", "importingModels": "İçe aktarılıyor...", "importFromModels": "/models'ten içe aktar", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Tüm modeller zaten içe aktarıldı", "noNewModelsToImport": "İçe aktarılacak yeni model yok — tüm modeller zaten kayıt defterinde veya özel modeller listesinde", "skippingExistingModels": "{count} mevcut model atlanıyor", @@ -2373,6 +2782,7 @@ "importFailed": "İçe aktarma başarısız oldu", "noNewModelsAdded": "Yeni model eklenmedi.", "adding": "Ekleniyor...", + "close": "Close", "importingModelsTitle": "Modelleri İçe Aktarma", "copyModel": "Modeli kopyala", "filterModels": "Modelleri filtrele…", @@ -2413,6 +2823,11 @@ "configured": "yapılandırıldı", "providerProxyConfigureHint": "Bu sağlayıcının tüm bağlantıları için proxy'yi yapılandırın", "providerProxy": "Sağlayıcı Proxy", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Henüz bağlantı yok", "addFirstConnectionHint": "Başlamak için ilk bağlantınızı ekleyin", "addConnection": "Bağlantı Ekle", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Başlık ekle", "compatUpstreamRemoveRow": "Satırı kaldır", "compatBadgeUpstreamHeaders": "Başlıklar", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Model Kimliği", "customModelPlaceholder": "örneğin gpt-4.5-turbo", "loading": "Yükleniyor...", @@ -2513,6 +2931,10 @@ "email": "E-posta", "healthCheckMinutes": "Sağlık Kontrolü (dk)", "healthCheckHint": "Proaktif jeton yenileme aralığı. 0 = devre dışı.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Ortam", "groupPlaceholder": "örneğin eKaizen, Kişisel", "failedTestConnection": "Bağlantı testi başarısız oldu", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Model Uç Noktası Yolu", "modelsPathPlaceholder": "/models", "modelsPathHint": "Doğrulama için özel model yolu (ör. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "deselectAllModels": "Deselect all", - "imagesGenerations": "Images Generations", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnv": "Repair env", "showEmails": "Show all emails", - "repairEnvFailed": "Failed to repair .env", - "repairEnvWorking": "Repairing...", "hideEmails": "Hide all emails", - "audioTranscriptions": "Audio Transcriptions", - "modelsActiveCount": "{active}/{total} active", - "selectAllModels": "Select all", - "noModelsMatch": "No models match \"{filter}\"", - "embeddings": "Embeddings", - "audioSpeech": "Audio Speech", - "repairEnvSuccess": "OAuth defaults restored", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Sağlayıcı ara...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Ayarlar", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Fiyatlandırma", "storage": "Depolama", "policies": "Politikalar", @@ -2749,6 +3164,46 @@ "enablePassword": "Şifreyi Etkinleştir", "darkMode": "Karanlık Mod", "lightMode": "Açık Mod", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "az önce", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Sağlayıcılar", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Sistem Teması", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Önbellek TTL", "maxCacheSize": "Maksimum Önbellek Boyutu", "clearCache": "Önbelleği Temizle", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Önbellek İsabetleri", "cacheMisses": "Önbellek Iskalamaları", "hitRate": "İsabet Oranı", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Düşünmeyi Etkinleştir", "maxThinkingTokens": "Maksimum Düşünme Jetonları", "enableProxy": "Proxy'yi Etkinleştir", @@ -2818,6 +3277,14 @@ "themeLight": "Açık", "themeDark": "Koyu", "themeSystem": "Sistem", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Uç Noktası Koruması", "requireAuthModels": "/models için API anahtarı gerektir", "requireAuthModelsDesc": "AÇIK olduğunda /v1/models uç noktası, kimliği doğrulanmamış istekler için 404 değerini döndürür. Yetkisiz kullanıcıların model bulmasını engeller.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Engellenen Sağlayıcılar", "blockedProvidersDesc": "Belirli sağlayıcıları /v1/models yanıtından gizleyin. Engellenen sağlayıcılar model listelerinde görünmez.", "providersBlocked": "/models için {count} sağlayıcı engellendi", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "En uzun süredir kullanılmayan hesabı seçin", "costOpt": "Maliyet Odaklı", "costOptDesc": "Mevcut en uygun maliyetli hesabı tercih edin", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Katı Rastgele", "strictRandomDesc": "Karıştırma destesi — yeniden karıştırmadan önce her hesabı bir kez kullanır", "stickyLimit": "Yapışkan Sınır", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Kombinasyon stratejisi", "priority": "Öncelik", "weighted": "Ağırlıklı", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Maksimum Yeniden Deneme Sayısı", "retryDelayLabel": "Yeniden Deneme Gecikmesi (ms)", "timeoutLabel": "Zaman aşımı (ms)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Maksimum İç İçe Derinlik", "concurrencyPerModel": "Model Başına Eşzamanlılık", "queueTimeout": "Kuyruk Zaman Aşımı (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Sağlayıcı Profilleri", "providerProfilesDesc": "OAuth (oturum tabanlı) ve API Anahtarı (kotalı) sağlayıcılar için ayrı dayanıklılık ayarları. OAuth sağlayıcılarında hız limitleri daha düşük olduğundan eşikler daha sıkıdır.", "oauthProviders": "OAuth Sağlayıcıları", @@ -3113,7 +3596,6 @@ "backupCreated": "Yedekleme oluşturuldu: {file}", "restoreSuccess": "Geri yüklendi! {connections} bağlantı, {nodes} düğüm, {combos} kombo, {apiKeys} API anahtarı.", "importSuccess": "Veritabanı içe aktarıldı! {connections} bağlantı, {nodes} düğüm, {combos} kombo, {apiKeys} API anahtarı.", - "justNow": "az önce", "minutesAgo": "{count} dk önce", "hoursAgo": "{count} saat önce", "daysAgo": "{count} gün önce", @@ -3128,7 +3610,6 @@ "errorDuringImport": "İçe aktarma sırasında bir hata oluştu", "modelPricing": "Model Fiyatlandırması", "modelPricingDesc": "Model başına maliyet oranlarını yapılandırın • Tüm oranlar $/1M jeton cinsindendir", - "providers": "Sağlayıcılar", "registry": "Katalog", "priced": "Fiyatlandırılan", "searchProvidersModels": "Sağlayıcı veya model ara...", @@ -3170,47 +3651,6 @@ "editPricing": "Fiyatlandırmayı Düzenle", "viewFullDetails": "Tüm Ayrıntıları Görüntüle", "themeCoral": "Mercan", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "HATA", "formatConverter": "Biçim Dönüştürücü", "formatConverterDescription": "Bir JSON istek gövdesi yapıştırın veya yazın. Çevirici, kaynak formatı otomatik olarak algılar ve hedef formata dönüştürür. OmniRoute'un istekleri formatlar arasında (OpenAI ↔ Claude ↔ Gemini ↔ Responses API) nasıl çevirdiğini hata ayıklamak için bunu kullanın.", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Giriş", "output": "Çıktı", "auto": "Otomatik", @@ -3573,6 +4059,11 @@ "errorMessage": "Hata: {message}", "requestFailed": "İstek başarısız oldu", "noTextExtracted": "(Metin çıkarılmadı)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "API çağrıları OmniRoute üzerinden akarken çeviri olaylarını gösterir. Olaylar bellek içi arabellekten gelir (yeniden başlatıldığında sıfırlanır). Etkinlik üretmek için", "liveMonitorDescriptionSuffix": " sekmelerini veya harici API çağrılarını kullanın." }, @@ -3648,14 +4139,25 @@ "passSuffix": "başarı", "casesCount": "{count, plural, one {# senaryo} other {# senaryo}}", "runEval": "Değerlendirmeyi Çalıştır", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Çalışıyor {current}/{total}...", "passRate": "başarı oranı", "summaryBreakdown": "{passed} başarılı · {failed} başarısız · {total} toplam", "passedIconLabel": "✅ Başarılı", "failedIconLabel": "❌ Başarısız", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "İçerir: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Beklenen: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Henüz sonuç yok", "testCasesCount": "Test Senaryoları ({count})", "noTestCasesDefined": "Tanımlı test senaryosu yok", @@ -3723,6 +4225,16 @@ "tierFree": "Ücretsiz", "tierUnknown": "Bilinmiyor", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,10 +4459,10 @@ "waitingForAntigravityAuthorization": "Antigravity yetkilendirmesi bekleniyor...", "waitingForQoderAuthorization": "Qoder yetkilendirmesi bekleniyor...", "exchangingCodeForTokens": "Kod jetonlarla değiştiriliyor...", - "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended.", "nodeIncompatibleTitle": "Incompatible Node.js Version", + "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", - "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release." + "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { "brandName": "OmniRoute", @@ -4032,6 +4549,7 @@ "docs": { "title": "Dokümantasyon", "quickStart": "Hızlı Başlangıç", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Özellikler", "supportedProviders": "Desteklenen Sağlayıcılar", "supportedProvidersToc": "Sağlayıcılar", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. İstemci temel URL'sini ayarlayın", "quickStartStep4Prefix": "IDE veya API istemcinizi şuraya yönlendirin:", "quickStartStep4Suffix": "Örneğin sağlayıcı önekini kullanın", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Çoklu Sağlayıcı Yönlendirme", "featureRoutingText": "İstekleri tek bir OpenAI uyumlu uç nokta üzerinden 30+ AI sağlayıcısına yönlendirin. Chat, Responses, ses ve görsel API'lerini destekler.", "featureCombosTitle": "Kombinasyonlar ve Dengeleme", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "Claude için", "clientClaudeBullet1Middle": "veya Antigravity için", "clientClaudeBullet1Suffix": "önekini kullanın.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protokoller: MCP ve A2A", "protocolsDescription": "OmniRoute, OpenAI uyumlu API'lere ek olarak iki operasyonel protokol sunar: araç yürütme için MCP ve ajanlar arası iş akışları için A2A.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "IDE'lerden veya harici istemcilerden test yapmadan önce Kontrol Paneli > Sağlayıcılar > Bağlantıyı Test Et'i kullanın.", "troubleshootingCircuitBreaker": "Bir sağlayıcıda devre kesici açık görünüyorsa cooldown süresinin dolmasını bekleyin veya ayrıntılar için Sağlık sayfasını kontrol edin.", "troubleshootingOAuth": "OAuth sağlayıcıları için belirteçlerin süresi dolduğunda yeniden kimlik doğrulaması yapın. Sağlayıcı kartı durum göstergesini kontrol edin.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Gizlilik Politikası", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Basit Sohbet", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "activityVolume": "Activity", - "trendHour": "Hour", - "cacheRate": "Cache Rate", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "busiestHour": "Busiest Hour", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "cacheRateDesc": "of total requests", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "hoursTracked": "hours tracked", - "cachedRequests24h": "Cached Requests (24h)", - "peakCacheRate": "Peak Cache Rate", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "lastUpdated": "Last updated", - "entriesLoadError": "Failed to load semantic cache entries.", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "semanticCache": "Semantic Cache", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/uk-UA.json b/src/i18n/messages/uk-UA.json index f8d744939d..f1675ca8b9 100644 --- a/src/i18n/messages/uk-UA.json +++ b/src/i18n/messages/uk-UA.json @@ -23,6 +23,7 @@ "active": "Активний", "inactive": "Неактивний", "noData": "Немає даних", + "nothingHere": "Nothing here yet", "configure": "Налаштувати", "manage": "Керувати", "name": "Ім'я", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Не вдалося скинути ціни", "apikey": "Ключ API", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Агенти", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "документи", "issues": "Питання", "endpoints": "Кінцеві точки", "apiManager": "Менеджер API", "logs": "Журнали", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Журнал аудиту", "shutdown": "Вимкнути", "restart": "Перезапуск", @@ -705,8 +710,6 @@ "cliToolsShort": "Інструменти", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Оцінки", "utilization": "Використання", "utilizationDescription": "Тренди використання квоти постачальника та відстеження обмежень швидкості", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Здоров'я комбінації", "comboHealthDescription": "Квота на рівні комбінації, розподіл використання та метрики продуктивності", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Останній: {date}", "editPermissions": "Права на редагування", "deleteKey": "Видалити ключ", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "Модель {count}", "models": "{count} моделей", "permissionsTitle": "Дозволи: {name}", @@ -1188,11 +1296,13 @@ "continue": "Використовуйте під час запуску Продовжити в IDE і вам потрібна портативна конфігурація постачальника на основі JSON.", "opencode": "Використовуйте, якщо ви віддаєте перевагу запуску агента на терміналі та автоматизації за сценарієм через OpenCode.", "kiro": "Використовуйте під час інтеграції Kiro та централізованого керування маршрутизацією моделі з OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Використовуйте, коли трафік Antigravity/Kiro потрібно перехопити через MITM і направити на OmniRoute.", "copilot": "Використовуйте, коли вам потрібен UX у стилі чату Copilot із застосуванням ключів OmniRoute і правил маршрутизації.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "Google Antigravity IDE з MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Послідовний резерв: спочатку пробує модель 1, потім 2 тощо.", "weightedDesc": "Розподіляє трафік за ваговим відсотком із резервним варіантом", "roundRobinDesc": "Циркулярний розподіл: кожен запит переходить до наступної моделі по черзі", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Рівномірний випадковий вибір, а потім повернення до інших моделей", "leastUsedDesc": "Вибирає модель із найменшою кількістю запитів, балансуючи навантаження за часом", "costOptimizedDesc": "Маршрути до найдешевшої моделі на основі ціни", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Моделі", @@ -1404,6 +1521,13 @@ "retryDelay": "Затримка повтору (мс)", "concurrencyPerModel": "Одночасність / Модель", "queueTimeout": "Час очікування черги (мс)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Залиште пустим, щоб використовувати глобальні параметри за умовчанням. Вони замінюють налаштування кожного постачальника.", "moveUp": "Рухатися вгору", "moveDown": "Рухатися вниз", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, + "p2c": { + "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." + }, "context-relay": { - "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "when": "Use when long sessions must survive account rotation without losing the working context.", + "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." }, - "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", - "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm." + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Готові економити?", "readinessDescription": "Перегляньте контрольний список, перш ніж створювати або оновлювати цю комбінацію.", "readinessCheckName": "Ім'я комбінованого тексту дійсне", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "builderComboRefStep": "Add combo reference", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", "builderFlowTitle": "Combo Builder Flow", - "noExcludedProviders": "No providers are currently excluded.", - "reviewProviders": "Providers", - "excludedProviders": "Excluded Providers", - "routerStrategyLabel": "Router Strategy", - "reviewSequence": "Model Sequence", "builderStage": { - "strategy": { - "label": "Strategy", - "description": "Routing behavior and advanced settings" + "basics": { + "label": "Basics", + "description": "Name and starting template" }, "steps": { "label": "Steps", "description": "Provider, model, and account selection" }, + "strategy": { + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "basics": { - "label": "Basics", - "description": "Name and starting template" } }, - "reviewSteps": "Steps", - "builderPinnedAccount": "Pinned Account", - "builderSelectProvider": "Select provider", - "builderSelectModel": "Select model", - "reviewAgentFlags": "Agent Flags", - "builderAccount": "Account", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "builderStageVisited": "Stage completed", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayHandoffThreshold": "Handoff Threshold", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "emailVisibilityStateOff": "Off", - "candidatePoolLabel": "Candidate Pool", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "filterEmptyTitle": "No combos match this strategy filter.", - "builderAddStep": "Add step", - "incidentMode": "Incident Mode", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "explorationRateLabel": "Exploration Rate", - "reorderHandle": "Drag to reorder", - "budgetCapLabel": "Budget Cap (USD / request)", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "activeModePack": "Active Mode Pack", - "weightQuota": "Quota", - "normalOperation": "Normal Operation", - "builderProviderFirst": "Pick provider first", - "weightCostInv": "Cost", - "builderLoadingProviders": "Loading providers...", - "weightLatencyInv": "Latency", - "reviewAdvanced": "Advanced Settings", - "filterAll": "All", - "builderTitle": "Build a Combo", - "contextRelay": "Context Relay", - "weightTaskFit": "Task Fit", - "contextRelayMaxMessages": "Max Messages For Summary", - "filterIntelligent": "Intelligent", - "weightTierPriority": "Tier", - "modePackUpdated": "Mode pack updated to {pack}.", - "reviewNoSteps": "No steps configured", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "budgetCapPlaceholder": "No limit", - "reviewName": "Name", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderStageLocked": "Locked — complete previous stage first", - "weightHealth": "Health", "builderStageCurrent": "Current stage", - "providerScores": "Provider Scores", - "emailVisibilityStateOn": "On", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "reviewComboRefs": "Combo References", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "reviewIntelligentTitle": "Intelligent Routing Config", - "failedReorder": "Failed to reorder models", - "builderComboRef": "Combo Ref", "builderStagePending": "Pending", - "reviewStrategy": "Strategy", - "statusOverview": "Status Overview", - "weightStability": "Stability", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "builderPreview": "Preview", + "builderStageLocked": "Locked — complete previous stage first", + "builderTitle": "Build a Combo", "builderBrowseCatalog": "Browse catalog", - "reviewAccounts": "Accounts", "builderProvider": "Provider", - "builderAddComboRef": "Add combo reference", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", "builderModel": "Model", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "filterDeterministic": "Deterministic", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", + "builderComboRefStep": "Add combo reference", + "builderPinnedAccount": "Pinned Account", "builderLegacyEntry": "Legacy entry", - "modePackLabel": "Mode Pack", - "candidatePoolEmpty": "No active providers available yet.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "cooldownMinutes": "Cooldown: {minutes}m", - "candidatePoolAllProviders": "All providers", - "strategyRules": "Rules (6-Factor Scoring)" + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Витрати", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Бюджет", "totalCost": "Загальна вартість", "breakdown": "Розподіл витрат", "noData": "Немає даних про вартість", "byModel": "За моделлю", "byProvider": "Від постачальника", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Кінцева точка API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Транскрибувати аудіофайли в текст (Whisper)", "textToSpeech": "Перетворення тексту в мовлення", "textToSpeechDesc": "Перетворення тексту на природне мовлення", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Модерації", "moderationsDesc": "Модерація контенту та класифікація безпеки", "responsesDesc": "OpenAI Responses API for Codex and advanced agentic workflows", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", - "musicGeneration": "Music Generation", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Здоров'я системи", "description": "Моніторинг вашого екземпляра OmniRoute у реальному часі", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Ліміти та квоти", "rateLimit": "Обмеження швидкості", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Ласкаво просимо", @@ -2262,6 +2661,12 @@ "errorCount": "Помилка {count} ({code})", "errorCountNoCode": "{count} Помилка", "noConnections": "Жодних зв'язків", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Вимкнено", "enableProvider": "Увімкнути провайдера", "disableProvider": "Вимкнути провайдера", @@ -2296,7 +2701,6 @@ "errorOccurred": "Сталася помилка. Спробуйте ще раз.", "modelStatus": "Статус моделі", "showConfiguredOnly": "Configured only", - "searchProviders": "Пошук постачальників...", "allModelsOperational": "Всі моделі робочі", "modelsWithIssues": "{count} моделі з проблемами", "allModelsNormal": "Усі моделі реагують нормально.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Відомості про сумісність з OpenAI", "messagesApi": "API повідомлень", "responsesApi": "API відповідей", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Завершення чату", "importingModels": "Імпорт...", "importFromModels": "Імпортувати з /models", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Усі моделі вже імпортовано", "noNewModelsToImport": "Немає нових моделей для імпорту — усі моделі вже є в реєстрі або списку користувацьких моделей", "skippingExistingModels": "Пропуск {count} наявних моделей", @@ -2373,6 +2782,7 @@ "importFailed": "Помилка імпорту", "noNewModelsAdded": "Нові моделі не додано.", "adding": "Додавання...", + "close": "Close", "importingModelsTitle": "Імпорт моделей", "copyModel": "Копія моделі", "filterModels": "Фільтрувати моделі…", @@ -2413,6 +2823,11 @@ "configured": "налаштовано", "providerProxyConfigureHint": "Налаштувати проксі для всіх підключень цього провайдера", "providerProxy": "Проксі-сервер постачальника", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Підключень ще немає", "addFirstConnectionHint": "Щоб почати, додайте своє перше підключення", "addConnection": "Додати підключення", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "ID моделі", "customModelPlaceholder": "напр. gpt-4.5-турбо", "loading": "Завантаження...", @@ -2513,6 +2931,10 @@ "email": "Електронна пошта", "healthCheckMinutes": "Перевірка стану (хв.)", "healthCheckHint": "Проактивний інтервал оновлення маркера. 0 = вимкнено.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Не вдалося перевірити з’єднання", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "embeddings": "Embeddings", - "hideEmails": "Hide all emails", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvSuccess": "OAuth defaults restored", - "repairEnvWorking": "Repairing...", - "audioTranscriptions": "Audio Transcriptions", - "selectAllModels": "Select all", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "imagesGenerations": "Images Generations", - "audioSpeech": "Audio Speech", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", - "repairEnvFailed": "Failed to repair .env", - "repairEnv": "Repair env", - "deselectAllModels": "Deselect all", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Пошук постачальників...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Налаштування", @@ -2739,6 +3153,7 @@ "requestBodyLimitSaving": "Saving...", "requestBodyLimitSave": "Save", "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Ціноутворення", "storage": "Зберігання", "policies": "політики", @@ -2749,6 +3164,46 @@ "enablePassword": "Увімкнути пароль", "darkMode": "Темний режим", "lightMode": "Світловий режим", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "тільки зараз", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Провайдери", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Тема системи", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2756,6 +3211,8 @@ "cacheTTL": "Кеш TTL", "maxCacheSize": "Максимальний розмір кешу", "clearCache": "Очистити кеш", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Звернення до кешу", "cacheMisses": "Промахи кешу", "hitRate": "Рейтинг попадань", @@ -2782,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Увімкнути мислення", "maxThinkingTokens": "Макс жетонів мислення", "enableProxy": "Увімкнути проксі", @@ -2818,6 +3277,14 @@ "themeLight": "світло", "themeDark": "Темний", "themeSystem": "система", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2899,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Вимагати ключ API для /models", "requireAuthModelsDesc": "Якщо ON, кінцева точка /v1/models повертає 404 для неавтентифікованих запитів. Запобігає виявленню моделі неавторизованими користувачами.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Заблоковані постачальники", "blockedProvidersDesc": "Приховати певних постачальників у відповіді /v1/models. Заблоковані постачальники не відображатимуться в списках моделей.", "providersBlocked": "{count} постачальник(ів) заблоковано для /models", @@ -2927,6 +3402,8 @@ "leastUsedDesc": "Виберіть нещодавно використовуваний обліковий запис", "costOpt": "Вартість Opt", "costOptDesc": "Віддайте перевагу найдешевшому доступному обліковому запису", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3018,6 +3495,8 @@ "comboStrategyAria": "Комбінована стратегія", "priority": "Пріоритет", "weighted": "Зважений", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Макс. повторних спроб", "retryDelayLabel": "Затримка повтору (мс)", "timeoutLabel": "Час очікування (мс)", @@ -3038,6 +3517,10 @@ "maxNestingDepth": "Максимальна глибина вкладення", "concurrencyPerModel": "Одночасність / Модель", "queueTimeout": "Час очікування черги (мс)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Профілі постачальників", "providerProfilesDesc": "Окремі параметри стійкості для постачальників OAuth (на основі сеансу) і ключа API (з вимірюванням). Постачальники OAuth мають суворіші порогові значення через нижчі обмеження швидкості.", "oauthProviders": "Постачальники OAuth", @@ -3113,7 +3596,6 @@ "backupCreated": "Створено резервну копію: {file}", "restoreSuccess": "Відновлено! {connections} підключень, {nodes} вузлів, {combos} комбо, {apiKeys} ключів API.", "importSuccess": "Базу даних імпортовано! {connections} підключень, {nodes} вузлів, {combos} комбо, {apiKeys} ключів API.", - "justNow": "тільки зараз", "minutesAgo": "{count}хв тому", "hoursAgo": "{count} год тому", "daysAgo": "{count} дн. тому", @@ -3128,7 +3610,6 @@ "errorDuringImport": "Під час імпорту сталася помилка", "modelPricing": "Модель ціноутворення", "modelPricingDesc": "Налаштуйте ставки витрат для моделі • Усі ставки в токенах $/1 млн", - "providers": "Провайдери", "registry": "Реєстр", "priced": "Ціна", "searchProvidersModels": "Пошук постачальників або моделей...", @@ -3170,47 +3651,6 @@ "editPricing": "Редагувати ціни", "viewFullDetails": "Переглянути повну інформацію", "themeCoral": "Корал", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3218,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3246,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayMaxMessages": "Max Messages For Summary", - "contextRelaySummaryModel": "Summary Model", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelayHandoffThreshold": "Handoff Threshold", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3295,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3312,6 +3762,7 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Конвертер форматів", "formatConverterDescription": "Вставте або введіть тіло запиту JSON. Перекладач автоматично визначить вихідний формат і перетворить його на цільовий формат. Використовуйте це, щоб налагодити, як OmniRoute перекладає запити між форматами (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Введення", "output": "Вихід", "auto": "Авто", @@ -3573,6 +4059,11 @@ "errorMessage": "Помилка: {message}", "requestFailed": "Запит не виконано", "noTextExtracted": "(Текст не витягнуто)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Показує події перекладу, коли виклики API проходять через OmniRoute. Події надходять із буфера в пам'яті (скидається під час перезавантаження). використання", "liveMonitorDescriptionSuffix": "або виклики зовнішнього API для створення подій." }, @@ -3648,14 +4139,25 @@ "passSuffix": "пропуск", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Запустіть Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Виконується {current}/{total}...", "passRate": "прохідний бал", "summaryBreakdown": "{passed} пройдено · {failed} не виконано · {total} всього", "passedIconLabel": "✅ Пройшли", "failedIconLabel": "❌ Не вдалося", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Містить: \"{term}\"", "detailsRegex": "Регулярний вираз: {pattern}", "detailsExpected": "Очікується: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Результатів ще немає", "testCasesCount": "Тестові випадки ({count})", "noTestCasesDefined": "Тестових випадків не визначено", @@ -3723,6 +4225,16 @@ "tierFree": "безкоштовно", "tierUnknown": "Невідомий", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,9 +4459,9 @@ "waitingForAntigravityAuthorization": "Очікування авторизації Antigravity...", "waitingForQoderAuthorization": "Очікування авторизації Qoder...", "exchangingCodeForTokens": "Обмін коду на токени...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "Документація", "quickStart": "Швидкий старт", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "особливості", "supportedProviders": "Підтримувані постачальники", "supportedProvidersToc": "Провайдери", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Встановіть базову URL-адресу клієнта", "quickStartStep4Prefix": "Наведіть свій клієнт IDE або API на", "quickStartStep4Suffix": "Використовуйте, наприклад, префікс провайдера", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Маршрутизація з кількома провайдерами", "featureRoutingText": "Направляйте запити до 30+ постачальників штучного інтелекту через єдину кінцеву точку, сумісну з OpenAI. Підтримує чат, відповіді, аудіо та API зображень.", "featureCombosTitle": "Комбо і балансування", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "використання", "clientClaudeBullet1Middle": "(Клод) або", "clientClaudeBullet1Suffix": "(Антигравітація) префікс.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Перед тестуванням із IDE або зовнішніх клієнтів скористайтеся інструментальною панеллю > Постачальники > Перевірити з’єднання.", "troubleshootingCircuitBreaker": "Якщо постачальник показує, що автоматичний вимикач розімкнуто, дочекайтеся охолодження або подробиці перевірте на сторінці «Стан».", "troubleshootingOAuth": "Для постачальників OAuth повторна автентифікація, якщо термін дії маркерів закінчився. Перевірте індикатор стану картки провайдера.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Політика конфіденційності", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Простий чат", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "cacheRateDesc": "of total requests", - "semanticCache": "Semantic Cache", - "cachedRequests24h": "Cached Requests (24h)", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "trendHour": "Hour", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "peakCacheRate": "Peak Cache Rate", - "activityVolume": "Activity", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "busiestHour": "Busiest Hour", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", - "hoursTracked": "hours tracked", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "lastUpdated": "Last updated", - "cacheRate": "Cache Rate", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/ur.json b/src/i18n/messages/ur.json index e2844cebaf..2a8afe0085 100644 --- a/src/i18n/messages/ur.json +++ b/src/i18n/messages/ur.json @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,6 +669,7 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Agents", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "Memory", "skills": "Skills", "docs": "Docs", @@ -675,6 +677,7 @@ "endpoints": "Endpoints", "apiManager": "API Manager", "logs": "Logs", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Audit Log", "shutdown": "Shutdown", "restart": "Restart", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -935,6 +1035,10 @@ "lastUsedOn": "Last: {date}", "editPermissions": "Edit permissions", "deleteKey": "Delete key", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} model", "models": "{count} models", "permissionsTitle": "Permissions: {name}", @@ -1347,6 +1451,7 @@ "allToolsTab": "All Tools", "guidedClientsTab": "Guided Clients", "mitmClientsTab": "MITM Clients", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "{count} tools available" }, @@ -1406,6 +1511,8 @@ "randomDesc": "Uniform random selection, then fallback to remaining models", "leastUsedDesc": "Picks the model with fewest requests, balancing load over time", "costOptimizedDesc": "Routes to the cheapest model first based on pricing", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Models", @@ -1464,6 +1571,11 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", @@ -1636,6 +1748,13 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", @@ -1788,7 +1907,12 @@ "agentFeaturesToolFilterRegex": "/regex-pattern/", "agentFeaturesToolFilterHint": "Tool filter regex for agents", "agentFeaturesContextCacheHint": "Enable in-context cache for agent tools", - "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations" + "agentFeaturesContextCacheProtection": "Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Costs", @@ -1820,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No cost data yet", "topModels": "Top Models", - "requestsInWindow": "Requests in Window" + "requestsInWindow": "Requests in Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "API Endpoint", @@ -1987,7 +2143,24 @@ "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", "tailscaleInstalling": "Installing", - "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)" + "tailscaleSudoLabel": "Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2265,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Limits & Quotas", "rateLimit": "Rate Limit", @@ -2331,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Welcome", @@ -2422,6 +2661,12 @@ "errorCount": "{count} Error ({code})", "errorCountNoCode": "{count} Error", "noConnections": "No connections", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Disabled", "enableProvider": "Enable provider", "disableProvider": "Disable provider", @@ -2728,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2738,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2793,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2869,9 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Settings", @@ -2884,6 +3137,23 @@ "systemPrompt": "System Prompt", "thinkingBudget": "Thinking Budget", "proxy": "Proxy", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Pricing", "storage": "Storage", "policies": "Policies", @@ -2969,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Enable Thinking", "maxThinkingTokens": "Max Thinking Tokens", "enableProxy": "Enable Proxy", @@ -3005,6 +3277,14 @@ "themeLight": "Light", "themeDark": "Dark", "themeSystem": "System", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter without disabling any features", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when all of its entries are hidden", @@ -3086,6 +3366,14 @@ "apiEndpointProtection": "API Endpoint Protection", "requireAuthModels": "Require API key for /models", "requireAuthModelsDesc": "When ON, the /v1/models endpoint returns 404 for unauthenticated requests. Prevents model discovery by unauthorized users.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Blocked Providers", "blockedProvidersDesc": "Hide specific providers from the /v1/models response. Blocked providers will not appear in model listings.", "providersBlocked": "{count} provider(s) blocked from /models", @@ -3114,6 +3402,8 @@ "leastUsedDesc": "Pick least recently used account", "costOpt": "Cost Opt", "costOptDesc": "Prefer cheapest available account", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Sticky Limit", @@ -3436,6 +3726,25 @@ "compressionModeLiteDesc": "Whitespace and blank line reduction", "compressionModeStandard": "Standard (Caveman)", "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeAggressive": "__MISSING__:Aggressive", + "compressionModeAggressiveDesc": "__MISSING__:Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeUltra": "__MISSING__:Ultra", + "compressionModeUltraDesc": "__MISSING__:Heuristic token pruning with optional local SLM fallback", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3453,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3509,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3524,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3575,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3622,6 +3929,28 @@ "errorShort": "ERR", "formatConverter": "Format Converter", "formatConverterDescription": "Paste or type a JSON request body. The translator will auto-detect the source format and convert it to the target format. Use this to debug how OmniRoute translates requests between formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "Input", "output": "Output", "auto": "Auto", @@ -3730,6 +4059,11 @@ "errorMessage": "Error: {message}", "requestFailed": "Request failed", "noTextExtracted": "(No text extracted)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Shows translation events as API calls flow through OmniRoute. Events come from the in-memory buffer (resets on restart). Use", "liveMonitorDescriptionSuffix": ", or external API calls to generate events." }, @@ -3805,14 +4139,25 @@ "passSuffix": "pass", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Run Eval", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Running {current}/{total}...", "passRate": "pass rate", "summaryBreakdown": "{passed} passed · {failed} failed · {total} total", "passedIconLabel": "✅ Passed", "failedIconLabel": "❌ Failed", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Contains: \"{term}\"", "detailsRegex": "Regex: {pattern}", "detailsExpected": "Expected: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "No results yet", "testCasesCount": "Test Cases ({count})", "noTestCasesDefined": "No test cases defined", @@ -3880,6 +4225,16 @@ "tierFree": "Free", "tierUnknown": "Unknown", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3922,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3935,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -4189,6 +4549,7 @@ "docs": { "title": "Documentation", "quickStart": "Quick Start", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Features", "supportedProviders": "Supported Providers", "supportedProvidersToc": "Providers", @@ -4225,6 +4586,20 @@ "quickStartStep4Title": "4. Set client base URL", "quickStartStep4Prefix": "Point your IDE or API client to", "quickStartStep4Suffix": "Use provider prefix, for example", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Multi-Provider Routing", "featureRoutingText": "Route requests to 30+ AI providers through a single OpenAI-compatible endpoint. Supports chat, responses, audio, and image APIs.", "featureCombosTitle": "Combos and Balancing", @@ -4356,6 +4731,10 @@ "mcpToolsOperationsDesc": "Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", "mcpToolsCacheTitle": "Cache Management", "mcpToolsCacheDesc": "View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", "mcpToolsMemoryTitle": "Memory", "mcpToolsMemoryDesc": "Search, add, and clear persistent conversational memory entries.", "mcpToolsSkillsTitle": "Skills", @@ -4374,9 +4753,7 @@ "protocolAcpDesc": "Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", "protocolAcpStep1": "Navigate to Dashboard → Agents to view registered ACP agents.", "protocolAcpStep2": "Register new agents with capabilities and endpoint configuration.", - "protocolAcpStep3": "Use CLI Tools to configure agent communication channels.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "protocolAcpStep3": "Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Privacy Policy", @@ -4480,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Simple Chat", @@ -4617,7 +5050,32 @@ "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, "proxyConfigModal": { "levelGlobal": "Global", @@ -4778,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}ms", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, "playground": { "title": "Model Playground", @@ -4827,6 +5304,8 @@ "pipelineLogsOn": "Pipeline logs on", "pipelineLogsOff": "Pipeline logs off", "updatingPipelineLogs": "Updating pipeline logs...", + "updatePipelineFailed": "Failed to update pipeline logging", + "capturePipeline": "Capture pipeline payloads for new requests", "searchPlaceholder": "Search models, providers, accounts, API keys, combos...", "allProviders": "All providers", "allModels": "All models", @@ -4848,6 +5327,17 @@ "sortStatusAsc": "Status ↑", "sortModelAsc": "Model A-Z", "sortModelDesc": "Model Z-A", + "sortLogs": "Sort logs", + "refresh": "Refresh", + "columnsLabel": "Columns", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic", + "upstream": "Upstream", + "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", + "upstreamResponse": "Upstream provider response", + "noApiKey": "No API key", + "requestedRoutedTitle": "Requested {requested}, routed as {routed}", "statusFilters": { "all": "All", "error": "Error", @@ -4865,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4872,40 +5363,7 @@ "loadingLogs": "Loading logs...", "noLogs": "No logs yet. Make some API calls to see them here.", "noMatchingLogs": "No logs matching current filters.", - "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}.", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" - }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" - }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "callLogsInfo": "Call logs are also saved as JSON files to {dataDir} and rotated based on {retentionDays} and {maxEntries}." }, "proxyLogger": { "filterAll": "All", @@ -4944,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/vi.json b/src/i18n/messages/vi.json index 221a85193e..e7acba5a9c 100644 --- a/src/i18n/messages/vi.json +++ b/src/i18n/messages/vi.json @@ -23,6 +23,7 @@ "active": "Đang hoạt động", "inactive": "Không hoạt động", "noData": "Không có sẵn dữ liệu", + "nothingHere": "Nothing here yet", "configure": "Cấu hình", "manage": "Quản lý", "name": "Tên", @@ -137,9 +138,8 @@ "Failed to reset pricing": "Không thể đặt lại giá", "apikey": "Khóa API", "http": "HTTP", - "nothingHere": "Nothing here yet", - "checkSystemStatus": "Check System Status", "goToDashboard": "Go to Dashboard", + "checkSystemStatus": "Check System Status", "selectModel": "Select Model", "combos": "Combos", "noModelsFound": "No models found", @@ -158,6 +158,7 @@ "noLockouts": "No Lockouts", "webSearchDesc": "Web Search Desc", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "minutesAgo": "Minutes Ago", "a": "A", "liveAutoRefreshing": "Live Auto Refreshing", @@ -668,11 +669,15 @@ "playground": "Playground", "searchTools": "Search Tools", "agents": "Tác nhân", + "cloudAgents": "__MISSING__:Cloud Agents", + "memory": "Memory", + "skills": "Skills", "docs": "Tài liệu", "issues": "vấn đề", "endpoints": "Điểm cuối", "apiManager": "Trình quản lý API", "logs": "Nhật ký", + "webhooks": "__MISSING__:Webhooks", "auditLog": "Nhật ký kiểm tra", "shutdown": "Tắt máy", "restart": "Khởi động lại", @@ -705,8 +710,6 @@ "cliToolsShort": "Công cụ", "cache": "Cache", "cacheShort": "Cache", - "memory": "Memory", - "skills": "Skills", "batch": "Batch Jobs", "themeSystem": "Theme System", "whitelabelingDesc": "Whitelabeling Desc", @@ -742,6 +745,103 @@ "contextRtk": "RTK", "contextCombos": "Compression Combos" }, + "webhooks": { + "title": "__MISSING__:Webhooks", + "description": "__MISSING__:Configure HTTP callbacks for system events.", + "configuredWebhooks": "__MISSING__:Configured Webhooks", + "configuredWebhooksDesc": "__MISSING__:Manage delivery endpoints, subscribed events, status, and test sends.", + "addWebhook": "__MISSING__:Add Webhook", + "editWebhook": "__MISSING__:Edit Webhook", + "name": "__MISSING__:Name", + "namePlaceholder": "__MISSING__:Production monitoring", + "unnamedWebhook": "__MISSING__:Unnamed webhook", + "url": "__MISSING__:Endpoint URL", + "events": "__MISSING__:Events", + "allEvents": "__MISSING__:All events", + "secret": "__MISSING__:Secret", + "secretPlaceholder": "__MISSING__:Leave blank to auto-generate a secret", + "secretEditPlaceholder": "__MISSING__:Leave blank to keep the current secret", + "status": "__MISSING__:Status", + "active": "__MISSING__:Active", + "inactive": "__MISSING__:Inactive", + "errored": "__MISSING__:Errored", + "total": "__MISSING__:Total", + "lastTriggered": "__MISSING__:Last Triggered", + "actions": "__MISSING__:Actions", + "enabled": "__MISSING__:Enabled", + "enabledDesc": "__MISSING__:Disabled webhooks remain saved but do not receive deliveries.", + "refresh": "__MISSING__:Refresh", + "loading": "__MISSING__:Loading webhooks...", + "never": "__MISSING__:Never", + "failureCount": "__MISSING__:{count, plural, =0 {no failures} one {# failure} other {# failures}}", + "testWebhook": "__MISSING__:Send Test", + "testSuccess": "__MISSING__:Test webhook sent successfully.", + "testFailed": "__MISSING__:Test webhook failed.", + "saveSuccess": "__MISSING__:Webhook saved successfully.", + "saveFailed": "__MISSING__:Failed to save webhook.", + "loadFailed": "__MISSING__:Failed to load webhooks.", + "delete": "__MISSING__:Delete", + "deleteConfirm": "__MISSING__:Are you sure you want to delete this webhook?", + "deleteSuccess": "__MISSING__:Webhook deleted successfully.", + "deleteFailed": "__MISSING__:Failed to delete webhook.", + "edit": "__MISSING__:Edit", + "enable": "__MISSING__:Enable", + "disable": "__MISSING__:Disable", + "noWebhooks": "__MISSING__:No webhooks configured yet.", + "signatureTitle": "__MISSING__:Webhook Signatures", + "signatureDescription": "__MISSING__:Each delivery includes an X-Webhook-Signature header signed with HMAC-SHA256 using the webhook secret. Verify the signature before trusting the payload." + }, + "compliance": { + "auditTitle": "__MISSING__:Audit", + "auditDescription": "__MISSING__:Review compliance events and MCP tool calls from one operational view.", + "complianceTab": "__MISSING__:Compliance", + "mcpTab": "__MISSING__:MCP Audit", + "title": "__MISSING__:Compliance Audit", + "description": "__MISSING__:Policy, access, provider, and security events recorded by the compliance audit log.", + "eventType": "__MISSING__:Event Type", + "eventTypePlaceholder": "__MISSING__:Filter by action or event type", + "severity": "__MISSING__:Severity", + "allSeverities": "__MISSING__:All severities", + "info": "__MISSING__:Info", + "warning": "__MISSING__:Warning", + "critical": "__MISSING__:Critical", + "sourceIp": "__MISSING__:Source IP", + "userOrKey": "__MISSING__:User / Key", + "action": "__MISSING__:Action", + "result": "__MISSING__:Result", + "details": "__MISSING__:Details", + "timestamp": "__MISSING__:Timestamp", + "from": "__MISSING__:From", + "to": "__MISSING__:To", + "refresh": "__MISSING__:Refresh", + "export": "__MISSING__:Export", + "clearFilters": "__MISSING__:Clear filters", + "loading": "__MISSING__:Loading audit events...", + "showing": "__MISSING__:Showing {count} of {total} events", + "policyViolation": "__MISSING__:Policy Violation", + "accessDenied": "__MISSING__:Access Denied", + "injectionBlocked": "__MISSING__:Injection Blocked", + "noEvents": "__MISSING__:No compliance events recorded.", + "failedFetch": "__MISSING__:Failed to fetch compliance audit log.", + "viewDetails": "__MISSING__:View details", + "closeDetails": "__MISSING__:Close details", + "notAvailable": "__MISSING__:—", + "system": "__MISSING__:system", + "previous": "__MISSING__:Previous", + "next": "__MISSING__:Next", + "mcpAudit": "__MISSING__:MCP Audit", + "mcpAuditDesc": "__MISSING__:Tool call audit entries recorded by the MCP server.", + "failedFetchMcpAudit": "__MISSING__:Failed to fetch MCP audit log.", + "tool": "__MISSING__:Tool", + "toolPlaceholder": "__MISSING__:Filter by tool name", + "duration": "__MISSING__:Duration", + "apiKey": "__MISSING__:API Key", + "output": "__MISSING__:Output", + "allResults": "__MISSING__:All results", + "success": "__MISSING__:Success", + "failure": "__MISSING__:Failure", + "noMcpEvents": "__MISSING__:No MCP audit events recorded." + }, "themesPage": { "title": "Themes", "description": "Choose a preset theme or create your own with a single color", @@ -826,6 +926,10 @@ "evals": "Đánh giá", "utilization": "Tỷ lệ sử dụng", "utilizationDescription": "Xu hướng sử dụng hạn ngạch nhà cung cấp và theo dõi giới hạn tốc độ", + "modelStatus": "__MISSING__:Model Status", + "modelStatusCooldown": "__MISSING__:Cooldown", + "modelStatusUnavailable": "__MISSING__:Unavailable", + "modelStatusError": "__MISSING__:Error", "comboHealth": "Sức khỏe Combo", "comboHealthDescription": "Hạn ngạch cấp combo, phân phối sử dụng và số liệu hiệu suất", "compressionAnalyticsTitle": "Compression Analytics", @@ -931,6 +1035,10 @@ "lastUsedOn": "Cuối cùng: {date}", "editPermissions": "Chỉnh sửa quyền", "deleteKey": "Xóa phím", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} mô hình", "models": "{count} mô hình", "permissionsTitle": "Quyền: {name}", @@ -1188,11 +1296,13 @@ "continue": "Sử dụng khi chạy Tiếp tục trong IDE và bạn cần cấu hình nhà cung cấp dựa trên JSON di động.", "opencode": "Sử dụng khi bạn thích chạy tác nhân gốc trên thiết bị đầu cuối và tự động hóa theo kịch bản thông qua OpenCode.", "kiro": "Sử dụng khi tích hợp Kiro và điều khiển định tuyến mô hình tập trung từ OmniRoute.", + "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "antigravity": "Sử dụng khi lưu lượng truy cập AntiGravity/Kiro phải bị chặn thông qua MITM và được định tuyến đến OmniRoute.", "copilot": "Sử dụng khi bạn muốn UX kiểu trò chuyện Copilot trong khi thực thi các khóa OmniRoute và quy tắc định tuyến.", - "windsurf": "Use when you want an AI-first IDE with Codeium/Windsurf models routed through OmniRoute.", "amp": "Use when you want Amp CLI routed through OmniRoute with stable shorthand aliases and OpenAI-compatible setup.", - "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access." + "qwen": "Use when you want Qwen Code CLI with OmniRoute-managed provider settings and multi-provider model access.", + "hermes": "__MISSING__:Use when you need a lightweight terminal-native AI assistant for quick tasks.", + "custom": "__MISSING__:Use for custom tool implementations or generic OpenAI-compatible configurations." }, "toolDescriptions": { "antigravity": "IDE chống trọng lực của Google với MITM", @@ -1209,7 +1319,9 @@ "windsurf": "Windsurf AI Code Editor", "copilot": "GitHub Copilot AI Assistant", "qwen": "Alibaba Qwen Code CLI", - "amp": "Sourcegraph Amp coding assistant CLI" + "amp": "Sourcegraph Amp coding assistant CLI", + "hermes": "__MISSING__:Hermes AI Terminal Assistant", + "custom": "__MISSING__:Generic OpenAI-compatible CLI or SDK configuration generator" }, "guides": { "cursor": { @@ -1339,6 +1451,7 @@ "allToolsTab": "All Tools Tab", "guidedClientsTab": "Guided Clients Tab", "mitmClientsTab": "Mitm Clients Tab", + "customCliTab": "__MISSING__:Custom CLI", "toolCategories": "Tool Categories", "visibleToolsCount": "Visible Tools Count" }, @@ -1393,9 +1506,13 @@ "priorityDesc": "Dự phòng tuần tự: thử mô hình 1 trước, sau đó đến mô hình 2, v.v.", "weightedDesc": "Phân phối lưu lượng truy cập theo phần trăm trọng lượng với dự phòng", "roundRobinDesc": "Phân phối vòng tròn: mỗi yêu cầu sẽ chuyển sang mô hình tiếp theo trong vòng quay", + "contextRelay": "Context Relay", + "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", "randomDesc": "Lựa chọn ngẫu nhiên thống nhất, sau đó dự phòng cho các mô hình còn lại", "leastUsedDesc": "Chọn mô hình có ít yêu cầu nhất, cân bằng tải theo thời gian", "costOptimizedDesc": "Hướng tới mô hình rẻ nhất trước tiên dựa trên giá cả", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each model once before reshuffling", "models": "Người mẫu", @@ -1404,6 +1521,13 @@ "retryDelay": "Độ trễ thử lại (ms)", "concurrencyPerModel": "Đồng thời / Mô hình", "queueTimeout": "Hết thời gian xếp hàng (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", + "contextRelaySummaryModel": "Summary Model", + "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", "advancedHint": "Để trống để sử dụng mặc định chung. Những cài đặt này ghi đè lên mỗi nhà cung cấp.", "moveUp": "Di chuyển lên", "moveDown": "Di chuyển xuống", @@ -1447,20 +1571,45 @@ "avoid": "Pricing data is missing or outdated.", "example": "Background or batch jobs where lower cost is preferred." }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "Use when you want perfectly even spread — each model used once before repeating.", "avoid": "Avoid when models have different quality or latency and order matters.", "example": "Example: Multiple accounts of the same model to distribute usage evenly." }, "p2c": { - "example": "Example: High-throughput inference across 4+ equivalent model endpoints.", "when": "Use when you want low-latency selection using Power-of-Two-Choices algorithm.", - "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin." + "avoid": "Avoid for small combos with 2 or fewer models — no benefit over round-robin.", + "example": "Example: High-throughput inference across 4+ equivalent model endpoints." }, "context-relay": { - "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion.", + "when": "Use when long sessions must survive account rotation without losing the working context.", "avoid": "Avoid when account switching is rare or when you do not want extra summarization requests.", - "when": "Use when long sessions must survive account rotation without losing the working context." + "example": "Example: Codex sessions that rotate across multiple accounts near quota exhaustion." + }, + "fill-first": { + "when": "__MISSING__:Use when you want to fully exhaust one provider's quota before moving to the next.", + "avoid": "__MISSING__:Avoid when you need request-level load balancing across providers.", + "example": "__MISSING__:Example: Use all $200 Deepgram credits before falling back to Groq." + }, + "auto": { + "when": "__MISSING__:Use when you need multi-factor scoring routing based on cost, latency, and quality.", + "avoid": "__MISSING__:Avoid when you need strict priority ordering or historical persistence.", + "example": "__MISSING__:Example: Balance requests across models with different strengths." + }, + "lkgp": { + "when": "__MISSING__:Use when you want to route based on historical success rates and performance.", + "avoid": "__MISSING__:Avoid when historical data is limited or unreliable.", + "example": "__MISSING__:Example: Route to models with a good track record on specific tasks." + }, + "context-optimized": { + "when": "__MISSING__:Use when you need to optimize context window usage across models.", + "avoid": "__MISSING__:Avoid when models have similar context lengths or tasks are simple.", + "example": "__MISSING__:Example: Distribute long conversations across models with larger context windows." } }, "advancedHelp": { @@ -1495,6 +1644,12 @@ "warningRoundRobinSingleModel": "Round-robin is most useful with at least 2 models.", "warningCostOptimizedPartialPricing": "Only {priced} of {total} models have pricing. Routing may be partially cost-aware.", "warningCostOptimizedNoPricing": "No pricing data found for this combo. Cost-optimized may route unexpectedly.", + "filterAll": "All", + "filterIntelligent": "Intelligent", + "filterDeterministic": "Deterministic", + "filterEmptyTitle": "No combos match this strategy filter.", + "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", + "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", "readinessTitle": "Sẵn sàng để lưu?", "readinessDescription": "Xem lại danh sách kiểm tra trước khi tạo hoặc cập nhật kết hợp này.", "readinessCheckName": "Tên kết hợp là hợp lệ", @@ -1512,6 +1667,44 @@ "applyRecommendations": "Apply recommendations", "recommendationsUpdated": "Recommendations updated for {strategy}.", "recommendationsApplied": "Recommendations applied to this combo.", + "intelligentPanelTitle": "Intelligent Routing Dashboard", + "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", + "statusOverview": "Status Overview", + "normalOperation": "Normal Operation", + "allProvidersHealthy": "Providers are reporting healthy routing conditions.", + "incidentMode": "Incident Mode", + "highCircuitBreakerRate": "High circuit breaker trip rate detected.", + "activeModePack": "Active Mode Pack", + "modePackUpdated": "Mode pack updated to {pack}.", + "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", + "providerScores": "Provider Scores", + "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", + "excludedProviders": "Excluded Providers", + "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", + "noExcludedProviders": "No providers are currently excluded.", + "cooldownMinutes": "Cooldown: {minutes}m", + "builderIntelligentTitle": "Intelligent Routing Configuration", + "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", + "candidatePoolLabel": "Candidate Pool", + "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", + "candidatePoolEmpty": "No active providers available yet.", + "candidatePoolAllProviders": "All providers", + "modePackLabel": "Mode Pack", + "routerStrategyLabel": "Router Strategy", + "strategyRules": "Rules (6-Factor Scoring)", + "explorationRateLabel": "Exploration Rate", + "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", + "budgetCapLabel": "Budget Cap (USD / request)", + "budgetCapPlaceholder": "No limit", + "advancedWeightsTitle": "Advanced: Scoring Weights", + "weightQuota": "Quota", + "weightHealth": "Health", + "weightCostInv": "Cost", + "weightLatencyInv": "Latency", + "weightTaskFit": "Task Fit", + "weightStability": "Stability", + "weightTierPriority": "Tier", + "reviewIntelligentTitle": "Intelligent Routing Config", "strategyRecommendations": { "priority": { "title": "Fail-safe baseline", @@ -1555,12 +1748,61 @@ "tip2": "Keep a quality fallback for hard prompts.", "tip3": "Use for batch/background jobs where cost is the main KPI." }, + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." + }, "strict-random": { "title": "Shuffle deck distribution", "description": "Each model is used exactly once per cycle before reshuffling.", "tip1": "Use at least 2 models for meaningful distribution.", "tip2": "Works best with equivalent-performance models.", "tip3": "Ideal for load balancing across multiple API accounts." + }, + "fill-first": { + "description": "__MISSING__:Exhaust provider quotas sequentially before falling back.", + "tip1": "__MISSING__:Use for quota-based routing with clear fallback chains.", + "tip2": "__MISSING__:Set quotas accurately to avoid premature fallback.", + "tip3": "__MISSING__:Works best with providers offering free tiers or credit buckets.", + "title": "__MISSING__:Quota Exhaustion" + }, + "auto": { + "description": "__MISSING__:Route based on real-time scoring for cost, latency, quality, and health.", + "tip1": "__MISSING__:Let the engine balance multiple factors automatically.", + "tip2": "__MISSING__:Monitor which factors drive routing decisions in logs.", + "tip3": "__MISSING__:Use for complex workloads where no single factor dominates.", + "title": "__MISSING__:Multi-Factor Optimization" + }, + "lkgp": { + "description": "__MISSING__:Route based on historical performance and success patterns.", + "tip1": "__MISSING__:Requires sufficient request history for accurate predictions.", + "tip2": "__MISSING__:Good for workloads with consistent model performance patterns.", + "tip3": "__MISSING__:Monitor prediction accuracy and adjust weights as needed.", + "title": "__MISSING__:History-Based Routing" + }, + "context-optimized": { + "description": "__MISSING__:Optimize routing based on context window usage and token efficiency.", + "tip1": "__MISSING__:Route long conversations to models with larger context windows.", + "tip2": "__MISSING__:Monitor context utilization to avoid token waste.", + "tip3": "__MISSING__:Best for conversational AI requiring extensive context retention.", + "title": "__MISSING__:Context Optimization" + }, + "context-relay": { + "description": "__MISSING__:Best when account rotation is expected and the next account must inherit a simplified task summary.", + "tip1": "__MISSING__:Use with providers rotating accounts for the same model family.", + "tip2": "__MISSING__:Set handoff threshold below hard quota cutoffs for summary generation time.", + "tip3": "__MISSING__:Only set a dedicated summary model if the primary is too expensive or unstable.", + "title": "__MISSING__:Session Continuity Priority" + }, + "p2c": { + "description": "__MISSING__:Route to the provider with the lowest current load based on real-time metrics.", + "tip1": "__MISSING__:Monitor provider health metrics for accurate load assessment.", + "tip2": "__MISSING__:Works best with homogeneous provider pools.", + "tip3": "__MISSING__:Adjust sensitivity to avoid oscillation during traffic spikes.", + "title": "__MISSING__:Power of Two Choices" } }, "templateFreeStack": "Free Stack ($0)", @@ -1581,125 +1823,111 @@ "wizardStep3Desc": "Pick how requests are distributed across your models - 13 strategies available", "wizardStep4Title": "Review & Save", "wizardStep4Desc": "Review your configuration and activate the combo", - "reviewProviders": "Providers", + "emailVisibilityStateOn": "On", + "emailVisibilityStateOff": "Off", + "reorderHandle": "Drag to reorder", + "failedReorder": "Failed to reorder models", + "builderFlowTitle": "Combo Builder Flow", "builderStage": { "basics": { "label": "Basics", "description": "Name and starting template" }, "steps": { - "description": "Provider, model, and account selection", - "label": "Steps" + "label": "Steps", + "description": "Provider, model, and account selection" }, "strategy": { - "description": "Routing behavior and advanced settings", - "label": "Strategy" + "label": "Strategy", + "description": "Routing behavior and advanced settings" + }, + "intelligent": { + "label": "Smart Routing", + "description": "Auto-routing candidate pool, presets, and scoring" }, "review": { "label": "Review", "description": "Final validation before saving" - }, - "intelligent": { - "description": "Auto-routing candidate pool, presets, and scoring", - "label": "Smart Routing" } }, - "filterAll": "All", - "advancedWeightsTitle": "Advanced: Scoring Weights", - "providerScores": "Provider Scores", - "explorationRateLabel": "Exploration Rate", - "intelligentPanelTitle": "Intelligent Routing Dashboard", - "emailVisibilityStateOff": "Off", - "builderSelectProvider": "Select provider", - "filterIntelligent": "Intelligent", - "modePackUpdated": "Mode pack updated to {pack}.", - "activeModePack": "Active Mode Pack", - "weightStability": "Stability", - "contextRelay": "Context Relay", - "candidatePoolEmpty": "No active providers available yet.", - "emailVisibilityStateOn": "On", - "builderComboRef": "Combo Ref", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex account rotation. Pair it with multiple accounts of the same provider for the best continuity.", - "builderAccount": "Account", - "normalOperation": "Normal Operation", - "builderStageCurrent": "Current stage", - "failedReorder": "Failed to reorder models", - "weightQuota": "Quota", - "filterDeterministic": "Deterministic", - "contextRelayHandoffThresholdHelp": "When quota usage reaches this threshold, OmniRoute generates a structured handoff summary before the active account is exhausted.", - "builderSelectModel": "Select model", - "filterEmptyIntelligentDescription": "Create an auto or LKGP combo to populate the intelligent routing dashboard.", - "strategyRules": "Rules (6-Factor Scoring)", - "builderPinnedAccount": "Pinned Account", - "filterEmptyDeterministicDescription": "Only auto and LKGP combos exist right now. Switch back to All or create a deterministic combo.", - "candidatePoolHint": "Select which providers this engine should evaluate. Leave empty to use all active providers.", - "builderStagePending": "Pending", - "builderLoadingProviders": "Loading providers...", - "excludedProviders": "Excluded Providers", - "budgetCapLabel": "Budget Cap (USD / request)", - "contextRelaySummaryModel": "Summary Model", - "intelligentPanelDesc": "Real-time scoring and health status for this auto-routing combo.", - "reviewAdvanced": "Advanced Settings", - "reviewComboRefs": "Combo References", - "reviewNoSteps": "No steps configured", - "reviewSteps": "Steps", - "statusOverview": "Status Overview", - "builderFlowTitle": "Combo Builder Flow", - "allProvidersEvaluated": "No candidate pool configured. All active providers are evaluated at runtime.", - "contextRelayMaxMessages": "Max Messages For Summary", - "reorderHandle": "Drag to reorder", - "weightCostInv": "Cost", - "builderStageLocked": "Locked — complete previous stage first", - "candidatePoolLabel": "Candidate Pool", - "weightTaskFit": "Task Fit", - "weightLatencyInv": "Latency", - "reviewAccounts": "Accounts", - "allProvidersHealthy": "Providers are reporting healthy routing conditions.", - "builderIntelligentTitle": "Intelligent Routing Configuration", - "modePackLabel": "Mode Pack", - "explorationRateHint": "{percent}% of requests can explore non-optimal providers.", - "routerStrategyLabel": "Router Strategy", "builderStageVisited": "Stage completed", - "candidatePoolAllProviders": "All providers", - "contextRelayMaxMessagesHelp": "Limits how much recent history is condensed into the relay summary.", - "builderModel": "Model", - "builderBrowseCatalog": "Browse catalog", - "builderPreview": "Preview", - "budgetCapPlaceholder": "No limit", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayDesc": "Preserves session continuity with handoff summaries when accounts rotate", - "reviewName": "Name", - "cooldownMinutes": "Cooldown: {minutes}m", - "builderProviderFirst": "Pick provider first", - "reviewIntelligentTitle": "Intelligent Routing Config", - "incidentMode": "Incident Mode", - "excludedProvidersHint": "Providers with an OPEN circuit breaker are temporarily excluded from routing.", - "highCircuitBreakerRate": "High circuit breaker trip rate detected.", - "contextRelaySummaryModelHelp": "Optional override model used only for generating the handoff summary. Leave empty to reuse the active combo model.", - "weightHealth": "Health", - "builderAddComboRef": "Add combo reference", - "reviewAgentFlags": "Agent Flags", - "modePackHint": "Switch presets to bias the routing engine without rebuilding the combo.", - "builderIntelligentDesc": "Configure the multi-factor scoring engine for this auto-routing combo.", - "weightTierPriority": "Tier", - "builderLegacyEntry": "Legacy entry", - "builderAddStep": "Add step", - "noExcludedProviders": "No providers are currently excluded.", + "builderStageCurrent": "Current stage", + "builderStagePending": "Pending", + "builderStageLocked": "Locked — complete previous stage first", "builderTitle": "Build a Combo", + "builderBrowseCatalog": "Browse catalog", "builderProvider": "Provider", - "reviewSequence": "Model Sequence", - "reviewStrategy": "Strategy", + "builderLoadingProviders": "Loading providers...", + "builderSelectProvider": "Select provider", + "builderModel": "Model", + "builderSelectModel": "Select model", + "builderProviderFirst": "Pick provider first", + "builderAccount": "Account", + "builderPreview": "Preview", + "builderAddStep": "Add step", + "builderDuplicateExact": "__MISSING__:This exact provider/model/account step is already in the combo.", + "builderComboRef": "Combo Ref", + "builderAddComboRef": "Add combo reference", "builderComboRefStep": "Add combo reference", - "filterEmptyTitle": "No combos match this strategy filter." + "builderPinnedAccount": "Pinned Account", + "builderLegacyEntry": "Legacy entry", + "reviewName": "Name", + "reviewStrategy": "Strategy", + "reviewSteps": "Steps", + "reviewAccounts": "Accounts", + "reviewProviders": "Providers", + "reviewComboRefs": "Combo References", + "reviewAdvanced": "Advanced Settings", + "reviewAgentFlags": "Agent Flags", + "reviewSequence": "Model Sequence", + "reviewNoSteps": "No steps configured", + "builderStagesDescription": "__MISSING__:Complete each stage in order to define combos, build steps, select routing strategy, and review results.", + "builderStepsDescription": "__MISSING__:Build each combo step in order: provider, model, then account. This allows reusing the same provider and model across different accounts.", + "selectProvider": "__MISSING__:Select Provider", + "selectProviderPlaceholder": "__MISSING__:Select a provider", + "selectModel": "__MISSING__:Select Model", + "selectModelPlaceholder": "__MISSING__:Select a provider first", + "selectAccount": "__MISSING__:Select Account", + "selectComboToReference": "__MISSING__:Select combo to reference", + "comboReference": "__MISSING__:Combo Reference", + "addComboReference": "__MISSING__:Add Combo Reference", + "addStepBeforeContinue": "__MISSING__:Please add at least one step before proceeding to the next stage.", + "previewNextStep": "__MISSING__:Preview next step", + "autoSelectAccount": "__MISSING__:Automatically select account at runtime", + "modePackBalanced": "__MISSING__:Balanced", + "modePackBudget": "__MISSING__:Budget", + "modePackPerformance": "__MISSING__:Performance", + "modePackCustom": "__MISSING__:Custom", + "browseLegacyCatalog": "__MISSING__:Browse legacy combo catalog", + "agentFeaturesTitle": "__MISSING__:Agent Features", + "agentFeaturesDescription": "__MISSING__:Enable advanced features for agents using this combo", + "agentFeaturesSystemMessageOverride": "__MISSING__:Override system message", + "agentFeaturesSystemMessagePlaceholder": "__MISSING__:You are an expert assistant...", + "agentFeaturesSystemMessageHint": "__MISSING__:System message override for agents", + "agentFeaturesToolFilterRegex": "__MISSING__:/regex-pattern/", + "agentFeaturesToolFilterHint": "__MISSING__:Tool filter regex for agents", + "agentFeaturesContextCacheHint": "__MISSING__:Enable in-context cache for agent tools", + "agentFeaturesContextCacheProtection": "__MISSING__:Protect cache from agent tool mutations", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "Chi phí", + "pageDescription": "__MISSING__:Track spending, analyze trends, and manage your AI budget across all providers", + "overview": "__MISSING__:Overview", "budget": "Ngân sách", "totalCost": "Tổng chi phí", "breakdown": "Phân tích chi phí", "noData": "Không có dữ liệu chi phí", "byModel": "Theo mẫu", "byProvider": "Theo nhà cung cấp", + "range7d": "__MISSING__:7 Days", + "range30d": "__MISSING__:30 Days", + "range90d": "__MISSING__:90 Days", + "rangeAll": "__MISSING__:All Time", "spend30d": "Spend30D", "activeModels": "Active Models", "selectedWindow": "Selected Window", @@ -1716,7 +1944,39 @@ "costTrend": "Cost Trend", "noCostDataTitle": "No Cost Data Title", "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "requestsInWindow": "Requests In Window", + "tokenUsage": "__MISSING__:Token Usage", + "totalTokens": "__MISSING__:Total Tokens", + "inputTokens": "__MISSING__:Input Tokens", + "outputTokens": "__MISSING__:Output Tokens", + "inputOutputRatio": "__MISSING__:Input/Output Ratio", + "tokens": "__MISSING__:tokens", + "routingEfficiency": "__MISSING__:Routing Efficiency", + "fallbackCount": "__MISSING__:Fallback Requests", + "fallbackRate": "__MISSING__:Fallback Rate", + "modelCoverage": "__MISSING__:Model Coverage", + "modelCoverageDesc": "__MISSING__:% of requests with explicit model", + "outOfRequests": "__MISSING__:out of {total} requests", + "costByApiKey": "__MISSING__:Cost by API Key", + "costByAccount": "__MISSING__:Cost by Account", + "apiKeyName": "__MISSING__:API Key", + "account": "__MISSING__:Account", + "requests": "__MISSING__:Requests", + "cost": "__MISSING__:Cost", + "dayStreak": "__MISSING__:day streak", + "weeklyUsagePattern": "__MISSING__:Weekly Usage Pattern", + "activityHeatmap": "__MISSING__:Activity (365 days)", + "less": "__MISSING__:Less", + "more": "__MISSING__:More", + "monthlyForecast": "__MISSING__:Monthly Forecast", + "forecastBasis": "__MISSING__:Based on last {days} days", + "avgDailyCost": "__MISSING__:Avg. daily cost", + "daysRemaining": "__MISSING__:{days} days remaining", + "periodComparison": "__MISSING__:Period Comparison", + "previousPeriod": "__MISSING__:Previous Half", + "currentPeriod": "__MISSING__:Current Half", + "exportCSV": "__MISSING__:Export as CSV", + "exportJSON": "__MISSING__:Export as JSON" }, "endpoint": { "title": "Điểm cuối API", @@ -1747,6 +2007,8 @@ "audioTranscriptionDesc": "Phiên âm tập tin âm thanh thành văn bản (Whisper)", "textToSpeech": "Chuyển văn bản thành giọng nói", "textToSpeechDesc": "Chuyển đổi văn bản thành giọng nói tự nhiên", + "musicGeneration": "Music Generation", + "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "moderations": "Kiểm duyệt", "moderationsDesc": "Kiểm duyệt nội dung và phân loại an toàn", "responsesDesc": "API Responses của OpenAI cho Codex và quy trình làm việc tác tử nâng cao", @@ -1847,8 +2109,6 @@ "a2aQuickStartStep3": "Track and control tasks using `tasks/get` and `tasks/cancel`.", "completionsLegacy": "Completions (Legacy)", "completionsLegacyDesc": "Legacy OpenAI text completions — accepts both prompt string and messages array format", - "musicGeneration": "Music Generation", - "musicDesc": "Generate music and audio tracks via ComfyUI (Stable Audio, MusicGen)", "videoGeneration": "Video Generation", "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", "tailscaleRequestFailed": "Failed to load Tailscale status", @@ -1882,7 +2142,25 @@ "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleInstalling": "Installing", + "tailscaleSudoLabel": "__MISSING__:Sudo Password (required on macOS/Linux)", + "ngrokTitle": "__MISSING__:ngrok Tunnel", + "ngrokRunning": "__MISSING__:Running", + "ngrokStarting": "__MISSING__:Starting", + "ngrokStoppedState": "__MISSING__:Stopped", + "ngrokNeedsAuth": "__MISSING__:Needs Auth", + "ngrokNotInstalled": "__MISSING__:Not installed", + "ngrokUnsupported": "__MISSING__:Unsupported", + "ngrokError": "__MISSING__:Error", + "ngrokEnable": "__MISSING__:Enable Tunnel", + "ngrokDisable": "__MISSING__:Stop Tunnel", + "ngrokUrlNotice": "__MISSING__:Creates a public ngrok tunnel.", + "ngrokAuthTokenLabel": "__MISSING__:Authtoken (Required if NGROK_AUTHTOKEN not set)", + "ngrokAuthTokenPlaceholder": "__MISSING__:Enter your ngrok authtoken", + "ngrokLastError": "__MISSING__:Last error: {error}", + "ngrokStarted": "__MISSING__:ngrok tunnel started", + "ngrokStopped": "__MISSING__:ngrok tunnel stopped", + "ngrokRequestFailed": "__MISSING__:Failed to update ngrok tunnel" }, "endpoints": { "tabProxy": "Endpoint Proxy", @@ -2026,6 +2304,61 @@ "limit": "Limit", "skill": "Skill" }, + "memory": { + "title": "Memory Management", + "description": "View and manage stored memory entries", + "memories": "Memories", + "totalEntries": "Total Entries", + "tokensUsed": "Tokens Used", + "hitRate": "Hit Rate", + "loading": "Loading memories...", + "noMemories": "No memories found", + "search": "Search memories...", + "allTypes": "All Types", + "export": "Export", + "import": "Import", + "addMemory": "Add Memory", + "type": "Type", + "key": "Key", + "content": "Content", + "created": "Created", + "actions": "Actions", + "delete": "Delete", + "factual": "Factual", + "episodic": "Episodic", + "procedural": "Procedural", + "semantic": "Semantic", + "a": "A" + }, + "skills": { + "title": "Skills", + "description": "Manage and monitor AI skills", + "skillsTab": "Skills", + "executionsTab": "Executions", + "sandboxTab": "Sandbox", + "loading": "Loading skills...", + "noSkills": "No skills found", + "noExecutions": "No executions found", + "enabled": "Enabled", + "disabled": "Disabled", + "version": "Version", + "tableDescription": "Description", + "skill": "Skill", + "status": "Status", + "duration": "Duration", + "time": "Time", + "sandboxConfig": "Sandbox Configuration", + "cpuLimit": "CPU Limit", + "cpuLimitDesc": "Maximum execution time per skill", + "memoryLimit": "Memory Limit", + "memoryLimitDesc": "Maximum memory allocation", + "timeout": "Timeout", + "timeoutDesc": "Maximum wait time for response", + "networkAccess": "Network Access", + "networkAccessDesc": "Allow outbound network requests", + "mode": "Mode", + "q": "Q" + }, "health": { "title": "Tình trạng hệ thống", "description": "Giám sát thời gian thực phiên bản OmniRoute của bạn", @@ -2105,6 +2438,72 @@ "throttleStatus": "Throttle: {value}", "lastHeaderUpdate": "Header update: {age}" }, + "telemetry": { + "title": "__MISSING__:System Telemetry", + "description": "__MISSING__:Rolling request, runtime, session, and memory signals from this OmniRoute process.", + "uptime": "__MISSING__:Uptime", + "totalRequests": "__MISSING__:Total Requests", + "avgLatency": "__MISSING__:Avg Latency", + "errorRate": "__MISSING__:Error Rate", + "activeConnections": "__MISSING__:Active Connections", + "memoryUsage": "__MISSING__:Memory Usage", + "latencyTrend": "__MISSING__:Latency trend", + "throughputTrend": "__MISSING__:Throughput trend", + "memoryTrend": "__MISSING__:Memory trend", + "refresh": "__MISSING__:Refresh", + "updatedAt": "__MISSING__:Updated {time}", + "loadFailed": "__MISSING__:Failed to load telemetry.", + "partialData": "__MISSING__:Telemetry is partially available: {error}" + }, + "mitm": { + "title": "__MISSING__:MITM Proxy", + "description": "__MISSING__:Transparent proxy for intercepting and routing client requests.", + "enable": "__MISSING__:Enable MITM Proxy", + "enableDesc": "__MISSING__:Start or stop the local interception process and DNS override.", + "status": "__MISSING__:Status", + "running": "__MISSING__:Running", + "stopped": "__MISSING__:Stopped", + "start": "__MISSING__:Start", + "stop": "__MISSING__:Stop", + "refresh": "__MISSING__:Refresh", + "port": "__MISSING__:Proxy Port", + "apiKey": "__MISSING__:Router API Key", + "apiKeyPlaceholder": "__MISSING__:Optional; falls back to a local key", + "sudoPassword": "__MISSING__:Sudo Password", + "cachedPassword": "__MISSING__:Cached for this process", + "saveSettings": "__MISSING__:Save Settings", + "settingsSaved": "__MISSING__:MITM settings saved.", + "startedSuccess": "__MISSING__:MITM proxy started.", + "stoppedSuccess": "__MISSING__:MITM proxy stopped.", + "saveFailed": "__MISSING__:Failed to update MITM settings.", + "loadFailed": "__MISSING__:Failed to load MITM settings.", + "invalidPort": "__MISSING__:Transparent MITM interception currently requires port 443.", + "certificate": "__MISSING__:CA Certificate", + "certificateReady": "__MISSING__:Certificate is available for client trust installation.", + "certificateMissing": "__MISSING__:Certificate has not been generated yet.", + "available": "__MISSING__:Available", + "missing": "__MISSING__:Missing", + "downloadCert": "__MISSING__:Download CA Certificate", + "regenerateCert": "__MISSING__:Regenerate Certificate", + "regenerateConfirm": "__MISSING__:This will invalidate existing client trust. Continue?", + "regenerateSuccess": "__MISSING__:MITM certificate regenerated.", + "regenerateFailed": "__MISSING__:Failed to regenerate MITM certificate.", + "targetRoutes": "__MISSING__:Target Routes", + "interceptedRequests": "__MISSING__:Intercepted Requests", + "activeConnections": "__MISSING__:Active Connections", + "dnsConfigured": "__MISSING__:DNS Configured", + "pid": "__MISSING__:PID", + "lastIntercept": "__MISSING__:Last Intercept", + "target": "__MISSING__:Target", + "host": "__MISSING__:Host", + "localPort": "__MISSING__:Local Port", + "endpoints": "__MISSING__:Endpoints", + "enabled": "__MISSING__:Enabled", + "configured": "__MISSING__:Configured", + "yes": "__MISSING__:Yes", + "no": "__MISSING__:No", + "noTargets": "__MISSING__:No target routes configured." + }, "limits": { "title": "Giới hạn & hạn ngạch", "rateLimit": "Giới hạn tỷ lệ", @@ -2171,17 +2570,17 @@ "upstreamPayload": "Upstream Provider Payload", "upstreamNotSentYet": "Not sent to upstream yet", "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", - "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, "export": "Export", "exporting": "Exporting...", "exportFailed": "Export failed", "timeRange": "Time Range", "lastNHours": "Last {hours}", - "defaultRange": "default" + "defaultRange": "default", + "consoleViewer": { + "fetchFailed": "Failed to fetch logs", + "copyFailed": "Failed to copy log entry", + "copyLogEntry": "Copy log entry" + } }, "onboarding": { "welcome": "Chào mừng", @@ -2262,6 +2661,12 @@ "errorCount": "{count} Lỗi ({code})", "errorCountNoCode": "{count} Lỗi", "noConnections": "Không có kết nối", + "expiredBadge": "Expired", + "expiringSoonBadge": "Expiring Soon", + "freeTier": "__MISSING__:Free Tier", + "freeTierAvailable": "__MISSING__:Free tier available", + "deprecated": "__MISSING__:Deprecated", + "deprecatedProvider": "__MISSING__:This provider has been deprecated", "disabled": "Đã tắt", "enableProvider": "Kích hoạt nhà cung cấp", "disableProvider": "Vô hiệu hóa nhà cung cấp", @@ -2296,7 +2701,6 @@ "errorOccurred": "Đã xảy ra lỗi. Vui lòng thử lại.", "modelStatus": "Tình trạng mẫu", "showConfiguredOnly": "Configured only", - "searchProviders": "Tìm kiếm nhà cung cấp...", "allModelsOperational": "Tất cả các mô hình hoạt động", "modelsWithIssues": "{count} mô hình có vấn đề", "allModelsNormal": "Tất cả các model đều phản hồi bình thường.", @@ -2349,9 +2753,14 @@ "openaiCompatibleDetails": "Chi tiết tương thích OpenAI", "messagesApi": "API tin nhắn", "responsesApi": "API phản hồi", + "embeddings": "Embeddings", + "audioTranscriptions": "Audio Transcriptions", + "audioSpeech": "Audio Speech", + "imagesGenerations": "Images Generations", "chatCompletions": "Hoàn thành cuộc trò chuyện", "importingModels": "Đang nhập khẩu...", "importFromModels": "Nhập từ /model", + "modelsImported": "{count} models imported", "allModelsAlreadyImported": "Tất cả mô hình đã được nhập", "noNewModelsToImport": "Không có mô hình mới để nhập — tất cả mô hình đã có trong danh mục hoặc danh sách mô hình tùy chỉnh", "skippingExistingModels": "Bỏ qua {count} mô hình hiện có", @@ -2373,6 +2782,7 @@ "importFailed": "Nhập không thành công", "noNewModelsAdded": "Không có mô hình mới được thêm vào.", "adding": "Đang thêm...", + "close": "Close", "importingModelsTitle": "Nhập mô hình", "copyModel": "Sao chép mô hình", "filterModels": "Lọc mô hình…", @@ -2413,6 +2823,11 @@ "configured": "được cấu hình", "providerProxyConfigureHint": "Định cấu hình proxy cho tất cả các kết nối của nhà cung cấp này", "providerProxy": "Ủy quyền của nhà cung cấp", + "repairEnv": "Repair env", + "repairEnvWorking": "Repairing...", + "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", + "repairEnvSuccess": "OAuth defaults restored", + "repairEnvFailed": "Failed to repair .env", "noConnectionsYet": "Chưa có kết nối nào", "addFirstConnectionHint": "Thêm kết nối đầu tiên của bạn để bắt đầu", "addConnection": "Thêm kết nối", @@ -2479,6 +2894,9 @@ "compatUpstreamAddRow": "Add header", "compatUpstreamRemoveRow": "Remove row", "compatBadgeUpstreamHeaders": "Headers", + "perModelQuotaLabel": "Per Model Quota Label", + "perModelQuotaDescription": "Per Model Quota Description", + "perModelQuotaToggle": "__MISSING__:Per-Model Quota Toggle", "modelId": "Mã mẫu", "customModelPlaceholder": "ví dụ: gpt-4.5-turbo", "loading": "Đang tải...", @@ -2513,6 +2931,10 @@ "email": "Email", "healthCheckMinutes": "Kiểm tra sức khỏe (phút)", "healthCheckHint": "Khoảng thời gian làm mới mã thông báo chủ động. 0 = bị vô hiệu hóa.", + "selectAllModels": "Select all", + "deselectAllModels": "Deselect all", + "modelsActiveCount": "{active}/{total} active", + "noModelsMatch": "No models match \"{filter}\"", "groupLabel": "Environment", "groupPlaceholder": "e.g. eKaizen, Personal", "failedTestConnection": "Không thể kiểm tra kết nối", @@ -2537,26 +2959,11 @@ "modelsPathLabel": "Models Endpoint Path", "modelsPathPlaceholder": "/models", "modelsPathHint": "Custom models path for validation (e.g. /v4/models)", - "modelsImported": "{count} models imported", - "close": "Close", "statusDeactivated": "Deactivated (Manual)", "statusBanned": "Banned / Sandbox Violation", "statusCreditsExhausted": "Insufficient Balance / Quota Exhausted", - "audioTranscriptions": "Audio Transcriptions", - "audioSpeech": "Audio Speech", - "noModelsMatch": "No models match \"{filter}\"", - "repairEnvWorking": "Repairing...", - "deselectAllModels": "Deselect all", - "hideEmails": "Hide all emails", - "repairEnvFailed": "Failed to repair .env", - "repairEnvSuccess": "OAuth defaults restored", - "embeddings": "Embeddings", - "repairEnvHint": "Restore missing OAuth defaults into .env without overwriting existing values.", - "repairEnv": "Repair env", - "selectAllModels": "Select all", - "imagesGenerations": "Images Generations", "showEmails": "Show all emails", - "modelsActiveCount": "{active}/{total} active", + "hideEmails": "Hide all emails", "a": "A", "accountConcurrencyCapHint": "Account Concurrency Cap Hint", "accountConcurrencyCapLabel": "Account Concurrency Cap Label", @@ -2566,6 +2973,7 @@ "addAnotherApiKey": "Add another API key or paste multiple keys", "addCcCompatible": "Add Cc Compatible", "aggregatorsGateways": "Aggregators Gateways", + "enterpriseCloud": "__MISSING__:Enterprise & Cloud", "apiFormatLabel": "Api Format Label", "apiKeyOptionalHint": "Api Key Optional Hint", "apiKeyOptionalLabel": "Api Key Optional Label", @@ -2576,6 +2984,7 @@ "apikey": "Apikey", "audio": "Audio", "audioProvidersHeading": "Audio Providers Heading", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", "audioShortLabel": "Audio Short Label", "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", "bailianBaseUrlHint": "Bailian Base Url Hint", @@ -2631,11 +3040,19 @@ "extraApiKeysHint": "Extra Api Keys Hint", "extraApiKeysLabel": "Extra Api Keys Label", "googlePseInfo": "Google Pse Info", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", "grokWebCookieHint": "Grok Web Cookie Hint", "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", "herokuBaseUrlHint": "Heroku Base Url Hint", "hideEmail": "Hide Email", "imageProviders": "Image Providers", + "videoProviders": "__MISSING__:Video Generation", + "embeddingRerankProviders": "__MISSING__:Embeddings & Rerank", "imagesShortLabel": "Images Short Label", "llmProviders": "Llm Providers", "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", @@ -2668,6 +3085,7 @@ "searchEngineIdRequired": "Search Engine Id Required", "searchProvider": "Search Provider", "searchProviderDesc": "Search Provider Desc", + "searchProviders": "Tìm kiếm nhà cung cấp...", "searchProvidersHeading": "Search Providers Heading", "searxngBaseUrlHint": "Searxng Base Url Hint", "searxngInfo": "Searxng Info", @@ -2706,11 +3124,7 @@ "zedImportNetworkError": "Zed Import Network Error", "zedImportNone": "Zed Import None", "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "perModelQuotaDescription": "Per Model Quota Description", - "perModelQuotaLabel": "Per Model Quota Label", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "zedImporting": "Zed Importing" }, "settings": { "title": "Cài đặt", @@ -2723,6 +3137,23 @@ "systemPrompt": "Lời nhắc hệ thống", "thinkingBudget": "Suy nghĩ về ngân sách", "proxy": "ủy nhiệm", + "httpProxy": "HTTP Proxy", + "1proxy": "1proxy", + "proxySubTabsAria": "Proxy sections", + "requestBodyLimitTitle": "Request Body Limit", + "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", + "requestBodyLimitInputLabel": "Request body limit in MB", + "requestBodyLimitEmptyError": "Enter a limit in MB", + "requestBodyLimitWholeNumberError": "Use a whole number", + "requestBodyLimitMinimumError": "Minimum is {min} MB", + "requestBodyLimitMaximumError": "Maximum is {max} MB", + "requestBodyLimitLoadFailed": "Failed to load request limit settings", + "requestBodyLimitSaveSuccess": "Request body limit saved", + "requestBodyLimitSaveFailed": "Failed to save request body limit", + "requestBodyLimitSaving": "Saving...", + "requestBodyLimitSave": "Save", + "requestBodyLimitCurrent": "Current: {value}", + "mitmProxy": "__MISSING__:MITM Proxy", "pricing": "Định giá", "storage": "Lưu trữ", "policies": "Chính sách", @@ -2733,6 +3164,46 @@ "enablePassword": "Kích hoạt mật khẩu", "darkMode": "Chế độ tối", "lightMode": "Chế độ ánh sáng", + "memoryTitle": "Memory", + "memoryDesc": "Persistent cross-session conversational memory", + "memoryEnabled": "Enable Memory", + "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", + "maxTokens": "Max Tokens", + "retentionDays": "Retention", + "recent": "Recent", + "recentDesc": "Chronological window", + "semantic": "Semantic", + "semanticDesc": "Vector search", + "hybrid": "Hybrid", + "hybridDesc": "Recent + Semantic", + "skillsTitle": "Skills", + "skillsDesc": "Tools for models", + "skillsEnabled": "Enable Skills", + "skillsEnabledDesc": "Allows agents to trigger functions.", + "skillsComingSoon": "Skills marketplace coming soon.", + "memorySkillsTitle": "Memory & Skills", + "memorySkillsDesc": "Persistent context & capabilities", + "modelsDevTitle": "Model Database", + "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", + "modelsDevEnabled": "Enable models.dev Sync", + "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", + "modelsDevInterval": "Sync Interval", + "syncNow": "Sync Now", + "syncing": "Syncing...", + "lastSync": "Last sync", + "never": "Never", + "justNow": "ngay bây giờ", + "modelsDevStats": "Sync Statistics", + "modelsDevStatsDesc": "Current models.dev data coverage", + "providers": "Nhà cung cấp", + "modelsWithPricing": "Models with Pricing", + "capabilities": "Capabilities", + "lastSyncCount": "Last Sync Count", + "lastSyncFull": "Last full sync", + "modelsDevInfo": "How It Works", + "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", + "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", + "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", "systemTheme": "Chủ đề hệ thống", "debugToggle": "Enable Debug Mode", "sidebarVisibilityToggle": "Show Sidebar Items", @@ -2740,6 +3211,8 @@ "cacheTTL": "Bộ nhớ đệm TTL", "maxCacheSize": "Kích thước bộ đệm tối đa", "clearCache": "Xóa bộ nhớ đệm", + "cacheCleared": "Cache cleared successfully", + "clearCacheFailed": "Failed to clear cache", "cacheHits": "Số lần truy cập bộ đệm", "cacheMisses": "Thiếu bộ nhớ đệm", "hitRate": "Tỷ lệ trúng", @@ -2766,6 +3239,8 @@ "autoDisableDescription": "Permanently mark provider connections as deactivated if they return specific terminal ban signals (e.g. HTTP 403 'verify your account'). This removes them from the combo rotation.", "autoDisableThreshold": "Ban Threshold", "autoDisableThresholdDesc": "Consecutive ban signals required before permanent deactivation.", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "Kích hoạt tư duy", "maxThinkingTokens": "Mã thông báo tư duy tối đa", "enableProxy": "Kích hoạt proxy", @@ -2802,6 +3277,14 @@ "themeLight": "Ánh sáng", "themeDark": "Tối", "themeSystem": "Hệ thống", + "endpointTunnelVisibility": "__MISSING__:Endpoint tunnel visibility", + "endpointTunnelVisibilityDesc": "__MISSING__:Hide tunnel controls from the Endpoint page without changing tunnel state.", + "showCloudflareTunnel": "__MISSING__:Cloudflare Quick Tunnel", + "showCloudflareTunnelDesc": "__MISSING__:Show Cloudflare Quick Tunnel controls on the Endpoint page.", + "showTailscaleFunnel": "__MISSING__:Tailscale Funnel", + "showTailscaleFunnelDesc": "__MISSING__:Show Tailscale Funnel controls on the Endpoint page.", + "showNgrokTunnel": "__MISSING__:ngrok Tunnel", + "showNgrokTunnelDesc": "__MISSING__:Show ngrok Tunnel controls on the Endpoint page.", "sidebarVisibility": "Hide sidebar items", "sidebarVisibilityDesc": "Hide any sidebar navigation entry to reduce visual clutter.", "sidebarVisibilityHint": "Any sidebar section is hidden automatically when a...", @@ -2883,6 +3366,14 @@ "apiEndpointProtection": "Bảo vệ điểm cuối API", "requireAuthModels": "Yêu cầu khóa API cho /model", "requireAuthModelsDesc": "Khi BẬT, điểm cuối /v1/models trả về 404 cho các yêu cầu không được xác thực. Ngăn chặn việc phát hiện mô hình bởi người dùng trái phép.", + "authModelHeading": "__MISSING__:Active authorization model", + "authModelClient": "__MISSING__:Client API endpoints (/v1/*, /chat/*, /responses/*, /codex/*, /messages/*) require a Bearer API key.", + "authModelManagement": "__MISSING__:Management endpoints (/dashboard, /api/*) require a dashboard session or management credential.", + "authModelPublic": "__MISSING__:Only login, health, and bootstrap routes are public.", + "bruteForceProtection": "__MISSING__:Login brute-force protection", + "bruteForceProtectionDesc": "__MISSING__:Throttle and lock /api/auth/login after repeated failures from the same IP.", + "corsAllowedOrigins": "__MISSING__:CORS allowed origins", + "corsAllowedOriginsDesc": "__MISSING__:Comma-separated list of browser origins permitted to call this server. Empty list = no browser CORS access (server-to-server still works). Use CORS_ALLOW_ALL=true env var only for development.", "blockedProviders": "Nhà cung cấp bị chặn", "blockedProvidersDesc": "Ẩn các nhà cung cấp cụ thể khỏi phản hồi /v1/models. Các nhà cung cấp bị chặn sẽ không xuất hiện trong danh sách mô hình.", "providersBlocked": "{count} nhà cung cấp bị chặn khỏi /models", @@ -2911,6 +3402,8 @@ "leastUsedDesc": "Chọn tài khoản ít được sử dụng gần đây nhất", "costOpt": "Lựa chọn chi phí", "costOptDesc": "Ưu tiên tài khoản có sẵn rẻ nhất", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "Strict Random", "strictRandomDesc": "Shuffle deck — uses each account once before reshuffling", "stickyLimit": "Giới hạn dính", @@ -3002,6 +3495,8 @@ "comboStrategyAria": "Chiến lược kết hợp", "priority": "Ưu tiên", "weighted": "Có trọng số", + "contextRelay": "Context Relay", + "contextRelayDesc": "Hands off context between providers with automatic summarization", "maxRetriesLabel": "Số lần thử lại tối đa", "retryDelayLabel": "Độ trễ thử lại (ms)", "timeoutLabel": "Thời gian chờ (ms)", @@ -3022,6 +3517,10 @@ "maxNestingDepth": "Độ sâu lồng tối đa", "concurrencyPerModel": "Đồng thời / Mô hình", "queueTimeout": "Hết thời gian xếp hàng (ms)", + "contextRelayHandoffThreshold": "Handoff Threshold", + "contextRelayMaxMessages": "Max Messages For Summary", + "contextRelaySummaryModel": "Summary Model", + "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", "providerProfiles": "Hồ sơ nhà cung cấp", "providerProfilesDesc": "Cài đặt khả năng phục hồi riêng biệt cho các nhà cung cấp OAuth (dựa trên phiên) và Khóa API (được đo lường). Nhà cung cấp OAuth có ngưỡng chặt chẽ hơn do giới hạn tốc độ thấp hơn.", "oauthProviders": "Nhà cung cấp OAuth", @@ -3097,7 +3596,6 @@ "backupCreated": "Đã tạo bản sao lưu: {file}", "restoreSuccess": "Đã khôi phục! {connections} kết nối, nút {nodes}, tổ hợp {combos}, khóa API {apiKeys}.", "importSuccess": "Cơ sở dữ liệu đã được nhập! {connections} kết nối, nút {nodes}, tổ hợp {combos}, khóa API {apiKeys}.", - "justNow": "ngay bây giờ", "minutesAgo": "{count} phút trước", "hoursAgo": "{count} giờ trước", "daysAgo": "{count}ngày trước", @@ -3112,7 +3610,6 @@ "errorDuringImport": "Đã xảy ra lỗi trong quá trình nhập", "modelPricing": "Giá mẫu", "modelPricingDesc": "Định cấu hình mức chi phí cho mỗi mô hình • Tất cả mức giá bằng mã thông báo $/1 triệu", - "providers": "Nhà cung cấp", "registry": "Đăng ký", "priced": "Đã định giá", "searchProvidersModels": "Tìm kiếm nhà cung cấp hoặc mô hình...", @@ -3154,47 +3651,6 @@ "editPricing": "Chỉnh sửa giá", "viewFullDetails": "Xem chi tiết đầy đủ", "themeCoral": "San hô", - "modelsDevTitle": "Model Database", - "modelsDevDesc": "Auto-sync pricing, capabilities & specs from models.dev", - "modelsDevEnabled": "Enable models.dev Sync", - "modelsDevEnabledDesc": "Fetch model pricing, capabilities, and specs from the open-source models.dev database", - "modelsDevInterval": "Sync Interval", - "syncNow": "Sync Now", - "syncing": "Syncing...", - "lastSync": "Last sync", - "never": "Never", - "modelsDevStats": "Sync Statistics", - "modelsDevStatsDesc": "Current models.dev data coverage", - "modelsWithPricing": "Models with Pricing", - "capabilities": "Capabilities", - "lastSyncCount": "Last Sync Count", - "lastSyncFull": "Last full sync", - "modelsDevInfo": "How It Works", - "modelsDevInfoDesc": "models.dev is an open-source database of AI model specifications maintained by the SST/OpenCode team. It provides pricing, capabilities, context limits, and modalities for 4,000+ models across 100+ providers.", - "modelsDevInfoResolution": "Pricing resolution order (highest priority first):", - "modelsDevInfoOrder": "User Override → models.dev → LiteLLM → Hardcoded Default", - "memoryTitle": "Memory", - "memoryDesc": "Persistent cross-session conversational memory", - "memoryEnabled": "Enable Memory", - "memoryEnabledDesc": "When enabled, OmniRoute will inject relevant past context.", - "maxTokens": "Max Tokens", - "retentionDays": "Retention", - "recent": "Recent", - "recentDesc": "Chronological window", - "semantic": "Semantic", - "semanticDesc": "Vector search", - "hybrid": "Hybrid", - "hybridDesc": "Recent + Semantic", - "skillsTitle": "Skills", - "skillsDesc": "Tools for models", - "skillsEnabled": "Enable Skills", - "skillsEnabledDesc": "Allows agents to trigger functions.", - "skillsComingSoon": "Skills marketplace coming soon.", - "memorySkillsTitle": "Memory & Skills", - "memorySkillsDesc": "Persistent context & capabilities", - "days": "Days", - "cacheCleared": "Cache cleared successfully", - "clearCacheFailed": "Failed to clear cache", "adaptiveVolumeRouting": "Adaptive Volume Routing", "adaptiveVolumeRoutingDesc": "Scale connections dynamically based on payload volume and throughput pressure.", "lkgpToggleTitle": "Last Known Good Provider (LKGP)", @@ -3202,13 +3658,12 @@ "clearLkgpCache": "Clear LKGP Cache", "lkgpCacheCleared": "LKGP cache cleared successfully", "lkgpCacheClearFailed": "Failed to clear LKGP cache", + "days": "Days", "lkgp": "LKGP Mode", "lkgpDesc": "Last Known Good Provider (Predictable resilience)", "maintenance": "Maintenance", "purgeExpiredLogs": "Purge Expired Logs", "purgeLogsFailed": "Failed to purge logs", - "contextRelay": "Context Relay", - "contextRelayDesc": "Hands off context between providers with automatic summarization", "contextOpt": "Context Optimized", "contextOptDesc": "Routes based on context window requirements and conversation length", "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", @@ -3230,10 +3685,6 @@ "noExactAliasesConfigured": "No exact-match aliases configured.", "wildcardRulesTitle": "Wildcard Rules", "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "contextRelayHandoffThreshold": "Handoff Threshold", - "contextRelayProviderNote": "Context Relay currently generates handoffs for Codex accounts and uses these values as global defaults for new or unconfigured combos.", - "contextRelaySummaryModel": "Summary Model", - "contextRelayMaxMessages": "Max Messages For Summary", "overview": "Overview", "unknownError": "Unknown Error", "pricingSourceLiteLLM": "Pricing Source Lite Llm", @@ -3279,6 +3730,21 @@ "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", "compressionModeUltra": "Ultra", "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", + "compressionAggressiveConfig": "__MISSING__:Aggressive Engine Configuration", + "compressionAggressiveConfigDesc": "__MISSING__:Fine-tune summarization, tool compression, and aging thresholds", + "compressionUltraConfig": "__MISSING__:Ultra Engine Configuration", + "compressionUltraConfigDesc": "__MISSING__:Fine-tune heuristic pruning, SLM fallback, and per-message thresholds", + "compressionUltraRate": "__MISSING__:Keep Rate", + "compressionUltraMinScore": "__MISSING__:Minimum Score Threshold", + "compressionUltraSlmFallback": "__MISSING__:Fallback to Aggressive", + "compressionUltraModelPath": "__MISSING__:SLM Model Path", + "compressionSummarizerEnabled": "__MISSING__:Enable Summarizer", + "compressionMaxTokensPerMessage": "__MISSING__:Max Tokens Per Message", + "compressionMinSavings": "__MISSING__:Min Savings Threshold", + "compressionAgingThresholds": "__MISSING__:Aging Thresholds", + "compressionAgingThresholdsDesc": "__MISSING__:Number of recent messages kept at each aging tier (higher = more preserved)", + "compressionToolStrategies": "__MISSING__:Tool Result Strategies", + "compressionToolStrategiesDesc": "__MISSING__:Toggle compression strategies for different tool result types", "compressionGeneral": "General Settings", "compressionAutoTrigger": "Auto-Trigger Threshold", "compressionCacheTTL": "Cache TTL", @@ -3296,26 +3762,11 @@ "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", "compressionLogTitle": "Compression Log", "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "minutes": "__MISSING__:minutes", "compressionModeRtk": "RTK", "compressionModeRtkDesc": "Command-aware tool output filtering", "compressionModeStacked": "Stacked", "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "httpProxy": "HTTP Proxy", - "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", "qdrantTitle": "Qdrant (Vector memory)", "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", "qdrantStatusActive": "Active", @@ -3352,7 +3803,11 @@ "qdrantCleanupDesc": "Removes expired and old points based on", "searching": "Searching...", "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "cleanNow": "Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { "title": "RTK Engine", @@ -3367,6 +3822,14 @@ "codeBlocks": "Code blocks", "maxLines": "Max lines", "maxChars": "Max chars", + "deduplicateThreshold": "__MISSING__:Deduplicate threshold", + "customFilters": "__MISSING__:Custom filters", + "trustProjectFilters": "__MISSING__:Trust project filters", + "rawOutputRetention": "__MISSING__:Raw output retention", + "rawOutputNever": "__MISSING__:Never", + "rawOutputFailures": "__MISSING__:Failures", + "rawOutputAlways": "__MISSING__:Always", + "rawOutputMaxBytes": "__MISSING__:Raw output max bytes", "filterTesting": "Filter Testing", "pasteOutput": "Paste tool output to test filtering...", "run": "Run", @@ -3418,6 +3881,7 @@ "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", "autoClarity": "Auto-Clarity Bypass", "bypassConditions": "Bypass conditions", + "bypassConditionsList": "__MISSING__:security, irreversible, clarification, order-sensitive", "preview": { "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", "full": "Respond terse and compact. Preserve all technical substance.", @@ -3465,6 +3929,28 @@ "errorShort": "LỖI", "formatConverter": "Trình chuyển đổi định dạng", "formatConverterDescription": "Dán hoặc nhập nội dung yêu cầu JSON. Trình dịch sẽ tự động phát hiện định dạng nguồn và chuyển đổi nó sang định dạng đích. Sử dụng tính năng này để gỡ lỗi cách OmniRoute dịch các yêu cầu giữa các định dạng (OpenAI ↔ Claude ↔ Gemini ↔ API phản hồi).", + "translationPathHubSpoke": "__MISSING__:{source} → OpenAI (intermediate) → {target}", + "translationPathDirect": "__MISSING__:{source} → {target} (direct translator)", + "translationPathPassthrough": "__MISSING__:Same format — no translation needed", + "openaiIntermediatePanel": "__MISSING__:OpenAI Intermediate", + "autoFeaturesTitle": "__MISSING__:What OmniRoute does automatically", + "autoFeaturesCount": "__MISSING__:8 features", + "featureReasoningCache": "__MISSING__:Reasoning Cache", + "featureReasoningCacheDesc": "__MISSING__:Re-injects cached reasoning_content for thinking-mode models (DeepSeek V4, Kimi K2, Qwen) when clients omit it from conversation history.", + "featureSchemaCoercion": "__MISSING__:Schema Coercion", + "featureSchemaCoercionDesc": "__MISSING__:Fixes broken tool schemas: adds missing additionalProperties, sanitizes long descriptions, normalizes nested objects.", + "featureRoleNormalization": "__MISSING__:Role Normalization", + "featureRoleNormalizationDesc": "__MISSING__:Maps developer→system for non-OpenAI targets. Maps system→user for models that don't support system role.", + "featureToolCallIds": "__MISSING__:Tool Call ID Normalization", + "featureToolCallIdsDesc": "__MISSING__:Generates unique tool_call IDs when missing. Normalizes to 9-char format for providers like Mistral.", + "featureMissingToolResponse": "__MISSING__:Tool Response Injection", + "featureMissingToolResponseDesc": "__MISSING__:Injects empty tool_result messages when clients send tool_calls without corresponding responses.", + "featureThinkingBudget": "__MISSING__:Thinking Budget", + "featureThinkingBudgetDesc": "__MISSING__:Automatically manages thinking config. Removes thinking parameters when the last message is not from the user.", + "featureDirectPaths": "__MISSING__:Direct Translation Paths", + "featureDirectPathsDesc": "__MISSING__:Some format pairs (Claude→Gemini) have direct translators that bypass the OpenAI hub, producing more accurate output.", + "featureImageMapping": "__MISSING__:Image Size Mapping", + "featureImageMappingDesc": "__MISSING__:Translates image dimension conventions between API formats (e.g., OpenAI detail levels → Gemini dimensions).", "input": "đầu vào", "output": "đầu ra", "auto": "Tự động", @@ -3573,6 +4059,11 @@ "errorMessage": "Lỗi: {message}", "requestFailed": "Yêu cầu không thành công", "noTextExtracted": "(Không trích xuất văn bản)", + "liveMonitorMemoryNote": "__MISSING__:Events are stored in memory and lost on restart.", + "liveMonitorMemoryCapNote": "__MISSING__:Max 200 events retained.", + "eventSourcesLabel": "__MISSING__:Event sources:", + "eventSourceTranslatorPage": "__MISSING__:• Translator page (Chat Tester, Test Bench)", + "eventSourceMainPipeline": "__MISSING__:• Main request pipeline (CLI/IDE/API traffic)", "liveMonitorDescriptionPrefix": "Hiển thị các sự kiện dịch khi lệnh gọi API đi qua OmniRoute. Các sự kiện đến từ bộ đệm trong bộ nhớ (đặt lại khi khởi động lại). sử dụng", "liveMonitorDescriptionSuffix": "hoặc lệnh gọi API bên ngoài để tạo sự kiện." }, @@ -3648,14 +4139,25 @@ "passSuffix": "vượt qua", "casesCount": "{count, plural, one {# case} other {# cases}}", "runEval": "Chạy đánh giá", + "runAllSuites": "__MISSING__:Run All", + "runAllRunning": "__MISSING__:Running all...", + "runAllProgress": "__MISSING__:Running {current}/{total}: {name}", + "runAllFailedSuites": "__MISSING__:{count, plural, one {# suite failed} other {# suites failed}}", + "runAllCompleted": "__MISSING__:Ran {suites} suites — {passed} passed, {failed} failed", + "runAllCompletedWithFailures": "__MISSING__:Ran {completed} suites; {failedSuites} failed to complete", "runningProgress": "Đang chạy {current}/{total}...", "passRate": "tỷ lệ đậu", "summaryBreakdown": "{passed} đã đạt · {failed} thất bại · tổng cộng {total}", "passedIconLabel": "✅ Đạt", "failedIconLabel": "❌ Thất bại", + "resultPassed": "__MISSING__:Passed", + "resultFailed": "__MISSING__:Failed", + "expandResult": "__MISSING__:Expand result details", + "collapseResult": "__MISSING__:Collapse result details", "detailsContains": "Chứa: \"{term}\"", "detailsRegex": "Biểu thức chính quy: {pattern}", "detailsExpected": "Dự kiến: \"{expected}\"", + "expectedOutputLabel": "__MISSING__:Expected Output", "noResultsYet": "Chưa có kết quả", "testCasesCount": "Các trường hợp thử nghiệm ({count})", "noTestCasesDefined": "Không có trường hợp thử nghiệm nào được xác định", @@ -3723,6 +4225,16 @@ "tierFree": "miễn phí", "tierUnknown": "Không xác định", "suiteBuilderSaveFailed": "Failed to save suite", + "clone": "__MISSING__:Clone", + "exportSuite": "__MISSING__:Export", + "importSuite": "__MISSING__:Import", + "suiteExported": "__MISSING__:Suite exported", + "suiteExportFailed": "__MISSING__:Failed to export suite", + "suiteImportReady": "__MISSING__:Suite import loaded for review", + "suiteImportFailed": "__MISSING__:Failed to import suite", + "suiteImportInvalid": "__MISSING__:Invalid eval suite JSON", + "suiteBuilderCloneSuffix": "__MISSING__:copy", + "suiteBuilderImportedSuite": "__MISSING__:Imported Suite", "scorecardTitle": "Scorecard", "evalApiKey": "API Key", "scorecardPassRate": "Pass Rate", @@ -3765,6 +4277,10 @@ "recentRunsTitle": "Recent Runs", "suiteBuilderCaseSystemPromptLabel": "System Prompt", "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "__MISSING__:e.g. def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "__MISSING__:Paste the exact expected response", + "suiteBuilderCaseExpectedPlaceholderRegex": "__MISSING__:e.g. ^\\\\s*\\\\{.*\\\\}\\\\s*$", + "suiteBuilderCaseExpectedHintRegex": "__MISSING__:Use a JavaScript regular expression without wrapping slashes.", "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", "suiteBuilderAddCase": "Add Case", "cancel": "Cancel", @@ -3778,6 +4294,7 @@ "resultErrorLabel": "Error", "suiteBuilderBuiltInBadge": "Built-in", "suiteBuilderCaseCardTitle": "Test Case", + "suiteBuilderDuplicateCase": "__MISSING__:Duplicate", "weeklyLimitPlaceholder": "e.g. 50.00", "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", @@ -3942,9 +4459,9 @@ "waitingForAntigravityAuthorization": "Đang chờ ủy quyền chống hấp dẫn...", "waitingForQoderAuthorization": "Đang chờ ủy quyền Qoder...", "exchangingCodeForTokens": "Đổi mã lấy token...", - "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleTitle": "Incompatible Node.js Version", "nodeIncompatibleDesc": "You are running Node.js {version}, which is outside OmniRoute's supported secure runtime policy. Use a patched Node.js 20.x or 22.x LTS release.", + "nodeIncompatibleFixLabel": "Fix: install a patched Node.js 22 LTS release", "nodeIncompatibleHint": "OmniRoute requires Node.js 20.20.2+ (20.x LTS), 22.22.2+ (22.x LTS) or 24.0.0+ (24.x LTS). Node 24 LTS is recommended." }, "landing": { @@ -4032,6 +4549,7 @@ "docs": { "title": "Tài liệu", "quickStart": "Bắt đầu nhanh", + "deploymentGuides": "__MISSING__:Deployment Guides", "features": "Tính năng", "supportedProviders": "Nhà cung cấp được hỗ trợ", "supportedProvidersToc": "Nhà cung cấp", @@ -4068,6 +4586,20 @@ "quickStartStep4Title": "4. Đặt URL cơ sở khách hàng", "quickStartStep4Prefix": "Trỏ ứng dụng khách IDE hoặc API của bạn tới", "quickStartStep4Suffix": "Sử dụng tiền tố nhà cung cấp, ví dụ", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser.", "featureRoutingTitle": "Định tuyến nhiều nhà cung cấp", "featureRoutingText": "Định tuyến yêu cầu đến hơn 30 nhà cung cấp AI thông qua một điểm cuối tương thích với OpenAI. Hỗ trợ API trò chuyện, phản hồi, âm thanh và hình ảnh.", "featureCombosTitle": "Combo và cân bằng", @@ -4112,6 +4644,18 @@ "clientClaudeBullet1Prefix": "sử dụng", "clientClaudeBullet1Middle": "(Claude) hoặc", "clientClaudeBullet1Suffix": "(Phản trọng lực) tiền tố.", + "clientWindsurfTitle": "__MISSING__:Windsurf", + "clientWindsurfBullet1": "__MISSING__:Use OmniRoute as an OpenAI-compatible base URL and keep explicit provider prefixes for deterministic routing.", + "clientWindsurfBullet2": "__MISSING__:Point models to `/v1/chat/completions` for general traffic and preserve `/v1/responses` for Codex-style flows.", + "clientWindsurfBullet3": "__MISSING__:Use Dashboard -> CLI Tools for a ready-made Windsurf configuration guide.", + "clientClineTitle": "__MISSING__:Cline", + "clientClineBullet1": "__MISSING__:Cline works best with explicit provider/model prefixes so the router never has to guess the backend.", + "clientClineBullet2": "__MISSING__:Use `/v1/chat/completions` for general models and reuse the same OmniRoute base URL across different accounts.", + "clientClineBullet3": "__MISSING__:Use the Providers dashboard to validate OAuth/API key before debugging Cline runtime issues.", + "clientKimiTitle": "__MISSING__:Kimi Coding", + "clientKimiBullet1": "__MISSING__:Use OmniRoute as a stable base URL while rotating accounts or provider combos underneath.", + "clientKimiBullet2": "__MISSING__:Prefer prefixed models in coding flows so fallback and audit trail remain explicit.", + "clientKimiBullet3": "__MISSING__:Use `/v1/responses` when you want native Responses-style routing for tool-using clients.", "protocolsTitle": "Protocols: MCP & A2A", "protocolsDescription": "OmniRoute exposes two operational protocols in addition to OpenAI-compatible APIs: MCP for tool execution and A2A for agent-to-agent workflows.", "protocolMcpTitle": "MCP (Model Context Protocol)", @@ -4155,8 +4699,61 @@ "troubleshootingTestConnection": "Sử dụng Trang tổng quan > Nhà cung cấp > Kiểm tra kết nối trước khi thử nghiệm từ IDE hoặc ứng dụng khách bên ngoài.", "troubleshootingCircuitBreaker": "Nếu nhà cung cấp hiển thị cầu dao đang mở, hãy đợi thời gian hồi chiêu hoặc kiểm tra trang Sức khỏe để biết chi tiết.", "troubleshootingOAuth": "Đối với nhà cung cấp OAuth, hãy xác thực lại nếu mã thông báo hết hạn. Kiểm tra chỉ báo trạng thái thẻ nhà cung cấp.", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "__MISSING__:Legacy completions endpoint for text generation.", + "endpointModerationsNote": "__MISSING__:Content moderation and safety classification.", + "endpointRerankNote": "__MISSING__:Document reranking for retrieval-augmented generation (Cohere, Jina).", + "endpointSearchNote": "__MISSING__:Web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity).", + "endpointSearchAnalyticsNote": "__MISSING__:Analytics and metrics for search requests.", + "endpointVideoNote": "__MISSING__:Video generation (ComfyUI, SD WebUI workflows).", + "endpointMusicNote": "__MISSING__:Music generation via ComfyUI workflows.", + "endpointMessagesNote": "__MISSING__:Anthropic-native messages endpoint.", + "endpointCountTokensNote": "__MISSING__:Count tokens for a given message payload.", + "endpointFilesNote": "__MISSING__:File upload for multimodal inputs.", + "endpointBatchesNote": "__MISSING__:Batch processing for bulk API requests.", + "endpointWsNote": "__MISSING__:WebSocket endpoint for real-time streaming.", + "mgmtProvidersListNote": "__MISSING__:List all registered provider connections.", + "mgmtProvidersCreateNote": "__MISSING__:Create a new provider connection.", + "mgmtProvidersUpdateNote": "__MISSING__:Update an existing provider connection.", + "mgmtProvidersDeleteNote": "__MISSING__:Delete a provider connection.", + "mgmtProvidersTestNote": "__MISSING__:Test connectivity and authentication for a provider.", + "mgmtProvidersModelsNote": "__MISSING__:List available models for a specific provider.", + "mgmtSettingsGetNote": "__MISSING__:Retrieve current application settings.", + "mgmtSettingsUpdateNote": "__MISSING__:Update application settings.", + "mgmtPayloadRulesGetNote": "__MISSING__:Get payload transformation rules.", + "mgmtPayloadRulesUpdateNote": "__MISSING__:Update payload transformation rules.", + "mcpToolsTitle": "__MISSING__:MCP Tools", + "mcpToolsDescription": "__MISSING__:OmniRoute exposes {count} tools via Model Context Protocol for agent orchestration.", + "mcpToolsCount": "__MISSING__:{count} tools", + "mcpToolsToc": "__MISSING__:MCP Tools", + "mcpToolsRoutingTitle": "__MISSING__:Routing & Discovery", + "mcpToolsRoutingDesc": "__MISSING__:Health checks, combo management, quota monitoring, cost reporting, and model catalog access.", + "mcpToolsOperationsTitle": "__MISSING__:Operations & Strategy", + "mcpToolsOperationsDesc": "__MISSING__:Route simulation, budget guards, strategy switching, resilience profiles, and provider metrics.", + "mcpToolsCacheTitle": "__MISSING__:Cache Management", + "mcpToolsCacheDesc": "__MISSING__:View cache statistics and flush semantic or signature caches.", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "__MISSING__:Memory", + "mcpToolsMemoryDesc": "__MISSING__:Search, add, and clear persistent conversational memory entries.", + "mcpToolsSkillsTitle": "__MISSING__:Skills", + "mcpToolsSkillsDesc": "__MISSING__:List, enable, execute, and monitor custom skill executions.", + "featureAutoComboTitle": "__MISSING__:Auto-Combo", + "featureAutoComboText": "__MISSING__:Automatically create optimized combos based on your connected providers, usage patterns, and model capabilities.", + "featureSearchTitle": "__MISSING__:Web Search", + "featureSearchText": "__MISSING__:Integrated web search with 5 providers (Serper, Brave, Exa, Tavily, Perplexity) including analytics and cost tracking.", + "featureMemoryTitle": "__MISSING__:Memory System", + "featureMemoryText": "__MISSING__:Persistent conversational memory with extraction, injection, retrieval, and summarization across sessions.", + "featureSkillsTitle": "__MISSING__:Skills Framework", + "featureSkillsText": "__MISSING__:Extensible skill system with built-in and custom skills, sandbox execution, request interception, and context injection.", + "featureAcpTitle": "__MISSING__:Agent Communication", + "featureAcpText": "__MISSING__:Agent Communication Protocol (ACP) registry for managing agent-to-agent workflows and tool orchestration.", + "protocolAcpTitle": "__MISSING__:ACP (Agent Communication)", + "protocolAcpDesc": "__MISSING__:Register and manage agents via the ACP registry for inter-agent communication and tool sharing.", + "protocolAcpStep1": "__MISSING__:Navigate to Dashboard → Agents to view registered ACP agents.", + "protocolAcpStep2": "__MISSING__:Register new agents with capabilities and endpoint configuration.", + "protocolAcpStep3": "__MISSING__:Use CLI Tools to configure agent communication channels." }, "legal": { "privacyPolicy": "Chính sách bảo mật", @@ -4260,7 +4857,63 @@ "architectureDescription": "Architecture Description", "flowExecute": "Flow Execute", "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectCta": "Cli Tools Redirect Cta", + "comparisonTitle": "__MISSING__:CLI Tools vs Agent Targets — What's the Difference?", + "comparisonCliToolsLabel": "__MISSING__:CLI Tools page", + "comparisonCliToolsTitle": "__MISSING__:Your IDE sends requests through OmniRoute", + "comparisonCliToolsDesc": "__MISSING__:Configure Claude Code, Codex, Cursor, and other IDEs to use OmniRoute as their API base URL. OmniRoute acts as a proxy, routing requests to your configured providers.", + "comparisonAgentsLabel": "__MISSING__:This page (Agent Targets)", + "comparisonAgentsTitle": "__MISSING__:OmniRoute sends requests into local CLI tools", + "comparisonAgentsDesc": "__MISSING__:OmniRoute can spawn local CLI binaries (claude, codex, goose) as execution backends. The CLI tool processes the request using its own authentication and returns the result.", + "comparisonSummary": "__MISSING__:In short: CLI Tools = you configure tools to point at OmniRoute. Agent Targets = OmniRoute uses tools as its endpoints.", + "agentUseCaseHint": "__MISSING__:Can be used as an execution target via ACP protocol", + "flowDiagramClient": "__MISSING__:Client App", + "flowDiagramClientDesc": "__MISSING__:SDK, API, or upstream service", + "flowDiagramOmniRoute": "__MISSING__:OmniRoute", + "flowDiagramOmniRouteDesc": "__MISSING__:Receives request and selects target", + "flowDiagramSpawn": "__MISSING__:Spawn Process", + "flowDiagramSpawnDesc": "__MISSING__:Launches CLI binary via stdio", + "flowDiagramCli": "__MISSING__:CLI Agent", + "flowDiagramCliDesc": "__MISSING__:Processes with own auth/model", + "fingerprintSettingsHint": "__MISSING__:CLI Fingerprint matching (disguise requests as specific CLI tools) can be configured in", + "settingsRoutingLink": "__MISSING__:Settings/Routing", + "openSettings": "__MISSING__:Settings" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "Trò chuyện đơn giản", @@ -4337,8 +4990,14 @@ "unavailable": "Cache unavailable", "unavailableDesc": "Could not fetch cache statistics. Make sure the server is running.", "promptCache": "Prompt Cache (Provider-Side)", + "semanticCache": "Semantic Cache", + "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", + "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", "cachedRequests": "Cached Requests", + "cachedRequests24h": "Cached Requests (24h)", "cacheHitRate": "Cache Hit Rate", + "cacheRate": "Cache Rate", + "cacheRateDesc": "of total requests", "cachedTokens": "Cached Tokens", "cacheCreationTokens": "Cache Creation Tokens", "cacheMetrics": "Prompt Cache Metrics", @@ -4348,6 +5007,12 @@ "cacheReuseRatio": "Cache Reuse Ratio", "cacheReuseRatioDesc": "Cached tokens / Total input tokens", "estCostSaved": "Est. Cost Saved", + "lastUpdated": "Last updated", + "hoursTracked": "hours tracked", + "busiestHour": "Busiest Hour", + "peakCacheRate": "Peak Cache Rate", + "trendHour": "Hour", + "activityVolume": "Activity", "requestsShort": "reqs", "inputShort": "In", "cachedShort": "Cached", @@ -4355,198 +5020,283 @@ "resetting": "Resetting...", "resetMetrics": "Reset Metrics", "byProvider": "Breakdown by Provider", + "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "provider": "Provider", "requests": "Requests", "inputTokens": "Input Tokens", "cachedTokensCol": "Cached", "cacheCreation": "Creation", "trend24h": "Cache Trend (24h)", + "peakCached": "Peak cached", "cached": "Cached", "overview": "Overview", "entries": "Entries", + "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", + "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", + "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", "searchEntries": "Search entries...", "search": "Search", "loading": "Loading...", + "entriesLoadError": "Failed to load semantic cache entries.", "noEntries": "No cache entries found", + "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", + "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", "signature": "Signature", "model": "Model", "created": "Created", "expires": "Expires", "actions": "Actions", - "peakCached": "Peak cached", "deduplicatedRequests": "Deduplicated Requests", "savedCalls": "Saved API Calls", "totalProcessed": "Total Requests Processed", - "lastUpdated": "Last updated", - "hoursTracked": "hours tracked", - "semanticCacheSectionDesc": "OmniRoute's own deterministic response cache. When enabled, repeated non-streaming temperature=0 requests can be served locally without hitting the upstream provider.", - "promptCacheSectionDesc": "Shows provider-side prompt caching activity from usage history so you can see where cache control is active and how much input reuse you are getting.", - "semanticCache": "Semantic Cache", - "promptTrendDesc": "Hourly request volume, cache coverage, and cache read volume across the last 24 hours.", - "busiestHour": "Busiest Hour", - "noPromptCacheData": "No provider-side prompt cache activity has been recorded yet.", - "cachedRequests24h": "Cached Requests (24h)", - "semanticEntriesDesc": "Persisted semantic cache records currently stored in SQLite. Provider-side prompt cache activity is not listed here.", - "entriesLoadError": "Failed to load semantic cache entries.", - "cacheRate": "Cache Rate", - "semanticCacheDisabledDesc": "Semantic cache is disabled. OmniRoute will skip local response reuse until you turn it back on in Settings.", - "trendHour": "Hour", - "peakCacheRate": "Peak Cache Rate", - "activityVolume": "Activity", - "noTrendData": "No prompt cache activity has been recorded over the last 24 hours.", - "cacheRateDesc": "of total requests", - "providerCacheRateDesc": "Each provider exposes total input tokens, cache read tokens, and cache write tokens so you can verify the reuse ratio against raw totals.", "disabled": "Disabled", - "totalRequests": "Total Requests" + "totalRequests": "Total Requests", + "reasoningCache": "__MISSING__:Reasoning Replay", + "reasoningCacheDesc": "__MISSING__:Preserves model thinking for multi-turn tool calling flows", + "reasoningEntries": "__MISSING__:Active Entries", + "reasoningReplayRate": "__MISSING__:Replay Rate", + "reasoningReplays": "__MISSING__:Total Replays", + "reasoningCharsCached": "__MISSING__:Characters Cached", + "reasoningMisses": "__MISSING__:Cache Misses", + "reasoningByProvider": "__MISSING__:By Provider", + "reasoningByModel": "__MISSING__:By Model", + "reasoningRecentEntries": "__MISSING__:Recent Entries", + "reasoningToolCallId": "__MISSING__:Tool Call ID", + "reasoningChars": "__MISSING__:Characters", + "reasoningAge": "__MISSING__:Age", + "reasoningView": "__MISSING__:View", + "reasoningDetail": "__MISSING__:Reasoning Content", + "reasoningBehavior": "__MISSING__:Behavior", + "reasoningBehaviorCapture": "__MISSING__:Captures reasoning_content from streaming responses", + "reasoningBehaviorReplay": "__MISSING__:Re-injects on next turn when client omits it", + "reasoningBehaviorFallback": "__MISSING__:Memory-first with SQLite fallback for crash recovery", + "reasoningBehaviorTtl": "__MISSING__:TTL: 2 hours | Max entries: 2,000 (memory)", + "reasoningBehaviorModels": "__MISSING__:Supported: DeepSeek, Kimi, Qwen-Thinking, GLM", + "reasoningClearAll": "__MISSING__:Clear Reasoning Cache", + "reasoningClearSuccess": "__MISSING__:Cleared {count} reasoning cache entries", + "reasoningClearError": "__MISSING__:Failed to clear reasoning cache", + "reasoningNoData": "__MISSING__:No reasoning entries cached yet. Entries appear when thinking models use tool calling." }, - "memory": { - "title": "Memory Management", - "description": "View and manage stored memory entries", - "memories": "Memories", - "totalEntries": "Total Entries", - "tokensUsed": "Tokens Used", - "hitRate": "Hit Rate", - "loading": "Loading memories...", - "noMemories": "No memories found", - "search": "Search memories...", - "allTypes": "All Types", - "export": "Export", - "import": "Import", - "addMemory": "Add Memory", - "type": "Type", - "key": "Key", - "content": "Content", - "created": "Created", - "actions": "Actions", - "factual": "Factual", - "episodic": "Episodic", - "procedural": "Procedural", - "semantic": "Semantic", - "delete": "Delete", - "a": "A" + "proxyConfigModal": { + "levelGlobal": "__MISSING__:Global", + "levelProvider": "__MISSING__:Provider", + "levelCombo": "__MISSING__:Combo", + "levelKey": "__MISSING__:Key", + "levelDirect": "__MISSING__:Direct (no proxy)", + "titleGlobal": "__MISSING__:Global Proxy Configuration", + "titleLevel": "__MISSING__:{level} Proxy — {label}", + "loading": "__MISSING__:Loading proxy configuration...", + "inheritingFrom": "__MISSING__:Inheriting from", + "source": "__MISSING__:Source", + "savedProxy": "__MISSING__:Saved Proxy", + "custom": "__MISSING__:Custom", + "selectSavedProxyPlaceholder": "__MISSING__:Select saved proxy...", + "proxyType": "__MISSING__:Proxy Type", + "host": "__MISSING__:Host", + "hostPlaceholder": "__MISSING__:1.2.3.4 or proxy.example.com", + "port": "__MISSING__:Port", + "authOptional": "__MISSING__:Authentication (optional)", + "username": "__MISSING__:Username", + "usernamePlaceholder": "__MISSING__:Username", + "password": "__MISSING__:Password", + "passwordPlaceholder": "__MISSING__:Password", + "connected": "__MISSING__:Connected", + "ip": "__MISSING__:IP:", + "connectionFailed": "__MISSING__:Connection failed", + "testConnection": "__MISSING__:Test connection", + "clear": "__MISSING__:Clear", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "errorSelectSavedProxy": "__MISSING__:Please select a saved proxy first.", + "errorSelectProxyFirst": "__MISSING__:Please select a proxy first.", + "errorProxyNotFound": "__MISSING__:Selected proxy not found.", + "errorClearSavedProxy": "__MISSING__:Failed to clear saved proxy", + "errorSaveProxy": "__MISSING__:Failed to save proxy configuration", + "errorClearProxy": "__MISSING__:Failed to clear proxy configuration", + "errorSocks5Hidden": "__MISSING__:SOCKS5 is configured but hidden because NEXT_PUBLIC_ENABLE_SOCKS5_PROXY=false." }, - "skills": { - "title": "Skills", - "description": "Manage and monitor AI skills", - "skillsTab": "Skills", - "executionsTab": "Executions", - "sandboxTab": "Sandbox", - "loading": "Loading skills...", - "noSkills": "No skills found", - "noExecutions": "No executions found", - "enabled": "Enabled", - "disabled": "Disabled", - "version": "Version", - "tableDescription": "Description", - "skill": "Skill", - "status": "Status", - "duration": "Duration", - "time": "Time", - "sandboxConfig": "Sandbox Configuration", - "cpuLimit": "CPU Limit", - "cpuLimitDesc": "Maximum execution time per skill", - "memoryLimit": "Memory Limit", - "memoryLimitDesc": "Maximum memory allocation", - "timeout": "Timeout", - "timeoutDesc": "Maximum wait time for response", - "networkAccess": "Network Access", - "networkAccessDesc": "Allow outbound network requests", - "mode": "Mode", - "q": "Q" + "oauthModal": { + "title": "__MISSING__:Connect {providerName}", + "waiting": "__MISSING__:Waiting for authorization", + "completeAuthInPopup": "__MISSING__:Complete authorization in popup.", + "popupClosedHint": "__MISSING__:If the popup closed without redirecting back (e.g. Qoder), this dialog will auto-switch to manual URL entry mode.", + "popupBlocked": "__MISSING__:Popup blocked? Enter URL manually", + "deviceCodeVisitUrl": "__MISSING__:Visit the URL below and enter code:", + "deviceCodeVerificationUrl": "__MISSING__:Verification URL", + "deviceCodeYourCode": "__MISSING__:Your code", + "deviceCodeWaiting": "__MISSING__:Waiting for authorization...", + "googleOAuthWarning": "__MISSING__:Remote access + Google OAuth: Default credentials only accept redirects to <code>localhost</code>. After authorizing, your browser will try to open <code>localhost</code> — copy that full URL and paste it below. For fully remote use without this manual step, <a>configure your own OAuth credentials</a>.", + "remoteAccessInfo": "__MISSING__:Remote access: Since you're accessing OmniRoute remotely, after authorization you'll see an error page (localhost not found). This is normal — just copy the full URL from your browser address bar and paste it below.", + "step1OpenUrl": "__MISSING__:Step 1: Open this URL in your browser", + "copy": "__MISSING__:Copy", + "step2PasteCallback": "__MISSING__:Step 2: Paste callback URL or authorization code here", + "step2Hint": "__MISSING__:After authorization, paste the full callback URL. For Claude Code and Cline, you can also paste the authentication code directly, e.g. <code>code#state</code>.", + "connect": "__MISSING__:Connect", + "cancel": "__MISSING__:Cancel", + "success": "__MISSING__:Connection successful!", + "successMessage": "__MISSING__:Your {providerName} account has been connected.", + "done": "__MISSING__:Done", + "error": "__MISSING__:Connection failed", + "tryAgain": "__MISSING__:Try again" }, - "playground": { - "endpointOptions": { - "images": "Images", - "video": "Video", - "chat": "Chat", - "speech": "Speech", - "rerank": "Rerank", - "transcription": "Transcription", - "responses": "Responses", - "search": "Search", - "music": "Music", - "embeddings": "Embeddings" - }, - "transcriptionHint": "Transcription Hint", - "noAccounts": "No Accounts", - "attachImages": "Attach Images", - "cancel": "Cancel", - "downloadAudio": "Download Audio", - "title": "Title", - "request": "Request", - "send": "Send", - "description": "Description", - "multipartFormData": "Multipart Form Data", - "generatedImage": "Generated Image", - "upToImages": "Up To Images", - "autoAccounts": "Auto Accounts", - "imagesGenerated": "Images Generated", - "model": "Model", - "clearAll": "Clear All", - "response": "Response", - "endpoint": "Endpoint", - "copyText": "Copy Text", - "resetToDefault": "Reset To Default", - "audioFile": "Audio File", - "provider": "Provider", - "save": "Save", - "accountKey": "Account Key", - "transcription": "Transcription", - "selectAudioFile": "Select Audio File", - "copy": "Copy" + "cursorAuthModal": { + "title": "__MISSING__:Connect Cursor IDE", + "autoDetecting": "__MISSING__:Auto-detecting tokens...", + "readingFromCursor": "__MISSING__:Reading from Cursor IDE or cursor-agent", + "tokensAutoDetected": "__MISSING__:Tokens successfully auto-detected from Cursor IDE!", + "cursorNotDetected": "__MISSING__:Cursor IDE not detected. Please manually paste your token.", + "accessToken": "__MISSING__:Access Token", + "required": "__MISSING__:*", + "accessTokenPlaceholder": "__MISSING__:Access token will auto-populate...", + "machineId": "__MISSING__:Machine ID", + "optional": "__MISSING__:(optional)", + "machineIdPlaceholder": "__MISSING__:Machine ID will auto-populate...", + "importing": "__MISSING__:Importing...", + "importToken": "__MISSING__:Import Token", + "cancel": "__MISSING__:Cancel", + "errorAutoDetect": "__MISSING__:Unable to auto-detect tokens", + "errorAutoDetectFailed": "__MISSING__:Auto-detect tokens failed", + "errorEnterToken": "__MISSING__:Please enter access token", + "errorImportFailed": "__MISSING__:Import failed" }, - "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", - "responses": "Responses", - "rerank": "Rerank", - "video": "Video", - "embeddings": "Embeddings", - "transcription": "Transcription" + "pricingModal": { + "title": "__MISSING__:Pricing Configuration", + "loading": "__MISSING__:Loading pricing data...", + "pricingRatesFormat": "__MISSING__:Pricing Rates Format", + "ratesDescription": "__MISSING__:All rates are in <strong>dollars per million tokens</strong> ($/1M tokens). Example: Input rate of 2.50 means $2.50 per 1,000,000 input tokens.", + "model": "__MISSING__:Model", + "input": "__MISSING__:Input", + "output": "__MISSING__:Output", + "cached": "__MISSING__:Cached", + "reasoning": "__MISSING__:Reasoning", + "cacheCreation": "__MISSING__:Cache Creation", + "noPricingData": "__MISSING__:No pricing data available", + "resetToDefaults": "__MISSING__:Reset to defaults", + "cancel": "__MISSING__:Cancel", + "saving": "__MISSING__:Saving...", + "saveChanges": "__MISSING__:Save changes", + "resetConfirm": "__MISSING__:Reset all pricing to defaults? This cannot be undone.", + "errorSaveFailed": "__MISSING__:Failed to save pricing", + "errorResetFailed": "__MISSING__:Failed to reset pricing" }, "proxyRegistry": { - "errorLoadFailed": "Error Load Failed", - "errorMigrateFailed": "Error Migrate Failed", - "noProxies": "No Proxies", - "errorSaveFailed": "Error Save Failed", - "modalCreateTitle": "Modal Create Title", - "tableUsage": "Table Usage", - "failed": "Failed", - "successRate": "Success Rate", - "errorDeleteFailed": "Error Delete Failed", - "loading": "Loading", - "importLegacy": "Import Legacy", - "test": "Test", "title": "Title", - "errorBulkFailed": "Error Bulk Failed", "description": "Description", - "avgLatency": "Avg Latency", + "importLegacy": "Import Legacy", "bulkAssign": "Bulk Assign", - "errorNameHostRequired": "Error Name Host Required", - "tableStatus": "Table Status", "addProxy": "Add Proxy", - "tableActions": "Table Actions", + "loading": "Loading", + "noProxies": "No Proxies", + "tableName": "Table Name", "tableEndpoint": "Table Endpoint", - "delete": "Delete", - "errorForceDeleteConfirm": "Error Force Delete Confirm", - "noData": "No Data", + "tableStatus": "Table Status", + "tableHealth": "Table Health", + "tableUsage": "Table Usage", + "tableActions": "Table Actions", + "test": "Test", "edit": "Edit", - "assignmentsCount": "Assignments Count", + "delete": "Delete", + "modalCreateTitle": "Modal Create Title", "modalEditTitle": "Modal Edit Title", "labelName": "Label Name", - "tableName": "Table Name", - "tableHealth": "Table Health" + "labelType": "__MISSING__:Type", + "labelHost": "__MISSING__:Host", + "labelPort": "__MISSING__:Port", + "labelUsername": "__MISSING__:Username", + "labelPassword": "__MISSING__:Password", + "labelRegion": "__MISSING__:Region", + "labelStatus": "__MISSING__:Status", + "labelNotes": "__MISSING__:Notes", + "usernamePlaceholderEdit": "__MISSING__:Leave blank to keep current username", + "passwordPlaceholderEdit": "__MISSING__:Leave blank to keep current password", + "statusActive": "__MISSING__:Active", + "statusInactive": "__MISSING__:Inactive", + "cancel": "__MISSING__:Cancel", + "save": "__MISSING__:Save", + "bulkModalTitle": "__MISSING__:Bulk Proxy Assignment", + "bulkLabelScope": "__MISSING__:Scope", + "bulkLabelProxy": "__MISSING__:Proxy", + "bulkClearAssignment": "__MISSING__:(Clear assignment)", + "bulkLabelScopeIds": "__MISSING__:Scope IDs (comma or newline separated)", + "bulkScopeIdsPlaceholder": "__MISSING__:provider-openai,provider-anthropic", + "bulkApply": "__MISSING__:Apply", + "errorLoadFailed": "Error Load Failed", + "errorNameHostRequired": "Error Name Host Required", + "errorSaveFailed": "Error Save Failed", + "errorDeleteFailed": "Error Delete Failed", + "errorForceDeleteConfirm": "Error Force Delete Confirm", + "errorMigrateFailed": "Error Migrate Failed", + "errorBulkFailed": "Error Bulk Failed", + "success": "__MISSING__:✓", + "failure": "__MISSING__:✗", + "failed": "Failed", + "successRate": "Success Rate", + "avgLatency": "Avg Latency", + "assignmentsCount": "Assignments Count", + "noData": "No Data", + "testSuccess": "__MISSING__:✓ {ip}", + "testLatency": "__MISSING__:{latency}ms", + "testFailure": "__MISSING__:✗ {error}", + "bulkImport": "__MISSING__:Bulk Import", + "bulkImportTitle": "__MISSING__:Bulk Import Proxies", + "bulkImportDescription": "__MISSING__:Paste proxy profiles using pipe-delimited format. One proxy per line. Existing proxies (same host + port) will be updated.", + "bulkImportParse": "__MISSING__:Parse", + "bulkImportImport": "__MISSING__:Import {count} Proxies", + "bulkImportImporting": "__MISSING__:Importing...", + "bulkImportParsed": "__MISSING__:{count} proxies parsed", + "bulkImportSkipped": "__MISSING__:{count} lines skipped", + "bulkImportParseErrors": "__MISSING__:{count} errors", + "bulkImportNoValidEntries": "__MISSING__:No valid entries found. Check the format and try again.", + "bulkImportSuccess": "__MISSING__:Import complete: {created} created, {updated} updated, {failed} failed", + "bulkImportErrorLine": "__MISSING__:Line {line}: {reason}", + "bulkImportMaxExceeded": "__MISSING__:Maximum 100 proxies per import", + "bulkImportPreview": "__MISSING__:Preview", + "bulkImportErrorMissingName": "__MISSING__:Missing NAME", + "bulkImportErrorMissingHost": "__MISSING__:Missing HOST", + "bulkImportErrorInvalidPort": "__MISSING__:Invalid PORT (must be 1-65535)", + "bulkImportErrorInvalidType": "__MISSING__:Invalid TYPE (use http, https, or socks5)", + "bulkImportErrorInvalidStatus": "__MISSING__:Invalid STATUS (use active or inactive)" }, - "toolDescriptions": { - "cline": "Cline", - "openclaw": "Openclaw", - "droid": "Droid", - "codex": "Codex", - "claude": "Claude", - "kilo": "Kilo" + "playground": { + "title": "Title", + "description": "Description", + "endpoint": "Endpoint", + "provider": "Provider", + "model": "Model", + "accountKey": "Account Key", + "autoAccounts": "Auto Accounts", + "noAccounts": "No Accounts", + "send": "Send", + "cancel": "Cancel", + "audioFile": "Audio File", + "attachImages": "Attach Images", + "multipartFormData": "Multipart Form Data", + "upToImages": "Up To Images", + "selectAudioFile": "Select Audio File", + "clearAll": "Clear All", + "request": "Request", + "response": "Response", + "transcription": "Transcription", + "copy": "Copy", + "resetToDefault": "Reset To Default", + "downloadAudio": "Download Audio", + "copyText": "Copy Text", + "transcriptionHint": "Transcription Hint", + "imagesGenerated": "Images Generated", + "generatedImage": "Generated Image", + "save": "Save", + "endpointOptions": { + "chat": "Chat", + "responses": "Responses", + "images": "Images", + "embeddings": "Embeddings", + "speech": "Speech", + "transcription": "Transcription", + "video": "Video", + "music": "Music", + "rerank": "Rerank", + "search": "Search" + } }, "requestLogger": { "recording": "Recording", @@ -4605,6 +5355,7 @@ "apiKey": "API Key", "combo": "Combo", "tokens": "Tokens", + "compressed": "__MISSING__:Compression", "tps": "TPS", "duration": "Duration", "time": "Time" @@ -4651,11 +5402,24 @@ "noMatchingLogs": "No logs match the current filters.", "tlsFingerprint": "Chrome 124 TLS Fingerprint" }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" + "endpointOptions": { + "speech": "Speech", + "search": "Search", + "images": "Images", + "chat": "Chat", + "music": "Music", + "responses": "Responses", + "rerank": "Rerank", + "video": "Video", + "embeddings": "Embeddings", + "transcription": "Transcription" + }, + "toolDescriptions": { + "cline": "Cline", + "openclaw": "Openclaw", + "droid": "Droid", + "codex": "Codex", + "claude": "Claude", + "kilo": "Kilo" } -} \ No newline at end of file +} diff --git a/src/i18n/messages/zh-CN.json b/src/i18n/messages/zh-CN.json index e6cd0d6ca5..fbb466f3f8 100644 --- a/src/i18n/messages/zh-CN.json +++ b/src/i18n/messages/zh-CN.json @@ -140,515 +140,516 @@ "http": "HTTP", "goToDashboard": "前往仪表板", "checkSystemStatus": "查看系统状态", - "selectModel": "Select Model", + "selectModel": "选择模型", "combos": "Combos", - "noModelsFound": "No models found", - "clear": "Clear", - "done": "Done", - "errorOccurred": "Error Occurred", - "comboDeleted": "Combo Deleted", - "hide": "Hide", - "creating": "Creating", - "comboCreated": "Combo Created", - "swapFormats": "Swap Formats", - "daysAgo": "Days Ago", - "retries": "Retries", - "errorDuringRestore": "Error During Restore", - "eventsAppearHint": "Events Appear Hint", - "noLockouts": "No Lockouts", - "webSearchDesc": "Web Search Desc", - "audioProvidersHeading": "Audio Providers Heading", - "minutesAgo": "Minutes Ago", + "noModelsFound": "未找到 Model", + "clear": "清除", + "done": "完成", + "errorOccurred": "错误发生", + "comboDeleted": "Combo 已删除", + "hide": "隐藏", + "creating": "正在创建", + "comboCreated": "Combo 已创建", + "swapFormats": "交换格式", + "daysAgo": "天前", + "retries": "重试次数", + "errorDuringRestore": "错误期间恢复", + "eventsAppearHint": "事件显示提示", + "noLockouts": "无锁定", + "webSearchDesc": "Web Search 功能说明", + "audioProvidersHeading": "音频 Provider", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", + "minutesAgo": "分钟前", "a": "A", - "liveAutoRefreshing": "Live Auto Refreshing", + "liveAutoRefreshing": "实时自动刷新中", "webSearch": "Web Search", - "anthropicPrefixPlaceholder": "Anthropic Prefix Placeholder", - "addModelToCombo": "Add Model To Combo", - "failedToLoad": "Failed To Load", - "categoryMedia": "Category Media", - "enableCloud": "Enable Cloud", - "expirationBannerExpiringSoon": "Expiration Banner Expiring Soon", - "retry": "Retry", + "anthropicPrefixPlaceholder": "Anthropic 前缀", + "addModelToCombo": "添加模型到组合", + "failedToLoad": "加载失败", + "categoryMedia": "类别媒体", + "enableCloud": "启用云端", + "expirationBannerExpiringSoon": "过期横幅即将过期即将", + "retry": "重试", "embeddings": "Embeddings", - "errorCount": "Error Count", - "backupReasonManual": "Backup Reason Manual", - "safeSearchModerate": "Safe Search Moderate", - "activeLimiters": "Active Limiters", - "a2aCardTitle": "A2A Card Title", - "cloudWorkerUnreachable": "Cloud Worker Unreachable", - "testFailed": "Test Failed", - "compatibleBaseUrlHint": "Compatible Base Url Hint", - "usageTracking": "Usage Tracking", - "disableCloudTitle": "Disable Cloud Title", - "noConnections": "No Connections", - "providerHealth": "Provider Health", - "confirmDbImport": "Confirm Db Import", - "notAvailableSymbol": "Not Available Symbol", - "backupsAvailable": "Backups Available", - "providerAuto": "Provider Auto", - "newProviderNamePlaceholder": "New Provider Name Placeholder", - "a2aQuickStartStep2": "A2A Quick Start Step2", - "ok": "Ok", - "available": "Available", - "noBackupYet": "No Backup Yet", - "more": "More", - "noCompatibleYet": "No Compatible Yet", - "multiProvider": "Multi Provider", - "repairEnvHint": "Repair Env Hint", - "disablingCloud": "Disabling Cloud", - "testBench": "Test Bench", - "valid": "Valid", - "cloudBenefitShare": "Cloud Benefit Share", - "mcpCardTitle": "Mcp Card Title", - "disableConfirm": "Disable Confirm", - "filters": "Filters", - "expirationBannerExpiredDesc": "Expiration Banner Expired Desc", - "saveComboDefaults": "Save Combo Defaults", - "cloudConnectedVerified": "Cloud Connected Verified", - "uptime": "Uptime", - "compatibleProdPlaceholder": "Compatible Prod Placeholder", - "fallbackChainsTitle": "Fallback Chains Title", - "oauthLabel": "Oauth Label", - "a2aCardDescription": "A2A Card Description", - "okShort": "Ok Short", - "maintenance": "Maintenance", - "formatConverter": "Format Converter", - "zedImportNetworkError": "Zed Import Network Error", - "apiKeyLabel": "Api Key Label", - "noModelsForProvider": "No Models For Provider", - "mcpCardDescription": "Mcp Card Description", - "apiTypeLabel": "Api Type Label", - "configuredProvidersLabel": "Configured Providers Label", - "maxRetriesLabel": "Max Retries Label", - "title": "Title", - "output": "Output", - "prefixHint": "Prefix Hint", - "skipWizard": "Skip Wizard", - "failedCount": "Failed Count", - "confirmDbImportDesc": "Confirm Db Import Desc", - "entries": "Entries", - "until": "Until", - "disableCombo": "Disable Combo", - "liveMonitorDescriptionPrefix": "Live Monitor Description Prefix", - "runningCount": "Running Count", - "noActiveConnectionsInGroup": "No Active Connections In Group", - "savedSuccessfully": "Saved Successfully", - "systemStorage": "System Storage", - "videoDesc": "Video Desc", - "maxResults": "Max Results", - "timeRangeMonth": "Time Range Month", - "testSummary": "Test Summary", - "failedSetPassword": "Failed Set Password", - "audio": "Audio", - "restore": "Restore", - "disableWarning": "Disable Warning", - "moderationsDesc": "Moderations Desc", - "providerHealthStatusAria": "Provider Health Status Aria", - "modelNamePlaceholder": "Model Name Placeholder", - "mcpQuickStartStep2": "Mcp Quick Start Step2", - "quickStart": "Quick Start", - "fullExportFailedWithError": "Full Export Failed With Error", - "loadingBackups": "Loading Backups", - "anthropicBaseUrlPlaceholder": "Anthropic Base Url Placeholder", - "description": "Description", - "noProviderFound": "No Provider Found", - "auto": "Auto", - "protocolsDescription": "Protocols Description", - "cloudSessionNote": "Cloud Session Note", - "advancedSettings": "Advanced Settings", - "defaultStrategy": "Default Strategy", - "purgeExpiredLogs": "Purge Expired Logs", - "justNow": "Just Now", - "providerTestFailed": "Provider Test Failed", - "openaiBaseUrlPlaceholder": "Openai Base Url Placeholder", - "image": "Image", - "failedCreateChain": "Failed Create Chain", - "importDatabase": "Import Database", - "allDataLocal": "All Data Local", - "sectionTitle": "Section Title", - "failedToggle": "Failed Toggle", - "editCombo": "Edit Combo", - "testResults": "Test Results", - "searchQuery": "Search Query", + "errorCount": "错误数量", + "backupReasonManual": "备份原因手动", + "safeSearchModerate": "安全搜索中等", + "activeLimiters": "活跃限制器", + "a2aCardTitle": "A2A", + "cloudWorkerUnreachable": "Cloud Worker 不可达", + "testFailed": "测试失败", + "compatibleBaseUrlHint": "填写兼容 API 的 Base URL。", + "usageTracking": "使用量跟踪", + "disableCloudTitle": "禁用云端", + "noConnections": "无连接", + "providerHealth": "提供商健康状态", + "confirmDbImport": "确认DB导入", + "notAvailableSymbol": "—", + "backupsAvailable": "可用备份", + "providerAuto": "自动提供商", + "newProviderNamePlaceholder": "新的提供商名称", + "a2aQuickStartStep2": "A2A快速开始步骤2", + "ok": "确定", + "available": "可用", + "noBackupYet": "无备份暂无", + "more": "更多", + "noCompatibleYet": "无兼容暂无", + "multiProvider": "多提供商", + "repairEnvHint": "修复环境提示", + "disablingCloud": "正在禁用 Cloud", + "testBench": "测试台", + "valid": "有效", + "cloudBenefitShare": "共享 Cloud 访问能力", + "mcpCardTitle": "MCP", + "disableConfirm": "确认禁用？", + "filters": "筛选器", + "expirationBannerExpiredDesc": "过期横幅已过期说明", + "saveComboDefaults": "保存组合默认值", + "cloudConnectedVerified": "Cloud 连接已验证", + "uptime": "运行时间", + "compatibleProdPlaceholder": "兼容生产占位符", + "fallbackChainsTitle": "后备链", + "oauthLabel": "OAuth 标签", + "a2aCardDescription": "通过 A2A 协议连接 Agent 工作流。", + "okShort": "确定短标签", + "maintenance": "维护", + "formatConverter": "格式转换器", + "zedImportNetworkError": "Zed 导入网络错误", + "apiKeyLabel": "API key 标签", + "noModelsForProvider": "此提供商没有可用模型", + "mcpCardDescription": "通过 MCP 工具连接 Agent 和自动化流程。", + "apiTypeLabel": "API 类型标签", + "configuredProvidersLabel": "已配置 Provider 标签", + "maxRetriesLabel": "最大重试次数标签", + "title": "标题", + "output": "输出", + "prefixHint": "前缀提示", + "skipWizard": "跳过向导", + "failedCount": "失败数量", + "confirmDbImportDesc": "确认DB导入说明", + "entries": "条目", + "until": "直到", + "disableCombo": "禁用组合", + "liveMonitorDescriptionPrefix": "实时显示请求流经 OmniRoute 时产生的事件。使用", + "runningCount": "运行中数量", + "noActiveConnectionsInGroup": "此分组中没有活跃连接", + "savedSuccessfully": "保存成功", + "systemStorage": "系统存储", + "videoDesc": "视频说明", + "maxResults": "最大结果数", + "timeRangeMonth": "时间范围月", + "testSummary": "测试摘要", + "failedSetPassword": "设置密码失败", + "audio": "音频", + "restore": "恢复", + "disableWarning": "禁用警告", + "moderationsDesc": "审核说明", + "providerHealthStatusAria": "提供商健康状态", + "modelNamePlaceholder": "模型名称", + "mcpQuickStartStep2": "MCP 快速开始步骤 2", + "quickStart": "快速开始", + "fullExportFailedWithError": "完整导出失败：{error}", + "loadingBackups": "正在加载备份", + "anthropicBaseUrlPlaceholder": "Anthropic Base URL", + "description": "描述", + "noProviderFound": "未找到提供商", + "auto": "自动", + "protocolsDescription": "配置并测试支持的协议端点。", + "cloudSessionNote": "Cloud Session 提示", + "advancedSettings": "高级设置", + "defaultStrategy": "默认策略", + "purgeExpiredLogs": "清理已过期日志", + "justNow": "刚刚现在", + "providerTestFailed": "提供商测试失败", + "openaiBaseUrlPlaceholder": "OpenAI Base URL", + "image": "图像", + "failedCreateChain": "创建链失败", + "importDatabase": "导入数据库", + "allDataLocal": "全部数据本地", + "sectionTitle": "分区标题", + "failedToggle": "切换失败", + "editCombo": "编辑 Combo", + "testResults": "测试结果", + "searchQuery": "搜索查询", "addCcCompatible": "添加 CC 兼容", - "duplicate": "Duplicate", - "createCombo": "Create Combo", - "searchTypeWeb": "Search Type Web", - "addChain": "Add Chain", - "prefixLabel": "Prefix Label", - "listModelsDesc": "List Models Desc", - "databaseSize": "Database Size", - "chainCreated": "Chain Created", - "providerTestTimeout": "Provider Test Timeout", - "routingStrategy": "Routing Strategy", - "translateAction": "Translate Action", - "exportFailed": "Export Failed", - "connectedVerificationPending": "Connected Verification Pending", - "a2aQuickStartTitle": "A2A Quick Start Title", - "couldNotTest": "Could Not Test", - "testAllCompatible": "Test All Compatible", - "anthropicCompatibleName": "Anthropic Compatible Name", - "disabling": "Disabling", - "failedEnable": "Failed Enable", - "categoryUtility": "Category Utility", - "customUrlOptional": "Custom Url Optional", - "localProviders": "Local Providers", - "comboNamePlaceholder": "Combo Name Placeholder", - "memoryRss": "Memory Rss", - "disableProvider": "Disable Provider", - "welcomeDesc": "Welcome Desc", - "nameLabel": "Name Label", - "allOperational": "All Operational", - "backupNow": "Backup Now", - "providerMaxRetriesAria": "Provider Max Retries Aria", - "textToSpeechDesc": "Text To Speech Desc", - "machineId": "Machine Id", - "globalProxy": "Global Proxy", - "hitsMisses": "Hits Misses", - "testDesc": "Test Desc", - "chatDesc": "Chat Desc", - "importSuccess": "Import Success", - "chat": "Chat", - "a2aQuickStartStep1": "A2A Quick Start Step1", - "importFailed": "Import Failed", - "inputPlaceholder": "Input Placeholder", - "providerModelsTitle": "Provider Models Title", - "lastBackup": "Last Backup", - "yourEndpoint": "Your Endpoint", - "autoDisableThresholdDesc": "Auto Disable Threshold Desc", - "rerankDesc": "Rerank Desc", - "modelsPathPlaceholder": "Models Path Placeholder", - "noCombosYet": "No Combos Yet", - "connectedVerificationPendingWithError": "Connected Verification Pending With Error", - "comboDefaultsGuideHint1": "Combo Defaults Guide Hint1", - "enableCloudTitle": "Enable Cloud Title", - "configuredProvidersHint": "Configured Providers Hint", - "paused": "Paused", - "llmProviders": "Llm Providers", - "enableCombo": "Enable Combo", - "removeProviderOverrideAria": "Remove Provider Override Aria", - "nodeVersion": "Node Version", + "duplicate": "重复", + "createCombo": "创建组合", + "searchTypeWeb": "搜索类型：Web", + "addChain": "添加链", + "prefixLabel": "前缀标签", + "listModelsDesc": "列出可用 Model。", + "databaseSize": "数据库大小", + "chainCreated": "链已创建", + "providerTestTimeout": "提供商测试超时", + "routingStrategy": "路由策略", + "translateAction": "翻译操作", + "exportFailed": "导出失败", + "connectedVerificationPending": "连接验证待处理", + "a2aQuickStartTitle": "A2A 快速开始", + "couldNotTest": "无法测试", + "testAllCompatible": "测试所有兼容项", + "anthropicCompatibleName": "Anthropic 兼容名称", + "disabling": "正在禁用", + "failedEnable": "启用失败", + "categoryUtility": "工具类别", + "customUrlOptional": "自定义 URL（可选）", + "localProviders": "本地 Provider", + "comboNamePlaceholder": "Combo 名称", + "memoryRss": "内存 RSS", + "disableProvider": "禁用提供商", + "welcomeDesc": "欢迎使用 OmniRoute。", + "nameLabel": "名称标签", + "allOperational": "全部运行正常", + "backupNow": "备份现在", + "providerMaxRetriesAria": "提供商最大重试次数", + "textToSpeechDesc": "将文本转换为语音音频。", + "machineId": "机器 ID", + "globalProxy": "全局代理", + "hitsMisses": "命中未命中", + "testDesc": "运行连接测试以验证配置。", + "chatDesc": "聊天说明", + "importSuccess": "导入成功", + "chat": "聊天", + "a2aQuickStartStep1": "A2A快速开始步骤1", + "importFailed": "导入失败", + "inputPlaceholder": "输入内容...", + "providerModelsTitle": "提供商模型", + "lastBackup": "最近备份", + "yourEndpoint": "你的 Endpoint", + "autoDisableThresholdDesc": "触发自动禁用前允许的连续失败次数。", + "rerankDesc": "重排说明", + "modelsPathPlaceholder": "Model 路径", + "noCombosYet": "暂无 Combo", + "connectedVerificationPendingWithError": "已连接，验证待完成：{error}", + "comboDefaultsGuideHint1": "配置 Combo 默认策略和目标。", + "enableCloudTitle": "启用云端", + "configuredProvidersHint": "仅显示已配置的 Provider。", + "paused": "已暂停", + "llmProviders": "LLM Provider", + "enableCombo": "启用组合", + "removeProviderOverrideAria": "移除提供商覆盖", + "nodeVersion": "Node 版本", "openai": "Openai", - "exportFailedWithError": "Export Failed With Error", - "proxyConfigured": "Proxy Configured", - "concurrencyPerModel": "Concurrency Per Model", - "protocolTasksLabel": "Protocol Tasks Label", + "exportFailedWithError": "导出失败：{error}", + "proxyConfigured": "代理已配置", + "concurrencyPerModel": "每个模型并发数", + "protocolTasksLabel": "协议任务标签", "oauthProviders": "Oauth Providers", - "lockedCount": "Locked Count", - "deleteChainConfirm": "Delete Chain Confirm", - "recentTranslations": "Recent Translations", - "zedImportButton": "Zed Import Button", - "responsesDesc": "Responses Desc", - "testedCount": "Tested Count", - "providersCommaSeparatedPlaceholder": "Providers Comma Separated Placeholder", - "signatureDefaults": "Signature Defaults", - "errorCreating": "Error Creating", - "timeRangeYear": "Time Range Year", + "lockedCount": "已锁定数量", + "deleteChainConfirm": "删除此后备链？", + "recentTranslations": "最近翻译", + "zedImportButton": "从 Zed 导入", + "responsesDesc": "Responses API 兼容端点", + "testedCount": "已测试数量", + "providersCommaSeparatedPlaceholder": "以逗号分隔的 Provider", + "signatureDefaults": "签名默认值", + "errorCreating": "错误创建", + "timeRangeYear": "时间范围年", "compatibleLabel": "兼容", - "cloudDisabledSuccess": "Cloud Disabled Success", - "deleteConfirm": "Delete Confirm", - "check": "Check", - "safeSearch": "Safe Search", - "protocolLastActivity": "Protocol Last Activity", - "openMcpDashboard": "Open Mcp Dashboard", - "testBenchTab": "Test Bench Tab", - "chatPathLabel": "Chat Path Label", - "retryDelay": "Retry Delay", - "errorUpdating": "Error Updating", - "ideCliIntegrations": "Ide Cli Integrations", - "imageGeneration": "Image Generation", - "apiKeyRequired": "Api Key Required", - "resetAllTitle": "Reset All Title", - "connectionError": "Connection Error", - "modelName": "Model Name", - "apiKeyForCheck": "Api Key For Check", - "cloudRequestTimeout": "Cloud Request Timeout", - "showConfiguredOnly": "Show Configured Only", - "includeDomains": "Include Domains", - "promptCache": "Prompt Cache", - "cloudConnected": "Cloud Connected", - "deleteChain": "Delete Chain", - "chatPathPlaceholder": "Chat Path Placeholder", - "databasePath": "Database Path", - "usingLocalServer": "Using Local Server", - "globalComboConfig": "Global Combo Config", - "backupFailed": "Backup Failed", - "tabProtocols": "Tab Protocols", - "continue": "Continue", - "categorySearch": "Category Search", - "rateLimitStatus": "Rate Limit Status", - "repairEnvSuccess": "Repair Env Success", - "nameRequired": "Name Required", - "country": "Country", - "trackMetricsDesc": "Track Metrics Desc", - "durationSecondsShort": "Duration Seconds Short", - "formatConverterDescription": "Format Converter Description", - "cloudBenefitAccess": "Cloud Benefit Access", - "maxRetries": "Max Retries", - "queueTimeout": "Queue Timeout", - "addProvider": "Add Provider", - "realtime": "Realtime", - "totalTranslations": "Total Translations", - "protocolActiveStreamsLabel": "Protocol Active Streams Label", - "repairEnv": "Repair Env", - "modelsCount": "Models Count", - "viewBackups": "View Backups", - "responsesApi": "Responses Api", - "copyComboName": "Copy Combo Name", - "failures": "Failures", - "failedUpdate": "Failed Update", - "imageDesc": "Image Desc", - "failedCreate": "Failed Create", - "remainingOfLimit": "Remaining Of Limit", - "protocolsTitle": "Protocols Title", - "expirationBannerExpiringSoonDesc": "Expiration Banner Expiring Soon Desc", - "source": "Source", - "failed": "Failed", - "apiKeyMgmt": "Api Key Mgmt", - "mcpQuickStartStep1": "Mcp Quick Start Step1", - "runTest": "Run Test", - "loadingFallbackChains": "Loading Fallback Chains", - "healthy": "Healthy", - "version": "Version", - "saveBlockWeighted": "Save Block Weighted", - "zedImportNone": "Zed Import None", - "noBackupsYet": "No Backups Yet", - "noGlobalProxy": "No Global Proxy", - "noModels": "No Models", - "stickyLimit": "Sticky Limit", - "passedCount": "Passed Count", - "zedImportFailed": "Zed Import Failed", - "saving": "Saving", - "testAll": "Test All", - "globalProxyDesc": "Global Proxy Desc", - "latencyP99": "Latency P99", - "connectingToCloud": "Connecting To Cloud", + "cloudDisabledSuccess": "云端已禁用", + "deleteConfirm": "确认删除？", + "check": "检查", + "safeSearch": "安全搜索", + "protocolLastActivity": "协议最近活动", + "openMcpDashboard": "打开 MCP Dashboard", + "testBenchTab": "测试台", + "chatPathLabel": "聊天路径标签", + "retryDelay": "重试延迟", + "errorUpdating": "错误更新", + "ideCliIntegrations": "IDE 与 CLI 集成", + "imageGeneration": "图像生成", + "apiKeyRequired": "API key 为必填项", + "resetAllTitle": "全部重置", + "connectionError": "连接错误", + "modelName": "模型名称", + "apiKeyForCheck": "用于检查的 API 密钥", + "cloudRequestTimeout": "云端请求超时", + "showConfiguredOnly": "显示已配置仅", + "includeDomains": "包含域名", + "promptCache": "提示缓存", + "cloudConnected": "Cloud 已连接", + "deleteChain": "删除链", + "chatPathPlaceholder": "聊天路径占位符", + "databasePath": "数据库路径", + "usingLocalServer": "正在使用本地 Server", + "globalComboConfig": "全局 Combo 配置", + "backupFailed": "备份失败", + "tabProtocols": "协议标签页", + "continue": "继续", + "categorySearch": "类别搜索", + "rateLimitStatus": "速率限制状态", + "repairEnvSuccess": "环境修复成功", + "nameRequired": "名称必填", + "country": "国家/地区", + "trackMetricsDesc": "跟踪请求、延迟和成本指标。", + "durationSecondsShort": "时长秒短标签", + "formatConverterDescription": "在不同 API 格式之间转换请求。", + "cloudBenefitAccess": "访问 Cloud 能力", + "maxRetries": "最大重试次数", + "queueTimeout": "队列超时", + "addProvider": "添加提供商", + "realtime": "实时", + "totalTranslations": "总计翻译", + "protocolActiveStreamsLabel": "协议活跃 Stream", + "repairEnv": "修复环境", + "modelsCount": "Model 数量", + "viewBackups": "查看备份", + "responsesApi": "Responses API", + "copyComboName": "复制 Combo 名称", + "failures": "失败", + "failedUpdate": "更新失败", + "imageDesc": "图像说明", + "failedCreate": "创建失败", + "remainingOfLimit": "剩余Of限制", + "protocolsTitle": "协议", + "expirationBannerExpiringSoonDesc": "过期横幅即将过期即将说明", + "source": "来源", + "failed": "失败", + "apiKeyMgmt": "API key 管理", + "mcpQuickStartStep1": "MCP 快速开始步骤 1", + "runTest": "运行测试", + "loadingFallbackChains": "正在加载后备链", + "healthy": "健康", + "version": "版本", + "saveBlockWeighted": "保存 Block Weighted", + "zedImportNone": "没有可从 Zed 导入的内容", + "noBackupsYet": "无备份暂无", + "noGlobalProxy": "无全局代理", + "noModels": "无 Model", + "stickyLimit": "粘性限制", + "passedCount": "通过数量", + "zedImportFailed": "Zed 导入失败", + "saving": "正在保存", + "testAll": "全部测试", + "globalProxyDesc": "全局代理说明", + "latencyP99": "延迟P99", + "connectingToCloud": "正在连接云端", "responses": "Responses", - "errorDeleting": "Error Deleting", - "openaiPrefixPlaceholder": "Openai Prefix Placeholder", - "enterPassword": "Enter Password", - "openA2aDashboard": "Open A2A Dashboard", - "enableProvider": "Enable Provider", - "modeTest": "Mode Test", - "failedDeleteChain": "Failed Delete Chain", - "providerDesc": "Provider Desc", - "templateLoadHint": "Template Load Hint", - "lastFailure": "Last Failure", - "moveDown": "Move Down", - "providerLabel": "Provider Label", - "clearCacheFailed": "Clear Cache Failed", - "imagesGenerations": "Images Generations", - "repairEnvWorking": "Repair Env Working", - "millisecondsShort": "Milliseconds Short", - "globalLabel": "Global Label", - "failuresPlural": "Failures Plural", - "completionsLegacyDesc": "Completions Legacy Desc", - "searchProviders": "Search Providers", - "chatPathHint": "Chat Path Hint", - "defaultStrategyDesc": "Default Strategy Desc", - "latencyP95": "Latency P95", - "textToSpeech": "Text To Speech", - "searchType": "Search Type", + "errorDeleting": "错误删除", + "openaiPrefixPlaceholder": "OpenAI 前缀", + "enterPassword": "输入密码", + "openA2aDashboard": "打开 A2A Dashboard", + "enableProvider": "启用提供商", + "modeTest": "测试模式", + "failedDeleteChain": "删除链失败", + "providerDesc": "提供商描述", + "templateLoadHint": "选择模板以快速填充配置。", + "lastFailure": "最近失败", + "moveDown": "移动下移", + "providerLabel": "提供商标签", + "clearCacheFailed": "清除缓存失败", + "imagesGenerations": "图像生成", + "repairEnvWorking": "修复环境处理中", + "millisecondsShort": "毫秒短标签", + "globalLabel": "全局标签", + "failuresPlural": "失败复数", + "completionsLegacyDesc": "旧版 Completions API 兼容端点。", + "searchProviders": "搜索 Provider", + "chatPathHint": "聊天路径提示", + "defaultStrategyDesc": "默认策略说明", + "latencyP95": "延迟P95", + "textToSpeech": "文本转语音", + "searchType": "搜索类型", "messages": "Messages", - "aggregatorsGateways": "Aggregators Gateways", - "comboStrategyAria": "Combo Strategy Aria", - "input": "Input", - "testingConnection": "Testing Connection", - "excludeDomains": "Exclude Domains", + "aggregatorsGateways": "聚合器与网关", + "comboStrategyAria": "Combo 策略", + "input": "输入", + "testingConnection": "正在测试连接", + "excludeDomains": "排除域名", "webCookieProviders": "Web Cookie Providers", - "allTestsPassed": "All Tests Passed", - "openaiCompatibleName": "Openai Compatible Name", - "warningCostOptimizedPartialPricing": "Warning Cost Optimized Partial Pricing", - "comboDefaultsGuideTitle": "Combo Defaults Guide Title", - "hoursAgo": "Hours Ago", - "notAvailable": "Not Available", - "skipAndContinue": "Skip And Continue", - "moderations": "Moderations", - "proxyConfig": "Proxy Config", - "upstreamProxyProviders": "Upstream Proxy Providers", - "exportAll": "Export All", - "queuedCount": "Queued Count", - "resetAll": "Reset All", - "noTranslations": "No Translations", - "avgLatency": "Avg Latency", - "throttleStatus": "Throttle Status", - "backupRetentionDesc": "Backup Retention Desc", - "noCBData": "No Cb Data", - "chainDeleted": "Chain Deleted", - "timeLeft": "Time Left", - "expirationBannerExpired": "Expiration Banner Expired", - "language": "Language", - "invalidFileType": "Invalid File Type", - "monitoredProviders": "Monitored Providers", - "errors": "Errors", - "heap": "Heap", + "allTestsPassed": "全部测试通过", + "openaiCompatibleName": "OpenAI 兼容名称", + "warningCostOptimizedPartialPricing": "部分模型缺少定价，成本优化结果可能不完整。", + "comboDefaultsGuideTitle": "组合默认值指南", + "hoursAgo": "小时前", + "notAvailable": "不可用", + "skipAndContinue": "跳过并继续", + "moderations": "审核", + "proxyConfig": "代理配置", + "upstreamProxyProviders": "上游代理 Provider", + "exportAll": "导出全部", + "queuedCount": "排队中数量", + "resetAll": "重置全部", + "noTranslations": "无翻译", + "avgLatency": "平均延迟", + "throttleStatus": "限流状态", + "backupRetentionDesc": "备份保留说明", + "noCBData": "无CB数据", + "chainDeleted": "链已删除", + "timeLeft": "时间剩余", + "expirationBannerExpired": "过期横幅已过期", + "language": "语言", + "invalidFileType": "无效文件类型", + "monitoredProviders": "监控中的 Provider", + "errors": "错误", + "heap": "堆内存", "chatCompletions": "Chat Completions", - "exampleTemplatesHint": "Example Templates Hint", - "retryDelayLabel": "Retry Delay Label", - "audioTranscription": "Audio Transcription", - "fallbackChainsDesc": "Fallback Chains Desc", - "exampleTemplates": "Example Templates", - "connectionsCount": "Connections Count", - "modelsPathLabel": "Models Path Label", - "activeProvidersHint": "Active Providers Hint", - "activeLockouts": "Active Lockouts", - "invalid": "Invalid", - "skipPassword": "Skip Password", - "moveUp": "Move Up", - "timeRange": "Time Range", - "stickyLimitDesc": "Sticky Limit Desc", - "cloudBenefitEdge": "Cloud Benefit Edge", - "custom": "Custom", - "verifying": "Verifying", - "baseUrlLabel": "Base Url Label", - "setPassword": "Set Password", - "safeSearchStrict": "Safe Search Strict", - "noChangesSinceBackup": "No Changes Since Backup", - "modelsPathHint": "Models Path Hint", - "audioTranscriptions": "Audio Transcriptions", - "testCombo": "Test Combo", - "mcpQuickStartTitle": "Mcp Quick Start Title", - "comboUpdated": "Combo Updated", - "weighted": "Weighted", - "providers": "Providers", + "exampleTemplatesHint": "示例模板提示", + "retryDelayLabel": "重试延迟标签", + "audioTranscription": "音频转写", + "fallbackChainsDesc": "定义每个模型的提供商后备顺序。", + "exampleTemplates": "示例模板", + "connectionsCount": "连接数量", + "modelsPathLabel": "Model 路径", + "activeProvidersHint": "当前正在处理请求的 Provider。", + "activeLockouts": "活跃锁定", + "invalid": "无效", + "skipPassword": "跳过密码", + "moveUp": "移动上移", + "timeRange": "时间范围", + "stickyLimitDesc": "粘性限制说明", + "cloudBenefitEdge": "边缘 Cloud 能力", + "custom": "自定义", + "verifying": "正在验证", + "baseUrlLabel": "Base URL 标签", + "setPassword": "设置密码", + "safeSearchStrict": "安全搜索严格", + "noChangesSinceBackup": "无变更自从备份", + "modelsPathHint": "用于拉取 Model 列表的路径。", + "audioTranscriptions": "音频转写", + "testCombo": "测试组合", + "mcpQuickStartTitle": "MCP 快速开始", + "comboUpdated": "Combo 已更新", + "weighted": "加权", + "providers": "Provider", "ccCompatibleLabel": "CC 兼容", - "noFallbackChainsDesc": "No Fallback Chains Desc", - "yesImport": "Yes Import", - "lockoutsAutoRefreshHint": "Lockouts Auto Refresh Hint", - "tabApis": "Tab Apis", - "sectionDescription": "Section Description", - "filter": "Filter", - "purgeLogsFailed": "Purge Logs Failed", - "latency": "Latency", - "testAllOAuth": "Test All O Auth", - "mcpQuickStartStep3": "Mcp Quick Start Step3", - "repairEnvFailed": "Repair Env Failed", - "zedImportHint": "Zed Import Hint", - "modelsAcrossEndpoints": "Models Across Endpoints", - "autoDisableBannedAccounts": "Auto Disable Banned Accounts", - "securityDesc": "Security Desc", - "listModels": "List Models", - "backupRestore": "Backup Restore", - "target": "Target", - "zedImportSuccess": "Zed Import Success", - "lastHeaderUpdate": "Last Header Update", - "categoryCore": "Category Core", - "noFallbackChains": "No Fallback Chains", - "noSearchProviders": "No Search Providers", - "autoBalance": "Auto Balance", - "noModelsYet": "No Models Yet", - "signatureFamily": "Signature Family", - "externalApiCalls": "External Api Calls", - "providerOverridesDesc": "Provider Overrides Desc", - "signatureTool": "Signature Tool", - "connectionFailed": "Connection Failed", - "activeLimitersPlural": "Active Limiters Plural", - "doneDesc": "Done Desc", - "down": "Down", - "noDataYet": "No Data Yet", - "activeProviders": "Active Providers", - "nameInvalid": "Name Invalid", - "skip": "Skip", - "createChain": "Create Chain", - "audioSpeech": "Audio Speech", - "cacheCleared": "Cache Cleared", - "searchTypeNews": "Search Type News", - "durationMillisecondsShort": "Duration Milliseconds Short", - "addOpenAICompatible": "Add Open Ai Compatible", - "chatTesterTab": "Chat Tester Tab", - "queued": "Queued", - "domainPlaceholder": "Domain Placeholder", - "durationMinutesShort": "Duration Minutes Short", - "verifyingConnection": "Verifying Connection", - "imageProviders": "Image Providers", - "protocolToolsLabel": "Protocol Tools Label", - "queryPlaceholder": "Query Placeholder", - "videoGeneration": "Video Generation", - "timeRangeWeek": "Time Range Week", - "limitExhausted": "Limit Exhausted", - "failedDisable": "Failed Disable", - "inMemoryNote": "In Memory Note", - "compatibleHint": "Compatible Hint", - "errorShort": "Error Short", - "advancedHint": "Advanced Hint", - "restoreFailed": "Restore Failed", - "searchProvidersHeading": "Search Providers Heading", - "comboName": "Combo Name", - "autoDisableDescription": "Auto Disable Description", - "embeddingsDesc": "Embeddings Desc", - "operational": "Operational", - "testAllApiKey": "Test All Api Key", - "backupCreated": "Backup Created", - "errorDuringImport": "Error During Import", - "comboDefaultsGuideHint2": "Combo Defaults Guide Hint2", - "connecting": "Connecting", - "fillModelAndProviders": "Fill Model And Providers", - "syncing": "Syncing", - "resetConfirm": "Reset Confirm", - "trackMetrics": "Track Metrics", - "successful": "Successful", - "recovering": "Recovering", - "autoDisableThreshold": "Auto Disable Threshold", + "noFallbackChainsDesc": "创建一条链路，用于定义某个模型的提供商回退顺序。", + "yesImport": "确认导入", + "lockoutsAutoRefreshHint": "锁定自动刷新提示", + "tabApis": "API 标签页", + "sectionDescription": "分区描述", + "filter": "筛选", + "purgeLogsFailed": "清理日志失败", + "latency": "延迟", + "testAllOAuth": "测试所有 OAuth", + "mcpQuickStartStep3": "MCP 快速开始步骤 3", + "repairEnvFailed": "环境修复失败", + "zedImportHint": "从 Zed 配置中导入 Provider。", + "modelsAcrossEndpoints": "跨 Endpoint 的 Model", + "autoDisableBannedAccounts": "自动禁用被封禁账户", + "securityDesc": "安全说明", + "listModels": "列出 Model", + "backupRestore": "备份恢复", + "target": "目标", + "zedImportSuccess": "Zed 导入成功", + "lastHeaderUpdate": "上次请求头更新", + "categoryCore": "类别核心", + "noFallbackChains": "无后备链", + "noSearchProviders": "无搜索 Provider", + "autoBalance": "自动均衡", + "noModelsYet": "暂无 Model", + "signatureFamily": "签名族", + "externalApiCalls": "外部 API 调用", + "providerOverridesDesc": "覆盖每个提供商的超时和重试设置。", + "signatureTool": "签名工具", + "connectionFailed": "连接失败", + "activeLimitersPlural": "活跃限制器复数", + "doneDesc": "完成说明", + "down": "下移", + "noDataYet": "无数据暂无", + "activeProviders": "活跃 Provider", + "nameInvalid": "名称无效", + "skip": "跳过", + "createChain": "创建链", + "audioSpeech": "语音合成", + "cacheCleared": "缓存已清除", + "searchTypeNews": "搜索类型：News", + "durationMillisecondsShort": "时长毫秒短标签", + "addOpenAICompatible": "添加打开Ai兼容", + "chatTesterTab": "聊天测试标签页", + "queued": "排队中", + "domainPlaceholder": "域名占位符", + "durationMinutesShort": "时长分钟短标签", + "verifyingConnection": "正在验证连接", + "imageProviders": "图像 Provider", + "protocolToolsLabel": "协议工具标签", + "queryPlaceholder": "查询占位符", + "videoGeneration": "视频生成", + "timeRangeWeek": "时间范围：周", + "limitExhausted": "限额已耗尽", + "failedDisable": "禁用失败", + "inMemoryNote": "数据仅保存在内存中。", + "compatibleHint": "兼容提示", + "errorShort": "错误短标签", + "advancedHint": "显示高级选项。", + "restoreFailed": "恢复失败", + "searchProvidersHeading": "搜索 Provider", + "comboName": "Combo 名称", + "autoDisableDescription": "当检测到永久封禁信号时自动禁用账户。", + "embeddingsDesc": "Embeddings API 兼容端点。", + "operational": "运行正常", + "testAllApiKey": "测试所有 API 密钥", + "backupCreated": "备份已创建", + "errorDuringImport": "错误期间导入", + "comboDefaultsGuideHint2": "这些默认值会在新建 Combo 时使用。", + "connecting": "正在连接", + "fillModelAndProviders": "请填写模型和提供商", + "syncing": "正在同步", + "resetConfirm": "重置确认", + "trackMetrics": "跟踪指标", + "successful": "成功", + "recovering": "正在恢复", + "autoDisableThreshold": "自动禁用阈值", "anthropic": "Anthropic", - "syncingData": "Syncing Data", - "cloudBenefitPorts": "Cloud Benefit Ports", - "compatibleProviders": "Compatible Providers", - "clearCache": "Clear Cache", - "reqs": "Reqs", - "addAnthropicCompatible": "Add Anthropic Compatible", - "apiKeyProviders": "Api Key Providers", - "tabsAria": "Tabs Aria", - "resetting": "Resetting", - "millisecondsAbbr": "Milliseconds Abbr", - "backupReasonPreRestore": "Backup Reason Pre Restore", - "disableCloud": "Disable Cloud", - "newProviderNameAria": "New Provider Name Aria", - "passwordsMismatch": "Passwords Mismatch", - "a2aQuickStartStep3": "A2A Quick Start Step3", - "liveMonitorDescriptionSuffix": "Live Monitor Description Suffix", - "failedAddProvider": "Failed Add Provider", - "addAtLeastOneProvider": "Add At Least One Provider", - "reasonSeparator": "Reason Separator", - "zedImporting": "Zed Importing", - "confirmPasswordPlaceholder": "Confirm Password Placeholder", - "whatYouGet": "What You Get", - "signatureSession": "Signature Session", - "errorCountNoCode": "Error Count No Code", - "testing": "Testing", - "providersCommaSeparated": "Providers Comma Separated", - "exportDatabase": "Export Database", - "hitRate": "Hit Rate", - "completionsLegacy": "Completions Legacy", - "removeModel": "Remove Model", - "timeRangeDay": "Time Range Day", - "cloudRequestFailed": "Cloud Request Failed", - "updatedAt": "Updated At", - "monitoredProvidersHint": "Monitored Providers Hint", - "connectionSuccessful": "Connection Successful", - "latencyP50": "Latency P50", - "logsDeleted": "Logs Deleted", - "chatTester": "Chat Tester", - "safeSearchOff": "Safe Search Off", - "nameHint": "Name Hint", - "debugToggle": "Debug Toggle", + "syncingData": "正在同步数据", + "cloudBenefitPorts": "通过 Cloud 暴露端口", + "compatibleProviders": "兼容 Provider", + "clearCache": "清除缓存", + "reqs": "请求数", + "addAnthropicCompatible": "添加 Anthropic 兼容 Provider", + "apiKeyProviders": "API key Provider", + "tabsAria": "标签页", + "resetting": "正在重置", + "millisecondsAbbr": "毫秒缩写", + "backupReasonPreRestore": "恢复前备份", + "disableCloud": "禁用云端", + "newProviderNameAria": "新的提供商名称", + "passwordsMismatch": "密码不匹配", + "a2aQuickStartStep3": "A2A快速开始步骤3", + "liveMonitorDescriptionSuffix": "或外部 API 调用来生成事件。", + "failedAddProvider": "添加提供商失败", + "addAtLeastOneProvider": "至少添加一个提供商", + "reasonSeparator": "原因分隔符", + "zedImporting": "正在从 Zed 导入", + "confirmPasswordPlaceholder": "确认密码占位符", + "whatYouGet": "你将获得", + "signatureSession": "签名 Session", + "errorCountNoCode": "无代码错误数", + "testing": "正在测试", + "providersCommaSeparated": "以逗号分隔的 Provider", + "exportDatabase": "导出数据库", + "hitRate": "命中率", + "completionsLegacy": "Completions 旧版", + "removeModel": "移除模型", + "timeRangeDay": "时间范围：天", + "cloudRequestFailed": "云端请求失败", + "updatedAt": "更新时间", + "monitoredProvidersHint": "选择需要监控的 Provider。", + "connectionSuccessful": "连接成功", + "latencyP50": "延迟P50", + "logsDeleted": "日志已删除", + "chatTester": "聊天测试器", + "safeSearchOff": "Safe Search 关闭", + "nameHint": "名称提示", + "debugToggle": "调试开关", "embedding": "Embedding", - "issuesLabel": "Issues Label", - "optionAny": "Option Any", - "maxNestingDepth": "Max Nesting Depth", + "issuesLabel": "问题标签", + "optionAny": "任意选项", + "maxNestingDepth": "最大嵌套深度", "rerank": "Rerank", - "checking": "Checking", - "getStarted": "Get Started", - "restoreSuccess": "Restore Success", - "issuesDetected": "Issues Detected", - "signatureCache": "Signature Cache", - "modelLockouts": "Model Lockouts", - "usingCloudProxy": "Using Cloud Proxy", - "loadingHealth": "Loading Health", - "providerOverrides": "Provider Overrides", - "audioTranscriptionDesc": "Audio Transcription Desc", - "learnedFromHeaders": "Learned From Headers", - "totalRequests": "Total Requests", - "cloudUnstableNote": "Cloud Unstable Note" + "checking": "正在检查", + "getStarted": "开始使用", + "restoreSuccess": "恢复成功", + "issuesDetected": "检测到问题", + "signatureCache": "签名缓存", + "modelLockouts": "模型锁定", + "usingCloudProxy": "正在使用 Cloud 代理", + "loadingHealth": "正在加载健康状态", + "providerOverrides": "提供商覆盖", + "audioTranscriptionDesc": "音频转写说明", + "learnedFromHeaders": "从响应头学习", + "totalRequests": "总计请求", + "cloudUnstableNote": "Cloud 连接不稳定，部分功能可能受影响。" }, "sidebar": { "home": "首页", @@ -668,6 +669,7 @@ "playground": "演练场", "searchTools": "搜索工具", "agents": "智能体", + "cloudAgents": "__MISSING__:Cloud Agents", "memory": "记忆", "skills": "技能", "docs": "文档", @@ -675,6 +677,7 @@ "endpoints": "端点", "apiManager": "API 管理", "logs": "日志", + "webhooks": "Webhook", "auditLog": "审计日志", "shutdown": "停止服务", "restart": "重启服务", @@ -707,40 +710,137 @@ "cliToolsShort": "工具", "cache": "缓存", "cacheShort": "缓存", - "batch": "Batch Jobs", - "themeSystem": "Theme System", - "whitelabelingDesc": "Whitelabeling Desc", - "switchThemes": "Switch Themes", - "themeAccentDesc": "Theme Accent Desc", - "uploadFavicon": "Upload Favicon", - "themeDark": "Theme Dark", - "customLogoDesc": "Custom Logo Desc", - "sidebarVisibilityToggle": "Sidebar Visibility Toggle", - "themeAccent": "Theme Accent", - "resetFavicon": "Reset Favicon", - "whitelabeling": "Whitelabeling", - "darkMode": "Dark Mode", - "uploadLogo": "Upload Logo", - "themeLight": "Theme Light", - "appName": "App Name", - "appNameDesc": "App Name Desc", - "resetLogo": "Reset Logo", - "customFavicon": "Custom Favicon", - "hideHealthLogs": "Hide Health Logs", - "customLogo": "Custom Logo", - "appearance": "Appearance", - "themeSelectionAria": "Theme Selection Aria", - "themeCreate": "Theme Create", - "customFaviconDesc": "Custom Favicon Desc", - "logoPreview": "Logo Preview", - "themeCustom": "Theme Custom", - "hideHealthLogsDesc": "Hide Health Logs Desc", - "faviconPreview": "Favicon Preview", - "changelog": "Changelog", - "contextSection": "Context & Cache", + "batch": "批量任务", + "themeSystem": "主题系统", + "whitelabelingDesc": "自定义品牌展示与主题外观。", + "switchThemes": "切换主题", + "themeAccentDesc": "选择用于按钮、链接和高亮状态的强调色。", + "uploadFavicon": "上传 Favicon", + "themeDark": "深色主题", + "customLogoDesc": "上传用于侧边栏和登录页的自定义 Logo。", + "sidebarVisibilityToggle": "侧边栏可见性开关", + "themeAccent": "主题强调色", + "resetFavicon": "重置 Favicon", + "whitelabeling": "白标", + "darkMode": "深色模式", + "uploadLogo": "上传 Logo", + "themeLight": "浅色主题", + "appName": "应用名称", + "appNameDesc": "设置在界面和浏览器标题中显示的名称。", + "resetLogo": "重置 Logo", + "customFavicon": "自定义 Favicon", + "hideHealthLogs": "隐藏健康检查日志", + "customLogo": "自定义 Logo", + "appearance": "外观", + "themeSelectionAria": "主题选择", + "themeCreate": "创建主题", + "customFaviconDesc": "上传用于浏览器标签页的自定义 Favicon。", + "logoPreview": "Logo 预览", + "themeCustom": "自定义主题", + "hideHealthLogsDesc": "隐藏健康检查日志说明", + "faviconPreview": "Favicon 预览", + "changelog": "更新日志", + "contextSection": "上下文与缓存", "contextCaveman": "Caveman", "contextRtk": "RTK", - "contextCombos": "Compression Combos" + "contextCombos": "压缩组合" + }, + "webhooks": { + "title": "Webhook", + "description": "配置系统事件的 HTTP 回调。", + "configuredWebhooks": "已配置的 Webhook", + "configuredWebhooksDesc": "管理投递端点、订阅事件、状态和测试发送。", + "addWebhook": "添加 Webhook", + "editWebhook": "编辑 Webhook", + "name": "名称", + "namePlaceholder": "生产监控", + "unnamedWebhook": "未命名 Webhook", + "url": "端点 URL", + "events": "事件", + "allEvents": "所有事件", + "secret": "密钥", + "secretPlaceholder": "留空将自动生成密钥", + "secretEditPlaceholder": "留空以保留当前密钥", + "status": "状态", + "active": "活动", + "inactive": "未活动", + "errored": "出错", + "total": "总计", + "lastTriggered": "上次触发", + "actions": "操作", + "enabled": "已启用", + "enabledDesc": "禁用的 Webhook 会继续保存，但不会接收投递。", + "refresh": "刷新", + "loading": "正在加载 Webhook...", + "never": "从未", + "failureCount": "{count, plural, =0 {no failures} one {# 次失败} other {# 次失败}}", + "testWebhook": "发送测试", + "testSuccess": "测试 Webhook 发送成功。", + "testFailed": "测试 Webhook 失败。", + "saveSuccess": "Webhook 保存成功。", + "saveFailed": "保存 Webhook 失败。", + "loadFailed": "加载 Webhook 失败。", + "delete": "删除", + "deleteConfirm": "确定要删除此 Webhook 吗？", + "deleteSuccess": "Webhook 删除成功。", + "deleteFailed": "删除 Webhook 失败。", + "edit": "编辑", + "enable": "启用", + "disable": "禁用", + "noWebhooks": "尚未配置 Webhook。", + "signatureTitle": "Webhook 签名", + "signatureDescription": "每次投递都会包含一个 X-Webhook-Signature 请求头，该签名使用 Webhook 密钥通过 HMAC-SHA256 生成。信任载荷前请先验证签名。" + }, + "compliance": { + "auditTitle": "审计", + "auditDescription": "在一个运维视图中查看合规事件和 MCP 工具调用。", + "complianceTab": "合规", + "mcpTab": "MCP 审计", + "title": "合规审计", + "description": "合规审计日志记录的策略、访问、提供商和安全事件。", + "eventType": "事件类型", + "eventTypePlaceholder": "按操作或事件类型筛选", + "severity": "严重级别", + "allSeverities": "所有严重级别", + "info": "信息", + "warning": "警告", + "critical": "严重", + "sourceIp": "来源 IP", + "userOrKey": "用户 / 密钥", + "action": "操作", + "result": "结果", + "details": "详情", + "timestamp": "时间戳", + "from": "起始", + "to": "结束", + "refresh": "刷新", + "export": "导出", + "clearFilters": "清除筛选", + "loading": "正在加载审计事件...", + "showing": "正在显示 {total} 个事件中的 {count} 个", + "policyViolation": "策略违规", + "accessDenied": "访问被拒绝", + "injectionBlocked": "注入已阻止", + "noEvents": "尚未记录合规事件。", + "failedFetch": "获取合规审计日志失败。", + "viewDetails": "查看详情", + "closeDetails": "关闭详情", + "notAvailable": "—", + "system": "system", + "previous": "上一页", + "next": "下一页", + "mcpAudit": "MCP 审计", + "mcpAuditDesc": "MCP 服务器记录的工具调用审计条目。", + "failedFetchMcpAudit": "获取 MCP 审计日志失败。", + "tool": "工具", + "toolPlaceholder": "按工具名称筛选", + "duration": "持续时间", + "apiKey": "API 密钥", + "output": "输出", + "allResults": "所有结果", + "success": "成功", + "failure": "失败", + "noMcpEvents": "尚未记录 MCP 审计事件。" }, "themesPage": { "title": "主题", @@ -832,8 +932,8 @@ "modelStatusError": "错误", "comboHealth": "组合健康状况", "comboHealthDescription": "组合级别配额、使用分布和性能指标", - "compressionAnalyticsTitle": "Compression Analytics", - "compressionAnalyticsDescription": "Compression analytics — token savings, mode breakdown, and provider stats." + "compressionAnalyticsTitle": "压缩分析", + "compressionAnalyticsDescription": "压缩分析 — token 节省、模式分布和提供商统计。" }, "apiManager": { "title": "API 密钥", @@ -935,6 +1035,10 @@ "lastUsedOn": "最近使用：{date}", "editPermissions": "编辑权限", "deleteKey": "删除密钥", + "regenerateKey": "__MISSING__:Regenerate key", + "regenerateConfirm": "__MISSING__:Are you sure you want to regenerate this API key? The old key will be immediately invalidated.", + "failedRegenerateKey": "__MISSING__:Failed to regenerate API key", + "failedRegenerateKeyRetry": "__MISSING__:Failed to regenerate API key. Please try again.", "model": "{count} 个模型", "models": "{count} 个模型", "permissionsTitle": "权限：{name}", @@ -1287,8 +1391,8 @@ "title": "选择模型" }, "5": { - "title": "Use Thinking Variant", - "desc": "For thinking models, run with --variant high/low/max (example command below)." + "title": "使用 Thinking 变体", + "desc": "对于思考模型，请使用 --variant high/low/max 运行（示例命令见下方）。" } }, "notes": { @@ -1320,12 +1424,12 @@ "windsurf": { "steps": { "1": { - "title": "Open AI Settings", - "desc": "Click the AI Settings icon in Windsurf or go to Settings" + "title": "打开 AI 设置", + "desc": "点击 Windsurf 中的 AI Settings 图标，或前往 Settings" }, "2": { - "title": "Add Custom Provider", - "desc": "Select \"Add custom provider\" (OpenAI-compatible)" + "title": "添加自定义提供商", + "desc": "选择 \"Add custom provider\" (OpenAI 兼容)" }, "3": { "title": "Base URL", @@ -1333,11 +1437,11 @@ }, "4": { "title": "API Key", - "desc": "Select your OmniRoute API key" + "desc": "选择你的 OmniRoute API 密钥" }, "5": { - "title": "Select Model", - "desc": "Choose a model from the dropdown" + "title": "选择模型", + "desc": "从下拉菜单中选择模型" } } } @@ -1407,6 +1511,8 @@ "randomDesc": "均匀随机选择，失败后回退到剩余模型", "leastUsedDesc": "优先选择请求数最少的模型，随时间平衡负载", "costOptimizedDesc": "根据定价优先路由到最便宜的模型", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Balances remaining quota against 5h and weekly resets, then round-robins similar scores", "strictRandom": "严格随机", "strictRandomDesc": "洗牌池模式：每个模型使用一次后再重新洗牌", "models": "模型", @@ -1465,6 +1571,11 @@ "avoid": "定价数据缺失或已经过期。", "example": "后台任务或批处理作业，优先考虑更低成本。" }, + "reset-aware": { + "when": "__MISSING__:You route across multiple accounts with quota telemetry and different reset windows.", + "avoid": "__MISSING__:Quota telemetry is unavailable for most accounts.", + "example": "__MISSING__:Prefer a 60% weekly account resetting tomorrow over an 80% account resetting later." + }, "strict-random": { "when": "适用于希望实现绝对均匀分配的场景，每个模型在重复前都会恰好使用一次。", "avoid": "如果模型之间的质量或延迟差异较大，且调用顺序很重要，则不建议使用。", @@ -1533,6 +1644,12 @@ "warningRoundRobinSingleModel": "轮询策略至少有 2 个模型时才最有价值。", "warningCostOptimizedPartialPricing": "在 {total} 个模型中，只有 {priced} 个有定价信息。路由可能只具备部分成本感知能力。", "warningCostOptimizedNoPricing": "该组合未找到任何定价数据。成本优化策略的路由结果可能不符合预期。", + "filterAll": "全部", + "filterIntelligent": "智能路由", + "filterDeterministic": "确定性", + "filterEmptyTitle": "没有组合匹配此策略筛选。", + "filterEmptyIntelligentDescription": "创建自动或 LKGP 组合以填充智能路由仪表盘。", + "filterEmptyDeterministicDescription": "当前仅存在自动和 LKGP 组合。切换回\"全部\"或创建确定性组合。", "readinessTitle": "可以保存了吗？", "readinessDescription": "在创建或更新组合前，请先检查以下项目。", "readinessCheckName": "组合名称有效", @@ -1550,12 +1667,6 @@ "applyRecommendations": "应用推荐", "recommendationsUpdated": "已为 {strategy} 更新推荐配置。", "recommendationsApplied": "推荐配置已应用到当前组合。", - "filterAll": "全部", - "filterIntelligent": "智能路由", - "filterDeterministic": "确定性", - "filterEmptyTitle": "没有组合匹配此策略筛选。", - "filterEmptyIntelligentDescription": "创建自动或 LKGP 组合以填充智能路由仪表盘。", - "filterEmptyDeterministicDescription": "当前仅存在自动和 LKGP 组合。切换回\"全部\"或创建确定性组合。", "intelligentPanelTitle": "智能路由仪表盘", "intelligentPanelDesc": "此自动路由组合的实时评分和健康状态。", "statusOverview": "状态概览", @@ -1578,26 +1689,6 @@ "candidatePoolHint": "选择引擎应评估的供应商。留空则使用所有活跃供应商。", "candidatePoolEmpty": "暂无可用活跃供应商。", "candidatePoolAllProviders": "所有供应商", - "builderStagesDescription": "按顺序完成各个阶段以定义组合、构建步骤、选择路由策略并审查结果。", - "builderStepsDescription": "按顺序构建每个组合步骤：提供商、模型，然后是账户。这允许在不同账户上重复使用相同的提供商和模型。", - "selectProvider": "选择提供商", - "selectProviderPlaceholder": "选择提供商", - "selectModel": "选择模型", - "selectModelPlaceholder": "请先选择提供商", - "selectAccount": "选择账户", - "autoSelectAccount": "运行时自动选择账户", - "previewNextStep": "选择提供商和模型以预览下一步。", - "builderAddStep": "添加步骤", - "builderDuplicateExact": "该提供商/模型/账户步骤已存在于组合中。", - "comboReference": "组合引用", - "selectComboToReference": "选择要引用的现有组合", - "addComboReference": "添加组合引用", - "browseLegacyCatalog": "浏览旧版模型目录", - "addStepBeforeContinue": "在继续到下一阶段之前，请至少添加一个步骤。", - "modePackPerformance": "性能优先", - "modePackBudget": "预算优先", - "modePackBalanced": "均衡", - "modePackCustom": "自定义", "modePackLabel": "模式包", "routerStrategyLabel": "路由策略", "strategyRules": "规则（6 因子评分）", @@ -1657,26 +1748,12 @@ "tip2": "为高难度提示保留一个质量更高的回退模型。", "tip3": "适合批处理或后台任务等成本是主要指标的场景。" }, - "fill-first": { - "title": "配额耗尽策略", - "description": "在切换到链中的下一个提供商之前，先耗尽一个提供商的配额。", - "tip1": "按免费配额大小排列模型 — 最大的放在第一位。", - "tip2": "启用健康检查以跳过已耗尽的提供商。", - "tip3": "非常适合免费层级堆叠（Deepgram → Groq → NIM）。" - }, - "p2c": { - "title": "双选负载均衡", - "description": "每次请求从随机候选中选出负载较轻的一个 — 低延迟，高扩展性。", - "tip1": "配合 4 个或更多模型使用效果最佳。", - "tip2": "需要在设置中启用延迟遥测。", - "tip3": "是高吞吐量组合中轮询的绝佳替代方案。" - }, - "context-relay": { - "title": "会话连续性优先", - "description": "当预期账户轮换且下一个账户必须继承简化的任务摘要时效果最佳。", - "tip1": "与为同一模型系列轮换账户的提供商配合使用。", - "tip2": "将交接阈值设置在硬配额截止值以下，以便有时间生成摘要。", - "tip3": "仅在主模型太贵或不稳定时，才设置专用摘要模型。" + "reset-aware": { + "title": "__MISSING__:Reset-aware account rotation", + "description": "__MISSING__:Balances remaining provider quota against reset timing.", + "tip1": "__MISSING__:Use explicit account steps or account-tag routing for providers with quota telemetry.", + "tip2": "__MISSING__:Tune session vs weekly weights when short-term exhaustion is more risky.", + "tip3": "__MISSING__:Keep the tie band small so equivalent accounts still rotate fairly." }, "strict-random": { "title": "洗牌池分配", @@ -1685,26 +1762,47 @@ "tip2": "最适合性能相近的模型。", "tip3": "非常适合在多个 API 账户之间做负载均衡。" }, + "fill-first": { + "description": "在切换到链中的下一个提供商之前，先耗尽一个提供商的配额。", + "tip1": "按免费配额大小排列模型 — 最大的放在第一位。", + "tip2": "启用健康检查以跳过已耗尽的提供商。", + "tip3": "非常适合免费层级堆叠（Deepgram → Groq → NIM）。", + "title": "配额耗尽策略" + }, "auto": { - "title": "多因素优化", "description": "基于成本、延迟、质量和健康的实时评分进行路由。", "tip1": "让引擎自动平衡多个因素。", "tip2": "在日志中监控哪些因素驱动路由决策。", - "tip3": "用于复杂工作负载，其中没有单一因素占主导。" + "tip3": "用于复杂工作负载，其中没有单一因素占主导。", + "title": "多因素优化" }, "lkgp": { - "title": "历史路由", "description": "基于历史成功率和持久性能数据进行路由。", "tip1": "在依赖此策略之前让成功历史积累足够数据。", "tip2": "最适合具有稳定性能特征的工作负载。", - "tip3": "定期审查历史数据，确保路由决策保持准确。" + "tip3": "定期审查历史数据，确保路由决策保持准确。", + "title": "历史路由" }, "context-optimized": { - "title": "上下文优化", "description": "基于上下文窗口使用情况和令牌效率优化路由。", "tip1": "将长对话路由到具有更大上下文窗口的模型。", "tip2": "监控上下文利用率以避免令牌浪费。", - "tip3": "最适合需要大量上下文保留的对话式 AI。" + "tip3": "最适合需要大量上下文保留的对话式 AI。", + "title": "上下文优化" + }, + "context-relay": { + "description": "当预期账户轮换且下一个账户必须继承简化的任务摘要时效果最佳。", + "tip1": "与为同一模型系列轮换账户的提供商配合使用。", + "tip2": "将交接阈值设置在硬配额截止值以下，以便有时间生成摘要。", + "tip3": "仅在主模型太贵或不稳定时，才设置专用摘要模型。", + "title": "会话连续性优先" + }, + "p2c": { + "description": "每次请求从随机候选中选出负载较轻的一个 — 低延迟，高扩展性。", + "tip1": "配合 4 个或更多模型使用效果最佳。", + "tip2": "需要在设置中启用延迟遥测。", + "tip3": "是高吞吐量组合中轮询的绝佳替代方案。", + "title": "双选负载均衡" } }, "templateFreeStack": "免费栈（$0）", @@ -1766,6 +1864,8 @@ "builderProviderFirst": "请先选择提供商", "builderAccount": "账户", "builderPreview": "预览", + "builderAddStep": "添加步骤", + "builderDuplicateExact": "该提供商/模型/账户步骤已存在于组合中。", "builderComboRef": "组合引用", "builderAddComboRef": "添加组合引用", "builderComboRefStep": "添加组合引用步骤", @@ -1781,6 +1881,24 @@ "reviewAgentFlags": "Agent 标志", "reviewSequence": "模型序列", "reviewNoSteps": "未配置任何步骤", + "builderStagesDescription": "按顺序完成各个阶段以定义组合、构建步骤、选择路由策略并审查结果。", + "builderStepsDescription": "按顺序构建每个组合步骤：提供商、模型，然后是账户。这允许在不同账户上重复使用相同的提供商和模型。", + "selectProvider": "选择提供商", + "selectProviderPlaceholder": "选择提供商", + "selectModel": "选择模型", + "selectModelPlaceholder": "请先选择提供商", + "selectAccount": "选择账户", + "selectComboToReference": "选择要引用的现有组合", + "comboReference": "组合引用", + "addComboReference": "添加组合引用", + "addStepBeforeContinue": "在继续到下一阶段之前，请至少添加一个步骤。", + "previewNextStep": "选择提供商和模型以预览下一步。", + "autoSelectAccount": "运行时自动选择账户", + "modePackBalanced": "均衡", + "modePackBudget": "预算优先", + "modePackPerformance": "性能优先", + "modePackCustom": "自定义", + "browseLegacyCatalog": "浏览旧版模型目录", "agentFeaturesTitle": "智能代理功能", "agentFeaturesDescription": "— 可选，用于智能体/工具工作流", "agentFeaturesSystemMessageOverride": "系统消息覆盖", @@ -1788,35 +1906,77 @@ "agentFeaturesSystemMessageHint": "替换客户端发送的任何系统消息。留空则透传客户端系统消息。", "agentFeaturesToolFilterRegex": "工具过滤器正则", "agentFeaturesToolFilterHint": "只有名称匹配此正则的工具才会转发给供应商。留空则转发所有工具。", - "agentFeaturesContextCacheProtection": "上下文缓存保护", "agentFeaturesContextCacheHint": "跨轮次锁定供应商/模型以保持缓存会话。内部标签在转发给供应商前会被移除。", - "addStep": "添加步骤" + "agentFeaturesContextCacheProtection": "上下文缓存保护", + "agentFeaturesContextLength": "__MISSING__:Context length", + "agentFeaturesContextLengthPlaceholder": "__MISSING__:e.g. 128000", + "agentFeaturesContextLengthHint": "__MISSING__:Defines the context window for this combo in /v1/models.", + "agentFeaturesContextLengthErrorInteger": "__MISSING__:Context length must be a valid integer", + "agentFeaturesContextLengthErrorRange": "__MISSING__:Context length must be between 1000 and 2000000" }, "costs": { "title": "成本", + "pageDescription": "跟踪支出、分析趋势，并管理所有提供商的 AI 预算", + "overview": "概览", "budget": "预算", "totalCost": "总成本", "breakdown": "成本明细", "noData": "无成本数据", "byModel": "按模型", "byProvider": "按提供商", - "spend30d": "Spend30D", - "activeModels": "Active Models", - "selectedWindow": "Selected Window", - "activeProviders": "Active Providers", - "overviewTitle": "Overview Title", - "spend7d": "Spend7D", - "avgCostPerRequest": "Avg Cost Per Request", - "noCostDataDescription": "No Cost Data Description", - "spendToday": "Spend Today", - "overviewLoadFailed": "Overview Load Failed", - "overviewDescription": "Overview Description", - "providerShare": "Provider Share", - "topProviders": "Top Providers", - "costTrend": "Cost Trend", - "noCostDataTitle": "No Cost Data Title", - "topModels": "Top Models", - "requestsInWindow": "Requests In Window" + "range7d": "7 天", + "range30d": "30 天", + "range90d": "90 天", + "rangeAll": "全部时间", + "spend30d": "30 天支出", + "activeModels": "活跃 Model", + "selectedWindow": "已选窗口", + "activeProviders": "活跃 Provider", + "overviewTitle": "概览", + "spend7d": "7 天支出", + "avgCostPerRequest": "平均每次请求成本", + "noCostDataDescription": "发起请求后，成本数据会显示在这里。", + "spendToday": "今日支出", + "overviewLoadFailed": "加载成本概览失败", + "overviewDescription": "按提供商、模型和时间段汇总成本。", + "providerShare": "提供商占比", + "topProviders": "热门 Provider", + "costTrend": "成本趋势", + "noCostDataTitle": "暂无成本数据", + "topModels": "热门 Model", + "requestsInWindow": "窗口内请求数", + "tokenUsage": "Token 用量", + "totalTokens": "Token 总数", + "inputTokens": "输入 Token", + "outputTokens": "输出 Token", + "inputOutputRatio": "输入/输出比例", + "tokens": "token", + "routingEfficiency": "路由效率", + "fallbackCount": "回退请求数", + "fallbackRate": "回退率", + "modelCoverage": "模型覆盖率", + "modelCoverageDesc": "带有明确模型的请求占比", + "outOfRequests": "共 {total} 个请求", + "costByApiKey": "按 API 密钥统计成本", + "costByAccount": "按账户统计成本", + "apiKeyName": "API 密钥", + "account": "账户", + "requests": "请求数", + "cost": "成本", + "dayStreak": "连续天数", + "weeklyUsagePattern": "每周使用模式", + "activityHeatmap": "活动热力图（365 天）", + "less": "较少", + "more": "较多", + "monthlyForecast": "月度预测", + "forecastBasis": "基于最近 {days} 天", + "avgDailyCost": "平均每日成本", + "daysRemaining": "剩余 {days} 天", + "periodComparison": "周期对比", + "previousPeriod": "上半期", + "currentPeriod": "当前半期", + "exportCSV": "导出为 CSV", + "exportJSON": "导出为 JSON" }, "endpoint": { "title": "API 端点", @@ -1949,40 +2109,58 @@ "a2aQuickStartStep3": "使用 `tasks/get` 与 `tasks/cancel` 跟踪和控制任务。", "completionsLegacy": "Completions（旧版）", "completionsLegacyDesc": "旧版 OpenAI 文本补全接口，同时接受 `prompt` 字符串和 `messages` 数组格式", - "videoGeneration": "Video Generation", - "videoDesc": "Generate videos using AI models like ComfyUI and Stable Video Diffusion.", - "tailscaleRequestFailed": "Failed to load Tailscale status", - "tailscaleEnableFailed": "Failed to enable Tailscale Funnel", - "tailscaleWaitingForLogin": "Complete the Tailscale login in the opened browser tab. OmniRoute will retry automatically.", - "tailscaleLoginTimedOut": "Timed out waiting for Tailscale login", - "tailscaleWaitingForFunnel": "Enable Funnel for this device in the opened browser tab. OmniRoute will keep polling.", - "tailscaleFunnelTimedOut": "Timed out waiting for Tailscale Funnel to be enabled", - "tailscaleStarted": "Tailscale Funnel enabled", - "tailscaleDisableFailed": "Failed to disable Tailscale Funnel", - "tailscaleStopped": "Tailscale Funnel disabled", - "tailscaleInstallFailed": "Failed to install Tailscale", - "tailscaleInstallProgress": "Working...", - "tailscaleInstalled": "Tailscale installed successfully", - "tailscaleRunning": "Running", - "tailscaleNeedsLogin": "Needs Login", - "tailscaleStoppedState": "Stopped", - "tailscaleNotInstalled": "Not installed", - "tailscaleUnsupported": "Unsupported", - "tailscaleError": "Error", - "tailscaleDisable": "Stop Funnel", - "tailscaleInstallAndEnable": "Install & Enable", - "tailscaleLoginAndEnable": "Login & Enable", - "tailscaleEnable": "Enable Funnel", - "tailscaleUrlNotice": "Uses your Tailscale .ts.net address. Login and Funnel approval may be required on first use.", + "videoGeneration": "视频生成", + "videoDesc": "使用 ComfyUI 和 Stable Video Diffusion 等 AI 模型生成视频。", + "tailscaleRequestFailed": "加载 Tailscale 状态失败", + "tailscaleEnableFailed": "启用 Tailscale Funnel 失败", + "tailscaleWaitingForLogin": "请在打开的浏览器标签页中完成 Tailscale 登录。OmniRoute 会自动重试。", + "tailscaleLoginTimedOut": "等待 Tailscale 登录超时", + "tailscaleWaitingForFunnel": "请在打开的浏览器标签页中为此设备启用 Funnel。OmniRoute 会继续轮询。", + "tailscaleFunnelTimedOut": "等待启用 Tailscale Funnel 超时", + "tailscaleStarted": "Tailscale Funnel 已启用", + "tailscaleDisableFailed": "禁用 Tailscale Funnel 失败", + "tailscaleStopped": "Tailscale Funnel 已禁用", + "tailscaleInstallFailed": "安装 Tailscale 失败", + "tailscaleInstallProgress": "处理中...", + "tailscaleInstalled": "Tailscale 安装成功", + "tailscaleRunning": "运行中", + "tailscaleNeedsLogin": "需要登录", + "tailscaleStoppedState": "已停止", + "tailscaleNotInstalled": "未安装", + "tailscaleUnsupported": "不支持", + "tailscaleError": "错误", + "tailscaleDisable": "停止 Funnel", + "tailscaleInstallAndEnable": "安装并启用", + "tailscaleLoginAndEnable": "登录并启用", + "tailscaleEnable": "启用 Funnel", + "tailscaleUrlNotice": "使用你的 Tailscale .ts.net 地址。首次使用时可能需要登录并批准 Funnel。", "tailscaleTitle": "Tailscale Funnel", - "tailscaleNeedsLoginHint": "Authenticate this machine with Tailscale, then enable Funnel.", + "tailscaleNeedsLoginHint": "先使用 Tailscale 认证此机器，然后启用 Funnel。", "tailscaleBinaryPath": "Binary: {path}", - "tailscaleLastError": "Last error: {error}", - "tailscaleInstallTitle": "Install Tailscale", - "tailscaleInstallIntro": "Installs Tailscale on this machine and prepares OmniRoute to enable Funnel.", - "tailscaleInstallPasswordHint": "On macOS and Linux, sudo may be required for the package install and daemon start.", - "tailscaleSudoPlaceholder": "Optional sudo password", - "tailscaleInstalling": "Installing" + "tailscaleLastError": "最近错误：{error}", + "tailscaleInstallTitle": "安装 Tailscale", + "tailscaleInstallIntro": "在此机器上安装 Tailscale，并准备让 OmniRoute 启用 Funnel。", + "tailscaleInstallPasswordHint": "在 macOS 和 Linux 上，安装软件包和启动守护进程可能需要 sudo。", + "tailscaleSudoPlaceholder": "可选 sudo 密码", + "tailscaleInstalling": "正在安装", + "tailscaleSudoLabel": "Sudo 密码（macOS/Linux 上必需）", + "ngrokTitle": "ngrok 隧道", + "ngrokRunning": "运行中", + "ngrokStarting": "正在启动", + "ngrokStoppedState": "已停止", + "ngrokNeedsAuth": "需要认证", + "ngrokNotInstalled": "未安装", + "ngrokUnsupported": "不支持", + "ngrokError": "错误", + "ngrokEnable": "启用隧道", + "ngrokDisable": "停止隧道", + "ngrokUrlNotice": "创建一个公开的 ngrok 隧道。", + "ngrokAuthTokenLabel": "Authtoken（未设置 NGROK_AUTHTOKEN 时必需）", + "ngrokAuthTokenPlaceholder": "输入你的 ngrok authtoken", + "ngrokLastError": "上次错误：{error}", + "ngrokStarted": "ngrok 隧道已启动", + "ngrokStopped": "ngrok 隧道已停止", + "ngrokRequestFailed": "更新 ngrok 隧道失败" }, "endpoints": { "tabProxy": "端点代理", @@ -2063,10 +2241,10 @@ "failed": "失败", "previous": "上一页", "next": "下一页", - "apiKeyId": "Api Key Id", - "offset": "Offset", - "limit": "Limit", - "tool": "Tool" + "apiKeyId": "API Key ID", + "offset": "偏移量", + "limit": "限制", + "tool": "工具" }, "a2aDashboard": { "loading": "正在加载 A2A 仪表板...", @@ -2121,11 +2299,66 @@ "metadata": "元数据", "events": "事件", "artifacts": "产物", - "tablePhase": "Table Phase", - "offset": "Offset", - "limit": "Limit", + "tablePhase": "阶段", + "offset": "偏移量", + "limit": "限制", "skill": "Skill" }, + "memory": { + "title": "记忆管理", + "description": "查看并管理已存储的记忆条目", + "memories": "记忆", + "totalEntries": "总条目数", + "tokensUsed": "已用 Tokens", + "hitRate": "命中率", + "loading": "正在加载记忆...", + "noMemories": "未找到记忆条目", + "search": "搜索记忆...", + "allTypes": "全部类型", + "export": "导出", + "import": "导入", + "addMemory": "添加记忆", + "type": "类型", + "key": "键", + "content": "内容", + "created": "创建时间", + "actions": "操作", + "delete": "删除", + "factual": "事实型", + "episodic": "情景型", + "procedural": "程序型", + "semantic": "语义型", + "a": "A" + }, + "skills": { + "title": "技能", + "description": "管理并监控 AI 技能", + "skillsTab": "技能", + "executionsTab": "执行记录", + "sandboxTab": "沙箱", + "loading": "正在加载技能...", + "noSkills": "未找到技能", + "noExecutions": "未找到执行记录", + "enabled": "已启用", + "disabled": "已禁用", + "version": "版本", + "tableDescription": "说明", + "skill": "技能", + "status": "状态", + "duration": "耗时", + "time": "时间", + "sandboxConfig": "沙箱配置", + "cpuLimit": "CPU 限制", + "cpuLimitDesc": "单个技能允许的最长执行时间", + "memoryLimit": "内存限制", + "memoryLimitDesc": "允许分配的最大内存", + "timeout": "超时", + "timeoutDesc": "等待响应的最长时间", + "networkAccess": "网络访问", + "networkAccessDesc": "允许发起出站网络请求", + "mode": "模式", + "q": "Q" + }, "health": { "title": "系统健康状况", "description": "实时监控您的 OmniRoute 实例", @@ -2199,11 +2432,77 @@ "resetting": "正在重置...", "resetAll": "全部重置", "until": "直到 {time}", - "limitExhausted": "Exhausted", - "learnedFromHeaders": "Learned from headers", - "remainingOfLimit": "{remaining}/{limit} remaining", - "throttleStatus": "Throttle: {value}", - "lastHeaderUpdate": "Header update: {age}" + "limitExhausted": "已耗尽", + "learnedFromHeaders": "从响应头学习", + "remainingOfLimit": "剩余 {remaining}/{limit}", + "throttleStatus": "限流：{value}", + "lastHeaderUpdate": "响应头更新：{age}" + }, + "telemetry": { + "title": "系统遥测", + "description": "来自此 OmniRoute 进程的滚动请求、运行时、会话和内存信号。", + "uptime": "运行时间", + "totalRequests": "请求总数", + "avgLatency": "平均延迟", + "errorRate": "错误率", + "activeConnections": "活动连接", + "memoryUsage": "内存使用", + "latencyTrend": "延迟趋势", + "throughputTrend": "吞吐趋势", + "memoryTrend": "内存趋势", + "refresh": "刷新", + "updatedAt": "更新于 {time}", + "loadFailed": "加载遥测失败。", + "partialData": "遥测数据部分可用：{error}" + }, + "mitm": { + "title": "MITM 代理", + "description": "用于拦截和路由客户端请求的透明代理。", + "enable": "启用 MITM 代理", + "enableDesc": "启动或停止本地拦截进程和 DNS 覆盖。", + "status": "状态", + "running": "运行中", + "stopped": "已停止", + "start": "启动", + "stop": "停止", + "refresh": "刷新", + "port": "代理端口", + "apiKey": "路由器 API 密钥", + "apiKeyPlaceholder": "可选；留空则回退到本地密钥", + "sudoPassword": "Sudo 密码", + "cachedPassword": "已为此进程缓存", + "saveSettings": "保存设置", + "settingsSaved": "MITM 设置已保存。", + "startedSuccess": "MITM 代理已启动。", + "stoppedSuccess": "MITM 代理已停止。", + "saveFailed": "更新 MITM 设置失败。", + "loadFailed": "加载 MITM 设置失败。", + "invalidPort": "透明 MITM 拦截当前要求使用端口 443。", + "certificate": "CA 证书", + "certificateReady": "证书已可用于客户端信任安装。", + "certificateMissing": "尚未生成证书。", + "available": "可用", + "missing": "缺失", + "downloadCert": "下载 CA 证书", + "regenerateCert": "重新生成证书", + "regenerateConfirm": "这会使现有客户端信任失效。要继续吗？", + "regenerateSuccess": "MITM 证书已重新生成。", + "regenerateFailed": "重新生成 MITM 证书失败。", + "targetRoutes": "目标路由", + "interceptedRequests": "已拦截请求", + "activeConnections": "活动连接", + "dnsConfigured": "DNS 已配置", + "pid": "PID", + "lastIntercept": "上次拦截", + "target": "目标", + "host": "主机", + "localPort": "本地端口", + "endpoints": "端点", + "enabled": "已启用", + "configured": "已配置", + "yes": "是", + "no": "否", + "noTargets": "未配置目标路由。" }, "limits": { "title": "限制和配额", @@ -2242,46 +2541,46 @@ "noEntries": "未找到审核日志条目", "previous": "上一页", "next": "下一页", - "providerWarningTitle": "Provider Warning Title", - "viewDetails": "View Details", - "eventMetadata": "Event Metadata", - "eventPayload": "Event Payload", - "requestId": "Request Id", - "providerWarningDesc": "Provider Warning Desc", + "providerWarningTitle": "提供商警告", + "viewDetails": "查看详情", + "eventMetadata": "事件元数据", + "eventPayload": "事件负载", + "requestId": "请求 ID", + "providerWarningDesc": "上游提供商返回了警告。请查看详情以了解更多信息。", "a": "A", - "offset": "Offset", - "limit": "Limit", - "status": "Status", - "resourceType": "Resource Type", - "totalEntries": "Total Entries", - "tab": "Tab", - "auditModalSubtitle": "Audit Modal Subtitle", - "close": "Close", - "runningRequests": "Active Requests", - "runningRequestsDesc": "Real-time view of currently running upstream requests", - "model": "Model", - "provider": "Provider", + "offset": "偏移量", + "limit": "限制", + "status": "状态", + "resourceType": "资源类型", + "totalEntries": "总条目数", + "tab": "标签页", + "auditModalSubtitle": "审计详情", + "close": "关闭", + "runningRequests": "活跃请求", + "runningRequestsDesc": "当前正在运行的上游请求实时视图", + "model": "模型", + "provider": "提供商", "account": "Account", - "elapsed": "Elapsed", - "count": "Count", - "payloads": "Payloads", - "viewPayloads": "View", - "activeCount": "{count} active", - "clientPayload": "Client Request Payload", - "upstreamPayload": "Upstream Provider Payload", - "upstreamNotSentYet": "Not sent to upstream yet", - "runningRequestDetailMeta": "Account: {account} — Elapsed: {elapsed}", + "elapsed": "已耗时", + "count": "数量", + "payloads": "Payload", + "viewPayloads": "查看", + "activeCount": "{count} 个活跃", + "clientPayload": "客户端请求载荷", + "upstreamPayload": "上游提供商载荷", + "upstreamNotSentYet": "尚未发送到上游", + "runningRequestDetailMeta": "Account：{account} — 已耗时：{elapsed}", + "export": "导出", + "exporting": "正在导出...", + "exportFailed": "导出失败", + "timeRange": "时间范围", + "lastNHours": "最近 {hours} 小时", + "defaultRange": "默认", "consoleViewer": { - "fetchFailed": "Failed to fetch logs", - "copyFailed": "Failed to copy log entry", - "copyLogEntry": "Copy log entry" - }, - "export": "Export", - "exporting": "Exporting...", - "exportFailed": "Export failed", - "timeRange": "Time Range", - "lastNHours": "Last {hours}", - "defaultRange": "default" + "fetchFailed": "获取日志失败", + "copyFailed": "复制日志条目失败", + "copyLogEntry": "复制日志条目" + } }, "onboarding": { "welcome": "欢迎", @@ -2362,6 +2661,12 @@ "errorCount": "{count} 错误 ({code})", "errorCountNoCode": "{count} 错误", "noConnections": "无连接", + "expiredBadge": "已过期", + "expiringSoonBadge": "即将过期", + "freeTier": "免费额度", + "freeTierAvailable": "有免费额度", + "deprecated": "已弃用", + "deprecatedProvider": "此提供商已弃用", "disabled": "已禁用", "enableProvider": "启用提供商", "disableProvider": "禁用提供商", @@ -2377,7 +2682,7 @@ "selectProvider": "选择提供商", "selectedProvider": "选定的提供商", "authMethod": "认证方式", - "apiKeyLabel": "API密钥", + "apiKeyLabel": "API key", "apiKeyRequired": "需要 API 密钥", "selectProviderRequired": "请选择提供商", "enterApiKey": "输入您的 API 密钥", @@ -2420,7 +2725,7 @@ "nameLabel": "名称", "prefixLabel": "前缀", "baseUrlLabel": "基础 URL", - "apiTypeLabel": "API类型", + "apiTypeLabel": "API 类型", "prefixHint": "必填。模型名称使用的唯一前缀。", "nameHint": "必填。该节点的友好标签。", "baseUrlHint": "必填。  提供商 API 基本 URL。", @@ -2448,6 +2753,10 @@ "openaiCompatibleDetails": "OpenAI 兼容详情", "messagesApi": "Messages API", "responsesApi": "Responses API", + "embeddings": "Embeddings", + "audioTranscriptions": "音频转写", + "audioSpeech": "语音合成", + "imagesGenerations": "图像生成", "chatCompletions": "聊天完成", "importingModels": "正在导入...", "importFromModels": "从 /models 导入", @@ -2586,7 +2895,7 @@ "compatUpstreamRemoveRow": "删除此行", "compatBadgeUpstreamHeaders": "请求头", "perModelQuotaLabel": "按模型配额", - "perModelQuotaDescription": "启用后，429/404错误只会锁定特定模型，而不是整个连接。适用于具有按模型速率限制的提供商（例如ModelScope）。", + "perModelQuotaDescription": "启用后，429/404 错误只会锁定特定 Model，而不是整个连接。适用于具有按 Model 速率限制的 Provider（例如 ModelScope）。", "perModelQuotaToggle": "按模型配额开关", "modelId": "模型 ID", "customModelPlaceholder": "例如：gpt-4.5-turbo", @@ -2655,39 +2964,37 @@ "statusCreditsExhausted": "余额不足 / 配额已耗尽", "showEmails": "显示所有邮箱", "hideEmails": "隐藏所有邮箱", - "imagesGenerations": "Images Generations", - "audioSpeech": "Audio Speech", - "audioTranscriptions": "Audio Transcriptions", - "embeddings": "Embeddings", "a": "A", - "accountConcurrencyCapHint": "Account Concurrency Cap Hint", - "accountConcurrencyCapLabel": "Account Concurrency Cap Label", - "accountIdHint": "Account Id Hint", - "accountIdLabel": "Account Id Label", - "accountIdPlaceholder": "Account Id Placeholder", - "addAnotherApiKey": "Add another API key or paste multiple keys", + "accountConcurrencyCapHint": "限制此 Account 可同时处理的请求数。", + "accountConcurrencyCapLabel": "Account 并发上限", + "accountIdHint": "用于区分同一 Provider 下的多个 Account。", + "accountIdLabel": "Account ID", + "accountIdPlaceholder": "Account ID 占位符", + "addAnotherApiKey": "添加另一个 API 密钥或粘贴多个密钥", "addCcCompatible": "添加 CC 兼容", - "aggregatorsGateways": "Aggregators Gateways", - "apiFormatLabel": "Api Format Label", - "apiKeyOptionalHint": "Api Key Optional Hint", - "apiKeyOptionalLabel": "Api Key Optional Label", - "apiRegionChina": "Api Region China", - "apiRegionHint": "Api Region Hint", - "apiRegionInternational": "Api Region International", - "apiRegionLabel": "Api Region Label", - "apikey": "Apikey", - "audio": "Audio", - "audioProvidersHeading": "Audio Providers Heading", - "audioShortLabel": "Audio Short Label", - "azureOpenAiBaseUrlHint": "Azure Open Ai Base Url Hint", - "bailianBaseUrlHint": "Bailian Base Url Hint", - "blackboxWebCookieHint": "Blackbox Web Cookie Hint", - "blackboxWebCookiePlaceholder": "Blackbox Web Cookie Placeholder", + "aggregatorsGateways": "聚合器与网关", + "enterpriseCloud": "企业与云", + "apiFormatLabel": "API 格式", + "apiKeyOptionalHint": "如果上游不需要认证，可以留空 API key。", + "apiKeyOptionalLabel": "API key（可选）", + "apiRegionChina": "中国区", + "apiRegionHint": "选择此 Provider 的 API 区域。", + "apiRegionInternational": "国际区", + "apiRegionLabel": "API 区域", + "apikey": "API key", + "audio": "音频", + "audioProvidersHeading": "音频 Provider", + "cloudAgentProviders": "__MISSING__:Cloud Agent Providers", + "audioShortLabel": "音频", + "azureOpenAiBaseUrlHint": "Azure OpenAI 资源的 Base URL。", + "bailianBaseUrlHint": "阿里云百炼服务的 Base URL。", + "blackboxWebCookieHint": "从 Blackbox Web 会话复制 Cookie。", + "blackboxWebCookiePlaceholder": "Blackbox Web Cookie", "blockClaudeExtraUsageDescription": "隐藏部分 Provider 返回的重复 Claude 额外用量记录，避免和主 token 统计重复。", "blockClaudeExtraUsageLabel": "屏蔽重复 Claude 用量", - "bulkPasteAdded": "{count, plural, one {1 key added} other {# keys added}}", - "bulkPasteDuplicatesIgnored": "{count, plural, one {1 duplicate skipped} other {# duplicates skipped}}", - "bulkPasteHint": "Paste one API key per line. Empty lines are ignored and duplicate keys are skipped.", + "bulkPasteAdded": "{count, plural, one {已添加 1 个 key} other {已添加 # 个 key}}", + "bulkPasteDuplicatesIgnored": "{count, plural, one {已跳过 1 个重复项} other {已跳过 # 个重复项}}", + "bulkPasteHint": "每行粘贴一个 API 密钥。空行会被忽略，重复密钥会被跳过。", "ccCompatibleBaseUrlHint": "Claude Code 专用中转站的 Base URL，不要包含 /messages。", "ccCompatibleBaseUrlPlaceholder": "https://relay.example.com/v1", "ccCompatibleChatPathHint": "默认使用 Claude Code 严格的 Messages API 路径。仅在中转站文档要求时修改。", @@ -2707,111 +3014,117 @@ "codexFastServiceTierDescription": "可用时为 Codex 请求使用 priority 服务层。", "codexFastServiceTierLabel": "Codex 快速服务层", "codexWeeklyToggleTitle": "为此连接跟踪 Codex 周配额", - "compatUpstreamHeaderNamePlaceholder": "Compat Upstream Header Name Placeholder", - "compatUpstreamHeaderValuePlaceholder": "Compat Upstream Header Value Placeholder", - "compatible": "Compatible", - "configuredCount": "Configured Count", - "consoleApiKeyOracleHint": "Console Api Key Oracle Hint", - "consoleApiKeyOracleLabel": "Console Api Key Oracle Label", - "consoleApiKeyOraclePlaceholder": "Console Api Key Oracle Placeholder", + "compatUpstreamHeaderNamePlaceholder": "上游 Header 名称", + "compatUpstreamHeaderValuePlaceholder": "上游 Header 值", + "compatible": "兼容", + "configuredCount": "已配置数量", + "consoleApiKeyOracleHint": "用于从 Console 获取或验证 API key 的辅助配置。", + "consoleApiKeyOracleLabel": "Console API key Oracle", + "consoleApiKeyOraclePlaceholder": "Console API key Oracle 占位符", "cpaModeDisabledTitle": "CLIProxyAPI 兼容模式已关闭", "cpaModeEnabledTitle": "CLIProxyAPI 兼容模式已开启", - "customUserAgentHint": "Custom User Agent Hint", - "customUserAgentLabel": "Custom User Agent Label", - "databricksBaseUrlHint": "Databricks Base Url Hint", + "customUserAgentHint": "发送给上游 Provider 的自定义 User-Agent。", + "customUserAgentLabel": "自定义 User-Agent", + "databricksBaseUrlHint": "Databricks Serving Endpoint 的 Base URL。", "defaultThinkingStrengthHint": "请求未指定 reasoning effort 时使用。", "defaultThinkingStrengthLabel": "默认思考强度", - "deleteAllExtraApiKeys": "Delete all", - "excludedModelsHint": "Excluded Models Hint", - "excludedModelsLabel": "Excluded Models Label", - "excludedModelsPlaceholder": "Excluded Models Placeholder", - "expirationBannerExpired": "Expiration Banner Expired", - "expirationBannerExpiredDesc": "Expiration Banner Expired Desc", - "expirationBannerExpiringSoon": "Expiration Banner Expiring Soon", - "expirationBannerExpiringSoonDesc": "Expiration Banner Expiring Soon Desc", + "deleteAllExtraApiKeys": "全部删除", + "excludedModelsHint": "这些 Model 不会出现在路由和选择器中。", + "excludedModelsLabel": "排除的 Model", + "excludedModelsPlaceholder": "以逗号分隔的 Model ID", + "expirationBannerExpired": "凭据已过期", + "expirationBannerExpiredDesc": "此 Provider 的凭据已过期，请更新后继续使用。", + "expirationBannerExpiringSoon": "凭据即将过期", + "expirationBannerExpiringSoonDesc": "此 Provider 的凭据即将过期，请提前更新。", "extraApiKeyMasked": "Key {index}: {prefix}••••{suffix}", - "extraApiKeysHint": "Extra Api Keys Hint", - "extraApiKeysLabel": "Extra Api Keys Label", - "googlePseInfo": "Google Pse Info", - "grokWebCookieHint": "Grok Web Cookie Hint", - "grokWebCookiePlaceholder": "Grok Web Cookie Placeholder", - "herokuBaseUrlHint": "Heroku Base Url Hint", - "hideEmail": "Hide Email", - "imageProviders": "Image Providers", - "imagesShortLabel": "Images Short Label", - "llmProviders": "Llm Providers", - "localProviderApiKeyOptionalHint": "Local Provider Api Key Optional Hint", - "localProviderBaseUrlHint": "Local Provider Base Url Hint", - "localProviders": "Local Providers", - "maxConcurrentWholeNumberError": "Max Concurrent Whole Number Error", - "museSparkWebCookieHint": "Muse Spark Web Cookie Hint", - "museSparkWebCookiePlaceholder": "Muse Spark Web Cookie Placeholder", - "oauth": "Oauth", - "openCliTools": "Open Cli Tools", - "openSettings": "Open Settings", + "extraApiKeysHint": "为同一提供商添加额外 API 密钥，以便轮换和回退使用。", + "extraApiKeysLabel": "额外 API 密钥", + "googlePseInfo": "配置 Google Programmable Search Engine 以启用 Web Search。", + "geminiCliProjectIdHint": "__MISSING__:Your Google Cloud Project ID. Required for accounts with exceptions. Enter your GCP Project ID to use with Gemini CLI.", + "geminiCliProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "geminiCliProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "antigravityProjectIdHint": "__MISSING__:Optional override for Antigravity Cloud Code requests. Leave blank to use the project discovered during Google OAuth.", + "antigravityProjectIdLabel": "__MISSING__:Google Cloud Project ID", + "antigravityProjectIdPlaceholder": "__MISSING__:my-gcp-project-id", + "grokWebCookieHint": "从 Grok Web 会话复制 Cookie。", + "grokWebCookiePlaceholder": "Grok Web Cookie", + "herokuBaseUrlHint": "Heroku 部署的 Base URL。", + "hideEmail": "隐藏邮箱", + "imageProviders": "图像 Provider", + "videoProviders": "视频生成", + "embeddingRerankProviders": "嵌入与重排序", + "imagesShortLabel": "图像", + "llmProviders": "LLM Provider", + "localProviderApiKeyOptionalHint": "本地提供商的 API 密钥通常是可选的。", + "localProviderBaseUrlHint": "输入本地提供商的 Base URL。", + "localProviders": "本地 Provider", + "maxConcurrentWholeNumberError": "最大并发必须是整数", + "museSparkWebCookieHint": "从 Muse Spark Web 会话复制 Cookie。", + "museSparkWebCookiePlaceholder": "Muse Spark Web Cookie", + "oauth": "OAuth", + "openCliTools": "打开 CLI Tools", + "openSettings": "打开设置", "openaiResponsesStoreDescription": "允许兼容的 Responses API 请求保留已存储的响应状态。", "openaiResponsesStoreLabel": "OpenAI Responses 存储", - "perplexitySearchSharedKeyInfo": "Perplexity Search Shared Key Info", - "perplexityWebCookieHint": "Perplexity Web Cookie Hint", - "perplexityWebCookiePlaceholder": "Perplexity Web Cookie Placeholder", - "personalAccessTokenLabel": "Personal Access Token Label", - "qoderPatHint": "Qoder Pat Hint", - "qoderPatPlaceholder": "Qoder Pat Placeholder", - "refreshOauthTokenTitle": "Refresh Oauth Token Title", - "regionHint": "Region Hint", - "regionLabel": "Region Label", - "removeThisKey": "Remove This Key", - "routingTagsHint": "Routing Tags Hint", - "routingTagsLabel": "Routing Tags Label", - "routingTagsPlaceholder": "Routing Tags Placeholder", - "search": "Search", - "searchEngineIdHint": "Search Engine Id Hint", - "searchEngineIdLabel": "Search Engine Id Label", - "searchEngineIdRequired": "Search Engine Id Required", - "searchProvider": "Search Provider", - "searchProviderDesc": "Search Provider Desc", - "searchProviders": "Search Providers", - "searchProvidersHeading": "Search Providers Heading", - "searxngBaseUrlHint": "Searxng Base Url Hint", - "searxngInfo": "Searxng Info", - "sessionCookieLabel": "Session Cookie Label", - "showEmail": "Show Email", - "snowflakeBaseUrlHint": "Snowflake Base Url Hint", + "perplexitySearchSharedKeyInfo": "Perplexity Search 可使用共享 key 配置。", + "perplexityWebCookieHint": "从 Perplexity Web 会话复制 Cookie。", + "perplexityWebCookiePlaceholder": "Perplexity Web Cookie", + "personalAccessTokenLabel": "个人访问令牌", + "qoderPatHint": "输入 Qoder Personal Access Token。", + "qoderPatPlaceholder": "Qoder PAT", + "refreshOauthTokenTitle": "刷新 OAuth Token", + "regionHint": "选择此 Provider 使用的区域。", + "regionLabel": "区域", + "removeThisKey": "移除此 key", + "routingTagsHint": "添加标签以便在路由规则中匹配此连接。", + "routingTagsLabel": "路由标签", + "routingTagsPlaceholder": "例如 coding, fast, cheap", + "search": "搜索", + "searchEngineIdHint": "Google Programmable Search Engine 的 ID。", + "searchEngineIdLabel": "Search Engine ID", + "searchEngineIdRequired": "Search Engine ID 为必填项", + "searchProvider": "搜索提供商", + "searchProviderDesc": "按名称、能力或类别查找提供商。", + "searchProviders": "搜索 Provider", + "searchProvidersHeading": "搜索 Provider", + "searxngBaseUrlHint": "SearXNG 实例的 Base URL。", + "searxngInfo": "配置 SearXNG 以启用自托管 Web Search。", + "sessionCookieLabel": "Session Cookie", + "showEmail": "显示邮箱", + "snowflakeBaseUrlHint": "Snowflake Cortex 服务的 Base URL。", "supportedEndpointAudio": "音频", "supportedEndpointChat": "聊天", "supportedEndpointEmbeddings": "Embeddings", "supportedEndpointImages": "图像", "supportedEndpointsLabel": "支持的端点", - "tagGroupHint": "Tag Group Hint", - "tagGroupLabel": "Tag Group Label", - "tagGroupPlaceholder": "Tag Group Placeholder", - "testModel": "Test Model", - "testingModel": "Testing Model", + "tagGroupHint": "用于筛选和组织 Provider 的标签分组。", + "tagGroupLabel": "标签分组", + "tagGroupPlaceholder": "标签分组占位符", + "testModel": "测试模型", + "testingModel": "正在测试模型", "toggleOffShort": "关", "toggleOnShort": "开", - "tokenExpiredBadge": "Token Expired Badge", - "tokenExpiredTitle": "Token Expired Title", - "tokenExpiresSoonTitle": "Token Expires Soon Title", - "tokenShort": "Token Short", - "totalKeysRotating": "{count, plural, one {1 key rotating} other {# keys rotating}}", - "unhideModel": "Unhide Model", - "upstreamProxyProviders": "Upstream Proxy Providers", - "validationModelIdHint": "Validation Model Id Hint", - "validationModelIdLabel": "Validation Model Id Label", - "validationModelIdPlaceholder": "Validation Model Id Placeholder", - "vertexServiceAccountPlaceholder": "Vertex Service Account Placeholder", - "webCookieProviders": "Web Cookie Providers", - "weeklyShort": "Weekly Short", - "xiaomiMimoBaseUrlHint": "Xiaomi Mimo Base Url Hint", - "zedImportButton": "Zed Import Button", - "zedImportFailed": "Zed Import Failed", - "zedImportHint": "Zed Import Hint", - "zedImportNetworkError": "Zed Import Network Error", - "zedImportNone": "Zed Import None", - "zedImportSuccess": "Zed Import Success", - "zedImporting": "Zed Importing", - "expiredBadge": "Expired", - "expiringSoonBadge": "Expiring Soon" + "tokenExpiredBadge": "Token 已过期", + "tokenExpiredTitle": "Token 已过期", + "tokenExpiresSoonTitle": "Token 即将过期", + "tokenShort": "Token", + "totalKeysRotating": "{count, plural, one {1 个 key 正在轮换} other {# 个 key 正在轮换}}", + "unhideModel": "取消隐藏模型", + "upstreamProxyProviders": "上游代理 Provider", + "validationModelIdHint": "用于验证此提供商连接的模型 ID。", + "validationModelIdLabel": "验证模型 ID", + "validationModelIdPlaceholder": "输入用于测试的模型 ID", + "vertexServiceAccountPlaceholder": "Vertex Service Account", + "webCookieProviders": "Web Cookie Provider", + "weeklyShort": "每周", + "xiaomiMimoBaseUrlHint": "小米 Mimo 服务的 Base URL。", + "zedImportButton": "从 Zed 导入", + "zedImportFailed": "Zed 导入失败", + "zedImportHint": "从 Zed 配置中导入 Provider。", + "zedImportNetworkError": "Zed 导入网络错误", + "zedImportNone": "没有可从 Zed 导入的内容", + "zedImportSuccess": "Zed 导入成功", + "zedImporting": "正在从 Zed 导入" }, "settings": { "title": "设置", @@ -2824,22 +3137,23 @@ "systemPrompt": "系统提示", "thinkingBudget": "思考预算", "proxy": "代理", - "httpProxy": "HTTP Proxy", + "httpProxy": "HTTP 代理", "1proxy": "1proxy", - "proxySubTabsAria": "Proxy sections", - "requestBodyLimitTitle": "Request Body Limit", - "requestBodyLimitDescription": "Maximum API payload size accepted before a request body is parsed. Dedicated upload routes keep at least their built-in 100 MB limit.", - "requestBodyLimitInputLabel": "Request body limit in MB", - "requestBodyLimitEmptyError": "Enter a limit in MB", - "requestBodyLimitWholeNumberError": "Use a whole number", - "requestBodyLimitMinimumError": "Minimum is {min} MB", - "requestBodyLimitMaximumError": "Maximum is {max} MB", - "requestBodyLimitLoadFailed": "Failed to load request limit settings", - "requestBodyLimitSaveSuccess": "Request body limit saved", - "requestBodyLimitSaveFailed": "Failed to save request body limit", - "requestBodyLimitSaving": "Saving...", - "requestBodyLimitSave": "Save", - "requestBodyLimitCurrent": "Current: {value}", + "proxySubTabsAria": "代理设置分区", + "requestBodyLimitTitle": "请求体大小限制", + "requestBodyLimitDescription": "解析请求体前允许的最大 API 载荷大小。专用上传路由仍至少保留其内置的 100 MB 限制。", + "requestBodyLimitInputLabel": "请求体限制（MB）", + "requestBodyLimitEmptyError": "请输入 MB 限制值", + "requestBodyLimitWholeNumberError": "请使用整数", + "requestBodyLimitMinimumError": "最小值为 {min} MB", + "requestBodyLimitMaximumError": "最大值为 {max} MB", + "requestBodyLimitLoadFailed": "加载请求限制设置失败", + "requestBodyLimitSaveSuccess": "请求体限制已保存", + "requestBodyLimitSaveFailed": "保存请求体限制失败", + "requestBodyLimitSaving": "正在保存...", + "requestBodyLimitSave": "保存", + "requestBodyLimitCurrent": "当前：{value}", + "mitmProxy": "MITM 代理", "pricing": "定价", "storage": "存储", "policies": "策略", @@ -2925,6 +3239,8 @@ "autoDisableDescription": "若提供商连接返回特定的永久封禁信号（如 HTTP 403\"请验证您的账户\"），则将其永久标记为停用。这会将其从组合轮换中移除。", "autoDisableThreshold": "封禁阈值", "autoDisableThresholdDesc": "触发永久停用所需的连续封禁信号次数。", + "resilienceStructureTitle": "__MISSING__:Resilience Structure", + "resilienceStructureDesc": "__MISSING__:This page only configures behavior. Live breaker state is shown on the Health page. Combo-specific retry and round-robin slot control remain on combo settings.", "enableThinking": "激发思考", "maxThinkingTokens": "最大思考令牌", "enableProxy": "启用代理", @@ -3030,7 +3346,7 @@ "effortMedium": "中（10K Tokens）", "effortHigh": "高（128K Tokens）", "tokenBudget": "Token 预算", - "tokens": "Tokens", + "tokens": "Token", "baseEffortLevel": "基本努力水平", "adaptiveHint": "自适应模式根据消息计数、工具使用情况和提示长度从此基本级别进行扩展。", "requireLogin": "需要登录", @@ -3050,6 +3366,14 @@ "apiEndpointProtection": "API 端点保护", "requireAuthModels": "/models 需要 API 密钥", "requireAuthModelsDesc": "开启后，`/v1/models` 对未认证请求返回 404，从而阻止未授权用户发现模型。", + "authModelHeading": "当前授权模型", + "authModelClient": "客户端 API 端点（/v1/*、/chat/*、/responses/*、/codex/*、/messages/*）需要 Bearer API 密钥。", + "authModelManagement": "管理端点（/dashboard、/api/*）需要仪表盘会话或管理凭据。", + "authModelPublic": "只有登录、健康检查和引导路由是公开的。", + "bruteForceProtection": "登录暴力破解保护", + "bruteForceProtectionDesc": "在同一 IP 多次失败后，对 /api/auth/login 进行限流和锁定。", + "corsAllowedOrigins": "CORS 允许的源", + "corsAllowedOriginsDesc": "允许调用此服务器的浏览器来源列表，以逗号分隔。空列表 = 不允许浏览器 CORS 访问（服务器到服务器仍可用）。仅在开发环境使用 CORS_ALLOW_ALL=true 环境变量。", "blockedProviders": "被阻止的提供商", "blockedProvidersDesc": "在 `/v1/models` 响应中隐藏指定提供商。被隐藏的提供商不会出现在模型列表中。", "providersBlocked": "{count} 个提供商/模型已屏蔽", @@ -3078,13 +3402,15 @@ "leastUsedDesc": "优先选择最近使用最少的账户", "costOpt": "成本优化", "costOptDesc": "优先选择成本最低的可用账户", + "resetAware": "__MISSING__:Reset-Aware RR", + "resetAwareDesc": "__MISSING__:Prefer accounts with healthy remaining quota and nearer resets", "strictRandom": "严格随机", "strictRandomDesc": "洗牌池模式：每个账户使用一次后再重新洗牌", "stickyLimit": "粘性限制", "stickyLimitDesc": "切换前每个账户连续处理的请求次数", "modelAliases": "模型别名", "modelAliasesTitle": "模型别名", - "modelAliasesDesc": "Remap model names using exact matches or wildcard patterns.", + "modelAliasesDesc": "使用精确匹配或通配符模式重映射模型名称。", "addCustomAlias": "添加自定义别名", "deprecatedModelId": "已弃用的模型 ID", "newModelId": "新模型 ID", @@ -3338,199 +3664,228 @@ "maintenance": "维护", "purgeExpiredLogs": "清理过期日志", "purgeLogsFailed": "清理日志失败", - "contextOpt": "Context Optimized", - "contextOptDesc": "Routes based on context window requirements and conversation length", - "priorityDesc": "Sequential fallback - tries provider 1 first, then provider 2, and so on", - "weightedDesc": "Distributes traffic by percentage weights across providers", - "modelRoutingTitle": "Model Routing Rules", - "modelRoutingDesc": "Automatically route models to specific combos using glob patterns", - "addRule": "Add Rule", - "routeToCombo": "Route to Combo", - "selectCombo": "Select combo...", - "priorityHint": "Higher = checked first. Use 10+ for specific patterns.", - "patternHint": "Use * for any chars, ? for single char. Case-insensitive.", - "noRoutingRules": "No routing rules configured. Requests use the global combo by default.", - "routingRuleHint": "Add a rule like claude-opus* -> frontier-combo to automatically route requests.", - "deleteRoutingRule": "Delete this model routing rule?", - "exactMatchMode": "Exact Match", - "wildcardPatternMode": "Wildcard Pattern", - "exactMatchModeDesc": "Use exact aliases for deprecated or renamed model IDs.", - "wildcardPatternModeDesc": "Use wildcard aliases with * and ? when a family of models should map to one target.", - "noExactAliasesConfigured": "No exact-match aliases configured.", - "wildcardRulesTitle": "Wildcard Rules", - "noWildcardAliasesConfigured": "No wildcard aliases configured.", - "overview": "Overview", - "unknownError": "Unknown Error", - "pricingSourceLiteLLM": "Pricing Source Lite Llm", - "clearSyncedPricingConfirm": "Clear Synced Pricing Confirm", - "clearSyncedPricingFailed": "Clear Synced Pricing Failed", - "pricingSourceUser": "Pricing Source User", - "pageDescription": "Page Description", - "pricingSyncStatus": "Pricing Sync Status", - "whitelist": "Whitelist", - "syncDisabled": "Sync Disabled", - "pricingLoadFailed": "Pricing Load Failed", - "pricingSyncDescription": "Pricing Sync Description", - "clearSyncedPricingSuccess": "Clear Synced Pricing Success", - "clearSyncedPricingFailedWithReason": "Clear Synced Pricing Failed With Reason", - "pricingSourceDefault": "Pricing Source Default", - "pricingSyncSuccess": "Pricing Sync Success", - "enableSyncError": "Enable Sync Error", - "syncEnabled": "Sync Enabled", - "blacklist": "Blacklist", - "pricingSourceModelsDev": "Pricing Source Models Dev", - "syncedModels": "Synced Models", - "budget": "Budget", - "pricingSyncTitle": "Pricing Sync Title", - "pricingResetFailedWithReason": "Pricing Reset Failed With Reason", - "tab": "Tab", - "pricingSavedProvider": "Pricing Saved Provider", - "pricingSyncFailed": "Pricing Sync Failed", - "pricingSaveFailedWithReason": "Pricing Save Failed With Reason", - "pricingResetProvider": "Pricing Reset Provider", - "nextSync": "Next Sync", - "pricingSyncFailedWithReason": "Pricing Sync Failed With Reason", - "clearSyncedPricing": "Clear Synced Pricing", - "compressionTitle": "Prompt Compression", - "compressionDesc": "Reduce token usage by compressing prompts before sending to providers", - "compressionMode": "Compression Mode", - "compressionModeOff": "Off", - "compressionModeOffDesc": "No compression applied", + "contextOpt": "上下文优化", + "contextOptDesc": "根据上下文窗口需求和对话长度进行路由", + "priorityDesc": "顺序回退——先尝试提供商 1，再尝试提供商 2，依此类推", + "weightedDesc": "按百分比权重在各提供商之间分配流量", + "modelRoutingTitle": "模型路由规则", + "modelRoutingDesc": "使用 glob 模式自动将模型路由到指定组合", + "addRule": "添加规则", + "routeToCombo": "路由到组合", + "selectCombo": "选择组合...", + "priorityHint": "数值越高越优先检查。具体模式建议使用 10+。", + "patternHint": "使用 * 匹配任意字符，? 匹配单个字符。不区分大小写。", + "noRoutingRules": "未配置路由规则。请求默认使用全局组合。", + "routingRuleHint": "添加类似 claude-opus* -> frontier-combo 的规则，以自动路由请求。", + "deleteRoutingRule": "删除此模型路由规则？", + "exactMatchMode": "精确匹配", + "wildcardPatternMode": "通配符模式", + "exactMatchModeDesc": "对已弃用或已重命名的模型 ID 使用精确别名。", + "wildcardPatternModeDesc": "当一组模型应映射到同一目标时，使用带 * 和 ? 的通配符别名。", + "noExactAliasesConfigured": "未配置精确匹配别名。", + "wildcardRulesTitle": "通配符规则", + "noWildcardAliasesConfigured": "未配置通配符别名。", + "overview": "概览", + "unknownError": "未知错误", + "pricingSourceLiteLLM": "LiteLLM 定价来源", + "clearSyncedPricingConfirm": "确定要清除已同步的定价吗？", + "clearSyncedPricingFailed": "清除已同步定价失败", + "pricingSourceUser": "用户定价来源", + "pageDescription": "页面描述", + "pricingSyncStatus": "定价同步状态", + "whitelist": "白名单", + "syncDisabled": "同步已禁用", + "pricingLoadFailed": "加载定价失败", + "pricingSyncDescription": "从 models.dev 同步模型定价和能力数据。", + "clearSyncedPricingSuccess": "已清除同步定价", + "clearSyncedPricingFailedWithReason": "清除价格失败：{reason}", + "pricingSourceDefault": "默认定价来源", + "pricingSyncSuccess": "定价同步成功", + "enableSyncError": "启用同步失败", + "syncEnabled": "同步已启用", + "blacklist": "黑名单", + "pricingSourceModelsDev": "models.dev 定价来源", + "syncedModels": "已同步模型", + "budget": "预算", + "pricingSyncTitle": "定价同步", + "pricingResetFailedWithReason": "重置价格失败：{reason}", + "tab": "选项卡", + "pricingSavedProvider": "已保存 {provider} 的价格", + "pricingSyncFailed": "定价同步失败", + "pricingSaveFailedWithReason": "保存价格失败：{reason}", + "pricingResetProvider": "已重置 {provider} 的价格", + "nextSync": "下次同步", + "pricingSyncFailedWithReason": "价格同步失败：{reason}", + "clearSyncedPricing": "清除同步定价", + "compressionTitle": "提示词压缩", + "compressionDesc": "在发送给提供商之前压缩提示词，以减少 token 使用量", + "compressionMode": "压缩模式", + "compressionModeOff": "关闭", + "compressionModeOffDesc": "不应用压缩", "compressionModeLite": "Lite", - "compressionModeLiteDesc": "Whitespace and blank line reduction", - "compressionModeStandard": "Standard (Caveman)", - "compressionModeStandardDesc": "Rule-based compression with 30+ patterns, preserves code blocks and URLs", + "compressionModeLiteDesc": "减少空白字符和空行", + "compressionModeStandard": "标准（Caveman）", + "compressionModeStandardDesc": "基于规则的压缩，包含 30+ 个模式，并保留代码块和 URL", "compressionModeAggressive": "Aggressive", - "compressionModeAggressiveDesc": "Summarization + tool result compression + progressive aging for maximum savings", + "compressionModeAggressiveDesc": "摘要 + 工具结果压缩 + 渐进老化，以实现最大节省", "compressionModeUltra": "Ultra", - "compressionModeUltraDesc": "Maximum compression with all techniques including semantic deduplication", - "compressionGeneral": "General Settings", - "compressionAutoTrigger": "Auto-Trigger Threshold", - "compressionCacheTTL": "Cache TTL", - "compressionPreserveSystem": "Preserve System Prompt", - "compressionCavemanConfig": "Caveman Engine Configuration", - "compressionCavemanConfigDesc": "Fine-tune the rule-based compression engine", - "compressionRoles": "Compress Message Roles", - "compressionRoleUser": "User", - "compressionRoleAssistant": "Assistant", - "compressionRoleSystem": "System", - "compressionMinLength": "Minimum Message Length", - "compressionSkipRules": "Skip Compression Rules", - "compressionSkipRulesDesc": "Click rules to skip them during compression", - "compressionPreservePatterns": "Preserve Patterns", - "compressionPreservePatternsDesc": "Regex patterns that are never compressed (one per line)", - "compressionLogTitle": "Compression Log", - "compressionLogEmpty": "No compressed requests yet. Compression stats will appear here when requests are processed with compression enabled.", + "compressionModeUltraDesc": "使用包括语义去重在内的全部技术进行最大压缩", + "compressionAggressiveConfig": "Aggressive 引擎配置", + "compressionAggressiveConfigDesc": "微调摘要、工具压缩和老化阈值", + "compressionUltraConfig": "Ultra 引擎配置", + "compressionUltraConfigDesc": "微调启发式剪枝、SLM 后备和每条消息阈值", + "compressionUltraRate": "保留比例", + "compressionUltraMinScore": "最低分数阈值", + "compressionUltraSlmFallback": "回退到 Aggressive", + "compressionUltraModelPath": "SLM 模型路径", + "compressionSummarizerEnabled": "启用摘要器", + "compressionMaxTokensPerMessage": "每条消息最大 Token 数", + "compressionMinSavings": "最低节省阈值", + "compressionAgingThresholds": "老化阈值", + "compressionAgingThresholdsDesc": "每个老化层级保留的最近消息数量（越高表示保留越多）", + "compressionToolStrategies": "工具结果策略", + "compressionToolStrategiesDesc": "为不同工具结果类型切换压缩策略", + "compressionGeneral": "通用设置", + "compressionAutoTrigger": "自动触发阈值", + "compressionCacheTTL": "缓存 TTL", + "compressionPreserveSystem": "保留系统提示", + "compressionCavemanConfig": "Caveman 引擎配置", + "compressionCavemanConfigDesc": "微调基于规则的压缩引擎", + "compressionRoles": "压缩消息角色", + "compressionRoleUser": "用户", + "compressionRoleAssistant": "助手", + "compressionRoleSystem": "系统", + "compressionMinLength": "最小消息长度", + "compressionSkipRules": "跳过压缩规则", + "compressionSkipRulesDesc": "点击规则以在压缩时跳过它们", + "compressionPreservePatterns": "保留模式", + "compressionPreservePatternsDesc": "永不压缩的正则表达式模式（每行一个）", + "compressionLogTitle": "压缩日志", + "compressionLogEmpty": "尚无压缩请求。启用压缩后处理请求时，压缩统计会显示在这里。", + "minutes": "分钟", "compressionModeRtk": "RTK", - "compressionModeRtkDesc": "Command-aware tool output filtering", - "compressionModeStacked": "Stacked", - "compressionModeStackedDesc": "RTK tool-output filtering followed by Caveman message compression", - "qdrantTitle": "Qdrant (Vector memory)", - "qdrantDesc": "Optional. Indexes semantic memories in an external vector database for faster retrieval.", - "qdrantStatusActive": "Active", - "qdrantStatusError": "Error", - "qdrantStatusDisabled": "Disabled", - "qdrantEnable": "Enable Qdrant", - "qdrantEnableDesc": "When enabled, semantic/hybrid strategy can use Qdrant to retrieve memories.", - "qdrantTesting": "Testing...", - "qdrantTestConnection": "Test connection", - "qdrantSaved": "Configuration saved", - "qdrantSaveError": "Failed to save configuration", - "qdrantHostHint": "Without port. Example: 127.0.0.1 or http://qdrant", - "qdrantPort": "Port", - "qdrantPortHint": "Qdrant default: 6333", - "qdrantCollectionHint": "Where memory points will be stored.", - "qdrantEmbeddingModel": "Embedding model", - "qdrantHelpTitle": "Quick setup help", - "qdrantHelpQuickTitle": "Quick setup (Qdrant + OpenRouter)", - "qdrantHelpStep1": "1. Host: Qdrant IP/URL, Port: 6333, Collection: omniroute_memory.", - "qdrantHelpStep2": "2. If using nvidia/llama-nemotron-embed-vl-1b-v2:free, use collection dimension 2048.", - "qdrantHelpStep3": "3. Model field: openrouter/nvidia/llama-nemotron-embed-vl-1b-v2:free.", - "qdrantHelpStep4": "4. Save, test connection, then test search.", - "qdrantEmbeddingQuickSelect": "Quick select from discovered models...", - "qdrantEmbeddingInputPlaceholder": "openai/text-embedding-3-small", - "qdrantEmbeddingHint": "Format: provider/model. The provider credential must be configured.", - "qdrantApiKeyPlaceholderKeep": "(leave empty to keep current key)", - "qdrantApiKeyPlaceholderOptional": "(leave empty if not used)", - "qdrantSaveHint": "Tip: edit host/port/collection/model and click Save. API key is optional.", - "qdrantSearchTestTitle": "Search test", - "qdrantSearchTestDesc": "Generates embedding and searches in Qdrant.", - "qdrantSearchPlaceholder": "Example: user preferences, history, etc", - "qdrantNoResults": "No results (or Qdrant is not configured).", - "qdrantCleanupTitle": "Retention and cleanup", - "qdrantCleanupDesc": "Removes expired and old points based on", - "searching": "Searching...", - "cleaning": "Cleaning...", - "cleanNow": "Clean now" + "compressionModeRtkDesc": "感知命令的工具输出过滤", + "compressionModeStacked": "堆叠", + "compressionModeStackedDesc": "先进行 RTK 工具输出过滤，再进行 Caveman 消息压缩", + "qdrantTitle": "__MISSING__:Qdrant (Vector memory)", + "qdrantDesc": "__MISSING__:Optional. Indexes semantic memories in an external vector database for faster retrieval.", + "qdrantStatusActive": "__MISSING__:Active", + "qdrantStatusError": "__MISSING__:Error", + "qdrantStatusDisabled": "__MISSING__:Disabled", + "qdrantEnable": "__MISSING__:Enable Qdrant", + "qdrantEnableDesc": "__MISSING__:When enabled, semantic/hybrid strategy can use Qdrant to retrieve memories.", + "qdrantTesting": "__MISSING__:Testing...", + "qdrantTestConnection": "__MISSING__:Test connection", + "qdrantSaved": "__MISSING__:Configuration saved", + "qdrantSaveError": "__MISSING__:Failed to save configuration", + "qdrantHostHint": "__MISSING__:Without port. Example: 127.0.0.1 or http://qdrant", + "qdrantPort": "__MISSING__:Port", + "qdrantPortHint": "__MISSING__:Qdrant default: 6333", + "qdrantCollectionHint": "__MISSING__:Where memory points will be stored.", + "qdrantEmbeddingModel": "__MISSING__:Embedding model", + "qdrantHelpTitle": "__MISSING__:Quick setup help", + "qdrantHelpQuickTitle": "__MISSING__:Quick setup (Qdrant + OpenRouter)", + "qdrantHelpStep1": "__MISSING__:1. Host: Qdrant IP/URL, Port: 6333, Collection: omniroute_memory.", + "qdrantHelpStep2": "__MISSING__:2. If using nvidia/llama-nemotron-embed-vl-1b-v2:free, use collection dimension 2048.", + "qdrantHelpStep3": "__MISSING__:3. Model field: openrouter/nvidia/llama-nemotron-embed-vl-1b-v2:free.", + "qdrantHelpStep4": "__MISSING__:4. Save, test connection, then test search.", + "qdrantEmbeddingQuickSelect": "__MISSING__:Quick select from discovered models...", + "qdrantEmbeddingInputPlaceholder": "__MISSING__:openai/text-embedding-3-small", + "qdrantEmbeddingHint": "__MISSING__:Format: provider/model. The provider credential must be configured.", + "qdrantApiKeyPlaceholderKeep": "__MISSING__:(leave empty to keep current key)", + "qdrantApiKeyPlaceholderOptional": "__MISSING__:(leave empty if not used)", + "qdrantSaveHint": "__MISSING__:Tip: edit host/port/collection/model and click Save. API key is optional.", + "qdrantSearchTestTitle": "__MISSING__:Search test", + "qdrantSearchTestDesc": "__MISSING__:Generates embedding and searches in Qdrant.", + "qdrantSearchPlaceholder": "__MISSING__:Example: user preferences, history, etc", + "qdrantNoResults": "__MISSING__:No results (or Qdrant is not configured).", + "qdrantCleanupTitle": "__MISSING__:Retention and cleanup", + "qdrantCleanupDesc": "__MISSING__:Removes expired and old points based on", + "searching": "__MISSING__:Searching...", + "cleaning": "__MISSING__:Cleaning...", + "cleanNow": "__MISSING__:Clean now", + "optional": "__MISSING__:Optional", + "current": "__MISSING__:Current", + "remove": "__MISSING__:Remove", + "search": "__MISSING__:Search" }, "contextRtk": { - "title": "RTK Engine", - "description": "Command-aware compression for tool output, terminal logs and build results.", - "enabled": "Enabled", - "intensity": "Intensity", - "intensityMinimal": "Minimal", - "intensityStandard": "Standard", - "intensityAggressive": "Aggressive", - "toolResults": "Tool results", - "assistantMessages": "Assistant messages", - "codeBlocks": "Code blocks", - "maxLines": "Max lines", - "maxChars": "Max chars", - "filterTesting": "Filter Testing", - "pasteOutput": "Paste tool output to test filtering...", - "run": "Run", - "result": "Result", - "previewEmpty": "Run a sample to preview RTK output.", - "detected": "Detected", - "tokensFiltered": "Tokens filtered", - "filtersActive": "Filters active", - "requests": "Requests", - "avgSavings": "Avg savings" + "title": "RTK 引擎", + "description": "面向工具输出、终端日志和构建结果的命令感知压缩。", + "enabled": "已启用", + "intensity": "强度", + "intensityMinimal": "最小", + "intensityStandard": "标准", + "intensityAggressive": "激进", + "toolResults": "工具结果", + "assistantMessages": "助手消息", + "codeBlocks": "代码块", + "maxLines": "最大行数", + "maxChars": "最大字符数", + "deduplicateThreshold": "去重阈值", + "customFilters": "自定义过滤器", + "trustProjectFilters": "信任项目过滤器", + "rawOutputRetention": "原始输出保留", + "rawOutputNever": "从不", + "rawOutputFailures": "失败时", + "rawOutputAlways": "始终", + "rawOutputMaxBytes": "原始输出最大字节数", + "filterTesting": "过滤测试", + "pasteOutput": "粘贴工具输出以测试过滤...", + "run": "运行", + "result": "结果", + "previewEmpty": "运行示例以预览 RTK 输出。", + "detected": "已检测", + "tokensFiltered": "已过滤 token", + "filtersActive": "活动过滤器", + "requests": "请求数", + "avgSavings": "平均节省" }, "contextCombos": { - "title": "Compression Combos", - "description": "Define how engines are combined for different routing scenarios.", - "createCombo": "Create Compression Combo", - "editCombo": "Edit", - "deleteCombo": "Delete", - "deleteConfirm": "Delete this compression combo?", - "pipeline": "Pipeline", - "addStep": "Add Step", - "removeStep": "Remove", - "name": "Name", - "descriptionField": "Description", - "languagePacks": "Language Packs", - "outputMode": "Output Mode", - "assignToRouting": "Assign to Routing Combos", - "noAssignments": "No routing combos available", - "default": "Default", - "setAsDefault": "Set as Default", - "save": "Save", - "cancel": "Cancel", - "enabled": "Enabled" + "title": "压缩组合", + "description": "定义不同路由场景中引擎的组合方式。", + "createCombo": "创建压缩组合", + "editCombo": "编辑", + "deleteCombo": "删除", + "deleteConfirm": "删除此压缩组合？", + "pipeline": "流水线", + "addStep": "添加步骤", + "removeStep": "移除", + "name": "名称", + "descriptionField": "描述", + "languagePacks": "语言包", + "outputMode": "输出模式", + "assignToRouting": "分配到路由组合", + "noAssignments": "没有可用的路由组合", + "default": "默认", + "setAsDefault": "设为默认", + "save": "保存", + "cancel": "取消", + "enabled": "已启用" }, "contextCaveman": { - "title": "Caveman Engine", - "description": "Rule-based message compression, language packs, analytics and output mode controls.", - "requests": "Requests", - "tokensSaved": "Tokens saved", - "savingsPercent": "Savings %", - "avgLatency": "Avg latency", - "languagePacks": "Language Packs", - "languagePacksDesc": "Enable compression rules for specific languages.", - "enabled": "Enabled", - "autoDetect": "Auto-detect language", - "rulesCount": "{count} rules", - "analyticsTitle": "Compression Analytics", - "noAnalytics": "No compression analytics yet.", - "outputModeTitle": "Output Mode", - "outputModeDesc": "Instructs the LLM to respond in a terse, compact format.", - "autoClarity": "Auto-Clarity Bypass", - "bypassConditions": "Bypass conditions", + "title": "Caveman 引擎", + "description": "基于规则的消息压缩，包含语言包、分析和输出模式控制。", + "requests": "请求数", + "tokensSaved": "已节省 token", + "savingsPercent": "节省比例", + "avgLatency": "平均延迟", + "languagePacks": "语言包", + "languagePacksDesc": "为特定语言启用压缩规则。", + "enabled": "已启用", + "autoDetect": "自动检测语言", + "rulesCount": "{count} 条规则", + "analyticsTitle": "压缩分析", + "noAnalytics": "尚无压缩分析。", + "outputModeTitle": "输出模式", + "outputModeDesc": "指示 LLM 以简洁、紧凑的格式回复。", + "autoClarity": "自动清晰度绕过", + "bypassConditions": "绕过条件", + "bypassConditionsList": "安全、不可逆、需澄清、顺序敏感", "preview": { - "lite": "Respond concise. Preserve technical terms, code, errors, URLs, and identifiers.", - "full": "Respond terse and compact. Preserve all technical substance.", - "ultra": "Respond ultra terse with common technical abbreviations. Preserve exact symbols." + "lite": "回复要简洁。保留技术术语、代码、错误、URL 和标识符。", + "full": "回复要简短紧凑。保留所有技术实质。", + "ultra": "用常见技术缩写进行极简回复。保留精确符号。" } }, "translator": { @@ -3574,6 +3929,28 @@ "errorShort": "错误率", "formatConverter": "格式转换器", "formatConverterDescription": "粘贴或输入 JSON 请求体。翻译器会自动识别源格式并将其转换为目标格式。你可以借此调试 OmniRoute 在各种格式之间的转换行为（OpenAI ↔ Claude ↔ Gemini ↔ Responses API）。", + "translationPathHubSpoke": "{source} → OpenAI（中间格式）→ {target}", + "translationPathDirect": "{source} → {target}（直接转换器）", + "translationPathPassthrough": "格式相同 — 无需转换", + "openaiIntermediatePanel": "OpenAI 中间格式", + "autoFeaturesTitle": "OmniRoute 自动处理的内容", + "autoFeaturesCount": "8 项功能", + "featureReasoningCache": "推理缓存", + "featureReasoningCacheDesc": "当客户端在对话历史中省略 thinking-mode 模型（DeepSeek V4、Kimi K2、Qwen）的缓存 reasoning_content 时，会重新注入。", + "featureSchemaCoercion": "Schema 校正", + "featureSchemaCoercionDesc": "修复损坏的工具 schema：添加缺失的 additionalProperties、清理过长描述、规范化嵌套对象。", + "featureRoleNormalization": "角色规范化", + "featureRoleNormalizationDesc": "针对非 OpenAI 目标将 developer→system。针对不支持 system 角色的模型将 system→user。", + "featureToolCallIds": "工具调用 ID 规范化", + "featureToolCallIdsDesc": "在缺失时生成唯一的 tool_call ID。针对 Mistral 等提供商规范化为 9 字符格式。", + "featureMissingToolResponse": "工具响应注入", + "featureMissingToolResponseDesc": "当客户端发送 tool_calls 但没有对应响应时，注入空的 tool_result 消息。", + "featureThinkingBudget": "思考预算", + "featureThinkingBudgetDesc": "自动管理 thinking 配置。当最后一条消息不是用户消息时移除 thinking 参数。", + "featureDirectPaths": "直接转换路径", + "featureDirectPathsDesc": "某些格式组合（Claude→Gemini）有绕过 OpenAI 中枢的直接转换器，可产生更准确的输出。", + "featureImageMapping": "图像尺寸映射", + "featureImageMappingDesc": "在 API 格式之间转换图像尺寸约定（例如 OpenAI detail 等级 → Gemini 尺寸）。", "input": "输入", "output": "输出", "auto": "汽车", @@ -3682,6 +4059,11 @@ "errorMessage": "错误：{message}", "requestFailed": "请求失败", "noTextExtracted": "（未提取文字）", + "liveMonitorMemoryNote": "事件存储在内存中，重启后会丢失。", + "liveMonitorMemoryCapNote": "最多保留 200 个事件。", + "eventSourcesLabel": "事件来源：", + "eventSourceTranslatorPage": "• Translator 页面（Chat Tester、Test Bench）", + "eventSourceMainPipeline": "• 主请求流水线（CLI/IDE/API 流量）", "liveMonitorDescriptionPrefix": "这里会显示 API 调用流经 OmniRoute 时产生的翻译事件。事件来自内存缓冲区（重启后会重置）。使用", "liveMonitorDescriptionSuffix": "，或外部 API 调用来生成事件。" }, @@ -3695,7 +4077,7 @@ "loadingBudgetData": "正在加载预算数据...", "noApiKeysTitle": "没有 API 密钥", "noApiKeysDescription": "首先添加 API 密钥以设置预算限制。", - "apiKey": "API密钥", + "apiKey": "API key", "todaysSpend": "今天的花费", "thisMonth": "本月", "setLimits": "设定限制", @@ -3757,14 +4139,25 @@ "passSuffix": "通过", "casesCount": "{count, plural, one {# 个案例} other {# 个案例}}", "runEval": "运行评估", + "runAllSuites": "全部运行", + "runAllRunning": "正在全部运行...", + "runAllProgress": "正在运行 {current}/{total}：{name}", + "runAllFailedSuites": "{count, plural, one {# 个套件失败} other {# 个套件失败}}", + "runAllCompleted": "已运行 {suites} 个套件 — {passed} 个通过，{failed} 个失败", + "runAllCompletedWithFailures": "已运行 {completed} 个套件；{failedSuites} 个运行失败", "runningProgress": "正在运行 {current}/{total}...", "passRate": "通过率", "summaryBreakdown": "{passed} 通过 · {failed} 失败 · {total} 总计", "passedIconLabel": "✅ 通过", "failedIconLabel": "❌ 失败", + "resultPassed": "已通过", + "resultFailed": "失败", + "expandResult": "展开结果详情", + "collapseResult": "折叠结果详情", "detailsContains": "包含：“{term}”", "detailsRegex": "正则表达式：{pattern}", "detailsExpected": "预期：“{expected}”", + "expectedOutputLabel": "预期输出", "noResultsYet": "还没有结果", "testCasesCount": "测试用例 ({count})", "noTestCasesDefined": "没有定义测试用例", @@ -3831,99 +4224,114 @@ "tierPlus": "加号", "tierFree": "免费", "tierUnknown": "未知", - "suiteBuilderSaveFailed": "Failed to save suite", + "suiteBuilderSaveFailed": "保存套件失败", + "clone": "克隆", + "exportSuite": "导出", + "importSuite": "导入", + "suiteExported": "套件已导出", + "suiteExportFailed": "导出套件失败", + "suiteImportReady": "套件导入已加载，等待检查", + "suiteImportFailed": "导入套件失败", + "suiteImportInvalid": "无效的 eval 套件 JSON", + "suiteBuilderCloneSuffix": "副本", + "suiteBuilderImportedSuite": "已导入套件", "scorecardTitle": "Scorecard", - "evalApiKey": "API Key", - "scorecardPassRate": "Pass Rate", - "targetTypeModel": "Model", - "actualOutputLabel": "Actual Output", - "evalTargetHint": "Select a model or combo to evaluate.", - "suiteBuilderDeleted": "Suite deleted successfully", - "suiteBuilderCaseCardHint": "Define the input prompt and expected output criteria.", - "nextResetUtc": "Next reset (UTC)", - "scorecardHint": "Aggregated pass rates across all evaluation suites.", - "suiteLatestRunsHint": "Most recent evaluation runs for this suite.", - "saving": "Saving", - "suiteBuilderCaseModelLabel": "Model (optional)", - "evalControlsTitle": "Evaluation Controls", - "suiteBuilderEditTitle": "Edit Eval Suite", - "suiteBuilderCaseStrategyLabel": "Validation Strategy", - "notifySelectDifferentCompareTarget": "Please select a different target for comparison", - "recentRunsHint": "Showing the most recent evaluation runs. Click a run to see detailed results.", - "evalCompareHint": "Optionally compare results against a second target.", - "suiteBuilderCaseInvalid": "This case has validation errors. Please fix before saving.", - "historyEmpty": "No evaluation history yet", - "suiteBuilderUpdated": "Suite updated successfully", - "resetInterval": "Reset Interval", - "suiteBuilderCreateTitle": "Create Eval Suite", - "activePeriodSpend": "Active Period Spend", - "evalApiKeyHint": "Select which API key to use for evaluation requests.", - "evalCompareOptional": "Compare (optional)", - "suiteBuilderDeleteFailed": "Failed to delete suite", - "suiteBuilderCaseSystemPromptPlaceholder": "Optional system instructions...", - "scorecardCases": "Cases", - "runCompletedWithScore": "Evaluation completed — {score}% pass rate", - "suiteBuilderCustomBadge": "Custom", - "targetSuiteDefaults": "Suite defaults", - "suiteBuilderDeleteConfirm": "Are you sure you want to delete this suite? This action cannot be undone.", - "suiteBuilderNameLabel": "Suite Name", + "evalApiKey": "API key", + "scorecardPassRate": "通过率", + "targetTypeModel": "模型", + "actualOutputLabel": "实际输出", + "evalTargetHint": "选择要评估的模型或组合。", + "suiteBuilderDeleted": "Suite 删除成功", + "suiteBuilderCaseCardHint": "定义输入提示和预期输出标准。", + "nextResetUtc": "下次重置（UTC）", + "scorecardHint": "汇总所有 Evaluation Suite 的通过率。", + "suiteLatestRunsHint": "此套件最近的评估运行。", + "saving": "正在保存", + "suiteBuilderCaseModelLabel": "模型（可选）", + "evalControlsTitle": "Evaluation 控制项", + "suiteBuilderEditTitle": "编辑 Evaluation Suite", + "suiteBuilderCaseStrategyLabel": "验证策略", + "notifySelectDifferentCompareTarget": "请选择不同的比较目标", + "recentRunsHint": "正在显示最近的评估运行。点击某次运行可查看详细结果。", + "evalCompareHint": "可选择与第二个目标比较结果。", + "suiteBuilderCaseInvalid": "此 Case 存在验证错误，请先修复再保存。", + "historyEmpty": "暂无 Evaluation 历史", + "suiteBuilderUpdated": "Suite 更新成功", + "resetInterval": "重置间隔", + "suiteBuilderCreateTitle": "创建评估套件", + "activePeriodSpend": "当前周期支出", + "evalApiKeyHint": "选择用于评估请求的 API 密钥。", + "evalCompareOptional": "对比（可选）", + "suiteBuilderDeleteFailed": "删除套件失败", + "suiteBuilderCaseSystemPromptPlaceholder": "可选系统指令...", + "scorecardCases": "Case", + "runCompletedWithScore": "Evaluation 已完成 — 通过率 {score}%", + "suiteBuilderCustomBadge": "自定义", + "targetSuiteDefaults": "Suite 默认值", + "suiteBuilderDeleteConfirm": "确定要删除此套件吗？此操作无法撤销。", + "suiteBuilderNameLabel": "Suite 名称", "scorecardSuites": "Suites", - "evalCompareTarget": "Compare Target", - "suiteBuilderCaseModelPlaceholder": "e.g. gpt-4o-mini", - "evalControlsHint": "Configure your evaluation target and API key, then run suites to validate model quality.", - "recentRunsTitle": "Recent Runs", - "suiteBuilderCaseSystemPromptLabel": "System Prompt", - "suiteBuilderCaseExpectedPlaceholder": "e.g. def fibonacci", - "suiteBuilderNamePlaceholder": "e.g. Coding Quality Suite", - "suiteBuilderAddCase": "Add Case", - "cancel": "Cancel", - "evalTarget": "Target", - "suiteBuilderCaseNameLabel": "Case Name", - "weeklyLimitUsd": "Weekly Limit (USD)", - "suiteBuilderCaseUserPromptPlaceholder": "e.g. Write a fibonacci function in Python", - "suiteBuilderNameRequired": "Suite name is required", - "suiteBuilderCaseUserPromptLabel": "User Prompt", - "daily": "Daily", - "resultErrorLabel": "Error", - "suiteBuilderBuiltInBadge": "Built-in", - "suiteBuilderCaseCardTitle": "Test Case", - "weeklyLimitPlaceholder": "e.g. 50.00", - "suiteBuilderCaseTagsHint": "Comma-separated tags for organizing test cases.", - "notifyEvalRunFailedWithReason": "Evaluation failed: {reason}", - "weekly": "Weekly", - "runEvalRunning": "Running evaluation...", - "delete": "Delete", - "resetTimeUtc": "Reset Time (UTC)", - "evalApiKeyAuto": "Auto (use default)", - "suiteBuilderDescriptionPlaceholder": "Optional description of what this suite tests...", - "targetComparisonTitle": "Target Comparison", - "save": "Save", - "suiteBuilderCreated": "Suite created successfully", - "suiteLatestRuns": "Latest Runs", - "suiteBuilderCaseExpectedLabel": "Expected Value", - "historyLatency": "Latency", - "suiteBuilderCaseTagsPlaceholder": "e.g. coding, python", + "evalCompareTarget": "对比目标", + "suiteBuilderCaseModelPlaceholder": "例如 gpt-4o-mini", + "evalControlsHint": "配置评估目标和 API 密钥，然后运行套件以验证模型质量。", + "recentRunsTitle": "最近运行", + "suiteBuilderCaseSystemPromptLabel": "系统提示", + "suiteBuilderCaseExpectedPlaceholder": "例如 def fibonacci", + "suiteBuilderCaseExpectedPlaceholderContains": "例如 def fibonacci", + "suiteBuilderCaseExpectedPlaceholderExact": "粘贴精确的预期响应", + "suiteBuilderCaseExpectedPlaceholderRegex": "例如 ^\\s*\\{.*\\}\\s*$", + "suiteBuilderCaseExpectedHintRegex": "使用不带包裹斜杠的 JavaScript 正则表达式。", + "suiteBuilderNamePlaceholder": "例如 Coding Quality Suite", + "suiteBuilderAddCase": "添加 Case", + "cancel": "取消", + "evalTarget": "目标", + "suiteBuilderCaseNameLabel": "Case 名称", + "weeklyLimitUsd": "每周限额（USD）", + "suiteBuilderCaseUserPromptPlaceholder": "例如用 Python 写一个 fibonacci 函数", + "suiteBuilderNameRequired": "Suite 名称为必填项", + "suiteBuilderCaseUserPromptLabel": "用户 Prompt", + "daily": "每日", + "resultErrorLabel": "错误", + "suiteBuilderBuiltInBadge": "内置", + "suiteBuilderCaseCardTitle": "测试用例", + "suiteBuilderDuplicateCase": "复制", + "weeklyLimitPlaceholder": "例如 50.00", + "suiteBuilderCaseTagsHint": "用于组织测试用例的逗号分隔标签。", + "notifyEvalRunFailedWithReason": "评估失败：{reason}", + "weekly": "每周", + "runEvalRunning": "正在运行 Evaluation...", + "delete": "删除", + "resetTimeUtc": "重置时间（UTC）", + "evalApiKeyAuto": "自动（使用默认值）", + "suiteBuilderDescriptionPlaceholder": "可选：描述此套件测试的内容...", + "targetComparisonTitle": "目标对比", + "save": "保存", + "suiteBuilderCreated": "Suite 创建成功", + "suiteLatestRuns": "最新运行", + "suiteBuilderCaseExpectedLabel": "期望值", + "historyLatency": "延迟", + "suiteBuilderCaseTagsPlaceholder": "例如 coding, python", "targetTypeCombo": "Combo", - "scorecardPassed": "Passed", - "suiteBuilderCaseTagsLabel": "Tags", - "suiteBuilderNewSuite": "New Suite", - "notifyEvalLoadFailed": "Failed to load evaluation data", - "notConfigured": "Not Configured", - "suiteBuilderCaseNamePlaceholder": "e.g. Python fibonacci test", - "intervalLabel": "Interval", - "suiteBuilderCreateAction": "Create Suite", - "suiteBuilderCasesHint": "Each case sends a prompt and validates the response.", - "suiteBuilderUpdatedAt": "Updated", - "errorBadge": "Error", - "suiteBuilderCasesTitle": "Test Cases", - "edit": "Edit", - "monthly": "Monthly", - "suiteBuilderCasesRequired": "At least one test case is required", - "weeklyLimitSummary": "Weekly budget limit summary", - "suiteBuilderDescriptionLabel": "Description", - "targetComparisonHint": "Side-by-side comparison of evaluation results between targets.", - "compareCompletedWithScore": "Comparison completed — {score}% pass rate", - "staleQuotaTooltip": "Last refresh failed — showing cached data" + "scorecardPassed": "已通过", + "suiteBuilderCaseTagsLabel": "标签", + "suiteBuilderNewSuite": "新建 Suite", + "notifyEvalLoadFailed": "加载评估数据失败", + "notConfigured": "未配置", + "suiteBuilderCaseNamePlaceholder": "例如 Python 斐波那契测试", + "intervalLabel": "间隔", + "suiteBuilderCreateAction": "创建套件", + "suiteBuilderCasesHint": "每个用例都会发送一个提示并验证响应。", + "suiteBuilderUpdatedAt": "更新时间", + "errorBadge": "错误", + "suiteBuilderCasesTitle": "测试用例", + "edit": "编辑", + "monthly": "每月", + "suiteBuilderCasesRequired": "至少需要一个测试用例", + "weeklyLimitSummary": "每周预算限额摘要", + "suiteBuilderDescriptionLabel": "描述", + "targetComparisonHint": "在目标之间并排比较评估结果。", + "compareCompletedWithScore": "对比已完成 — 通过率 {score}%", + "staleQuotaTooltip": "__MISSING__:Last refresh failed — showing cached data" }, "modals": { "waitingAuth": "等待授权", @@ -4141,6 +4549,7 @@ "docs": { "title": "文档", "quickStart": "快速入门", + "deploymentGuides": "部署指南", "features": "特点", "supportedProviders": "支持的提供商", "supportedProvidersToc": "提供商", @@ -4177,6 +4586,20 @@ "quickStartStep4Title": "4. 设置客户端基本 URL", "quickStartStep4Prefix": "将您的 IDE 或 API 客户端指向", "quickStartStep4Suffix": "例如使用提供商前缀", + "deploySetupTitle": "__MISSING__:Setup Guide", + "deploySetupText": "__MISSING__:Step-by-step installation, environment configuration, and first-run walkthrough for OmniRoute.", + "deployElectronTitle": "__MISSING__:Electron Desktop", + "deployElectronText": "__MISSING__:Run OmniRoute as a native desktop application on Windows, macOS, and Linux.", + "deployDockerTitle": "__MISSING__:Docker", + "deployDockerText": "__MISSING__:Containerized deployment with Docker Compose; ready for production stacks and Kubernetes.", + "deployVmTitle": "__MISSING__:Virtual Machine", + "deployVmText": "__MISSING__:Self-host on any Linux VM. Includes systemd unit, log rotation, and backup tooling.", + "deployFlyTitle": "__MISSING__:Fly.io", + "deployFlyText": "__MISSING__:Deploy to Fly.io edge runtime with one fly.toml and a single deploy command.", + "deployPwaTitle": "__MISSING__:PWA", + "deployPwaText": "__MISSING__:Install OmniRoute as a Progressive Web App on Android, iOS, and desktop browsers.", + "deployTermuxTitle": "Termux (Android)", + "deployTermuxText": "通过 Termux 在 Android 上以无界面模式运行 OmniRoute，并从移动浏览器访问仪表盘。", "featureRoutingTitle": "多提供商路由", "featureRoutingText": "通过单一 OpenAI 兼容端点将请求路由到 30+ AI 提供商，支持聊天、Responses、音频和图像 API。", "featureCombosTitle": "组合和平衡", @@ -4221,6 +4644,18 @@ "clientClaudeBullet1Prefix": "使用", "clientClaudeBullet1Middle": "（Claude）或", "clientClaudeBullet1Suffix": "（Antigravity）前缀。", + "clientWindsurfTitle": "Windsurf", + "clientWindsurfBullet1": "将 OmniRoute 用作 OpenAI 兼容的 base URL，并保留显式提供商前缀，以实现确定性路由。", + "clientWindsurfBullet2": "常规流量将模型指向 `/v1/chat/completions`，并为 Codex 风格流程保留 `/v1/responses`。", + "clientWindsurfBullet3": "使用仪表盘 -> CLI 工具获取现成的 Windsurf 配置指南。", + "clientClineTitle": "Cline", + "clientClineBullet1": "Cline 最适合使用显式的提供商/模型前缀，这样路由器无需猜测后端。", + "clientClineBullet2": "常规模型使用 `/v1/chat/completions`，并在不同账户间复用同一个 OmniRoute base URL。", + "clientClineBullet3": "调试 Cline 运行时问题前，请使用提供商仪表盘验证 OAuth/API 密钥。", + "clientKimiTitle": "Kimi Coding", + "clientKimiBullet1": "轮换底层账户或提供商组合时，将 OmniRoute 用作稳定的 base URL。", + "clientKimiBullet2": "在编码流程中优先使用带前缀的模型，让回退和审计轨迹保持明确。", + "clientKimiBullet3": "当你希望为使用工具的客户端启用原生 Responses 风格路由时，请使用 `/v1/responses`。", "protocolsTitle": "协议：MCP 与 A2A", "protocolsDescription": "除了 OpenAI 兼容 API 之外，OmniRoute 还提供两类操作协议：用于工具执行的 MCP，以及用于智能体协作工作流的 A2A。", "protocolMcpTitle": "MCP（Model Context Protocol）", @@ -4264,8 +4699,61 @@ "troubleshootingTestConnection": "在从 IDE 或外部客户端进行测试之前，请使用仪表板 > 提供商 > 测试连接。", "troubleshootingCircuitBreaker": "如果提供商显示断路器已打开，请等待冷却或查看运行状况页面以了解详细信息。", "troubleshootingOAuth": "对于 OAuth 提供商，如果 Token 过期，请重新认证，并检查提供商卡片上的状态指示器。", - "deployTermuxTitle": "Termux (Android)", - "deployTermuxText": "Run OmniRoute headless on Android via Termux. Access the dashboard from your mobile browser." + "endpointCompletionsNote": "用于文本生成的旧版 completions 端点。", + "endpointModerationsNote": "内容审核和安全分类。", + "endpointRerankNote": "用于检索增强生成的文档重排序（Cohere、Jina）。", + "endpointSearchNote": "通过 5 个提供商进行网页搜索（Serper、Brave、Exa、Tavily、Perplexity）。", + "endpointSearchAnalyticsNote": "搜索请求的分析和指标。", + "endpointVideoNote": "视频生成（ComfyUI、SD WebUI 工作流）。", + "endpointMusicNote": "通过 ComfyUI 工作流生成音乐。", + "endpointMessagesNote": "Anthropic 原生 messages 端点。", + "endpointCountTokensNote": "统计给定消息载荷的 token 数。", + "endpointFilesNote": "用于多模态输入的文件上传。", + "endpointBatchesNote": "用于批量 API 请求的 Batch 处理。", + "endpointWsNote": "用于实时流式传输的 WebSocket 端点。", + "mgmtProvidersListNote": "列出所有已注册的提供商连接。", + "mgmtProvidersCreateNote": "创建新的提供商连接。", + "mgmtProvidersUpdateNote": "更新现有提供商连接。", + "mgmtProvidersDeleteNote": "删除提供商连接。", + "mgmtProvidersTestNote": "测试提供商的连接和认证。", + "mgmtProvidersModelsNote": "列出特定提供商的可用模型。", + "mgmtSettingsGetNote": "获取当前应用设置。", + "mgmtSettingsUpdateNote": "更新应用设置。", + "mgmtPayloadRulesGetNote": "获取载荷转换规则。", + "mgmtPayloadRulesUpdateNote": "更新载荷转换规则。", + "mcpToolsTitle": "MCP 工具", + "mcpToolsDescription": "OmniRoute 通过 Model Context Protocol 暴露 {count} 个工具，用于 Agent 编排。", + "mcpToolsCount": "{count} 个工具", + "mcpToolsToc": "MCP 工具", + "mcpToolsRoutingTitle": "路由与发现", + "mcpToolsRoutingDesc": "健康检查、组合管理、配额监控、成本报告和模型目录访问。", + "mcpToolsOperationsTitle": "运维与策略", + "mcpToolsOperationsDesc": "路由模拟、预算保护、策略切换、韧性配置和提供商指标。", + "mcpToolsCacheTitle": "缓存管理", + "mcpToolsCacheDesc": "查看缓存统计，并清空语义缓存或签名缓存。", + "mcpToolsCompressionTitle": "__MISSING__:Compression Engines", + "mcpToolsCompressionDesc": "__MISSING__:Configure RTK/Brotli compression, swap engines, and inspect compression analytics by combo.", + "mcpToolsOneProxyTitle": "__MISSING__:1Proxy / Tunnels", + "mcpToolsOneProxyDesc": "__MISSING__:Manage outbound proxies, rotate residential IPs, and inspect proxy health.", + "mcpToolsMemoryTitle": "记忆", + "mcpToolsMemoryDesc": "搜索、添加和清除持久化对话记忆条目。", + "mcpToolsSkillsTitle": "技能", + "mcpToolsSkillsDesc": "列出、启用、执行和监控自定义技能执行。", + "featureAutoComboTitle": "Auto-Combo", + "featureAutoComboText": "根据你连接的提供商、使用模式和模型能力，自动创建优化组合。", + "featureSearchTitle": "网页搜索", + "featureSearchText": "集成 5 个提供商的网页搜索（Serper、Brave、Exa、Tavily、Perplexity），并包含分析和成本跟踪。", + "featureMemoryTitle": "记忆系统", + "featureMemoryText": "跨会话提供提取、注入、检索和摘要能力的持久化对话记忆。", + "featureSkillsTitle": "技能框架", + "featureSkillsText": "可扩展技能系统，支持内置和自定义技能、沙箱执行、请求拦截和上下文注入。", + "featureAcpTitle": "Agent 通信", + "featureAcpText": "Agent Communication Protocol (ACP) 注册表，用于管理 Agent 间工作流和工具编排。", + "protocolAcpTitle": "ACP（Agent 通信）", + "protocolAcpDesc": "通过 ACP 注册表注册和管理 Agent，用于 Agent 间通信和工具共享。", + "protocolAcpStep1": "前往仪表盘 → Agents 查看已注册的 ACP Agent。", + "protocolAcpStep2": "使用能力和端点配置注册新的 Agent。", + "protocolAcpStep3": "使用 CLI 工具配置 Agent 通信通道。" }, "legal": { "privacyPolicy": "隐私政策", @@ -4357,19 +4845,75 @@ "setupGuideCustomAgentDesc": "如果你的 CLI 不在内置列表中，请使用“添加自定义智能体”，并填写可执行文件名与版本命令。", "setupGuideCommandMissingTitle": "修复“command not found”", "setupGuideCommandMissingDesc": "请确认 CLI 命令已存在于 PATH 中，重新打开一个终端会话后再次点击“刷新”。", - "cliToolsRedirectTitle": "Cli Tools Redirect Title", - "cliToolsRedirectDesc": "Cli Tools Redirect Desc", - "spawnArgsPlaceholder": "Spawn Args Placeholder", - "binaryNamePlaceholder": "Binary Name Placeholder", - "versionCommandPlaceholder": "Version Command Placeholder", - "architectureTitle": "Architecture Title", - "flowLocalBinary": "Flow Local Binary", - "flowOmniRoute": "Flow Omni Route", - "agentNamePlaceholder": "Agent Name Placeholder", - "architectureDescription": "Architecture Description", - "flowExecute": "Flow Execute", - "flowSpawn": "Flow Spawn", - "cliToolsRedirectCta": "Cli Tools Redirect Cta" + "cliToolsRedirectTitle": "CLI 工具已移至专用页面", + "cliToolsRedirectDesc": "在 CLI Tools 页面管理 Agent CLI 集成与重定向。", + "spawnArgsPlaceholder": "启动参数占位符", + "binaryNamePlaceholder": "二进制名称占位符", + "versionCommandPlaceholder": "版本命令占位符", + "architectureTitle": "架构", + "flowLocalBinary": "本地二进制", + "flowOmniRoute": "OmniRoute", + "agentNamePlaceholder": "Agent 名称占位符", + "architectureDescription": "了解 OmniRoute 如何在客户端、路由器和 Agent 目标之间转发请求。", + "flowExecute": "执行", + "flowSpawn": "启动", + "cliToolsRedirectCta": "打开 CLI Tools", + "comparisonTitle": "CLI 工具与 Agent 目标有什么区别？", + "comparisonCliToolsLabel": "CLI 工具页面", + "comparisonCliToolsTitle": "你的 IDE 通过 OmniRoute 发送请求", + "comparisonCliToolsDesc": "配置 Claude Code、Codex、Cursor 和其他 IDE，将 OmniRoute 用作它们的 API base URL。OmniRoute 作为代理，将请求路由到你配置的提供商。", + "comparisonAgentsLabel": "当前页面（Agent 目标）", + "comparisonAgentsTitle": "OmniRoute 将请求发送到本地 CLI 工具", + "comparisonAgentsDesc": "OmniRoute 可以启动本地 CLI 二进制文件（claude、codex、goose）作为执行后端。CLI 工具使用自己的认证处理请求并返回结果。", + "comparisonSummary": "简而言之：CLI 工具 = 你配置工具指向 OmniRoute。Agent 目标 = OmniRoute 将工具用作端点。", + "agentUseCaseHint": "可通过 ACP 协议用作执行目标", + "flowDiagramClient": "客户端应用", + "flowDiagramClientDesc": "SDK、API 或上游服务", + "flowDiagramOmniRoute": "OmniRoute", + "flowDiagramOmniRouteDesc": "接收请求并选择目标", + "flowDiagramSpawn": "启动进程", + "flowDiagramSpawnDesc": "通过 stdio 启动 CLI 二进制文件", + "flowDiagramCli": "CLI Agent", + "flowDiagramCliDesc": "使用自身认证/模型处理", + "fingerprintSettingsHint": "CLI 指纹匹配（伪装成特定 CLI 工具的请求）可在以下位置配置：", + "settingsRoutingLink": "设置/路由", + "openSettings": "设置" + }, + "cloudAgents": { + "title": "__MISSING__:Cloud Agents", + "description": "__MISSING__:Manage autonomous coding agents (Jules, Devin, Codex Cloud)", + "loading": "__MISSING__:Loading tasks...", + "aboutTitle": "__MISSING__:About Cloud Agents", + "aboutDescription": "__MISSING__:Cloud agents are remote AI coding assistants that can execute tasks autonomously. They work differently from local CLI agents - you interact with them through OmniRoute's API.", + "howItWorksTitle": "__MISSING__:How it works:", + "howItWorksDesc": "__MISSING__:Create a task → Agent analyzes and proposes a plan → You approve → Agent executes → Results returned", + "newTaskTitle": "__MISSING__:Create New Task", + "newTaskDescription": "__MISSING__:Start a new task with a cloud agent", + "selectAgent": "__MISSING__:Select Agent", + "taskDescription": "__MISSING__:Task Description", + "taskDescriptionPlaceholder": "__MISSING__:Describe what you want the agent to do...", + "startTask": "__MISSING__:Start Task", + "tasks": "__MISSING__:Tasks", + "taskDetail": "__MISSING__:Task Detail", + "noTasks": "__MISSING__:No tasks yet. Create one to get started.", + "untitledTask": "__MISSING__:Untitled Task", + "created": "__MISSING__:Created", + "conversation": "__MISSING__:Conversation", + "result": "__MISSING__:Result", + "error": "__MISSING__:Error", + "planReady": "__MISSING__:Plan Ready for Approval", + "approvePlan": "__MISSING__:Approve Plan", + "rejectPlan": "__MISSING__:Reject & Cancel", + "sendMessagePlaceholder": "__MISSING__:Send a message to the agent...", + "cancel": "__MISSING__:Cancel", + "delete": "__MISSING__:Delete", + "selectTaskPrompt": "__MISSING__:Select a task to view details", + "statusPending": "__MISSING__:Pending", + "statusRunning": "__MISSING__:Running", + "statusWaitingApproval": "__MISSING__:Waiting Approval", + "statusCompleted": "__MISSING__:Completed", + "statusFailed": "__MISSING__:Failed", + "statusCancelled": "__MISSING__:Cancelled" }, "templateNames": { "simple-chat": "简单对话", @@ -4454,14 +4998,14 @@ "cacheHitRate": "缓存命中率", "cacheRate": "缓存率", "cacheRateDesc": "占总请求数", - "cachedTokens": "Cache Read Tokens", - "cacheCreationTokens": "Cache Write Tokens", + "cachedTokens": "缓存读取 Token", + "cacheCreationTokens": "缓存写入 Token", "cacheMetrics": "Prompt 缓存指标", "withCacheControl": "含缓存控制", - "cachedTokensRead": "Read from cache", - "cacheCreationWrite": "Written to cache", + "cachedTokensRead": "从缓存读取", + "cacheCreationWrite": "写入缓存", "cacheReuseRatio": "缓存复用率", - "cacheReuseRatioDesc": "Cache read tokens / 输入 Tokens 总量", + "cacheReuseRatioDesc": "缓存读取 token / 输入 token 总量", "estCostSaved": "预估节省费用", "lastUpdated": "上次更新", "hoursTracked": "个小时", @@ -4476,12 +5020,12 @@ "resetting": "正在重置...", "resetMetrics": "重置指标", "byProvider": "按提供商分类", - "providerCacheRateDesc": "每个提供商都会直接展示总输入 Tokens、cache read tokens 和 cache write tokens，方便你对照原始数据判断 ratio 是否可靠。", + "providerCacheRateDesc": "每个提供商都会直接展示总输入 token、cache read token 和 cache write token，方便你对照原始数据判断比率是否可靠。", "provider": "提供商", "requests": "请求数", "inputTokens": "输入 Tokens 总计", - "cachedTokensCol": "Cache Read", - "cacheCreation": "Cache Write", + "cachedTokensCol": "缓存读取", + "cacheCreation": "缓存写入", "trend24h": "缓存趋势（24 小时）", "peakCached": "峰值缓存量", "cached": "已缓存", @@ -4495,7 +5039,7 @@ "loading": "加载中...", "entriesLoadError": "加载语义缓存条目失败。", "noEntries": "未找到缓存条目", - "noPromptCacheData": "暂时还没有记录到 provider-side prompt cache 活动。", + "noPromptCacheData": "暂时还没有记录到提供商侧 prompt cache 活动。", "noTrendData": "最近 24 小时还没有记录到 prompt cache 活动。", "signature": "签名", "model": "模型", @@ -4505,74 +5049,33 @@ "deduplicatedRequests": "去重请求数", "savedCalls": "节省的 API 调用次数", "totalProcessed": "已处理请求总数", - "disabled": "Disabled", - "totalRequests": "Total Requests" - }, - "memory": { - "title": "记忆管理", - "description": "查看并管理已存储的记忆条目", - "memories": "记忆", - "totalEntries": "总条目数", - "tokensUsed": "已用 Tokens", - "hitRate": "命中率", - "loading": "正在加载记忆...", - "noMemories": "未找到记忆条目", - "search": "搜索记忆...", - "allTypes": "全部类型", - "export": "导出", - "import": "导入", - "addMemory": "添加记忆", - "type": "类型", - "key": "键", - "keyPlaceholder": "例如：user_preference_theme", - "content": "内容", - "contentPlaceholder": "例如：偏好深色模式", - "created": "创建时间", - "actions": "操作", - "delete": "删除", - "factual": "事实型", - "episodic": "情景型", - "procedural": "程序型", - "semantic": "语义型", - "previous": "上一页", - "next": "下一页", - "pageInfo": "第 {page} 页，共 {totalPages} 页（共 {total} 条）", - "checkingHealth": "检查中...", - "checkHealth": "检查健康", - "pipelineOk": "Pipeline 正常 ({latencyMs}ms)", - "pipelineError": "Pipeline 错误", - "healthUnknown": "健康状态未知", - "cancel": "取消", - "save": "保存" - }, - "skills": { - "title": "技能", - "description": "管理并监控 AI 技能", - "skillsTab": "技能", - "executionsTab": "执行记录", - "sandboxTab": "沙箱", - "loading": "正在加载技能...", - "noSkills": "未找到技能", - "noExecutions": "未找到执行记录", - "enabled": "已启用", "disabled": "已禁用", - "version": "版本", - "tableDescription": "说明", - "skill": "技能", - "status": "状态", - "duration": "耗时", - "time": "时间", - "sandboxConfig": "沙箱配置", - "cpuLimit": "CPU 限制", - "cpuLimitDesc": "单个技能允许的最长执行时间", - "memoryLimit": "内存限制", - "memoryLimitDesc": "允许分配的最大内存", - "timeout": "超时", - "timeoutDesc": "等待响应的最长时间", - "networkAccess": "网络访问", - "networkAccessDesc": "允许发起出站网络请求", - "mode": "Mode", - "q": "Q" + "totalRequests": "总请求数", + "reasoningCache": "推理回放", + "reasoningCacheDesc": "为多轮工具调用流程保留模型思考内容", + "reasoningEntries": "活动条目", + "reasoningReplayRate": "回放率", + "reasoningReplays": "总回放次数", + "reasoningCharsCached": "已缓存字符数", + "reasoningMisses": "缓存未命中", + "reasoningByProvider": "按提供商", + "reasoningByModel": "按模型", + "reasoningRecentEntries": "最近条目", + "reasoningToolCallId": "工具调用 ID", + "reasoningChars": "字符数", + "reasoningAge": "时间", + "reasoningView": "查看", + "reasoningDetail": "推理内容", + "reasoningBehavior": "行为", + "reasoningBehaviorCapture": "从流式响应中捕获 reasoning_content", + "reasoningBehaviorReplay": "当客户端省略时，在下一轮重新注入", + "reasoningBehaviorFallback": "内存优先，并使用 SQLite 作为崩溃恢复后备", + "reasoningBehaviorTtl": "TTL：2 小时 | 最大条目：2,000（内存）", + "reasoningBehaviorModels": "支持：DeepSeek、Kimi、Qwen-Thinking、GLM", + "reasoningClearAll": "清空推理缓存", + "reasoningClearSuccess": "已清除 {count} 个推理缓存条目", + "reasoningClearError": "清除推理缓存失败", + "reasoningNoData": "尚未缓存推理条目。思考模型使用工具调用时会显示条目。" }, "proxyConfigModal": { "levelGlobal": "全局", @@ -4733,7 +5236,26 @@ "noData": "—", "testSuccess": "✓ {ip}", "testLatency": "{latency}毫秒", - "testFailure": "✗ {error}" + "testFailure": "✗ {error}", + "bulkImport": "批量导入", + "bulkImportTitle": "批量导入代理", + "bulkImportDescription": "使用管道符分隔格式粘贴代理配置。每行一个代理。已有代理（相同 host + port）将被更新。", + "bulkImportParse": "解析", + "bulkImportImport": "导入 {count} 个代理", + "bulkImportImporting": "正在导入...", + "bulkImportParsed": "已解析 {count} 个代理", + "bulkImportSkipped": "已跳过 {count} 行", + "bulkImportParseErrors": "{count} 个错误", + "bulkImportNoValidEntries": "未找到有效条目。请检查格式后重试。", + "bulkImportSuccess": "导入完成：已创建 {created} 个，已更新 {updated} 个，失败 {failed} 个", + "bulkImportErrorLine": "第 {line} 行：{reason}", + "bulkImportMaxExceeded": "每次最多导入 100 个代理", + "bulkImportPreview": "预览", + "bulkImportErrorMissingName": "缺少 NAME", + "bulkImportErrorMissingHost": "缺少 HOST", + "bulkImportErrorInvalidPort": "PORT 无效（必须为 1-65535）", + "bulkImportErrorInvalidType": "TYPE 无效（使用 http、https 或 socks5）", + "bulkImportErrorInvalidStatus": "STATUS 无效（使用 active 或 inactive）" }, "playground": { "title": "模型演练场", @@ -4782,6 +5304,8 @@ "pipelineLogsOn": "管道日志开启", "pipelineLogsOff": "管道日志关闭", "updatingPipelineLogs": "正在更新管道日志...", + "updatePipelineFailed": "更新流水线日志失败", + "capturePipeline": "为新请求捕获流水线载荷", "searchPlaceholder": "搜索模型、提供商、账户、API密钥、组合...", "allProviders": "所有提供商", "allModels": "所有模型", @@ -4803,6 +5327,17 @@ "sortStatusAsc": "状态 ↑", "sortModelAsc": "模型 A-Z", "sortModelDesc": "模型 Z-A", + "sortLogs": "日志排序", + "refresh": "刷新", + "columnsLabel": "列", + "cacheSem": "SEM", + "cacheUp": "UP", + "semantic": "Semantic Cache", + "upstream": "上游", + "semanticCacheHit": "语义缓存命中（由 OmniRoute 提供）", + "upstreamResponse": "上游提供商响应", + "noApiKey": "无 API key", + "requestedRoutedTitle": "请求 {requested}，路由为 {routed}", "statusFilters": { "all": "全部", "error": "错误", @@ -4820,6 +5355,7 @@ "apiKey": "API密钥", "combo": "组合", "tokens": "Tokens", + "compressed": "压缩", "tps": "TPS", "duration": "时长", "time": "时间" @@ -4827,32 +5363,56 @@ "loadingLogs": "正在加载日志...", "noLogs": "暂无日志记录。进行一些API调用以在此处查看它们。", "noMatchingLogs": "没有匹配当前筛选器的日志。", - "callLogsInfo": "调用日志也保存为JSON文件到{dataDir}，并根据{retentionDays}和{maxEntries}进行轮换。", - "updatePipelineFailed": "Failed to update pipeline logging", - "capturePipeline": "Capture pipeline payloads for new requests", - "sortLogs": "Sort logs", - "refresh": "Refresh", - "columnsLabel": "Columns", - "cacheSem": "SEM", - "cacheUp": "UP", - "semantic": "Semantic", - "upstream": "Upstream", - "semanticCacheHit": "Semantic cache hit (served by OmniRoute)", - "upstreamResponse": "Upstream provider response", - "noApiKey": "No API key", - "requestedRoutedTitle": "Requested {requested}, routed as {routed}" + "callLogsInfo": "调用日志也保存为JSON文件到{dataDir}，并根据{retentionDays}和{maxEntries}进行轮换。" + }, + "proxyLogger": { + "filterAll": "全部", + "filterErrors": "错误", + "filterSuccess": "成功", + "filterTimeout": "超时", + "colStatus": "状态", + "colProxy": "代理", + "colTls": "TLS", + "colType": "类型", + "colLevel": "级别", + "colProvider": "提供商", + "colTarget": "目标", + "colLatency": "延迟", + "colPublicIp": "公网 IP", + "colTime": "时间", + "recording": "记录中", + "paused": "已暂停", + "searchPlaceholder": "搜索主机、提供商、目标或 IP...", + "allTypes": "全部类型", + "allLevels": "全部级别", + "allProviders": "全部 Provider", + "total": "总计", + "ok": "OK", + "err": "ERR", + "timeoutShort": "TMO", + "direct": "direct", + "newest": "最新", + "oldest": "最旧", + "latencyDesc": "延迟 ↓", + "latencyAsc": "延迟 ↑", + "refresh": "刷新", + "columns": "列", + "loadingProxyLogs": "正在加载代理日志...", + "noProxyLogs": "尚无代理日志。配置代理并发起 API 调用后会显示在这里。", + "noMatchingLogs": "没有日志匹配当前筛选条件。", + "tlsFingerprint": "Chrome 124 TLS 指纹" }, "endpointOptions": { - "speech": "Speech", - "search": "Search", - "images": "Images", - "chat": "Chat", - "music": "Music", + "speech": "语音", + "search": "搜索", + "images": "图像", + "chat": "聊天", + "music": "音乐", "responses": "Responses", "rerank": "Rerank", - "video": "Video", + "video": "视频", "embeddings": "Embeddings", - "transcription": "Transcription" + "transcription": "转写" }, "toolDescriptions": { "cline": "Cline", @@ -4861,49 +5421,5 @@ "codex": "Codex", "claude": "Claude", "kilo": "Kilo" - }, - "proxyLogger": { - "filterAll": "All", - "filterErrors": "Errors", - "filterSuccess": "Success", - "filterTimeout": "Timeout", - "colStatus": "Status", - "colProxy": "Proxy", - "colTls": "TLS", - "colType": "Type", - "colLevel": "Level", - "colProvider": "Provider", - "colTarget": "Target", - "colLatency": "Latency", - "colPublicIp": "Public IP", - "colTime": "Time", - "recording": "Recording", - "paused": "Paused", - "searchPlaceholder": "Search host, provider, target, IP...", - "allTypes": "All Types", - "allLevels": "All Levels", - "allProviders": "All Providers", - "total": "total", - "ok": "OK", - "err": "ERR", - "timeoutShort": "TMO", - "direct": "direct", - "newest": "Newest", - "oldest": "Oldest", - "latencyDesc": "Latency ↓", - "latencyAsc": "Latency ↑", - "refresh": "Refresh", - "columns": "Columns", - "loadingProxyLogs": "Loading proxy logs...", - "noProxyLogs": "No proxy logs yet. Configure proxies and make API calls to see them here.", - "noMatchingLogs": "No logs match the current filters.", - "tlsFingerprint": "Chrome 124 TLS Fingerprint" - }, - "agentFeatures": { - "agentFeaturesContextLength": "Context length", - "agentFeaturesContextLengthPlaceholder": "e.g. 128000", - "agentFeaturesContextLengthHint": "Defines the context window for this combo in /v1/models.", - "agentFeaturesContextLengthErrorInteger": "Context length must be a valid integer", - "agentFeaturesContextLengthErrorRange": "Context length must be between 1000 and 2000000" } -} \ No newline at end of file +} diff --git a/src/instrumentation-node.ts b/src/instrumentation-node.ts index 50cbd0e208..b55d1e352e 100755 --- a/src/instrumentation-node.ts +++ b/src/instrumentation-node.ts @@ -136,11 +136,15 @@ export async function registerNodejs(): Promise<void> { } try { - const [{ migrateCodexConnectionDefaultsFromLegacySettings }, { seedDefaultModelAliases }] = - await Promise.all([ - import("@/lib/providers/codexConnectionDefaults"), - import("@/lib/modelAliasSeed"), - ]); + const [ + { migrateCodexConnectionDefaultsFromLegacySettings }, + { startSessionAccountAffinityCleanup }, + { seedDefaultModelAliases }, + ] = await Promise.all([ + import("@/lib/providers/codexConnectionDefaults"), + import("@/lib/db/sessionAccountAffinity"), + import("@/lib/modelAliasSeed"), + ]); let settings = await getSettings(); const passwordState = await ensurePersistentManagementPasswordHash({ logger: console, @@ -161,6 +165,7 @@ export async function registerNodejs(): Promise<void> { console.log( `[STARTUP] Model alias seed: applied=${seededModelAliases.applied.length}, skipped=${seededModelAliases.skipped.length}, failed=${seededModelAliases.failed.length}` ); + startSessionAccountAffinityCleanup(); const migration = await migrateCodexConnectionDefaultsFromLegacySettings(); if (migration.migrated) { diff --git a/src/lib/api/requireManagementAuth.ts b/src/lib/api/requireManagementAuth.ts index 9f119e5239..9c085e4f5e 100644 --- a/src/lib/api/requireManagementAuth.ts +++ b/src/lib/api/requireManagementAuth.ts @@ -24,8 +24,8 @@ export async function requireManagementAuth(request: Request): Promise<Response try { if (!(await isValidApiKey(apiKey))) { return createErrorResponse({ - status: 401, - message: "Invalid API key", + status: 403, + message: "Invalid management token", type: "invalid_request", }); } diff --git a/src/lib/apiBridgeServer.ts b/src/lib/apiBridgeServer.ts index d289d6f752..4109dfd6ac 100644 --- a/src/lib/apiBridgeServer.ts +++ b/src/lib/apiBridgeServer.ts @@ -22,7 +22,22 @@ function isOpenAiCompatiblePath(pathname: string): boolean { return OPENAI_COMPAT_PATHS.some((pattern) => pattern.test(pathname)); } +function requestWantsStreaming(req: IncomingMessage): boolean { + const accept = String(req.headers.accept || "").toLowerCase(); + if (accept.includes("text/event-stream")) return true; + + const pathname = (req.url || "/").split("?")[0] || "/"; + return /^\/(?:v1\/)?(?:responses|chat\/completions)(?:\/|$)/.test(pathname); +} + +function getProxyTimeoutMs(req: IncomingMessage): number { + if (!requestWantsStreaming(req)) return API_BRIDGE_TIMEOUTS.proxyTimeoutMs; + + return Math.max(API_BRIDGE_TIMEOUTS.proxyTimeoutMs, API_BRIDGE_TIMEOUTS.serverRequestTimeoutMs); +} + function proxyRequest(req: IncomingMessage, res: ServerResponse, dashboardPort: number): void { + const proxyTimeoutMs = getProxyTimeoutMs(req); const targetReq = http.request( { hostname: "127.0.0.1", @@ -33,9 +48,14 @@ function proxyRequest(req: IncomingMessage, res: ServerResponse, dashboardPort: ...req.headers, host: `127.0.0.1:${dashboardPort}`, }, - timeout: API_BRIDGE_TIMEOUTS.proxyTimeoutMs, + timeout: proxyTimeoutMs, }, (targetRes) => { + const contentType = String(targetRes.headers["content-type"] || "").toLowerCase(); + if (contentType.includes("text/event-stream")) { + targetReq.setTimeout(0); + } + res.writeHead(targetRes.statusCode || 502, targetRes.headers); targetRes.pipe(res); } @@ -48,7 +68,7 @@ function proxyRequest(req: IncomingMessage, res: ServerResponse, dashboardPort: res.end( JSON.stringify({ error: "api_bridge_timeout", - detail: `Proxy request timed out after ${API_BRIDGE_TIMEOUTS.proxyTimeoutMs}ms`, + detail: `Proxy request timed out after ${proxyTimeoutMs}ms`, }) ); }); diff --git a/src/lib/cli-helper/config-generator/claude.ts b/src/lib/cli-helper/config-generator/claude.ts new file mode 100644 index 0000000000..488f72eeaa --- /dev/null +++ b/src/lib/cli-helper/config-generator/claude.ts @@ -0,0 +1,21 @@ +import path from "node:path"; +import os from "node:os"; + +const CONFIG_PATH = path.join(os.homedir(), ".claude", "settings.json"); + +export function generateClaudeConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): string { + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + const model = options.model || "claude-3-5-sonnet-20241022"; + + const config = { + baseUrl: `${base}/v1`, + authToken: options.apiKey, + models: [{ id: model }], + }; + + return JSON.stringify(config, null, 2); +} diff --git a/src/lib/cli-helper/config-generator/cline.ts b/src/lib/cli-helper/config-generator/cline.ts new file mode 100644 index 0000000000..5c5bc78765 --- /dev/null +++ b/src/lib/cli-helper/config-generator/cline.ts @@ -0,0 +1,19 @@ +import path from "node:path"; +import os from "node:os"; + +const CONFIG_PATH = path.join(os.homedir(), ".cline", "data", "globalState.json"); + +export function generateClineConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): string { + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + + const config = { + openAiBaseUrl: `${base}/v1`, + openAiApiKey: options.apiKey, + }; + + return JSON.stringify(config, null, 2); +} diff --git a/src/lib/cli-helper/config-generator/codex.ts b/src/lib/cli-helper/config-generator/codex.ts new file mode 100644 index 0000000000..4ec669e483 --- /dev/null +++ b/src/lib/cli-helper/config-generator/codex.ts @@ -0,0 +1,30 @@ +import path from "node:path"; +import os from "node:os"; + +let yaml: typeof import("js-yaml") | null = null; +async function loadYaml() { + if (!yaml) { + yaml = await import("js-yaml"); + } + return yaml; +} + +const CONFIG_PATH = path.join(os.homedir(), ".codex", "config.yaml"); + +export async function generateCodexConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): Promise<string> { + const y = await loadYaml(); + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + + const config = { + openai: { + api_key: options.apiKey, + base_url: `${base}/v1`, + }, + }; + + return y.dump(config, { lineWidth: -1 }); +} diff --git a/src/lib/cli-helper/config-generator/continue.ts b/src/lib/cli-helper/config-generator/continue.ts new file mode 100644 index 0000000000..8eedb4afcf --- /dev/null +++ b/src/lib/cli-helper/config-generator/continue.ts @@ -0,0 +1,33 @@ +import path from "node:path"; +import os from "node:os"; + +let yaml: typeof import("js-yaml") | null = null; +async function loadYaml() { + if (!yaml) { + yaml = await import("js-yaml"); + } + return yaml; +} + +const CONFIG_PATH = path.join(os.homedir(), ".continue", "config.yaml"); + +export async function generateContinueConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): Promise<string> { + const y = await loadYaml(); + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + + const config = { + models: [ + { + title: "OmniRoute", + apiKey: options.apiKey, + apiBase: `${base}/v1`, + }, + ], + }; + + return y.dump(config, { lineWidth: -1 }); +} diff --git a/src/lib/cli-helper/config-generator/index.ts b/src/lib/cli-helper/config-generator/index.ts new file mode 100644 index 0000000000..9431eaa12d --- /dev/null +++ b/src/lib/cli-helper/config-generator/index.ts @@ -0,0 +1,95 @@ +import path from "node:path"; +import os from "node:os"; + +export interface GenerateOptions { + baseUrl: string; + apiKey: string; + model?: string; +} + +export interface GenerateResult { + success: boolean; + configPath: string; + content?: string; + error?: string; +} + +function validateBaseUrl(url: string): boolean { + try { + const u = new URL(url); + return u.protocol === "http:" || u.protocol === "https:"; + } catch { + return false; + } +} + +function expandHome(p: string): string { + const home = os.homedir(); + return p.replace(/^~\//, home + "/"); +} + +const TOOL_CONFIG_PATHS: Record<string, string> = { + claude: path.join(os.homedir(), ".claude", "settings.json"), + codex: path.join(os.homedir(), ".codex", "config.yaml"), + opencode: path.join(os.homedir(), ".config", "opencode", "opencode.json"), + cline: path.join(os.homedir(), ".cline", "data", "globalState.json"), + kilocode: path.join(os.homedir(), ".config", "kilocode", "settings.json"), + continue: path.join(os.homedir(), ".continue", "config.yaml"), +}; + +async function importGenerator(toolId: string) { + const generators: Record<string, { module: string; export: string }> = { + claude: { module: "./claude.js", export: "generateClaudeConfig" }, + codex: { module: "./codex.js", export: "generateCodexConfig" }, + opencode: { module: "./opencode.js", export: "generateOpencodeConfig" }, + cline: { module: "./cline.js", export: "generateClineConfig" }, + kilocode: { module: "./kilocode.js", export: "generateKilocodeConfig" }, + continue: { module: "./continue.js", export: "generateContinueConfig" }, + }; + + const gen = generators[toolId]; + if (!gen) return null; + const mod = await import(gen.module); + return { generate: mod[gen.export] }; +} + +export async function generateConfig( + toolId: string, + options: GenerateOptions +): Promise<GenerateResult> { + if (!validateBaseUrl(options.baseUrl)) { + return { + success: false, + configPath: "", + error: "Invalid baseUrl: must be an absolute HTTP(S) URL", + }; + } + + if (!options.apiKey || options.apiKey.trim().length === 0) { + return { success: false, configPath: "", error: "API key is required" }; + } + + try { + const mod = await importGenerator(toolId); + if (!mod) { + return { success: false, configPath: "", error: `Unknown tool: ${toolId}` }; + } + const content = await mod.generate(options); + const configPath = TOOL_CONFIG_PATHS[toolId] || ""; + return { success: true, configPath, content }; + } catch (err) { + const msg = err instanceof Error ? err.message : String(err); + return { success: false, configPath: "", error: `Generation failed: ${msg}` }; + } +} + +export async function generateAllConfigs(options: GenerateOptions): Promise<GenerateResult[]> { + const toolIds = ["claude", "codex", "opencode", "cline", "kilocode", "continue"] as const; + const results = await Promise.allSettled(toolIds.map((id) => generateConfig(id, options))); + + return results.map((r) => + r.status === "fulfilled" + ? r.value + : { success: false, configPath: "", error: r.reason?.message || "Unknown error" } + ); +} diff --git a/src/lib/cli-helper/config-generator/kilocode.ts b/src/lib/cli-helper/config-generator/kilocode.ts new file mode 100644 index 0000000000..8c43dcd407 --- /dev/null +++ b/src/lib/cli-helper/config-generator/kilocode.ts @@ -0,0 +1,19 @@ +import path from "node:path"; +import os from "node:os"; + +const CONFIG_PATH = path.join(os.homedir(), ".config", "kilocode", "settings.json"); + +export function generateKilocodeConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): string { + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + + const config = { + apiKey: options.apiKey, + baseUrl: `${base}/v1`, + }; + + return JSON.stringify(config, null, 2); +} diff --git a/src/lib/cli-helper/config-generator/opencode.ts b/src/lib/cli-helper/config-generator/opencode.ts new file mode 100644 index 0000000000..b17214dac7 --- /dev/null +++ b/src/lib/cli-helper/config-generator/opencode.ts @@ -0,0 +1,21 @@ +import path from "node:path"; +import os from "node:os"; + +const CONFIG_PATH = path.join(os.homedir(), ".config", "opencode", "opencode.json"); + +export function generateOpencodeConfig(options: { + baseUrl: string; + apiKey: string; + model?: string; +}): string { + const base = options.baseUrl.replace(/\/+$/, "").replace(/\/v1$/, ""); + + const config = { + provider: "omniroute", + baseURL: `${base}/v1`, + apiKey: options.apiKey, + model: options.model || "opencode", + }; + + return JSON.stringify(config, null, 2); +} diff --git a/src/lib/cli-helper/doctor/checks.ts b/src/lib/cli-helper/doctor/checks.ts new file mode 100644 index 0000000000..353d0e6026 --- /dev/null +++ b/src/lib/cli-helper/doctor/checks.ts @@ -0,0 +1,41 @@ +import path from "node:path"; +import os from "node:os"; + +export interface DoctorCheckResult { + name: string; + status: "ok" | "warn" | "fail"; + message: string; + details: Record<string, unknown>; +} + +export async function collectCliToolChecks(): Promise<DoctorCheckResult[]> { + const { detectAllTools } = await import("../tool-detector.js"); + const tools = await detectAllTools(); + + return tools.map((tool) => { + if (!tool.installed) { + return { + name: `CLI: ${tool.name}`, + status: "warn" as const, + message: `${tool.name} not installed`, + details: { id: tool.id, installed: false }, + }; + } + + if (!tool.configured) { + return { + name: `CLI: ${tool.name}`, + status: "warn" as const, + message: `${tool.name} not configured for OmniRoute`, + details: { id: tool.id, configured: false }, + }; + } + + return { + name: `CLI: ${tool.name}`, + status: "ok" as const, + message: `${tool.name} configured`, + details: { id: tool.id, configured: true }, + }; + }); +} diff --git a/src/lib/cli-helper/log-streamer.ts b/src/lib/cli-helper/log-streamer.ts new file mode 100644 index 0000000000..9a4c237fed --- /dev/null +++ b/src/lib/cli-helper/log-streamer.ts @@ -0,0 +1,79 @@ +import os from "node:os"; +import path from "node:path"; + +export interface LogStreamOptions { + baseUrl?: string; + filters?: string[]; + follow?: boolean; + timeout?: number; +} + +export interface LogStream { + stream: ReadableStream<Uint8Array>; + stop: () => void; +} + +export function createLogStream(options: LogStreamOptions = {}): LogStream { + const baseUrl = options.baseUrl || "http://localhost:20128"; + const filters = options.filters || []; + const follow = options.follow ?? false; + const timeout = options.timeout || 30000; + + const controller = new AbortController(); + const { signal } = controller; + + const stream = new ReadableStream<Uint8Array>({ + async start(controller) { + let url = `${baseUrl}/api/cli-tools/logs?follow=${follow}`; + if (filters.length > 0) { + url += `&filter=${encodeURIComponent(filters.join(","))}`; + } + + const timeoutId = setTimeout(() => { + if (follow) return; // Don't timeout follow mode + controller.error(new Error(`Log stream timed out after ${timeout}ms`)); + }, timeout); + + try { + const response = await fetch(url, { signal }); + + if (!response.ok) { + controller.error(new Error(`HTTP ${response.status}: ${response.statusText}`)); + clearTimeout(timeoutId); + return; + } + + if (!response.body) { + controller.error(new Error("Response body is null")); + clearTimeout(timeoutId); + return; + } + + const reader = response.body.getReader(); + + while (true) { + const { done, value } = await reader.read(); + if (done) break; + if (signal.aborted) break; + controller.enqueue(value); + } + + controller.close(); + clearTimeout(timeoutId); + } catch (err) { + if (signal.aborted) return; // Expected stop + controller.error(err instanceof Error ? err : new Error(String(err))); + clearTimeout(timeoutId); + } + }, + + cancel() { + controller.abort(); + }, + }); + + return { + stream, + stop: () => controller.abort(), + }; +} diff --git a/src/lib/cli-helper/tool-detector.ts b/src/lib/cli-helper/tool-detector.ts new file mode 100644 index 0000000000..7b48f46585 --- /dev/null +++ b/src/lib/cli-helper/tool-detector.ts @@ -0,0 +1,105 @@ +import os from "node:os"; +import path from "node:path"; +import { execFile } from "node:child_process"; +import { promisify } from "node:util"; + +const execFileAsync = promisify(execFile); + +export interface DetectedTool { + id: string; + name: string; + installed: boolean; + version?: string; + configPath: string; + configured: boolean; + configContents?: string; +} + +const TOOLS = [ + { id: "claude", name: "Claude Code", configPath: "~/.claude/settings.json" }, + { id: "codex", name: "Codex CLI", configPath: "~/.codex/config.yaml" }, + { id: "opencode", name: "OpenCode", configPath: "~/.config/opencode/opencode.json" }, + { id: "cline", name: "Cline", configPath: "~/.cline/data/globalState.json" }, + { id: "kilocode", name: "Kilo Code", configPath: "~/.config/kilocode/settings.json" }, + { id: "continue", name: "Continue", configPath: "~/.continue/config.yaml" }, +] as const; + +const BINARY_NAMES: Record<string, string> = { + claude: "claude", + codex: "codex", + opencode: "opencode", + cline: "cline", + kilocode: "kilocode", + continue: "continue", +}; + +function expandHome(p: string): string { + const home = os.homedir(); + return p.replace(/^~\//, home + "/"); +} + +function isConfigured(content: string, baseUrl: string): boolean { + const normalized = baseUrl.replace(/\/+$/, ""); + return ( + content.includes(normalized) || + content.includes("localhost:20128") || + content.includes("OMNIROUTE_BASE_URL") + ); +} + +async function detectBinary(name: string): Promise<{ installed: boolean; version?: string }> { + const binary = BINARY_NAMES[name] || name; + try { + const { stdout } = await execFileAsync(binary, ["--version"], { timeout: 5000 }); + const version = stdout.trim().replace(/^v/, ""); + return { installed: true, version }; + } catch { + try { + // Try `which` as fallback + const { stdout } = await execFileAsync("which", [binary], { timeout: 5000 }); + if (stdout.trim()) { + return { installed: true }; + } + } catch {} + return { installed: false }; + } +} + +async function readConfigFile(configPath: string): Promise<string | null> { + try { + const { readFileSync } = await import("node:fs"); + const expanded = expandHome(configPath); + if (!expanded) return null; + return readFileSync(expanded, "utf-8"); + } catch { + return null; + } +} + +export async function detectTool(id: string): Promise<DetectedTool | null> { + const tool = TOOLS.find((t) => t.id === id); + if (!tool) return null; + + const { installed, version } = await detectBinary(tool.id); + const configPath = expandHome(tool.configPath); + const configContents = await readConfigFile(tool.configPath); + const configured = !!configContents && isConfigured(configContents, "http://localhost:20128"); + + return { + id: tool.id, + name: tool.name, + installed, + version, + configPath, + configured, + configContents: configContents ?? undefined, + }; +} + +export async function detectAllTools(): Promise<DetectedTool[]> { + const results = await Promise.allSettled(TOOLS.map((t) => detectTool(t.id))); + + return results + .filter((r) => r.status === "fulfilled" && r.value !== null) + .map((r) => (r as PromiseFulfilledResult<DetectedTool>).value); +} diff --git a/src/lib/cloudAgent/agents/codex.ts b/src/lib/cloudAgent/agents/codex.ts new file mode 100644 index 0000000000..f069ac9109 --- /dev/null +++ b/src/lib/cloudAgent/agents/codex.ts @@ -0,0 +1,148 @@ +import { + CloudAgentBase, + type AgentCredentials, + type CreateTaskParams, + type GetStatusResult, +} from "../baseAgent.ts"; +import type { CloudAgentTask, CloudAgentActivity } from "../types.ts"; +import { CLOUD_AGENT_STATUS } from "../types.ts"; + +export class CodexCloudAgent extends CloudAgentBase { + readonly providerId = "codex-cloud"; + readonly baseUrl = "https://api.openai.com/v1"; + + async createTask( + params: CreateTaskParams, + credentials: AgentCredentials + ): Promise<CloudAgentTask> { + const taskId = this.generateTaskId(); + + const body: Record<string, unknown> = { + prompt: params.prompt, + repository_context: params.source.repoUrl, + }; + + if (params.source.branch) { + body.branch = params.source.branch; + } + + if (params.options.environment) { + body.environment = { + setup: params.options.environment, + }; + } + + const response = await fetch(`${this.baseUrl}/codex/cloud/tasks`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${credentials.apiKey}`, + }, + body: JSON.stringify(body), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Codex Cloud create task failed: ${response.status} ${error}`); + } + + const data = await response.json(); + + return { + id: taskId, + providerId: this.providerId, + externalId: data.id, + status: this.mapStatus(data.status || "pending"), + prompt: params.prompt, + source: params.source, + options: params.options, + activities: [], + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }; + } + + async getStatus(externalId: string, credentials: AgentCredentials): Promise<GetStatusResult> { + const response = await fetch(`${this.baseUrl}/codex/cloud/tasks/${externalId}`, { + headers: { + Authorization: `Bearer ${credentials.apiKey}`, + }, + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Codex Cloud get status failed: ${response.status} ${error}`); + } + + const data = await response.json(); + const status = this.mapStatus(data.status || "pending"); + + const activities: CloudAgentActivity[] = []; + + if (data.subagents) { + for (const subagent of data.subagents) { + activities.push({ + id: this.generateActivityId(), + type: "command", + content: `Subagent: ${subagent.name} - ${subagent.status}`, + timestamp: new Date().toISOString(), + }); + } + } + + let result; + if (status === CLOUD_AGENT_STATUS.COMPLETED && (data.result || data.pr_url)) { + result = { + prUrl: data.pr_url || data.result?.pr_url, + commitMessage: data.result?.commit_message, + summary: data.result?.summary, + duration: data.elapsed_time, + }; + } + + return { + status, + externalId, + result, + activities, + error: data.error || data.error_message, + }; + } + + async approvePlan(_externalId: string, _credentials: AgentCredentials): Promise<void> { + throw new Error("Codex Cloud does not support plan approval - it auto-plans"); + } + + async sendMessage( + externalId: string, + message: string, + credentials: AgentCredentials + ): Promise<CloudAgentActivity> { + const response = await fetch(`${this.baseUrl}/codex/cloud/tasks/${externalId}/followup`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${credentials.apiKey}`, + }, + body: JSON.stringify({ message }), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Codex Cloud send message failed: ${response.status} ${error}`); + } + + return { + id: this.generateActivityId(), + type: "message", + content: message, + timestamp: new Date().toISOString(), + }; + } + + async listSources( + _credentials: AgentCredentials + ): Promise<{ name: string; url: string; branch?: string }[]> { + return []; + } +} diff --git a/src/lib/cloudAgent/agents/devin.ts b/src/lib/cloudAgent/agents/devin.ts new file mode 100644 index 0000000000..c409c92349 --- /dev/null +++ b/src/lib/cloudAgent/agents/devin.ts @@ -0,0 +1,137 @@ +import { + CloudAgentBase, + type AgentCredentials, + type CreateTaskParams, + type GetStatusResult, +} from "../baseAgent.ts"; +import type { CloudAgentTask, CloudAgentActivity } from "../types.ts"; +import { CLOUD_AGENT_STATUS } from "../types.ts"; + +export class DevinAgent extends CloudAgentBase { + readonly providerId = "devin"; + readonly baseUrl = "https://api.devin.ai/v1"; + + async createTask( + params: CreateTaskParams, + credentials: AgentCredentials + ): Promise<CloudAgentTask> { + const taskId = this.generateTaskId(); + + const body: Record<string, unknown> = { + prompt: params.prompt, + repo_url: params.source.repoUrl, + }; + + if (params.source.branch) { + body.branch = params.source.branch; + } + + const response = await fetch(`${this.baseUrl}/sessions`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${credentials.apiKey}`, + }, + body: JSON.stringify(body), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Devin create task failed: ${response.status} ${error}`); + } + + const data = await response.json(); + + return { + id: taskId, + providerId: this.providerId, + externalId: data.id, + status: this.mapStatus(data.status || "created"), + prompt: params.prompt, + source: params.source, + options: params.options, + activities: [], + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }; + } + + async getStatus(externalId: string, credentials: AgentCredentials): Promise<GetStatusResult> { + const response = await fetch(`${this.baseUrl}/sessions/${externalId}`, { + headers: { + Authorization: `Bearer ${credentials.apiKey}`, + }, + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Devin get status failed: ${response.status} ${error}`); + } + + const data = await response.json(); + const status = this.mapStatus(data.status || "created"); + + const activities: CloudAgentActivity[] = (data.messages || []).map( + (msg: Record<string, unknown>) => ({ + id: this.generateActivityId(), + type: "message" as const, + content: (msg.content as string) || "", + timestamp: (msg.created_at as string) || new Date().toISOString(), + }) + ); + + let result; + if (status === CLOUD_AGENT_STATUS.COMPLETED && data.output) { + result = { + prUrl: data.pr_url, + summary: data.output, + duration: data.duration, + }; + } + + return { + status, + externalId, + result, + activities, + error: data.error, + }; + } + + async approvePlan(_externalId: string, _credentials: AgentCredentials): Promise<void> { + throw new Error("Devin does not support plan approval - it auto-plans"); + } + + async sendMessage( + externalId: string, + message: string, + credentials: AgentCredentials + ): Promise<CloudAgentActivity> { + const response = await fetch(`${this.baseUrl}/sessions/${externalId}/message`, { + method: "POST", + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${credentials.apiKey}`, + }, + body: JSON.stringify({ content: message }), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Devin send message failed: ${response.status} ${error}`); + } + + return { + id: this.generateActivityId(), + type: "message", + content: message, + timestamp: new Date().toISOString(), + }; + } + + async listSources( + _credentials: AgentCredentials + ): Promise<{ name: string; url: string; branch?: string }[]> { + return []; + } +} diff --git a/src/lib/cloudAgent/agents/jules.ts b/src/lib/cloudAgent/agents/jules.ts new file mode 100644 index 0000000000..932eb4dfaa --- /dev/null +++ b/src/lib/cloudAgent/agents/jules.ts @@ -0,0 +1,170 @@ +import { + CloudAgentBase, + type AgentCredentials, + type CreateTaskParams, + type GetStatusResult, +} from "../baseAgent.ts"; +import type { CloudAgentTask, CloudAgentActivity } from "../types.ts"; +import { CLOUD_AGENT_STATUS } from "../types.ts"; + +export class JulesAgent extends CloudAgentBase { + readonly providerId = "jules"; + readonly baseUrl = "https://jules.googleapis.com/v1alpha"; + + async createTask( + params: CreateTaskParams, + credentials: AgentCredentials + ): Promise<CloudAgentTask> { + const taskId = this.generateTaskId(); + + const body: Record<string, unknown> = { + prompt: params.prompt, + source: { + repository: { + owner: params.source.repoUrl.split("/").filter(Boolean).slice(-2, -1)[0] || "", + name: params.source.repoName, + }, + branch: params.source.branch || "main", + }, + }; + + if (params.options.autoCreatePr) { + body.automationMode = "AUTO_CREATE_PR"; + } + + const response = await fetch(`${this.baseUrl}/sessions`, { + method: "POST", + headers: { + "Content-Type": "application/json", + "X-Goog-Api-Key": credentials.apiKey, + }, + body: JSON.stringify(body), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Jules create task failed: ${response.status} ${error}`); + } + + const data = await response.json(); + + return { + id: taskId, + providerId: this.providerId, + externalId: data.name?.split("/").pop() || taskId, + status: this.mapStatus(data.state || "pending"), + prompt: params.prompt, + source: params.source, + options: params.options, + activities: [], + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }; + } + + async getStatus(externalId: string, _credentials: AgentCredentials): Promise<GetStatusResult> { + const response = await fetch(`${this.baseUrl}/sessions/${externalId}`, { + headers: { + "X-Goog-Api-Key": _credentials.apiKey, + }, + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Jules get status failed: ${response.status} ${error}`); + } + + const data = await response.json(); + const status = this.mapStatus(data.state || "pending"); + + const activities: CloudAgentActivity[] = (data.activities || []).map( + (act: Record<string, unknown>) => ({ + id: this.generateActivityId(), + type: act.type as CloudAgentActivity["type"], + content: (act.description as string) || "", + timestamp: (act.timestamp as string) || new Date().toISOString(), + }) + ); + + let result; + if (status === CLOUD_AGENT_STATUS.COMPLETED && data.outputs) { + result = { + prUrl: data.outputs.prUrl, + commitMessage: data.outputs.commitMessage, + summary: data.outputs.summary, + }; + } + + return { + status, + externalId, + result, + activities, + error: data.error, + }; + } + + async approvePlan(externalId: string, credentials: AgentCredentials): Promise<void> { + const response = await fetch(`${this.baseUrl}/sessions/${externalId}:approvePlan`, { + method: "POST", + headers: { + "Content-Type": "application/json", + "X-Goog-Api-Key": credentials.apiKey, + }, + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Jules approve plan failed: ${response.status} ${error}`); + } + } + + async sendMessage( + externalId: string, + message: string, + credentials: AgentCredentials + ): Promise<CloudAgentActivity> { + const response = await fetch(`${this.baseUrl}/sessions/${externalId}:sendMessage`, { + method: "POST", + headers: { + "Content-Type": "application/json", + "X-Goog-Api-Key": credentials.apiKey, + }, + body: JSON.stringify({ message }), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Jules send message failed: ${response.status} ${error}`); + } + + return { + id: this.generateActivityId(), + type: "message", + content: message, + timestamp: new Date().toISOString(), + }; + } + + async listSources( + credentials: AgentCredentials + ): Promise<{ name: string; url: string; branch?: string }[]> { + const response = await fetch(`${this.baseUrl}/sources`, { + headers: { + "X-Goog-Api-Key": credentials.apiKey, + }, + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Jules list sources failed: ${response.status} ${error}`); + } + + const data = await response.json(); + return (data.sources || []).map((source: Record<string, unknown>) => ({ + name: source.name as string, + url: `https://github.com/${source.repoOwner}/${source.repoName}`, + branch: source.defaultBranch as string | undefined, + })); + } +} diff --git a/src/lib/cloudAgent/api.ts b/src/lib/cloudAgent/api.ts new file mode 100644 index 0000000000..90dbcb1690 --- /dev/null +++ b/src/lib/cloudAgent/api.ts @@ -0,0 +1,86 @@ +import { requireManagementAuth } from "@/lib/api/requireManagementAuth"; +import { getProviderConnections } from "@/lib/db/providers"; +import type { AgentCredentials } from "./baseAgent.ts"; +import type { CloudAgentTaskRow } from "./db.ts"; + +type JsonRecord = Record<string, unknown>; + +export function getCloudAgentCorsHeaders(request?: Request) { + const origin = request?.headers.get("origin"); + return { + "Access-Control-Allow-Origin": origin || "*", + "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS", + "Access-Control-Allow-Headers": "Content-Type, Authorization", + "Access-Control-Allow-Credentials": "true", + }; +} + +export function withCloudAgentCors(response: Response, request?: Request): Response { + const headers = new Headers(response.headers); + for (const [key, value] of Object.entries(getCloudAgentCorsHeaders(request))) { + headers.set(key, value); + } + + return new Response(response.body, { + status: response.status, + statusText: response.statusText, + headers, + }); +} + +export async function requireCloudAgentManagementAuth(request: Request): Promise<Response | null> { + const authError = await requireManagementAuth(request); + return authError ? withCloudAgentCors(authError, request) : null; +} + +function parseJson<T>(value: string | null | undefined, fallback: T): T { + if (!value) return fallback; + try { + return JSON.parse(value) as T; + } catch { + return fallback; + } +} + +export function serializeCloudAgentTask(task: CloudAgentTaskRow) { + return { + id: task.id, + providerId: task.provider_id, + externalId: task.external_id, + status: task.status, + prompt: task.prompt, + source: parseJson<JsonRecord>(task.source, {}), + options: parseJson<JsonRecord>(task.options, {}), + result: task.result ? parseJson<JsonRecord>(task.result, {}) : null, + activities: parseJson<JsonRecord[]>(task.activities, []), + error: task.error, + createdAt: task.created_at, + updatedAt: task.updated_at, + completedAt: task.completed_at, + }; +} + +function getConnectionToken(connection: JsonRecord): string | null { + const apiKey = typeof connection.apiKey === "string" ? connection.apiKey.trim() : ""; + if (apiKey) return apiKey; + + const accessToken = + typeof connection.accessToken === "string" ? connection.accessToken.trim() : ""; + return accessToken || null; +} + +export async function getCloudAgentCredentials( + providerId: string +): Promise<AgentCredentials | null> { + const connections = (await getProviderConnections({ + provider: providerId, + isActive: true, + })) as JsonRecord[]; + + for (const connection of connections) { + const token = getConnectionToken(connection); + if (token) return { apiKey: token }; + } + + return null; +} diff --git a/src/lib/cloudAgent/baseAgent.ts b/src/lib/cloudAgent/baseAgent.ts new file mode 100644 index 0000000000..9f5689b90b --- /dev/null +++ b/src/lib/cloudAgent/baseAgent.ts @@ -0,0 +1,95 @@ +import type { + CloudAgentTask, + CloudAgentStatus, + CloudAgentSource, + CloudAgentResult, + CloudAgentActivity, +} from "./types.ts"; + +export interface AgentCredentials { + apiKey: string; + baseUrl?: string; +} + +export interface CreateTaskParams { + prompt: string; + source: CloudAgentSource; + options: { + autoCreatePr?: boolean; + planApprovalRequired?: boolean; + environment?: Record<string, string>; + }; +} + +export interface GetStatusResult { + status: CloudAgentStatus; + externalId?: string; + result?: CloudAgentResult; + activities: CloudAgentActivity[]; + error?: string; +} + +export abstract class CloudAgentBase { + abstract readonly providerId: string; + abstract readonly baseUrl: string; + + abstract createTask( + params: CreateTaskParams, + credentials: AgentCredentials + ): Promise<CloudAgentTask>; + + abstract getStatus(externalId: string, credentials: AgentCredentials): Promise<GetStatusResult>; + + abstract approvePlan(externalId: string, credentials: AgentCredentials): Promise<void>; + + abstract sendMessage( + externalId: string, + message: string, + credentials: AgentCredentials + ): Promise<CloudAgentActivity>; + + abstract listSources( + credentials: AgentCredentials + ): Promise<{ name: string; url: string; branch?: string }[]>; + + protected mapStatus(status: string): CloudAgentStatus { + const statusLower = status.toLowerCase(); + + if (statusLower.includes("completed") || statusLower.includes("done")) { + return "completed"; + } + if (statusLower.includes("failed") || statusLower.includes("error")) { + return "failed"; + } + if (statusLower.includes("cancelled") || statusLower.includes("canceled")) { + return "cancelled"; + } + if ( + statusLower.includes("running") || + statusLower.includes("active") || + statusLower.includes("executing") + ) { + return "running"; + } + if ( + statusLower.includes("pending") || + statusLower.includes("queued") || + statusLower.includes("waiting") + ) { + return "queued"; + } + if (statusLower.includes("approval") || statusLower.includes("plan")) { + return "awaiting_approval"; + } + + return "queued"; + } + + protected generateTaskId(): string { + return `task_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`; + } + + protected generateActivityId(): string { + return `act_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`; + } +} diff --git a/src/lib/cloudAgent/db.ts b/src/lib/cloudAgent/db.ts new file mode 100644 index 0000000000..91667f5422 --- /dev/null +++ b/src/lib/cloudAgent/db.ts @@ -0,0 +1,145 @@ +import { getDbInstance } from "@/lib/db/core.ts"; + +export interface CloudAgentTaskRow { + id: string; + provider_id: string; + external_id: string | null; + status: string; + prompt: string; + source: string; + options: string; + result: string | null; + activities: string; + error: string | null; + created_at: string; + updated_at: string; + completed_at: string | null; +} + +export function createCloudAgentTaskTable(): void { + const db = getDbInstance(); + + db.exec(` + CREATE TABLE IF NOT EXISTS cloud_agent_tasks ( + id TEXT PRIMARY KEY, + provider_id TEXT NOT NULL, + external_id TEXT, + status TEXT NOT NULL DEFAULT 'queued', + prompt TEXT NOT NULL, + source TEXT NOT NULL, + options TEXT DEFAULT '{}', + result TEXT, + activities TEXT DEFAULT '[]', + error TEXT, + created_at TEXT NOT NULL DEFAULT (datetime('now')), + updated_at TEXT NOT NULL DEFAULT (datetime('now')), + completed_at TEXT + ) + `); + + db.exec(` + CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_provider + ON cloud_agent_tasks(provider_id) + `); + + db.exec(` + CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_status + ON cloud_agent_tasks(status) + `); + + db.exec(` + CREATE INDEX IF NOT EXISTS idx_cloud_agent_tasks_created + ON cloud_agent_tasks(created_at DESC) + `); +} + +export function insertCloudAgentTask(task: CloudAgentTaskRow): void { + const db = getDbInstance(); + db.prepare( + ` + INSERT INTO cloud_agent_tasks ( + id, provider_id, external_id, status, prompt, source, + options, result, activities, error, created_at, updated_at, completed_at + ) VALUES ( + @id, @provider_id, @external_id, @status, @prompt, @source, + @options, @result, @activities, @error, @created_at, @updated_at, @completed_at + ) + ` + ).run(task); +} + +// Whitelist of allowed columns for update operations +const ALLOWED_UPDATE_COLUMNS = new Set([ + "status", + "prompt", + "source", + "options", + "result", + "activities", + "error", + "completed_at", +]); + +export function updateCloudAgentTask( + id: string, + updates: Partial<Omit<CloudAgentTaskRow, "id">> +): void { + const db = getDbInstance(); + + // Validate keys against whitelist to prevent SQL injection + const validUpdates: Partial<Omit<CloudAgentTaskRow, "id">> = {}; + for (const [key, value] of Object.entries(updates)) { + if (ALLOWED_UPDATE_COLUMNS.has(key)) { + (validUpdates as Record<string, unknown>)[key] = value; + } + } + + const fields = Object.keys(validUpdates) + .map((key) => `${key} = @${key}`) + .join(", "); + + if (!fields) return; // No valid updates + + db.prepare( + ` + UPDATE cloud_agent_tasks + SET ${fields}, updated_at = datetime('now') + WHERE id = @id + ` + ).run({ id, ...validUpdates }); +} + +export function getCloudAgentTaskById(id: string): CloudAgentTaskRow | null { + const db = getDbInstance(); + return db + .prepare("SELECT * FROM cloud_agent_tasks WHERE id = ?") + .get(id) as CloudAgentTaskRow | null; +} + +export function getCloudAgentTasksByProvider(providerId: string, limit = 50): CloudAgentTaskRow[] { + const db = getDbInstance(); + return db + .prepare( + "SELECT * FROM cloud_agent_tasks WHERE provider_id = ? ORDER BY created_at DESC LIMIT ?" + ) + .all(providerId, limit) as CloudAgentTaskRow[]; +} + +export function getCloudAgentTasksByStatus(status: string, limit = 50): CloudAgentTaskRow[] { + const db = getDbInstance(); + return db + .prepare("SELECT * FROM cloud_agent_tasks WHERE status = ? ORDER BY created_at DESC LIMIT ?") + .all(status, limit) as CloudAgentTaskRow[]; +} + +export function getAllCloudAgentTasks(limit = 100): CloudAgentTaskRow[] { + const db = getDbInstance(); + return db + .prepare("SELECT * FROM cloud_agent_tasks ORDER BY created_at DESC LIMIT ?") + .all(limit) as CloudAgentTaskRow[]; +} + +export function deleteCloudAgentTask(id: string): void { + const db = getDbInstance(); + db.prepare("DELETE FROM cloud_agent_tasks WHERE id = ?").run(id); +} diff --git a/src/lib/cloudAgent/index.ts b/src/lib/cloudAgent/index.ts new file mode 100644 index 0000000000..c8a23bf314 --- /dev/null +++ b/src/lib/cloudAgent/index.ts @@ -0,0 +1,8 @@ +export * from "./types.ts"; +export * from "./baseAgent.ts"; +export * from "./registry.ts"; +export * from "./db.ts"; + +import { createCloudAgentTaskTable } from "./db.ts"; + +createCloudAgentTaskTable(); diff --git a/src/lib/cloudAgent/registry.ts b/src/lib/cloudAgent/registry.ts new file mode 100644 index 0000000000..091359a400 --- /dev/null +++ b/src/lib/cloudAgent/registry.ts @@ -0,0 +1,25 @@ +import type { CloudAgentBase } from "./baseAgent.ts"; +import { JulesAgent } from "./agents/jules.ts"; +import { DevinAgent } from "./agents/devin.ts"; +import { CodexCloudAgent } from "./agents/codex.ts"; + +const AGENTS: Record<string, CloudAgentBase> = { + jules: new JulesAgent(), + devin: new DevinAgent(), + "codex-cloud": new CodexCloudAgent(), +}; + +export function getAgent(providerId: string): CloudAgentBase | null { + return AGENTS[providerId] || null; +} + +export function getAvailableAgents(): string[] { + return Object.keys(AGENTS); +} + +export function isCloudAgentProvider(providerId: string): boolean { + return providerId in AGENTS; +} + +export { JulesAgent, DevinAgent, CodexCloudAgent }; +export type { CloudAgentBase } from "./baseAgent.ts"; diff --git a/src/lib/cloudAgent/types.ts b/src/lib/cloudAgent/types.ts new file mode 100644 index 0000000000..45c7a65406 --- /dev/null +++ b/src/lib/cloudAgent/types.ts @@ -0,0 +1,111 @@ +import { z } from "zod"; + +export const CLOUD_AGENT_STATUS = { + QUEUED: "queued", + RUNNING: "running", + AWAITING_APPROVAL: "awaiting_approval", + COMPLETED: "completed", + FAILED: "failed", + CANCELLED: "cancelled", +} as const; + +export type CloudAgentStatus = (typeof CLOUD_AGENT_STATUS)[keyof typeof CLOUD_AGENT_STATUS]; + +export const CloudAgentStatusSchema = z.enum([ + "queued", + "running", + "awaiting_approval", + "completed", + "failed", + "cancelled", +]); + +export interface CloudAgentSource { + repoName: string; + repoUrl: string; + branch?: string; +} + +export interface CloudAgentResult { + prUrl?: string; + prNumber?: number; + commitMessage?: string; + diffUrl?: string; + summary?: string; + duration?: number; + cost?: number; +} + +export interface CloudAgentActivity { + id: string; + type: "plan" | "command" | "code_change" | "message" | "error" | "completion"; + content: string; + timestamp: string; + metadata?: Record<string, unknown>; +} + +export interface CloudAgentTask { + id: string; + providerId: "jules" | "devin" | "codex-cloud"; + externalId?: string; + status: CloudAgentStatus; + prompt: string; + source: CloudAgentSource; + options: { + autoCreatePr?: boolean; + planApprovalRequired?: boolean; + environment?: Record<string, string>; + }; + result?: CloudAgentResult; + activities: CloudAgentActivity[]; + error?: string; + createdAt: string; + updatedAt: string; + completedAt?: string; +} + +export const CloudAgentSourceSchema = z.object({ + repoName: z.string().min(1), + repoUrl: z.string().url(), + branch: z.string().optional(), +}); + +export const CloudAgentResultSchema = z.object({ + prUrl: z.string().url().optional(), + prNumber: z.number().int().positive().optional(), + commitMessage: z.string().optional(), + diffUrl: z.string().url().optional(), + summary: z.string().optional(), + duration: z.number().int().positive().optional(), + cost: z.number().positive().optional(), +}); + +export const CloudAgentActivitySchema = z.object({ + id: z.string(), + type: z.enum(["plan", "command", "code_change", "message", "error", "completion"]), + content: z.string(), + timestamp: z.string().datetime(), + metadata: z.record(z.string(), z.unknown()).optional(), +}); + +export const CloudAgentTaskOptionsSchema = z.object({ + autoCreatePr: z.boolean().optional(), + planApprovalRequired: z.boolean().optional(), + environment: z.record(z.string(), z.string()).optional(), +}); + +export const CreateCloudAgentTaskSchema = z.object({ + providerId: z.enum(["jules", "devin", "codex-cloud"]), + prompt: z.string().min(1).max(10000), + source: CloudAgentSourceSchema, + options: CloudAgentTaskOptionsSchema.optional(), +}); + +export const UpdateCloudAgentTaskSchema = z.object({ + id: z.string().min(1), + action: z.enum(["approve", "reject", "cancel", "message"]), + message: z.string().optional(), +}); + +export type CreateCloudAgentTaskInput = z.infer<typeof CreateCloudAgentTaskSchema>; +export type UpdateCloudAgentTaskInput = z.infer<typeof UpdateCloudAgentTaskSchema>; diff --git a/src/lib/cloudflaredTunnel.ts b/src/lib/cloudflaredTunnel.ts index 8106a585d2..bb8b6044b7 100644 --- a/src/lib/cloudflaredTunnel.ts +++ b/src/lib/cloudflaredTunnel.ts @@ -134,6 +134,7 @@ let tunnelProcess: ReturnType<typeof spawn> | null = null; let tunnelPid: number | null = null; let installPromise: Promise<string> | null = null; let startPromise: Promise<CloudflaredTunnelStatus> | null = null; +let stateFileQueue: Promise<void> = Promise.resolve(); const NON_ACTIONABLE_CLOUDFLARED_WARNING_PATTERNS = [ /failed to sufficiently increase receive buffer size/i, ] as const; @@ -205,14 +206,35 @@ async function readStateFile(): Promise<PersistedTunnelState> { } } -async function writeStateFile(state: PersistedTunnelState) { +async function writeStateFileNow(state: PersistedTunnelState) { await ensureTunnelDir(); await fs.writeFile(getStateFilePath(), JSON.stringify(state, null, 2) + "\n", "utf8"); } +async function withStateFileLock<T>(operation: () => Promise<T>): Promise<T> { + const previous = stateFileQueue; + let release!: () => void; + stateFileQueue = new Promise<void>((resolve) => { + release = resolve; + }); + + await previous; + try { + return await operation(); + } finally { + release(); + } +} + +async function writeStateFile(state: PersistedTunnelState) { + await withStateFileLock(() => writeStateFileNow(state)); +} + async function updateStateFile(patch: PersistedTunnelState) { - const current = await readStateFile(); - await writeStateFile({ ...current, ...patch }); + await withStateFileLock(async () => { + const current = await readStateFile(); + await writeStateFileNow({ ...current, ...patch }); + }); } async function clearPidFile() { diff --git a/src/lib/db/apiKeys.ts b/src/lib/db/apiKeys.ts index 65c33b2427..406fa0d133 100644 --- a/src/lib/db/apiKeys.ts +++ b/src/lib/db/apiKeys.ts @@ -173,6 +173,39 @@ function isConfiguredEnvApiKey(key: string): boolean { return Boolean(envKey && key === envKey); } +function isRedisAuthCacheEnabled(): boolean { + return ( + process.env.OMNIROUTE_DISABLE_REDIS_AUTH_CACHE !== "1" && + process.env.NODE_ENV !== "test" && + process.env.DISABLE_SQLITE_AUTO_BACKUP !== "true" + ); +} + +async function deleteRedisAuthCacheEntry(keyHash: unknown): Promise<void> { + if (!isRedisAuthCacheEnabled() || typeof keyHash !== "string" || keyHash.trim() === "") return; + + try { + const { getRedisClient } = await import("@/shared/utils/rateLimiter"); + const redis = getRedisClient(); + await redis.del(`auth:api_key:${keyHash}`); + } catch { + // Redis is an optimization for auth caching; SQLite remains authoritative. + } +} + +async function deleteRedisAuthCacheEntries(...keyHashes: unknown[]): Promise<void> { + await Promise.all(keyHashes.map((keyHash) => deleteRedisAuthCacheEntry(keyHash))); +} + +async function deleteRedisAuthCacheForKeyId(db: ApiKeysDbLike, id: string): Promise<void> { + if (!isRedisAuthCacheEnabled()) return; + + const row = db + .prepare<{ key_hash: string | null }>("SELECT key_hash FROM api_keys WHERE id = ?") + .get(id); + await deleteRedisAuthCacheEntry(row?.key_hash); +} + function markApiKeyUsed(db: ApiKeysDbLike, id: unknown, now: number): void { if (typeof id !== "string" || id.trim() === "") return; @@ -403,7 +436,7 @@ function parseRateLimits(value: unknown): RateLimitRule[] | null { const parsed = JSON.parse(value); if (!Array.isArray(parsed)) return null; return parsed.filter( - (rule: any) => + (rule: RateLimitRule) => typeof rule === "object" && rule !== null && typeof rule.limit === "number" && @@ -526,15 +559,7 @@ export async function regenerateApiKey(id: string) { // Invalidate all caches clearApiKeyCaches(); - // Redis invalidation - try { - const { getRedisClient } = await import("@/shared/utils/rateLimiter"); - const redis = getRedisClient(); - if (typeof row.key_hash === "string") await redis.del(`auth:api_key:${row.key_hash}`); - await redis.del(`auth:api_key:${newHash}`); - } catch (err) { - // Fail silent - } + await deleteRedisAuthCacheEntries(row.key_hash, newHash); const { logAuditEvent } = await import("@/lib/compliance"); logAuditEvent({ @@ -732,19 +757,7 @@ export async function updateApiKeyPermissions( // Invalidate caches since permissions changed invalidateCaches(); - // Also invalidate Redis if key_hash is available - try { - const row = db.prepare("SELECT key_hash FROM api_keys WHERE id = ?").get(id) as - | { key_hash: string | null } - | undefined; - if (row?.key_hash) { - const { getRedisClient } = await import("@/shared/utils/rateLimiter"); - const redis = getRedisClient(); - await redis.del(`auth:api_key:${row.key_hash}`); - } - } catch (err) { - // Fail silent - } + await deleteRedisAuthCacheForKeyId(db, id); backupDbFile("pre-write"); return true; @@ -753,6 +766,7 @@ export async function updateApiKeyPermissions( export async function deleteApiKey(id: string) { const db = getDbInstance() as ApiKeysDbLike; const stmt = getPreparedStatements(db); + const row = stmt.getKeyById.get(id) as ApiKeyRow | undefined; const result = stmt.deleteKey.run(id); if (result.changes === 0) return false; @@ -763,6 +777,7 @@ export async function deleteApiKey(id: string) { // Invalidate caches since a key was removed invalidateCaches(); + await deleteRedisAuthCacheEntry(row?.key_hash); backupDbFile("pre-write"); return true; @@ -786,6 +801,7 @@ export async function revokeApiKey(id: string): Promise<boolean> { if ((result.changes ?? 0) === 0) return false; invalidateCaches(); + await deleteRedisAuthCacheForKeyId(db, id); backupDbFile("pre-write"); return true; } @@ -804,6 +820,7 @@ export async function setApiKeyExpiry(id: string, expiresAt: string | null): Pro if ((result.changes ?? 0) === 0) return false; invalidateCaches(); + await deleteRedisAuthCacheForKeyId(db, id); backupDbFile("pre-write"); return true; } @@ -836,29 +853,31 @@ export async function validateApiKey(key: string | null | undefined) { return cached.valid; } - // Try Redis cache for multi-instance consistency - try { - const { getRedisClient } = await import("@/shared/utils/rateLimiter"); - const redis = getRedisClient(); - const redisKey = `auth:api_key:${hashedKey}`; - const redisData = await redis.get(redisKey); - if (redisData) { - const data = JSON.parse(redisData); - const isBanned = !!data.isBanned; - const isActive = !!data.isActive; - const revokedAt = data.revokedAt; - const expiresAt = data.expiresAt; + if (isRedisAuthCacheEnabled()) { + // Try Redis cache for multi-instance consistency + try { + const { getRedisClient } = await import("@/shared/utils/rateLimiter"); + const redis = getRedisClient(); + const redisKey = `auth:api_key:${hashedKey}`; + const redisData = await redis.get(redisKey); + if (redisData) { + const data = JSON.parse(redisData); + const isBanned = !!data.isBanned; + const isActive = !!data.isActive; + const revokedAt = data.revokedAt; + const expiresAt = data.expiresAt; - if (isBanned || !isActive) return false; - if (typeof revokedAt === "string" && revokedAt.trim() !== "") return false; - if (typeof expiresAt === "string" && expiresAt.trim() !== "") { - const expiresMs = Date.parse(expiresAt); - if (Number.isFinite(expiresMs) && expiresMs <= now) return false; + if (isBanned || !isActive) return false; + if (typeof revokedAt === "string" && revokedAt.trim() !== "") return false; + if (typeof expiresAt === "string" && expiresAt.trim() !== "") { + const expiresMs = Date.parse(expiresAt); + if (Number.isFinite(expiresMs) && expiresMs <= now) return false; + } + return true; } - return true; + } catch { + // Redis lookup failures fall through to SQLite. } - } catch (err) { - // Fail silent for Redis lookup } const db = getDbInstance() as ApiKeysDbLike; @@ -885,25 +904,27 @@ export async function validateApiKey(key: string | null | undefined) { evictIfNeeded(_keyValidationCache); _keyValidationCache.set(cacheKey, { valid: true, timestamp: now }); - // Update Redis cache for fast validation - try { - const { getRedisClient } = await import("@/shared/utils/rateLimiter"); - const redis = getRedisClient(); - const redisKey = `auth:api_key:${hashedKey}`; - await redis.set( - redisKey, - JSON.stringify({ - id: row.id, - isBanned: parseIsBanned(row.is_banned), - isActive: parseIsActive(row.is_active), - expiresAt: row.expires_at, - revokedAt: row.revoked_at, - }), - "EX", - 3600 // 1 hour cache - ); - } catch (err) { - // Fail silent for Redis cache update + if (isRedisAuthCacheEnabled()) { + // Update Redis cache for fast validation + try { + const { getRedisClient } = await import("@/shared/utils/rateLimiter"); + const redis = getRedisClient(); + const redisKey = `auth:api_key:${hashedKey}`; + await redis.set( + redisKey, + JSON.stringify({ + id: row.id, + isBanned: parseIsBanned(row.is_banned), + isActive: parseIsActive(row.is_active), + expiresAt: row.expires_at, + revokedAt: row.revoked_at, + }), + "EX", + 3600 // 1 hour cache + ); + } catch { + // Redis cache update failures do not block successful SQLite validation. + } } markApiKeyUsed(db, row.id, now); diff --git a/src/lib/db/commandCodeAuth.ts b/src/lib/db/commandCodeAuth.ts new file mode 100644 index 0000000000..33961fdc33 --- /dev/null +++ b/src/lib/db/commandCodeAuth.ts @@ -0,0 +1,213 @@ +import { createHash, randomUUID } from "crypto"; + +import { getDbInstance, rowToCamel } from "./core"; +import { decrypt, encrypt } from "./encryption"; + +export type CommandCodeAuthStatus = "pending" | "received" | "applied" | "expired"; + +export interface CommandCodeAuthMetadata { + userId?: string; + userName?: string; + keyName?: string; + receivedAt?: string; +} + +export interface CommandCodeAuthSafeStatus { + id: string; + stateHash: string; + status: CommandCodeAuthStatus; + metadata: CommandCodeAuthMetadata | null; + createdAt: string; + expiresAt: string; + receivedAt: string | null; + appliedAt: string | null; + updatedAt: string; +} + +export interface ConsumedCommandCodeAuthSecret extends CommandCodeAuthSafeStatus { + apiKey: string; +} + +type DbRunResult = { changes?: number }; +type DbStatement<TRow = unknown> = { + get: (...params: unknown[]) => TRow | undefined; + all: (...params: unknown[]) => TRow[]; + run: (...params: unknown[]) => DbRunResult; +}; +type DbLike = { + prepare: <TRow = unknown>(sql: string) => DbStatement<TRow>; + transaction: <T extends (...args: unknown[]) => unknown>(fn: T) => T; +}; + +type AuthSessionRow = { + id: string; + state_hash: string; + status: CommandCodeAuthStatus; + encrypted_api_key?: string | null; + metadata_json?: string | null; + created_at: string; + expires_at: string; + received_at?: string | null; + applied_at?: string | null; + updated_at: string; +}; + +function db(): DbLike { + return getDbInstance() as unknown as DbLike; +} + +export function hashCommandCodeAuthState(state: string): string { + return createHash("sha256").update(state, "utf8").digest("hex"); +} + +function nowIso(): string { + return new Date().toISOString(); +} + +function parseMetadata(value: string | null | undefined): CommandCodeAuthMetadata | null { + if (!value) return null; + try { + const parsed = JSON.parse(value) as CommandCodeAuthMetadata; + return parsed && typeof parsed === "object" ? parsed : null; + } catch { + return null; + } +} + +function toSafeStatus(row: AuthSessionRow): CommandCodeAuthSafeStatus { + const camel = rowToCamel(row) as Record<string, unknown>; + return { + id: String(camel.id), + stateHash: String(camel.stateHash), + status: camel.status as CommandCodeAuthStatus, + metadata: parseMetadata(camel.metadataJson as string | null | undefined), + createdAt: String(camel.createdAt), + expiresAt: String(camel.expiresAt), + receivedAt: (camel.receivedAt as string | null | undefined) ?? null, + appliedAt: (camel.appliedAt as string | null | undefined) ?? null, + updatedAt: String(camel.updatedAt), + }; +} + +function markExpiredForState(stateHash: string, now = nowIso()): void { + db() + .prepare( + `UPDATE command_code_auth_sessions + SET status = 'expired', updated_at = ? + WHERE state_hash = ? AND status IN ('pending', 'received') AND expires_at <= ?` + ) + .run(now, stateHash, now); +} + +export function createPendingCommandCodeAuthSession(input: { + stateHash: string; + expiresAt: string; +}): CommandCodeAuthSafeStatus { + const id = randomUUID(); + const now = nowIso(); + db() + .prepare( + `INSERT INTO command_code_auth_sessions ( + id, state_hash, status, encrypted_api_key, metadata_json, + created_at, expires_at, received_at, applied_at, updated_at + ) VALUES (?, ?, 'pending', NULL, NULL, ?, ?, NULL, NULL, ?)` + ) + .run(id, input.stateHash, now, input.expiresAt, now); + + const row = db() + .prepare<AuthSessionRow>("SELECT * FROM command_code_auth_sessions WHERE id = ?") + .get(id); + if (!row) throw new Error("Failed to create Command Code auth session"); + return toSafeStatus(row); +} + +export function markCommandCodeAuthSessionReceived(input: { + stateHash: string; + apiKey: string; + metadata?: CommandCodeAuthMetadata; +}): CommandCodeAuthSafeStatus | null { + const now = nowIso(); + markExpiredForState(input.stateHash, now); + const metadata: CommandCodeAuthMetadata = { + ...(input.metadata || {}), + receivedAt: now, + }; + const encryptedApiKey = encrypt(input.apiKey); + db() + .prepare( + `UPDATE command_code_auth_sessions + SET status = 'received', encrypted_api_key = ?, metadata_json = ?, received_at = ?, updated_at = ? + WHERE state_hash = ? AND status IN ('pending', 'received') AND expires_at > ?` + ) + .run(encryptedApiKey, JSON.stringify(metadata), now, now, input.stateHash, now); + + return getCommandCodeAuthSessionSafeStatus(input.stateHash); +} + +export function getCommandCodeAuthSessionSafeStatus( + stateHash: string +): CommandCodeAuthSafeStatus | null { + markExpiredForState(stateHash); + const row = db() + .prepare<AuthSessionRow>("SELECT * FROM command_code_auth_sessions WHERE state_hash = ?") + .get(stateHash); + return row ? toSafeStatus(row) : null; +} + +export function consumeCommandCodeAuthSecret( + stateHash: string +): ConsumedCommandCodeAuthSecret | null { + const database = db(); + return database.transaction(() => { + const now = nowIso(); + database + .prepare( + `UPDATE command_code_auth_sessions + SET status = 'expired', updated_at = ? + WHERE state_hash = ? AND status IN ('pending', 'received') AND expires_at <= ?` + ) + .run(now, stateHash, now); + + const row = database + .prepare<AuthSessionRow>( + `SELECT * FROM command_code_auth_sessions + WHERE state_hash = ? AND status = 'received' AND expires_at > ? AND encrypted_api_key IS NOT NULL` + ) + .get(stateHash, now); + if (!row?.encrypted_api_key) return null; + + const apiKey = decrypt(row.encrypted_api_key); + if (!apiKey) return null; + + const result = database + .prepare( + `UPDATE command_code_auth_sessions + SET status = 'applied', encrypted_api_key = NULL, applied_at = ?, updated_at = ? + WHERE id = ? AND status = 'received'` + ) + .run(now, now, row.id); + if (!result.changes) return null; + + return { + ...toSafeStatus({ + ...row, + status: "applied", + encrypted_api_key: null, + applied_at: now, + updated_at: now, + }), + apiKey, + }; + })() as ConsumedCommandCodeAuthSecret | null; +} + +export function cleanupExpiredCommandCodeAuthSessions(now = nowIso()): number { + const result = db() + .prepare( + `UPDATE command_code_auth_sessions + SET status = 'expired', updated_at = ? + WHERE status IN ('pending', 'received') AND expires_at <= ?` + ) + .run(now, now); + return result.changes ?? 0; +} diff --git a/src/lib/db/domainState.ts b/src/lib/db/domainState.ts index 4f0e9edb32..093355a28e 100644 --- a/src/lib/db/domainState.ts +++ b/src/lib/db/domainState.ts @@ -38,6 +38,24 @@ interface BudgetResetLogRecord { periodEnd: number; } +interface FallbackChainEntry { + provider: string; + priority: number; + enabled: boolean; +} + +interface LockoutStateRecord { + attempts: number[]; + lockedUntil: number | null; +} + +interface CircuitBreakerStateRecord { + state: string; + failureCount: number; + lastFailureTime: number | null; + options?: JsonRecord | null; +} + let _budgetSchemaChecked = false; function asRecord(value: unknown): JsonRecord { @@ -114,7 +132,7 @@ function ensureBudgetSchema() { * @param {string} model * @param {Array<{provider: string, priority: number, enabled: boolean}>} chain */ -export function saveFallbackChain(model, chain) { +export function saveFallbackChain(model: string, chain: FallbackChainEntry[]) { const db = getDbInstance(); db.prepare("INSERT OR REPLACE INTO domain_fallback_chains (model, chain) VALUES (?, ?)").run( model, @@ -127,7 +145,7 @@ export function saveFallbackChain(model, chain) { * @param {string} model * @returns {Array<{provider: string, priority: number, enabled: boolean}> | null} */ -export function loadFallbackChain(model) { +export function loadFallbackChain(model: string): FallbackChainEntry[] | null { const db = getDbInstance(); const row = db.prepare("SELECT chain FROM domain_fallback_chains WHERE model = ?").get(model); const chain = asRecord(row).chain; @@ -157,7 +175,7 @@ export function loadAllFallbackChains() { * @param {string} model * @returns {boolean} */ -export function deleteFallbackChain(model) { +export function deleteFallbackChain(model: string) { const db = getDbInstance(); const info = db.prepare("DELETE FROM domain_fallback_chains WHERE model = ?").run(model); return info.changes > 0; @@ -178,7 +196,7 @@ export function deleteAllFallbackChains() { * @param {string} apiKeyId * @param {{ dailyLimitUsd: number, monthlyLimitUsd?: number, warningThreshold?: number }} config */ -export function saveBudget(apiKeyId, config) { +export function saveBudget(apiKeyId: string, config: Partial<BudgetConfigRecord>) { ensureBudgetSchema(); const db = getDbInstance(); db.prepare( @@ -216,7 +234,7 @@ export function saveBudget(apiKeyId, config) { * @param {string} apiKeyId * @returns {{ dailyLimitUsd: number, monthlyLimitUsd: number, warningThreshold: number } | null} */ -export function loadBudget(apiKeyId) { +export function loadBudget(apiKeyId: string): BudgetConfigRecord | null { ensureBudgetSchema(); const db = getDbInstance(); const row = db.prepare("SELECT * FROM domain_budgets WHERE api_key_id = ?").get(apiKeyId); @@ -228,7 +246,9 @@ export function loadBudget(apiKeyId) { monthlyLimitUsd: toNumber(record.monthly_limit_usd), warningThreshold: toNumber(record.warning_threshold, 0.8), resetInterval: - typeof record.reset_interval === "string" ? record.reset_interval : ("daily" as const), + typeof record.reset_interval === "string" + ? (record.reset_interval as BudgetResetInterval) + : "daily", resetTime: typeof record.reset_time === "string" ? record.reset_time : "00:00", budgetResetAt: toNumber(record.budget_reset_at, 0) || null, lastBudgetResetAt: toNumber(record.last_budget_reset_at, 0) || null, @@ -335,7 +355,7 @@ export function loadBudgetResetLogs(apiKeyId: string, limit = 10) { * Delete a budget config. * @param {string} apiKeyId */ -export function deleteBudget(apiKeyId) { +export function deleteBudget(apiKeyId: string) { ensureBudgetSchema(); const db = getDbInstance(); db.prepare("DELETE FROM domain_budgets WHERE api_key_id = ?").run(apiKeyId); @@ -350,7 +370,7 @@ export function deleteBudget(apiKeyId) { * @param {number} cost * @param {number} [timestamp] */ -export function saveCostEntry(apiKeyId, cost, timestamp = Date.now()) { +export function saveCostEntry(apiKeyId: string, cost: number, timestamp = Date.now()) { ensureBudgetSchema(); const db = getDbInstance(); db.prepare("INSERT INTO domain_cost_history (api_key_id, cost, timestamp) VALUES (?, ?, ?)").run( @@ -437,7 +457,7 @@ export function loadCostEntriesInRange( * @param {number} olderThanTimestamp * @returns {number} deleted count */ -export function cleanOldCostEntries(olderThanTimestamp) { +export function cleanOldCostEntries(olderThanTimestamp: number) { ensureBudgetSchema(); const db = getDbInstance(); const info = db @@ -450,7 +470,7 @@ export function cleanOldCostEntries(olderThanTimestamp) { * Delete all cost data for an API key. * @param {string} apiKeyId */ -export function deleteCostEntries(apiKeyId) { +export function deleteCostEntries(apiKeyId: string) { ensureBudgetSchema(); const db = getDbInstance(); db.prepare("DELETE FROM domain_cost_history WHERE api_key_id = ?").run(apiKeyId); @@ -474,7 +494,7 @@ export function deleteAllCostData() { * @param {string} identifier * @param {{ attempts: number[], lockedUntil: number|null }} state */ -export function saveLockoutState(identifier, state) { +export function saveLockoutState(identifier: string, state: LockoutStateRecord) { const db = getDbInstance(); db.prepare( `INSERT OR REPLACE INTO domain_lockout_state (identifier, attempts, locked_until) @@ -487,7 +507,7 @@ export function saveLockoutState(identifier, state) { * @param {string} identifier * @returns {{ attempts: number[], lockedUntil: number|null } | null} */ -export function loadLockoutState(identifier) { +export function loadLockoutState(identifier: string): LockoutStateRecord | null { const db = getDbInstance(); const row = db.prepare("SELECT * FROM domain_lockout_state WHERE identifier = ?").get(identifier); if (!row) return null; @@ -504,7 +524,7 @@ export function loadLockoutState(identifier) { * Delete lockout state for an identifier. * @param {string} identifier */ -export function deleteLockoutState(identifier) { +export function deleteLockoutState(identifier: string) { const db = getDbInstance(); db.prepare("DELETE FROM domain_lockout_state WHERE identifier = ?").run(identifier); } @@ -538,7 +558,7 @@ export function loadAllLockedIdentifiers() { * @param {string} name * @param {{ state: string, failureCount: number, lastFailureTime: number|null, options?: object }} cbState */ -export function saveCircuitBreakerState(name, cbState) { +export function saveCircuitBreakerState(name: string, cbState: CircuitBreakerStateRecord) { const db = getDbInstance(); db.prepare( `INSERT OR REPLACE INTO domain_circuit_breakers (name, state, failure_count, last_failure_time, options) @@ -557,7 +577,7 @@ export function saveCircuitBreakerState(name, cbState) { * @param {string} name * @returns {{ state: string, failureCount: number, lastFailureTime: number|null, options?: object } | null} */ -export function loadCircuitBreakerState(name) { +export function loadCircuitBreakerState(name: string): CircuitBreakerStateRecord | null { const db = getDbInstance(); const row = db.prepare("SELECT * FROM domain_circuit_breakers WHERE name = ?").get(name); if (!row) return null; @@ -596,7 +616,7 @@ export function loadAllCircuitBreakerStates() { * Delete a circuit breaker state. * @param {string} name */ -export function deleteCircuitBreakerState(name) { +export function deleteCircuitBreakerState(name: string) { const db = getDbInstance(); db.prepare("DELETE FROM domain_circuit_breakers WHERE name = ?").run(name); } diff --git a/src/lib/db/migrationRunner.ts b/src/lib/db/migrationRunner.ts index bfc32b5e63..d53c66e9a9 100644 --- a/src/lib/db/migrationRunner.ts +++ b/src/lib/db/migrationRunner.ts @@ -133,6 +133,12 @@ const RENAMED_MIGRATION_COMPATIBILITY = [ toVersion: "039", toName: "compression_cache_stats", }, + { + fromVersion: "041", + fromName: "session_account_affinity", + toVersion: "050", + toName: "session_account_affinity", + }, ] as const; const LEGACY_VERSION_SLOT_MIGRATIONS = [ @@ -144,6 +150,15 @@ const LEGACY_VERSION_SLOT_MIGRATIONS = [ { version: "033", name: "provider_connections_block_extra_usage" }, ] as const; +const SUPERSEDED_DUPLICATE_MIGRATIONS = [ + { + version: "041", + name: "session_account_affinity", + supersededByVersion: "050", + supersededByName: "session_account_affinity", + }, +] as const; + const PHYSICAL_SCHEMA_SENTINELS = [ { version: "028", tableName: "batches", description: "batches table" }, { version: "024", tableName: "sync_tokens", description: "sync_tokens table" }, @@ -198,6 +213,34 @@ function getMigrationFiles(): Array<{ version: string; name: string; path: strin .filter(Boolean) as Array<{ version: string; name: string; path: string }>; } +function filterSupersededDuplicateMigrations( + files: Array<{ version: string; name: string; path: string }> +): Array<{ version: string; name: string; path: string }> { + return files.filter((file) => { + const superseded = SUPERSEDED_DUPLICATE_MIGRATIONS.find( + (migration) => migration.version === file.version && migration.name === file.name + ); + if (!superseded) { + return true; + } + + const hasReplacement = files.some( + (candidate) => + candidate.version === superseded.supersededByVersion && + candidate.name === superseded.supersededByName + ); + if (!hasReplacement) { + return true; + } + + console.warn( + `[Migration] Ignoring superseded duplicate migration ${file.version}_${file.name}; ` + + `${superseded.supersededByVersion}_${superseded.supersededByName} is the canonical slot.` + ); + return false; + }); +} + /** * Get list of already-applied migration versions. */ @@ -286,6 +329,9 @@ function isSchemaAlreadyApplied( case "040": return hasColumn(db, "proxy_registry", "source"); case "041": + if (migration.name === "session_account_affinity") { + return hasTable(db, "session_account_affinity"); + } return ( hasColumn(db, "compression_analytics", "actual_prompt_tokens") && hasColumn(db, "compression_analytics", "actual_completion_tokens") && @@ -667,7 +713,7 @@ export function runMigrations(db: Database.Database, options?: { isNewDb?: boole const isNewDb = options?.isNewDb === true; ensureMigrationsTable(db); - const files = getMigrationFiles(); + const files = filterSupersededDuplicateMigrations(getMigrationFiles()); rehomeLegacyVersionSlotMigrations(db, files); reconcileRenumberedMigrations(db, files); const applied = getAppliedVersions(db); @@ -779,7 +825,7 @@ export function runMigrations(db: Database.Database, options?: { isNewDb?: boole ); } else if (migration.version === "032") { applyApiKeyLifecycleMigration(db); - } else if (migration.version === "041") { + } else if (migration.version === "041" && migration.name === "compression_receipts") { applyCompressionReceiptsMigration(db); } else if (migration.version === "042") { applyCompressionCombosMigration(db, migration.path); diff --git a/src/lib/db/migrations/041_session_account_affinity.sql b/src/lib/db/migrations/041_session_account_affinity.sql new file mode 100644 index 0000000000..5a93707fb3 --- /dev/null +++ b/src/lib/db/migrations/041_session_account_affinity.sql @@ -0,0 +1,11 @@ +CREATE TABLE IF NOT EXISTS session_account_affinity ( + session_key TEXT NOT NULL, + provider TEXT NOT NULL, + connection_id TEXT NOT NULL, + created_at INTEGER NOT NULL, + last_seen_at INTEGER NOT NULL, + PRIMARY KEY (session_key, provider) +); + +CREATE INDEX IF NOT EXISTS idx_saa_provider ON session_account_affinity(provider); +CREATE INDEX IF NOT EXISTS idx_saa_last_seen ON session_account_affinity(last_seen_at); diff --git a/src/lib/db/migrations/055_command_code_auth_sessions.sql b/src/lib/db/migrations/055_command_code_auth_sessions.sql new file mode 100644 index 0000000000..f1e927443f --- /dev/null +++ b/src/lib/db/migrations/055_command_code_auth_sessions.sql @@ -0,0 +1,19 @@ +-- Migration 055: Pending browser-assisted Command Code auth sessions +CREATE TABLE IF NOT EXISTS command_code_auth_sessions ( + id TEXT PRIMARY KEY, + state_hash TEXT NOT NULL UNIQUE, + status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'received', 'applied', 'expired')), + encrypted_api_key TEXT, + metadata_json TEXT, + created_at TEXT NOT NULL, + expires_at TEXT NOT NULL, + received_at TEXT, + applied_at TEXT, + updated_at TEXT NOT NULL +); + +CREATE INDEX IF NOT EXISTS idx_command_code_auth_sessions_state_hash + ON command_code_auth_sessions(state_hash); + +CREATE INDEX IF NOT EXISTS idx_command_code_auth_sessions_status_expires + ON command_code_auth_sessions(status, expires_at); diff --git a/src/lib/db/providers.ts b/src/lib/db/providers.ts index f87953903a..9a023f40e2 100644 --- a/src/lib/db/providers.ts +++ b/src/lib/db/providers.ts @@ -442,9 +442,9 @@ export async function deleteProviderConnections(ids: string[]): Promise<number> const deletedCount = db.transaction(() => { const placeholders = ids.map(() => "?").join(","); db.prepare(`DELETE FROM quota_snapshots WHERE connection_id IN (${placeholders})`).run(...ids); - const result = db.prepare( - `DELETE FROM provider_connections WHERE id IN (${placeholders})` - ).run(...ids); + const result = db + .prepare(`DELETE FROM provider_connections WHERE id IN (${placeholders})`) + .run(...ids); return result.changes ?? 0; })(); diff --git a/src/lib/db/sessionAccountAffinity.ts b/src/lib/db/sessionAccountAffinity.ts index 80ba0a729d..dc63011a11 100644 --- a/src/lib/db/sessionAccountAffinity.ts +++ b/src/lib/db/sessionAccountAffinity.ts @@ -1,7 +1,49 @@ -// Stubbed functions for session account affinity (PR 1887 pending) +import { getDbInstance } from "./core"; -export function getSessionAccountAffinity(sessionKey: string, provider: string): any { - return null; +export interface SessionAccountAffinity { + sessionKey: string; + provider: string; + connectionId: string; + createdAt: number; + lastSeenAt: number; +} + +interface SessionAccountAffinityRow { + session_key: string; + provider: string; + connection_id: string; + created_at: number; + last_seen_at: number; +} + +const DEFAULT_TTL_MS = 30 * 60 * 1000; +const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; + +let cleanupTimer: NodeJS.Timeout | null = null; + +function rowToAffinity(row: SessionAccountAffinityRow): SessionAccountAffinity { + return { + sessionKey: row.session_key, + provider: row.provider, + connectionId: row.connection_id, + createdAt: row.created_at, + lastSeenAt: row.last_seen_at, + }; +} + +export function getSessionAccountAffinity( + sessionKey: string, + provider: string +): SessionAccountAffinity | null { + const db = getDbInstance(); + const row = db + .prepare( + `SELECT session_key, provider, connection_id, created_at, last_seen_at + FROM session_account_affinity + WHERE session_key = ? AND provider = ?` + ) + .get(sessionKey, provider) as SessionAccountAffinityRow | undefined; + return row ? rowToAffinity(row) : null; } export function upsertSessionAccountAffinity( @@ -9,23 +51,72 @@ export function upsertSessionAccountAffinity( provider: string, connectionId: string, now: number = Date.now() -): void {} +): void { + const db = getDbInstance(); + db.prepare( + `INSERT INTO session_account_affinity + (session_key, provider, connection_id, created_at, last_seen_at) + VALUES (?, ?, ?, ?, ?) + ON CONFLICT(session_key, provider) DO UPDATE SET + connection_id = excluded.connection_id, + last_seen_at = excluded.last_seen_at` + ).run(sessionKey, provider, connectionId, now, now); +} export function touchSessionAccountAffinity( sessionKey: string, provider: string, now: number = Date.now() -): void {} - -export function deleteSessionAccountAffinity(sessionKey: string, provider: string): void {} - -export function cleanupStaleSessionAccountAffinities( - ttlMs: number = 30 * 60 * 1000, - now: number = Date.now() -): number { - return 0; +): void { + const db = getDbInstance(); + db.prepare( + `UPDATE session_account_affinity + SET last_seen_at = ? + WHERE session_key = ? AND provider = ?` + ).run(now, sessionKey, provider); } -export function startSessionAccountAffinityCleanup(): void {} +export function deleteSessionAccountAffinity(sessionKey: string, provider: string): void { + const db = getDbInstance(); + db.prepare("DELETE FROM session_account_affinity WHERE session_key = ? AND provider = ?").run( + sessionKey, + provider + ); +} -export function stopSessionAccountAffinityCleanupForTests(): void {} +export function cleanupStaleSessionAccountAffinities( + ttlMs: number = DEFAULT_TTL_MS, + now: number = Date.now() +): number { + const db = getDbInstance(); + const cutoff = now - ttlMs; + const result = db + .prepare("DELETE FROM session_account_affinity WHERE last_seen_at < ?") + .run(cutoff); + return Number(result.changes || 0); +} + +export function startSessionAccountAffinityCleanup(): void { + if (cleanupTimer) return; + + try { + cleanupStaleSessionAccountAffinities(); + } catch (error) { + console.warn("[SESSION_AFFINITY] Startup cleanup failed:", error); + } + + cleanupTimer = setInterval(() => { + try { + cleanupStaleSessionAccountAffinities(); + } catch (error) { + console.warn("[SESSION_AFFINITY] Periodic cleanup failed:", error); + } + }, CLEANUP_INTERVAL_MS); + cleanupTimer.unref?.(); +} + +export function stopSessionAccountAffinityCleanupForTests(): void { + if (!cleanupTimer) return; + clearInterval(cleanupTimer); + cleanupTimer = null; +} diff --git a/src/lib/db/settings.ts b/src/lib/db/settings.ts index 3c17d7d9bc..7ac957d04a 100644 --- a/src/lib/db/settings.ts +++ b/src/lib/db/settings.ts @@ -271,24 +271,54 @@ export async function getPricingWithSources(): Promise<{ export async function getPricingForModel(provider: string, model: string) { const pricing = await getPricing(); - if (pricing[provider]?.[model]) return pricing[provider][model]; - const { PROVIDER_ID_TO_ALIAS } = await import("@omniroute/open-sse/config/providerModels"); - // Check if provider is an ID -> map to ALIAS - const alias = PROVIDER_ID_TO_ALIAS[provider]; - if (alias && pricing[alias]) return pricing[alias][model] || null; + const findKeyInsensitive = <T>( + obj: Record<string, T> | undefined | null, + key: string + ): T | undefined => { + if (!obj || !key) return undefined; + const lowerKey = key.toLowerCase(); + for (const [k, v] of Object.entries(obj)) { + if (k.toLowerCase() === lowerKey) return v; + } + return undefined; + }; - // Check if provider is an ALIAS -> map to ID (search values) - for (const [id, mappedAlias] of Object.entries(PROVIDER_ID_TO_ALIAS)) { - if (mappedAlias === provider && pricing[id]?.[model]) { - return pricing[id][model]; + const pLower = (provider || "").toLowerCase(); + let providerPricing = findKeyInsensitive<PricingModels>(pricing, pLower); + + if (!providerPricing) { + const alias = findKeyInsensitive<string>(PROVIDER_ID_TO_ALIAS, pLower); + if (alias) providerPricing = findKeyInsensitive(pricing, alias); + } + + if (!providerPricing) { + for (const [id, mappedAlias] of Object.entries(PROVIDER_ID_TO_ALIAS)) { + if (typeof mappedAlias === "string" && mappedAlias.toLowerCase() === pLower) { + providerPricing = findKeyInsensitive(pricing, id); + if (providerPricing) break; + } } } - const np = provider?.replace(/-cn$/, ""); - if (np && np !== provider && pricing[np]) return pricing[np][model] || null; + if (!providerPricing) { + const np = pLower.replace(/-cn$/, ""); + if (np && np !== pLower) { + providerPricing = findKeyInsensitive(pricing, np); + } + } - return null; + if (!providerPricing) return null; + + const mLower = (model || "").toLowerCase(); + let modelPricing = findKeyInsensitive<JsonRecord>(providerPricing, mLower); + + if (!modelPricing) { + const hyphenModel = mLower.replace(/\./g, "-"); + modelPricing = findKeyInsensitive(providerPricing, hyphenModel); + } + + return modelPricing || null; } export async function updatePricing(pricingData: PricingByProvider) { diff --git a/src/lib/embeddings/service.ts b/src/lib/embeddings/service.ts index a3c5443687..41d8a0f1c6 100644 --- a/src/lib/embeddings/service.ts +++ b/src/lib/embeddings/service.ts @@ -15,7 +15,7 @@ import { getProviderNodes } from "@/lib/localDb"; type ValidatedEmbeddingBody = Record<string, unknown> & { model: string }; -interface EmbeddingHandlerOptions { +export interface EmbeddingHandlerOptions { clientRawRequest?: { endpoint: string; body: Record<string, unknown>; diff --git a/src/lib/localDb.ts b/src/lib/localDb.ts index efe96f3199..f3af94bc83 100755 --- a/src/lib/localDb.ts +++ b/src/lib/localDb.ts @@ -372,3 +372,13 @@ export { } from "./db/oneproxy"; export type { OneproxyProxyRecord, OneproxyStats } from "./db/oneproxy"; + +export { + getSessionAccountAffinity, + upsertSessionAccountAffinity, + touchSessionAccountAffinity, + deleteSessionAccountAffinity, + cleanupStaleSessionAccountAffinities, + startSessionAccountAffinityCleanup, + stopSessionAccountAffinityCleanupForTests, +} from "./db/sessionAccountAffinity"; diff --git a/src/lib/logEnv.ts b/src/lib/logEnv.ts index f10d318034..f210cd0b11 100644 --- a/src/lib/logEnv.ts +++ b/src/lib/logEnv.ts @@ -16,6 +16,12 @@ function parsePositiveInt(value: string | undefined, fallback: number): number { return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback; } +function parseNonNegativeInt(value: string | undefined, fallback: number): number { + if (value === undefined || value === "") return fallback; + const parsed = Number.parseInt(value, 10); + return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback; +} + function parseBoolean(value: string | undefined, fallback: boolean): boolean { if (!value) return fallback; const normalized = value.trim().toLowerCase(); @@ -101,3 +107,26 @@ export function getAppLogLevel(defaultLevel: string): string { export function getAppLogFormat(defaultFormat: string): string { return process.env.APP_LOG_FORMAT || defaultFormat; } + +// ─── Chat log truncation limits ───────────────────────────────────────────── + +export function getChatLogTextLimit(): number { + return parsePositiveInt(process.env.CHAT_LOG_TEXT_LIMIT, 64 * 1024); +} + +export function getChatLogArrayTailItems(): number { + return parsePositiveInt(process.env.CHAT_LOG_ARRAY_TAIL_ITEMS, 24); +} + +export function getChatLogMaxDepth(): number { + return parsePositiveInt(process.env.CHAT_LOG_MAX_DEPTH, 6); +} + +export function getChatLogMaxObjectKeys(): number { + return parseNonNegativeInt(process.env.CHAT_LOG_MAX_OBJECT_KEYS, 80); +} + +export function isChatDebugFileEnabled(): boolean { + if (parseBoolean(process.env.CHAT_DEBUG_FILE, false)) return true; + return process.env.APP_LOG_LEVEL?.trim().toLowerCase() === "debug"; +} diff --git a/src/lib/modelCapabilities.ts b/src/lib/modelCapabilities.ts index 90612b19f0..07fec2152e 100644 --- a/src/lib/modelCapabilities.ts +++ b/src/lib/modelCapabilities.ts @@ -218,18 +218,20 @@ export function getResolvedModelCapabilities(input: CapabilityInput): ResolvedMo ? `${resolved.provider}/${resolved.model}` : resolved.model || resolved.rawModel || resolved.lookupKey ) || ""; + const reasoningDenied = !heuristicReasoning(lookupKey); const supportsTools = synced?.tool_call ?? (typeof registryModel?.toolCalling === "boolean" ? registryModel.toolCalling : null) ?? (typeof spec?.supportsTools === "boolean" ? spec.supportsTools : null); - const supportsThinking = - synced?.reasoning ?? - (typeof registryModel?.supportsReasoning === "boolean" - ? registryModel.supportsReasoning - : null) ?? - (typeof spec?.supportsThinking === "boolean" ? spec.supportsThinking : null); + const supportsThinking = reasoningDenied + ? false + : (synced?.reasoning ?? + (typeof registryModel?.supportsReasoning === "boolean" + ? registryModel.supportsReasoning + : null) ?? + (typeof spec?.supportsThinking === "boolean" ? spec.supportsThinking : null)); const contextWindow = synced?.limit_context ?? diff --git a/src/lib/oauth/constants/oauth.ts b/src/lib/oauth/constants/oauth.ts index 6a32388d20..7223690b09 100644 --- a/src/lib/oauth/constants/oauth.ts +++ b/src/lib/oauth/constants/oauth.ts @@ -16,7 +16,7 @@ import { buildGitLabOAuthEndpoints, GITLAB_DUO_DEFAULT_BASE_URL } from "../gitla * * All credentials are read exclusively from environment variables. * Default values match the public CLI client IDs from .env.example - * (auto-populated by scripts/sync-env.mjs on install). + * (auto-populated by scripts/dev/sync-env.mjs on install). * * These are public OAuth client credentials for desktop/CLI applications * that rely on PKCE for security (RFC 8252), not on secret confidentiality. @@ -264,6 +264,44 @@ export const CURSOR_CONFIG = { }, }; +// Windsurf / Devin CLI Configuration +// +// Authentication uses PKCE Authorization Code Flow — same pattern as Codex CLI. +// Extracted from Devin CLI binary (model_configs_v2.bin + devin.exe strings): +// +// Authorize URL: https://app.devin.ai/editor/signin +// Params: response_type=code, redirect_uri, code_challenge, code_challenge_method=S256 +// Callback path: /auth/callback (local server on random port 127.0.0.1:0) +// Exchange: POST https://server.codeium.com/<ExchangePKCEAuthorizationCode> +// via Connect JSON protocol (Content-Type: application/json) +// Response field: windsurfApiKey → stored as accessToken / WINDSURF_API_KEY +// +// Fallback: user can also paste a token from windsurf.com/show-auth-token +export const WINDSURF_CONFIG = { + // Browser-based PKCE authorize endpoint (extracted from devin.exe binary) + authorizeUrl: "https://app.devin.ai/editor/signin", + codeChallengeMethod: "S256" as const, + // Local callback server — 0 = OS assigns a free port + callbackPort: 0, + callbackPath: "/auth/callback", + // Token exchange via Windsurf Connect JSON (gRPC-web + JSON) + apiServerUrl: "https://server.codeium.com", + exchangePath: "/exa.seat_management_pb.SeatManagementService/ExchangePKCEAuthorizationCode", + // Inference server URL (gRPC-web requests go here) + inferenceUrl: "https://server.self-serve.windsurf.com", + // Fallback: user visits this page, copies token, pastes it + showAuthTokenUrl: "https://windsurf.com/show-auth-token", + // Token refresh via Firebase Secure Token Service (for short-lived browser-flow tokens). + // Value comes from WINDSURF_FIREBASE_API_KEY env var (set in .env.example). + // Long-lived import tokens never need this — refresh is skipped when key is absent. + firebaseApiKey: process.env.WINDSURF_FIREBASE_API_KEY || "", + firebaseTokenUrl: "https://securetoken.googleapis.com/v1/token", + // IDE identity sent with every gRPC request + ideName: "windsurf", + ideVersion: "3.14.0", + extensionVersion: "3.14.0", +}; + // OAuth timeout (5 minutes) export const OAUTH_TIMEOUT = 300000; @@ -284,4 +322,6 @@ export const PROVIDERS = { CURSOR: "cursor", KILOCODE: "kilocode", CLINE: "cline", + WINDSURF: "windsurf", + DEVIN_CLI: "devin-cli", }; diff --git a/src/lib/oauth/providers/index.ts b/src/lib/oauth/providers/index.ts index 5c13cb3c79..b747eff146 100644 --- a/src/lib/oauth/providers/index.ts +++ b/src/lib/oauth/providers/index.ts @@ -23,6 +23,7 @@ import { kiro } from "./kiro"; import { cursor } from "./cursor"; import { kilocode } from "./kilocode"; import { cline } from "./cline"; +import { windsurf } from "./windsurf"; export const PROVIDERS = { claude, @@ -39,6 +40,9 @@ export const PROVIDERS = { cursor, kilocode, cline, + windsurf, + // devin-cli shares the same token format as windsurf (WINDSURF_API_KEY / devin auth login) + "devin-cli": windsurf, }; export default PROVIDERS; diff --git a/src/lib/oauth/providers/windsurf.ts b/src/lib/oauth/providers/windsurf.ts new file mode 100644 index 0000000000..8990a2a580 --- /dev/null +++ b/src/lib/oauth/providers/windsurf.ts @@ -0,0 +1,121 @@ +import { WINDSURF_CONFIG } from "../constants/oauth"; + +/** + * Windsurf / Devin CLI OAuth Provider + * + * Uses PKCE Authorization Code Flow — same pattern as Codex CLI. + * Extracted from Devin CLI binary (devin.exe string analysis): + * + * 1. OmniRoute starts a local callback server (random port, 127.0.0.1) + * 2. Browser opens: + * https://app.devin.ai/editor/signin + * ?response_type=code + * &redirect_uri=http://127.0.0.1:PORT/auth/callback + * &code_challenge=<S256_CHALLENGE> + * &code_challenge_method=S256 + * 3. User logs in (Google / GitHub / Windsurf Enterprise) + * 4. Browser redirects back to callback server with `code` + * 5. Exchange code via Windsurf Connect JSON: + * POST https://server.codeium.com/exa.seat_management_pb.SeatManagementService/ExchangePKCEAuthorizationCode + * { "code": "...", "codeVerifier": "...", "redirectUri": "..." } + * 6. Response: { "windsurfApiKey": "...", "apiServerUrl": "...", ... } + * 7. `windsurfApiKey` stored as `accessToken` (= WINDSURF_API_KEY) + * + * Fallback (import_token): user visits windsurf.com/show-auth-token, + * copies their API key, and pastes it into the connection form. + */ +export const windsurf = { + config: WINDSURF_CONFIG, + flowType: "authorization_code_pkce", + // Fixed callback path expected by Devin CLI auth flow + callbackPath: WINDSURF_CONFIG.callbackPath, + // Port 0 = OS assigns a free port (we use the globalThis devin callback state) + callbackPort: WINDSURF_CONFIG.callbackPort, + + buildAuthUrl: ( + config: typeof WINDSURF_CONFIG, + redirectUri: string, + state: string, + codeChallenge: string + ) => { + const params = new URLSearchParams({ + response_type: "code", + redirect_uri: redirectUri, + code_challenge: codeChallenge, + code_challenge_method: config.codeChallengeMethod, + state, + }); + return `${config.authorizeUrl}?${params.toString()}`; + }, + + /** + * Exchange authorization code for Windsurf API key. + * Uses the Windsurf Connect JSON protocol (not standard OAuth token endpoint). + */ + exchangeToken: async ( + config: typeof WINDSURF_CONFIG, + code: string, + redirectUri: string, + codeVerifier: string + ) => { + const url = `${config.apiServerUrl}${config.exchangePath}`; + const response = await fetch(url, { + method: "POST", + headers: { + "Content-Type": "application/json", + Accept: "application/json", + // Connect protocol version header + "Connect-Protocol-Version": "1", + }, + body: JSON.stringify({ + code, + codeVerifier, + redirectUri, + }), + }); + + if (!response.ok) { + const error = await response.text(); + throw new Error(`Windsurf token exchange failed (${response.status}): ${error}`); + } + + const data = await response.json(); + return data; + }, + + /** + * Map exchange response to OmniRoute connection fields. + * The Windsurf Connect response uses camelCase JSON: + * windsurfApiKey, apiServerUrl, devinWebappHost, devinApiUrl + */ + mapTokens: (tokens: { + windsurfApiKey?: string; + apiServerUrl?: string; + devinWebappHost?: string; + devinApiUrl?: string; + // Fallback import-token fields + accessToken?: string; + apiKey?: string; + refreshToken?: string; + expiresIn?: number; + email?: string; + authMethod?: string; + }) => { + // PKCE flow: token is in windsurfApiKey + const token = tokens.windsurfApiKey || tokens.accessToken || tokens.apiKey || ""; + + return { + accessToken: token, + // Windsurf API keys are long-lived — no refresh token needed + refreshToken: tokens.refreshToken || null, + expiresIn: tokens.expiresIn || 0, + email: tokens.email || null, + providerSpecificData: { + authMethod: tokens.authMethod || (tokens.windsurfApiKey ? "browser" : "import"), + apiServerUrl: tokens.apiServerUrl || null, + devinWebappHost: tokens.devinWebappHost || null, + devinApiUrl: tokens.devinApiUrl || null, + }, + }; + }, +}; diff --git a/src/lib/oauth/services/cursor.ts b/src/lib/oauth/services/cursor.ts index d460520879..2d1e5af620 100644 --- a/src/lib/oauth/services/cursor.ts +++ b/src/lib/oauth/services/cursor.ts @@ -143,8 +143,10 @@ export class CursorService { const decoded = JSON.parse( Buffer.from(payload.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString() ); + const email = + typeof decoded.email === "string" && decoded.email.includes("@") ? decoded.email : null; return { - email: decoded.email || decoded.sub, + email, userId: decoded.sub || decoded.user_id, }; } @@ -155,6 +157,41 @@ export class CursorService { return null; } + /** + * Fetch real user profile from cursor.com using the same WorkOS-session cookie + * format that powers the dashboard. Returns null on any failure so the import + * flow can fall back to whatever it can extract from the JWT. + */ + async fetchUserInfo( + accessToken: string, + userId: string + ): Promise<{ email: string | null; name: string | null; sub: string | null } | null> { + if (!accessToken || !userId) return null; + try { + const response = await fetch("https://cursor.com/api/auth/me", { + method: "GET", + redirect: "manual", + headers: { + Cookie: `WorkosCursorSessionToken=${userId}::${accessToken}`, + Origin: "https://cursor.com", + Referer: "https://cursor.com/dashboard", + Accept: "application/json", + "User-Agent": getCursorUserAgent(this.config.clientVersion), + }, + }); + + if (!response.ok) return null; + const data = (await response.json()) as Record<string, unknown>; + return { + email: typeof data.email === "string" ? data.email : null, + name: typeof data.name === "string" ? data.name : null, + sub: typeof data.sub === "string" ? data.sub : null, + }; + } catch { + return null; + } + } + /** * Get token storage path instructions for user */ diff --git a/src/lib/providers/catalog.ts b/src/lib/providers/catalog.ts index d50f21475a..16bd18723c 100644 --- a/src/lib/providers/catalog.ts +++ b/src/lib/providers/catalog.ts @@ -1,6 +1,7 @@ import { APIKEY_PROVIDERS, AUDIO_ONLY_PROVIDERS, + CLOUD_AGENT_PROVIDERS, FREE_PROVIDERS, LOCAL_PROVIDERS, OAUTH_PROVIDERS, @@ -21,7 +22,8 @@ export type StaticProviderCatalogCategory = | "search" | "audio" | "upstream-proxy" - | "apikey"; + | "apikey" + | "cloud-agent"; export interface ProviderCatalogMetadata { id: string; @@ -133,6 +135,12 @@ export const STATIC_PROVIDER_CATALOG_GROUPS: Record< displayAuthType: "apikey", toggleAuthType: "apikey", }, + "cloud-agent": { + category: "cloud-agent", + providers: CLOUD_AGENT_PROVIDERS as ProviderRecord, + displayAuthType: "apikey", + toggleAuthType: "apikey", + }, }; export const STATIC_PROVIDER_CATALOG_RESOLUTION_ORDER: StaticProviderCatalogCategory[] = [ @@ -143,6 +151,7 @@ export const STATIC_PROVIDER_CATALOG_RESOLUTION_ORDER: StaticProviderCatalogCate "search", "audio", "upstream-proxy", + "cloud-agent", "apikey", ]; diff --git a/src/lib/providers/managedAvailableModels.ts b/src/lib/providers/managedAvailableModels.ts index 9905bfd25a..d450edfdf3 100644 --- a/src/lib/providers/managedAvailableModels.ts +++ b/src/lib/providers/managedAvailableModels.ts @@ -4,6 +4,7 @@ import { isClaudeCodeCompatibleProvider } from "@/shared/constants/providers"; type ManagedAvailableModel = { id?: string; name?: string; + contextLength?: number; }; export function getCompatibleFallbackModels( diff --git a/src/lib/providers/validation.ts b/src/lib/providers/validation.ts index c5e63c264c..88efc59903 100644 --- a/src/lib/providers/validation.ts +++ b/src/lib/providers/validation.ts @@ -1,6 +1,7 @@ -import { getRegistryEntry } from "@omniroute/open-sse/config/providerRegistry.ts"; +import { randomUUID } from "node:crypto"; import { getEmbeddingProvider } from "@omniroute/open-sse/config/embeddingRegistry.ts"; import { getRerankProvider } from "@omniroute/open-sse/config/rerankRegistry.ts"; +import { getRegistryEntry } from "@omniroute/open-sse/config/providerRegistry.ts"; import { buildClaudeCodeCompatibleHeaders, buildClaudeCodeCompatibleValidationPayload, @@ -17,6 +18,7 @@ import { isAnthropicCompatibleProvider, isOpenAICompatibleProvider, isSelfHostedChatProvider, + providerAllowsOptionalApiKey, } from "@/shared/constants/providers"; import { SAFE_OUTBOUND_FETCH_PRESETS, @@ -397,6 +399,55 @@ async function validateDirectChatProvider({ url, headers, body, providerSpecific } } +export async function validateCommandCodeProvider({ apiKey, providerSpecificData = {} }: any) { + const entry = getRegistryEntry("command-code"); + const baseUrl = normalizeBaseUrl(entry?.baseUrl || "https://api.commandcode.ai"); + const chatPath = entry?.chatPath || "/alpha/generate"; + const url = `${baseUrl}${chatPath.startsWith("/") ? chatPath : `/${chatPath}`}`; + + return validateDirectChatProvider({ + url, + providerSpecificData, + headers: { + "Content-Type": "application/json", + Authorization: `Bearer ${apiKey}`, + "x-command-code-version": "0.24.1", + "x-cli-environment": "external", + "x-project-slug": "pi-cc", + "x-taste-learning": "false", + "x-co-flag": "false", + "x-session-id": randomUUID(), + }, + body: { + config: { + workingDir: "/workspace", + date: new Date().toISOString().slice(0, 10), + environment: "external", + structure: [], + isGitRepo: false, + currentBranch: "", + mainBranch: "", + gitStatus: "", + recentCommits: [], + }, + memory: "", + taste: "", + permissionMode: "standard", + params: { + model: + providerSpecificData?.validationModelId || + entry?.models?.[0]?.id || + "deepseek/deepseek-v4-flash", + messages: [{ role: "user", content: "test" }], + tools: [], + system: "", + max_tokens: 1, + stream: false, + }, + }, + }); +} + async function validateClarifaiProvider({ apiKey, providerSpecificData = {} }: any) { const baseUrl = normalizeBaseUrl(providerSpecificData.baseUrl) || "https://api.clarifai.com/v2/ext/openai/v1"; @@ -2359,6 +2410,33 @@ const SEARCH_VALIDATOR_CONFIGS: Record< }, }; }, + "ollama-search": (apiKey) => ({ + url: "https://ollama.com/api/web_search", + init: { + method: "POST", + headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` }, + body: JSON.stringify({ query: "test", max_results: 1 }), + }, + }), + "zai-search": (apiKey, providerSpecificData = {}) => { + const baseUrl = + typeof providerSpecificData?.baseUrl === "string" && providerSpecificData.baseUrl.trim() + ? providerSpecificData.baseUrl.trim().replace(/\/+$/, "") + : "https://api.z.ai/api/mcp/web_search_prime/mcp"; + return { + url: baseUrl, + init: { + method: "POST", + headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` }, + body: JSON.stringify({ + jsonrpc: "2.0", + method: "tools/call", + params: { name: "web_search_prime", arguments: { search_query: "test" } }, + id: 1, + }), + }, + }; + }, }; // See open-sse/executors/muse-spark-web.ts for the rationale: Meta migrated @@ -2967,12 +3045,7 @@ async function validateMuseSparkWebProvider({ apiKey, providerSpecificData = {} } export async function validateProviderApiKey({ provider, apiKey, providerSpecificData = {} }: any) { - const requiresApiKey = - provider !== "searxng-search" && - provider !== "petals" && - !isSelfHostedChatProvider(provider) && - !isOpenAICompatibleProvider(provider) && - !isAnthropicCompatibleProvider(provider); + const requiresApiKey = !providerAllowsOptionalApiKey(provider); if (!provider || (requiresApiKey && !apiKey)) { return { valid: false, error: "Provider and API key required", unsupported: false }; @@ -3001,6 +3074,7 @@ export async function validateProviderApiKey({ provider, apiKey, providerSpecifi const SPECIALTY_VALIDATORS = { qoder: ({ apiKey, providerSpecificData }: any) => validateQoderCliPat({ apiKey, providerSpecificData }), + "command-code": validateCommandCodeProvider, deepgram: validateDeepgramProvider, assemblyai: validateAssemblyAIProvider, nanobanana: validateNanoBananaProvider, diff --git a/src/lib/resilience/settings.ts b/src/lib/resilience/settings.ts index f6f65e8faf..23842e5f47 100644 --- a/src/lib/resilience/settings.ts +++ b/src/lib/resilience/settings.ts @@ -14,6 +14,17 @@ export interface RequestQueueSettings { export interface ConnectionCooldownProfileSettings { baseCooldownMs: number; useUpstreamRetryHints: boolean; + /** + * Issue #2100 follow-up: opt-in toggle for upstream 429 hint trust at the + * circuit-breaker cooldown layer (independent of `useUpstreamRetryHints` + * which controls retry scheduling). + * + * Stored shape is intentionally optional / `boolean | undefined`: when + * unset, the per-provider default from `providerHints.ts` applies. + * Normalize/merge MUST preserve `undefined` — do not coerce via + * `toBoolean(value, fallback)`. + */ + useUpstream429BreakerHints?: boolean; maxBackoffSteps: number; } @@ -155,7 +166,26 @@ function normalizeConnectionCooldownProfile( fallback: ConnectionCooldownProfileSettings ): ConnectionCooldownProfileSettings { const record = asRecord(next); - return { + // useUpstream429BreakerHints uses a 3-state input contract: + // - boolean → user override, store as-is + // - null → explicit unset sentinel, drop key so the per-provider + // default in `providerHints.ts` resolves at runtime + // - omitted → leave existing fallback value unchanged (partial-merge) + // Never coerce via `toBoolean(value, fallback)` because that would + // collapse the unset state. + const hasHintsKey = Object.prototype.hasOwnProperty.call(record, "useUpstream429BreakerHints"); + const rawHints = record.useUpstream429BreakerHints; + let useUpstream429BreakerHints: boolean | undefined; + if (!hasHintsKey) { + useUpstream429BreakerHints = fallback.useUpstream429BreakerHints; + } else if (rawHints === null) { + useUpstream429BreakerHints = undefined; + } else if (typeof rawHints === "boolean") { + useUpstream429BreakerHints = rawHints; + } else { + useUpstream429BreakerHints = fallback.useUpstream429BreakerHints; + } + const out: ConnectionCooldownProfileSettings = { baseCooldownMs: toInteger(record.baseCooldownMs, fallback.baseCooldownMs, { min: 0, max: 24 * 60 * 60 * 1000, @@ -166,6 +196,11 @@ function normalizeConnectionCooldownProfile( max: 32, }), }; + // Only attach the key when defined — preserves omission across round-trips. + if (useUpstream429BreakerHints !== undefined) { + out.useUpstream429BreakerHints = useUpstream429BreakerHints; + } + return out; } function normalizeLegacyConnectionCooldownProfile( diff --git a/src/lib/sync/tokens.ts b/src/lib/sync/tokens.ts index 4b39db7ccd..f5b12499c7 100644 --- a/src/lib/sync/tokens.ts +++ b/src/lib/sync/tokens.ts @@ -16,7 +16,10 @@ function normalizeToken(rawToken: string | null | undefined) { } export function hashSyncToken(rawToken: string) { - return createHash("sha256").update(rawToken).digest("hex"); + // CodeQL: Intentionally SHA-256, NOT password hashing. Sync tokens are + // high-entropy random values (osync_ + 32 random bytes) — not user passwords. + // codeql[js/insufficient-password-hash] + return createHash("sha256").update(rawToken).digest("hex"); // nosemgrep: insufficient-password-hash } export function generatePlaintextSyncToken() { diff --git a/src/lib/system/autoUpdate.ts b/src/lib/system/autoUpdate.ts index 1bf071fe45..bfa51c648b 100644 --- a/src/lib/system/autoUpdate.ts +++ b/src/lib/system/autoUpdate.ts @@ -235,7 +235,7 @@ export function buildSourceUpdateScript(latest: string, gitRemote = "origin"): s 'git branch "$backup_branch" 2>/dev/null || true', `git checkout "${targetTag}"`, "npm install --legacy-peer-deps", - "node scripts/sync-env.mjs 2>/dev/null || true", + "node scripts/dev/sync-env.mjs 2>/dev/null || true", "npm run build", "if command -v pm2 >/dev/null 2>&1; then", " pm2 restart omniroute --update-env || true", diff --git a/src/lib/usage/callLogArtifacts.ts b/src/lib/usage/callLogArtifacts.ts index 41d03e1648..96f8dd4542 100644 --- a/src/lib/usage/callLogArtifacts.ts +++ b/src/lib/usage/callLogArtifacts.ts @@ -2,7 +2,7 @@ import fs from "node:fs"; import path from "node:path"; import type { RequestPipelinePayloads } from "@omniroute/open-sse/utils/requestLogger.ts"; import { resolveDataDir } from "../dataPaths"; -import { getCallLogPipelineMaxSizeBytes } from "../logEnv"; +import { getCallLogPipelineMaxSizeBytes, isChatDebugFileEnabled } from "../logEnv"; const isCloud = typeof globalThis.caches === "object" && globalThis.caches !== null; const isBuildPhase = process.env.NEXT_PHASE === "phase-production-build"; @@ -151,6 +151,11 @@ function serializeFinalSizeLimitFallback(artifact: CallLogArtifact, maxBytes: nu } function serializeArtifactForStorage(artifact: CallLogArtifact): string { + // Debug mode: write full untruncated payload + if (isChatDebugFileEnabled()) { + return JSON.stringify(artifact, null, 2); + } + const maxBytes = getArtifactMaxBytes(artifact); const serialized = JSON.stringify(artifact, null, 2); if (Buffer.byteLength(serialized) <= maxBytes) { diff --git a/src/lib/usage/providerLimits.ts b/src/lib/usage/providerLimits.ts index df189ceb5a..26d83fff16 100644 --- a/src/lib/usage/providerLimits.ts +++ b/src/lib/usage/providerLimits.ts @@ -47,6 +47,7 @@ interface ProviderConnectionLike { const PROVIDER_LIMITS_APIKEY_PROVIDERS = new Set([ "glm", "glm-cn", + "zai", "glmt", "minimax", "minimax-cn", @@ -297,7 +298,9 @@ async function fetchLiveProviderLimitsWithOptions( connection: ProviderConnectionLike; usage: JsonRecord; }> { - let connection = (await getProviderConnectionById(connectionId)) as ProviderConnectionLike | null; + let connection = (await getProviderConnectionById( + connectionId + )) as unknown as ProviderConnectionLike | null; if (!connection) { throw withStatus(new Error("Connection not found"), 404); } @@ -435,7 +438,7 @@ export async function syncAllProviderLimits( }> { const { source = "manual", concurrency = 5 } = options; const connections = ( - (await getProviderConnections({ isActive: true })) as ProviderConnectionLike[] + (await getProviderConnections({ isActive: true })) as unknown as ProviderConnectionLike[] ).filter(isSupportedUsageConnection); const cacheEntries: Array<{ connectionId: string; entry: ProviderLimitsCacheEntry }> = []; const caches: Record<string, ProviderLimitsCacheEntry> = {}; diff --git a/src/mitm/cert/install.ts b/src/mitm/cert/install.ts index 4f6a100aa1..d2e422a264 100644 --- a/src/mitm/cert/install.ts +++ b/src/mitm/cert/install.ts @@ -1,5 +1,6 @@ import fs from "fs"; import crypto from "crypto"; +import { exec } from "child_process"; import { execFileText, execFileWithPassword, @@ -12,8 +13,78 @@ const IS_WIN = process.platform === "win32"; const IS_MAC = process.platform === "darwin"; const LINUX_CERT_NAME = "omniroute-mitm.crt"; -const LINUX_CA_DIR = "/usr/local/share/ca-certificates"; -const LINUX_CERT_DEST = `${LINUX_CA_DIR}/${LINUX_CERT_NAME}`; + +interface LinuxCertConfig { + dir: string; + cmd: string; +} + +const LINUX_CERT_PATHS: LinuxCertConfig[] = [ + // Debian / Ubuntu + { dir: "/usr/local/share/ca-certificates", cmd: "update-ca-certificates" }, + // Arch Linux / CachyOS / Manjaro + { dir: "/etc/ca-certificates/trust-source/anchors", cmd: "update-ca-trust" }, + // Fedora / RHEL / CentOS + { dir: "/etc/pki/ca-trust/source/anchors", cmd: "update-ca-trust" }, + // openSUSE + { dir: "/etc/pki/trust/anchors", cmd: "update-ca-certificates" }, +]; + +function getLinuxCertConfig(): LinuxCertConfig { + for (const config of LINUX_CERT_PATHS) { + if (fs.existsSync(config.dir)) { + return config; + } + } + return LINUX_CERT_PATHS[0]; +} + +async function updateNssDatabases( + certPath: string | null, + action: "add" | "delete" = "add" +): Promise<void> { + const certName = "OmniRoute MITM Root CA"; + + const script = ` + if ! command -v certutil &> /dev/null; then + exit 0 + fi + + DIRS="$HOME/.pki/nssdb $HOME/snap/chromium/current/.pki/nssdb" + + if [ -d "$HOME/.mozilla/firefox" ]; then + for profile in "$HOME"/.mozilla/firefox/*/; do + if [ -f "\${profile}cert9.db" ] || [ -f "\${profile}cert8.db" ]; then + DIRS="$DIRS $profile" + fi + done + fi + + if [ -d "$HOME/snap/firefox/common/.mozilla/firefox" ]; then + for profile in "$HOME"/snap/firefox/common/.mozilla/firefox/*/; do + if [ -f "\${profile}cert9.db" ] || [ -f "\${profile}cert8.db" ]; then + DIRS="$DIRS $profile" + fi + done + fi + + for db in $DIRS; do + if [ -d "$db" ]; then + if [ "${action}" = "add" ]; then + certutil -d sql:"$db" -A -t "C,," -n "${certName}" -i "${certPath}" 2>/dev/null || \\ + certutil -d "$db" -A -t "C,," -n "${certName}" -i "${certPath}" 2>/dev/null || true + else + certutil -d sql:"$db" -D -n "${certName}" 2>/dev/null || \\ + certutil -d "$db" -D -n "${certName}" 2>/dev/null || true + fi + fi + done + `; + + return new Promise((resolve) => { + exec(script, { shell: "/bin/bash" }, () => resolve()); + }); +} // Get SHA1 fingerprint from cert file using Node.js crypto function getCertFingerprint(certPath: string): string { @@ -52,8 +123,10 @@ async function checkCertInstalledMac(certPath: string): Promise<boolean> { async function checkCertInstalledLinux(certPath: string): Promise<boolean> { try { - if (!fs.existsSync(LINUX_CERT_DEST)) return false; - return getCertFingerprint(certPath) === getCertFingerprint(LINUX_CERT_DEST); + const config = getLinuxCertConfig(); + const destFile = `${config.dir}/${LINUX_CERT_NAME}`; + if (!fs.existsSync(destFile)) return false; + return getCertFingerprint(certPath) === getCertFingerprint(destFile); } catch { return false; } @@ -120,9 +193,14 @@ async function installCertMac(sudoPassword: string, certPath: string): Promise<v async function installCertLinux(sudoPassword: string, certPath: string): Promise<void> { try { - await execFileWithPassword("sudo", ["-S", "mkdir", "-p", LINUX_CA_DIR], sudoPassword); - await execFileWithPassword("sudo", ["-S", "cp", certPath, LINUX_CERT_DEST], sudoPassword); - await execFileWithPassword("sudo", ["-S", "update-ca-certificates"], sudoPassword); + const config = getLinuxCertConfig(); + const destFile = `${config.dir}/${LINUX_CERT_NAME}`; + + await execFileWithPassword("sudo", ["-S", "mkdir", "-p", config.dir], sudoPassword); + await execFileWithPassword("sudo", ["-S", "cp", certPath, destFile], sudoPassword); + await execFileWithPassword("sudo", ["-S", config.cmd], sudoPassword); + + await updateNssDatabases(certPath, "add"); } catch (error) { const message = getErrorMessage(error); const msg = message.includes("canceled") @@ -183,10 +261,20 @@ async function uninstallCertMac(sudoPassword: string, certPath: string): Promise async function uninstallCertLinux(sudoPassword: string, certPath: string): Promise<void> { try { - if (fs.existsSync(LINUX_CERT_DEST)) { - await execFileWithPassword("sudo", ["-S", "rm", "-f", LINUX_CERT_DEST], sudoPassword); + await updateNssDatabases(null, "delete"); + + const config = getLinuxCertConfig(); + const destFile = `${config.dir}/${LINUX_CERT_NAME}`; + + if (fs.existsSync(destFile)) { + await execFileWithPassword("sudo", ["-S", "rm", "-f", destFile], sudoPassword); + } + + try { + await execFileWithPassword("sudo", ["-S", config.cmd, "--fresh"], sudoPassword); + } catch { + await execFileWithPassword("sudo", ["-S", config.cmd], sudoPassword); } - await execFileWithPassword("sudo", ["-S", "update-ca-certificates", "--fresh"], sudoPassword); } catch (err) { throw new Error("Failed to uninstall certificate"); } diff --git a/src/server/authz/classify.ts b/src/server/authz/classify.ts index 6093714baa..31f84fdcc0 100644 --- a/src/server/authz/classify.ts +++ b/src/server/authz/classify.ts @@ -53,6 +53,14 @@ export function classifyRoute(rawPath: string, method: string = "GET"): RouteCla }; } + if (normalizedPath === "/dashboard/onboarding") { + return { + routeClass: "PUBLIC", + reason: "setup_wizard", + normalizedPath, + }; + } + if (normalizedPath.startsWith("/dashboard")) { return { routeClass: "MANAGEMENT", @@ -61,16 +69,10 @@ export function classifyRoute(rawPath: string, method: string = "GET"): RouteCla }; } - if ( - normalizedPath === "/api/v1" || - normalizedPath.startsWith("/api/v1/") || - normalizedPath.startsWith("/api/mcp/") - ) { + if (normalizedPath === "/api/v1" || normalizedPath.startsWith("/api/v1/")) { return { routeClass: "CLIENT_API", - reason: - aliasReason ?? - (normalizedPath.startsWith("/api/mcp/") ? "client_api_mcp" : "client_api_v1"), + reason: aliasReason ?? "client_api_v1", normalizedPath, }; } diff --git a/src/server/authz/types.ts b/src/server/authz/types.ts index a8fd786408..443001dbca 100644 --- a/src/server/authz/types.ts +++ b/src/server/authz/types.ts @@ -28,7 +28,9 @@ export type ClassificationReason = | "public_prefix" | "public_readonly_prefix" | "dashboard_prefix" + | "setup_wizard" | "client_api_v1" + | "client_api_mcp" | "client_api_alias" | "client_api_codex_alias" | "client_api_double_prefix" diff --git a/src/shared/components/AutoRoutingBanner.test.tsx b/src/shared/components/AutoRoutingBanner.test.tsx new file mode 100644 index 0000000000..2249ef566e --- /dev/null +++ b/src/shared/components/AutoRoutingBanner.test.tsx @@ -0,0 +1,96 @@ +// @vitest-environment jsdom +import React from "react"; +import { act } from "react"; +import { createRoot } from "react-dom/client"; +import { afterEach, beforeEach, describe, expect, it } from "vitest"; + +const cleanupCallbacks: Array<() => void> = []; + +function makeContainer(): HTMLElement { + const container = document.createElement("div"); + document.body.appendChild(container); + cleanupCallbacks.push(() => { + container.remove(); + }); + return container; +} + +describe("AutoRoutingBanner", () => { + beforeEach(() => { + ( + globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean } + ).IS_REACT_ACT_ENVIRONMENT = true; + localStorage.clear(); + }); + + afterEach(() => { + while (cleanupCallbacks.length > 0) { + cleanupCallbacks.pop()?.(); + } + document.body.innerHTML = ""; + localStorage.clear(); + }); + + it("renders banner on first mount", async () => { + const { default: AutoRoutingBanner } = await import("./AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeTruthy(); + expect(container.textContent).toContain("Auto-Routing Active"); + }); + + it("includes link to Combos page", async () => { + const { default: AutoRoutingBanner } = await import("./AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + const link = container.querySelector('a[href="/dashboard/combos"]'); + expect(link).toBeTruthy(); + }); + + it("can be dismissed by clicking close button", async () => { + const { default: AutoRoutingBanner } = await import("./AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeTruthy(); + const closeButton = container.querySelector('button[aria-label="Dismiss auto-routing banner"]'); + expect(closeButton).toBeTruthy(); + await act(async () => { + closeButton?.click(); + }); + expect(container.querySelector('[role="banner"]')).toBeFalsy(); + }); + + it("persists dismissal to localStorage", async () => { + const { default: AutoRoutingBanner } = await import("./AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + const closeButton = container.querySelector('button[aria-label="Dismiss auto-routing banner"]'); + await act(async () => { + closeButton?.click(); + }); + expect(localStorage.getItem("auto-routing-banner-dismissed")).toBe("true"); + }); + + it("remains hidden after dismissal on remount", async () => { + localStorage.setItem("auto-routing-banner-dismissed", "true"); + const { default: AutoRoutingBanner } = await import("./AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeFalsy(); + }); +}); diff --git a/src/shared/components/AutoRoutingBanner.tsx b/src/shared/components/AutoRoutingBanner.tsx new file mode 100644 index 0000000000..9aedb528ce --- /dev/null +++ b/src/shared/components/AutoRoutingBanner.tsx @@ -0,0 +1,79 @@ +"use client"; + +import { useEffect, useState } from "react"; + +const AUTO_ROUTING_DISMISSED_KEY = "auto-routing-banner-dismissed"; + +export default function AutoRoutingBanner() { + const [isDismissed, setIsDismissed] = useState(false); + + useEffect(() => { + try { + const dismissed = localStorage.getItem(AUTO_ROUTING_DISMISSED_KEY); + if (dismissed === "true") { + // eslint-disable-next-line react-hooks/set-state-in-effect + setIsDismissed(true); + } + } catch { + // localStorage unavailable (SSR or private mode) — do nothing + } + }, []); + + const handleDismiss = () => { + try { + localStorage.setItem(AUTO_ROUTING_DISMISSED_KEY, "true"); + } catch { + // ignore localStorage errors (private mode, quotas) + } + + setIsDismissed(true); + }; + + if (isDismissed) return null; + + return ( + <div + role="banner" + aria-label="Auto-routing mode active" + className="relative overflow-hidden rounded-lg border-l-4 border-blue-500 bg-blue-50/50 p-4 my-4 dark:bg-blue-950/30 transition-colors" + > + <div className="flex items-start gap-3"> + <div className="flex items-center gap-2"> + <span className="inline-flex h-2 w-2 animate-pulse rounded-full bg-blue-500" /> + <span className="font-semibold text-sm text-blue-700 dark:text-blue-300"> + Auto-Routing Active + </span> + </div> + <div className="text-sm leading-relaxed text-text-muted"> + OmniRoute is automatically routing requests using combo-based strategies. + <span className="block sm:inline sm:ml-1"> + View or change your routing configuration on the{" "} + <a + href="/dashboard/combos" + className="text-blue-600 hover:text-blue-800 underline dark:text-blue-400 dark:hover:text-blue-300" + > + Combos page + </a> + . + </span> + </div> + <button + type="button" + onClick={handleDismiss} + aria-label="Dismiss auto-routing banner" + className="ml-auto flex-shrink-0 rounded-md p-1 text-text-muted hover:bg-blue-100 hover:text-blue-700 dark:hover:bg-blue-900/50 dark:hover:text-blue-300 transition-colors" + > + <svg + xmlns="http://www.w3.org/2000/svg" + viewBox="0 0 20 20" + fill="currentColor" + className="h-5 w-5" + aria-hidden="true" + > + <path d="M6.28 5.22a.75.75 0 00-1.06 1.06L8.94 10l-3.72 3.72a.75.75 0 101.06 1.06L10 11.06l3.72 3.72a.75.75 0 101.06-1.06L11.06 10l3.72-3.72a.75.75 0 00-1.06-1.06L10 8.94 6.28 5.22z" /> + </svg> + </button> + </div> + </div> + ); +} diff --git a/src/shared/components/Card.tsx b/src/shared/components/Card.tsx index be782cde92..f78f8abdde 100644 --- a/src/shared/components/Card.tsx +++ b/src/shared/components/Card.tsx @@ -65,8 +65,12 @@ export default function Card({ ); } +interface CardSectionProps extends React.HTMLAttributes<HTMLDivElement> { + children?: React.ReactNode; +} + // Sub-component: Bordered section inside Card -Card.Section = function CardSection({ children, className, ...props }) { +Card.Section = function CardSection({ children, className, ...props }: CardSectionProps) { return ( <div className={cn( @@ -82,8 +86,12 @@ Card.Section = function CardSection({ children, className, ...props }) { ); }; +interface CardRowProps extends React.HTMLAttributes<HTMLDivElement> { + children?: React.ReactNode; +} + // Sub-component: Hoverable row inside Card -Card.Row = function CardRow({ children, className, ...props }) { +Card.Row = function CardRow({ children, className, ...props }: CardRowProps) { return ( <div className={cn( @@ -99,8 +107,18 @@ Card.Row = function CardRow({ children, className, ...props }) { ); }; +interface CardListItemProps extends React.HTMLAttributes<HTMLDivElement> { + children?: React.ReactNode; + actions?: React.ReactNode; +} + // Sub-component: List item with hover actions (macOS style) -Card.ListItem = function CardListItem({ children, actions, className, ...props }) { +Card.ListItem = function CardListItem({ + children, + actions, + className, + ...props +}: CardListItemProps) { return ( <div className={cn( diff --git a/src/shared/components/OAuthModal.tsx b/src/shared/components/OAuthModal.tsx index 07b36f73f5..8f021c54d4 100644 --- a/src/shared/components/OAuthModal.tsx +++ b/src/shared/components/OAuthModal.tsx @@ -9,6 +9,9 @@ import { useCopyToClipboard } from "@/shared/hooks/useCopyToClipboard"; const GOOGLE_OAUTH_PROVIDERS = new Set(["antigravity", "gemini-cli"]); +/** Providers that use a local callback server on a random port (PKCE browser flow). */ +const PKCE_CALLBACK_SERVER_PROVIDERS = new Set(["codex", "windsurf", "devin-cli"]); + type OAuthModalProps = { isOpen: boolean; provider?: string; @@ -41,6 +44,12 @@ export default function OAuthModal({ const [isDeviceCode, setIsDeviceCode] = useState(false); const [deviceData, setDeviceData] = useState(null); const [polling, setPolling] = useState(false); + // API-key paste mode: for providers that accept a token directly (windsurf, devin-cli) + const [showPasteToken, setShowPasteToken] = useState(false); + const [pasteToken, setPasteToken] = useState(""); + const [savingToken, setSavingToken] = useState(false); + + const supportsTokenPaste = provider === "windsurf" || provider === "devin-cli"; const popupRef = useRef(null); const { copied, copy } = useCopyToClipboard(); const deviceVerificationUrl = @@ -149,6 +158,42 @@ export default function OAuthModal({ [authData, provider, onSuccess, reauthConnection] ); + // Save a raw API token directly (windsurf / devin-cli import-token path) + const handleSaveToken = useCallback(async () => { + const token = pasteToken.trim(); + if (!token || !provider) return; + setSavingToken(true); + setError(null); + try { + // POST to /exchange with a synthetic "import_token" payload. + // The windsurf provider's mapTokens() handles a bare accessToken/apiKey field. + const res = await fetch(`/api/oauth/${provider}/import-token`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + token, + connectionId: reauthConnection?.id, + }), + }); + const data = await res.json(); + if (!res.ok) { + const errMsg = + typeof data.error === "object" && data.error !== null + ? ((data.error as Record<string, unknown>).message as string) || + JSON.stringify(data.error) + : data.error || "Save failed"; + throw new Error(errMsg); + } + setStep("success"); + onSuccess?.(); + } catch (err) { + // Show error inline inside the paste-token form (don't flip to error step) + setError(err.message); + } finally { + setSavingToken(false); + } + }, [pasteToken, provider, onSuccess, reauthConnection]); + // Poll for device code token const startPolling = useCallback( async (deviceCode, codeVerifier, interval, extraData) => { @@ -273,13 +318,14 @@ export default function OAuthModal({ forceManual = true; } - // Codex: on localhost use callback server on port 1455, - // on remote use standard auth code flow (callback server is unreachable) - if (provider === "codex") { - if (isLocalhost) { - // Localhost: use callback server on port 1455 + polling + // PKCE callback server providers (Codex, Windsurf, Devin CLI): + // On localhost, spin up a local callback server and poll for the result. + // Codex uses a fixed port 1455; Windsurf/Devin CLI use a random OS-assigned port. + // On remote the server is unreachable — fall through to standard manual flow. + if (PKCE_CALLBACK_SERVER_PROVIDERS.has(provider)) { + if (isTrueLocalhost) { try { - const serverRes = await fetch(`/api/oauth/codex/start-callback-server`); + const serverRes = await fetch(`/api/oauth/${provider}/start-callback-server`); const serverData = await serverRes.json(); if (!serverRes.ok) throw new Error(serverData.error); @@ -297,7 +343,7 @@ export default function OAuthModal({ for (let i = 0; i < maxAttempts; i++) { await new Promise((r) => setTimeout(r, 2000)); - const pollRes = await fetch(`/api/oauth/codex/poll-callback`, { + const pollRes = await fetch(`/api/oauth/${provider}/poll-callback`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ connectionId: reauthConnection?.id }), @@ -318,10 +364,10 @@ export default function OAuthModal({ setPolling(false); throw new Error("Authorization timeout"); - } catch (codexErr) { + } catch (pkceErr) { console.warn( - "Codex callback server failed, falling back to standard manual flow", - codexErr + `${provider} callback server failed, falling back to manual flow`, + pkceErr ); setPolling(false); forceManual = true; @@ -333,6 +379,8 @@ export default function OAuthModal({ // Authorization code flow // Redirect URI strategy: // - Codex/OpenAI: always port 1455 (registered in OAuth app) + // - Windsurf/Devin CLI (remote fallback): use localhost with OmniRoute port + /auth/callback + // (on true localhost the callback server handles it; this is only reached on remote) // - Google OAuth providers (antigravity, gemini-cli): always localhost, regardless of // where OmniRoute is hosted — Google only accepts pre-registered localhost URIs with // the built-in credentials. Remote users must configure their own credentials. @@ -341,6 +389,11 @@ export default function OAuthModal({ let redirectUri: string; if (provider === "codex" || provider === "openai") { redirectUri = "http://localhost:1455/auth/callback"; + } else if (provider === "windsurf" || provider === "devin-cli") { + // Remote fallback: use OmniRoute's port with the /auth/callback path Windsurf expects. + // On true localhost this code is never reached (callback server handles the flow above). + const port = window.location.port || "20128"; + redirectUri = `http://localhost:${port}/auth/callback`; } else if (GOOGLE_OAUTH_PROVIDERS.has(provider)) { // Google OAuth built-in credentials only accept localhost redirect URIs. // Even in remote deployments we use localhost — user copies the callback URL manually. @@ -618,148 +671,210 @@ export default function OAuthModal({ size="lg" > <div className="flex flex-col gap-4"> - {/* Waiting Step (Localhost - popup mode) */} - {step === "waiting" && !isDeviceCode && ( - <div className="text-center py-6"> - <div className="size-16 mx-auto mb-4 rounded-full bg-primary/10 flex items-center justify-center"> - <span className="material-symbols-outlined text-3xl text-primary animate-spin"> - progress_activity - </span> - </div> - <h3 className="text-lg font-semibold mb-2">{t("waiting")}</h3> - <p className="text-sm text-text-muted mb-2">{t("completeAuthInPopup")}</p> - <p className="text-xs text-text-muted mb-4 opacity-70">{t("popupClosedHint")}</p> - <Button variant="ghost" onClick={() => setStep("input")}> - {t("popupBlocked")} - </Button> + {/* Paste-token tab toggle (Windsurf / Devin CLI only) */} + {supportsTokenPaste && step !== "success" && ( + <div className="flex gap-2 border-b border-border pb-3"> + <button + className={`text-sm px-3 py-1 rounded-t ${!showPasteToken ? "font-semibold border-b-2 border-primary text-primary" : "text-text-muted"}`} + onClick={() => setShowPasteToken(false)} + > + Browser Login + </button> + <button + className={`text-sm px-3 py-1 rounded-t ${showPasteToken ? "font-semibold border-b-2 border-primary text-primary" : "text-text-muted"}`} + onClick={() => setShowPasteToken(true)} + > + Paste API Key + </button> </div> )} - {/* Device Code Flow - Waiting */} - {step === "waiting" && isDeviceCode && deviceData && ( - <> - <div className="text-center py-4"> - <p className="text-sm text-text-muted mb-4">{t("deviceCodeVisitUrl")}</p> - <div className="bg-sidebar p-4 rounded-lg mb-4"> - <p className="text-xs text-text-muted mb-1">{t("deviceCodeVerificationUrl")}</p> - <div className="flex items-center gap-2"> - <code className="flex-1 text-sm break-all">{deviceVerificationUrl}</code> - <Button - size="sm" - variant="ghost" - icon={copied === "verify_url" ? "check" : "content_copy"} - onClick={() => copy(deviceVerificationUrl, "verify_url")} - /> - </div> - </div> - <div className="bg-primary/10 p-4 rounded-lg"> - <p className="text-xs text-text-muted mb-1">{t("deviceCodeYourCode")}</p> - <div className="flex items-center justify-center gap-2"> - <p className="text-2xl font-mono font-bold text-primary"> - {deviceData.user_code} - </p> - <Button - size="sm" - variant="ghost" - icon={copied === "user_code" ? "check" : "content_copy"} - onClick={() => copy(deviceData.user_code, "user_code")} - /> - </div> - </div> + {/* Paste-token form (Windsurf / Devin CLI) */} + {supportsTokenPaste && showPasteToken && step !== "success" && ( + <div className="flex flex-col gap-3"> + <p className="text-sm text-text-muted"> + {provider === "windsurf" + ? "Visit windsurf.com/show-auth-token, copy your Windsurf API key, and paste it below." + : "Provide your WINDSURF_API_KEY (obtained via `devin auth login` or windsurf.com/show-auth-token)."} + </p> + <Input + value={pasteToken} + onChange={(e) => setPasteToken(e.target.value)} + placeholder="ws-..." + type="password" + label="API Key / Token" + /> + {error && <p className="text-sm text-red-500">{error}</p>} + <div className="flex gap-2"> + <Button + onClick={handleSaveToken} + fullWidth + disabled={!pasteToken.trim() || savingToken} + > + {savingToken ? "Saving…" : "Save Connection"} + </Button> + <Button onClick={onClose} variant="ghost" fullWidth> + Cancel + </Button> </div> - {polling && ( - <div className="flex items-center justify-center gap-2 text-sm text-text-muted"> - <span className="material-symbols-outlined animate-spin">progress_activity</span> - {t("deviceCodeWaiting")} + </div> + )} + + {/* OAuth flow steps — hidden when paste-token mode is active */} + {(!supportsTokenPaste || !showPasteToken) && ( + <> + {/* Waiting Step (Localhost - popup mode) */} + {step === "waiting" && !isDeviceCode && ( + <div className="text-center py-6"> + <div className="size-16 mx-auto mb-4 rounded-full bg-primary/10 flex items-center justify-center"> + <span className="material-symbols-outlined text-3xl text-primary animate-spin"> + progress_activity + </span> + </div> + <h3 className="text-lg font-semibold mb-2">{t("waiting")}</h3> + <p className="text-sm text-text-muted mb-2">{t("completeAuthInPopup")}</p> + <p className="text-xs text-text-muted mb-4 opacity-70">{t("popupClosedHint")}</p> + <Button variant="ghost" onClick={() => setStep("input")}> + {t("popupBlocked")} + </Button> </div> )} + + {/* Device Code Flow - Waiting */} + {step === "waiting" && isDeviceCode && deviceData && ( + <> + <div className="text-center py-4"> + <p className="text-sm text-text-muted mb-4">{t("deviceCodeVisitUrl")}</p> + <div className="bg-sidebar p-4 rounded-lg mb-4"> + <p className="text-xs text-text-muted mb-1">{t("deviceCodeVerificationUrl")}</p> + <div className="flex items-center gap-2"> + <code className="flex-1 text-sm break-all">{deviceVerificationUrl}</code> + <Button + size="sm" + variant="ghost" + icon={copied === "verify_url" ? "check" : "content_copy"} + onClick={() => copy(deviceVerificationUrl, "verify_url")} + /> + </div> + </div> + <div className="bg-primary/10 p-4 rounded-lg"> + <p className="text-xs text-text-muted mb-1">{t("deviceCodeYourCode")}</p> + <div className="flex items-center justify-center gap-2"> + <p className="text-2xl font-mono font-bold text-primary"> + {deviceData.user_code} + </p> + <Button + size="sm" + variant="ghost" + icon={copied === "user_code" ? "check" : "content_copy"} + onClick={() => copy(deviceData.user_code, "user_code")} + /> + </div> + </div> + </div> + {polling && ( + <div className="flex items-center justify-center gap-2 text-sm text-text-muted"> + <span className="material-symbols-outlined animate-spin"> + progress_activity + </span> + {t("deviceCodeWaiting")} + </div> + )} + </> + )} + + {/* Manual Input Step */} + {step === "input" && !isDeviceCode && ( + <> + <div className="space-y-4"> + {/* Remote/LAN server info for Google OAuth providers */} + {!isTrueLocalhost && GOOGLE_OAUTH_PROVIDERS.has(provider) && ( + <div className="rounded-lg border border-amber-500/30 bg-amber-500/10 p-3 text-xs text-amber-200"> + <span className="material-symbols-outlined text-sm align-middle mr-1"> + warning + </span> + <strong> + {t.rich("googleOAuthWarning", { + code: (c) => <code className="font-mono">{c}</code>, + a: (c) => ( + <a + href="https://github.com/diegosouzapw/OmniRoute#oauth-on-a-remote-server" + target="_blank" + rel="noreferrer" + className="underline" + > + {c} + </a> + ), + })} + </strong> + </div> + )} + {/* Generic remote info for other providers */} + {!isTrueLocalhost && !GOOGLE_OAUTH_PROVIDERS.has(provider) && ( + <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> + {t("remoteAccessInfo")} + </div> + )} + <div> + <p className="text-sm font-medium mb-2">{t("step1OpenUrl")}</p> + <div className="flex gap-2"> + <Input + value={authData?.authUrl || ""} + readOnly + className="flex-1 font-mono text-xs" + /> + <Button + variant="secondary" + icon={copied === "auth_url" ? "check" : "content_copy"} + onClick={() => copy(authData?.authUrl, "auth_url")} + > + {t("copy")} + </Button> + </div> + </div> + + <div> + <p className="text-sm font-medium mb-2">{t("step2PasteCallback")}</p> + <p className="text-xs text-text-muted mb-2"> + {t.rich("step2Hint", { + code: (c) => <code className="font-mono">{c}</code>, + })} + </p> + <Input + value={callbackUrl} + onChange={(e) => setCallbackUrl(e.target.value)} + placeholder={ + provider === "claude" || provider === "cline" + ? "code#state or /callback?code=..." + : placeholderUrl + } + className="font-mono text-xs" + /> + </div> + </div> + + <div className="flex gap-2"> + <Button + onClick={handleManualSubmit} + fullWidth + disabled={!callbackUrl || !authData} + > + {t("connect")} + </Button> + <Button onClick={onClose} variant="ghost" fullWidth> + {t("cancel")} + </Button> + </div> + </> + )} </> )} - {/* Manual Input Step */} - {step === "input" && !isDeviceCode && ( - <> - <div className="space-y-4"> - {/* Remote/LAN server info for Google OAuth providers */} - {!isTrueLocalhost && GOOGLE_OAUTH_PROVIDERS.has(provider) && ( - <div className="rounded-lg border border-amber-500/30 bg-amber-500/10 p-3 text-xs text-amber-200"> - <span className="material-symbols-outlined text-sm align-middle mr-1"> - warning - </span> - <strong> - {t.rich("googleOAuthWarning", { - code: (c) => <code className="font-mono">{c}</code>, - a: (c) => ( - <a - href="https://github.com/diegosouzapw/OmniRoute#oauth-on-a-remote-server" - target="_blank" - rel="noreferrer" - className="underline" - > - {c} - </a> - ), - })} - </strong> - </div> - )} - {/* Generic remote info for other providers */} - {!isTrueLocalhost && !GOOGLE_OAUTH_PROVIDERS.has(provider) && ( - <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> - {t("remoteAccessInfo")} - </div> - )} - <div> - <p className="text-sm font-medium mb-2">{t("step1OpenUrl")}</p> - <div className="flex gap-2"> - <Input - value={authData?.authUrl || ""} - readOnly - className="flex-1 font-mono text-xs" - /> - <Button - variant="secondary" - icon={copied === "auth_url" ? "check" : "content_copy"} - onClick={() => copy(authData?.authUrl, "auth_url")} - > - {t("copy")} - </Button> - </div> - </div> - - <div> - <p className="text-sm font-medium mb-2">{t("step2PasteCallback")}</p> - <p className="text-xs text-text-muted mb-2"> - {t.rich("step2Hint", { - code: (c) => <code className="font-mono">{c}</code>, - })} - </p> - <Input - value={callbackUrl} - onChange={(e) => setCallbackUrl(e.target.value)} - placeholder={ - provider === "claude" || provider === "cline" - ? "code#state or /callback?code=..." - : placeholderUrl - } - className="font-mono text-xs" - /> - </div> - </div> - - <div className="flex gap-2"> - <Button onClick={handleManualSubmit} fullWidth disabled={!callbackUrl || !authData}> - {t("connect")} - </Button> - <Button onClick={onClose} variant="ghost" fullWidth> - {t("cancel")} - </Button> - </div> - </> - )} - - {/* Success Step */} + {/* Success Step — shown for both OAuth and paste-token flows */} {step === "success" && ( <div className="text-center py-6"> <div className="size-16 mx-auto mb-4 rounded-full bg-green-100 dark:bg-green-900/30 flex items-center justify-center"> @@ -777,8 +892,8 @@ export default function OAuthModal({ </div> )} - {/* Error Step */} - {step === "error" && ( + {/* Error Step — OAuth errors only; paste-token errors shown inline */} + {step === "error" && !showPasteToken && ( <div className="text-center py-6"> <div className="size-16 mx-auto mb-4 rounded-full bg-red-100 dark:bg-red-900/30 flex items-center justify-center"> <span className="material-symbols-outlined text-3xl text-red-600">error</span> diff --git a/src/shared/components/ProviderIcon.tsx b/src/shared/components/ProviderIcon.tsx index 795b1b56ac..a763ee0088 100644 --- a/src/shared/components/ProviderIcon.tsx +++ b/src/shared/components/ProviderIcon.tsx @@ -72,10 +72,12 @@ const KNOWN_PNGS = new Set([ ]); const KNOWN_SVGS = new Set([ "apikey", + "bazaarlink", "brave", "brave-search", "cartesia", "clarifai", + "command-code", "docker-model-runner", "droid", "gemini-cli", diff --git a/src/shared/components/layouts/DashboardLayout.tsx b/src/shared/components/layouts/DashboardLayout.tsx index 9c3e9c0751..a4b92b7005 100644 --- a/src/shared/components/layouts/DashboardLayout.tsx +++ b/src/shared/components/layouts/DashboardLayout.tsx @@ -7,6 +7,7 @@ import Breadcrumbs from "../Breadcrumbs"; import NotificationToast from "../NotificationToast"; import MaintenanceBanner from "../MaintenanceBanner"; import { useIsElectron } from "@/shared/hooks/useElectron"; +import AutoRoutingBanner from "../AutoRoutingBanner"; const SIDEBAR_COLLAPSED_KEY = "sidebar-collapsed"; const isE2EMode = process.env.NEXT_PUBLIC_OMNIROUTE_E2E_MODE === "1"; @@ -77,6 +78,7 @@ export default function DashboardLayout({ children }) { > <Header onMenuClick={() => setSidebarOpen(true)} /> {!isE2EMode && <MaintenanceBanner />} + <AutoRoutingBanner /> <div className="flex-1 min-h-0 overflow-y-auto overflow-x-hidden custom-scrollbar p-4 sm:p-6 lg:p-10"> <div className="max-w-7xl mx-auto w-full"> <Breadcrumbs /> diff --git a/src/shared/constants/modelSpecs.ts b/src/shared/constants/modelSpecs.ts index 079b6e04b7..4ed127e05f 100644 --- a/src/shared/constants/modelSpecs.ts +++ b/src/shared/constants/modelSpecs.ts @@ -79,16 +79,113 @@ export const MODEL_SPECS: Record<string, ModelSpec> = { supportsVision: true, }, + // ── Claude Opus 4.5 (full ID — overrides prefix match on claude-opus-4-5) ── + "claude-opus-4-5-20251101": { + maxOutputTokens: 64000, + contextWindow: 200000, + defaultThinkingBudget: 10000, + thinkingBudgetCap: 32000, + supportsThinking: true, + supportsTools: true, + supportsVision: true, + }, + + // ── Claude Opus 4.6 (1M context tier) ─────────────────────────── + "claude-opus-4-6": { + maxOutputTokens: 128000, + contextWindow: 1000000, + // Anthropic accepts thinking.budget_tokens in [1024, 128000]; cap + // a bit below to leave headroom for the visible response within + // max_tokens (thinking + response must both fit under max_tokens). + defaultThinkingBudget: 32000, + thinkingBudgetCap: 120000, + supportsThinking: true, + supportsTools: true, + supportsVision: true, + aliases: ["claude-opus-4.6"], + }, + // ── Claude Opus 4.7 ───────────────────────────────────────────── "claude-opus-4-7": { maxOutputTokens: 128000, contextWindow: 1000000, + // Anthropic accepts thinking.budget_tokens in [1024, 128000]; cap + // a bit below to leave headroom for the visible response within + // max_tokens. Without this cap, adaptive scaling on top of an + // `output_config.effort=max` request can push past 128000 and + // trigger a 400 "budget out of range" from Anthropic. + defaultThinkingBudget: 32000, + thinkingBudgetCap: 120000, supportsThinking: true, supportsTools: true, supportsVision: true, aliases: ["claude-opus-4.7"], }, + // ── Claude Sonnet 4.6 ─────────────────────────────────────────── + "claude-sonnet-4-6": { + maxOutputTokens: 64000, + contextWindow: 200000, + // ~94% of maxOutputTokens, mirroring the Opus 4.5 ratio (32000 / 32768). + defaultThinkingBudget: 16000, + thinkingBudgetCap: 60000, + supportsThinking: true, + supportsTools: true, + supportsVision: true, + aliases: ["claude-sonnet-4.6"], + }, + + // ── Claude Sonnet 4.5 ─────────────────────────────────────────── + "claude-sonnet-4-5-20250929": { + maxOutputTokens: 64000, + contextWindow: 200000, + supportsThinking: true, + supportsTools: true, + supportsVision: true, + aliases: ["claude-sonnet-4.5"], + }, + + // ── Claude Haiku 4.5 ──────────────────────────────────────────── + "claude-haiku-4-5-20251001": { + maxOutputTokens: 64000, + contextWindow: 200000, + supportsThinking: true, + supportsTools: true, + supportsVision: true, + aliases: ["claude-haiku-4.5"], + }, + + // ── Kimi K2.6 (Moonshot Kimi Code OAuth — 262K native) ────────── + "kimi-k2.6": { + maxOutputTokens: 262144, + contextWindow: 262144, + supportsThinking: true, + supportsTools: true, + aliases: ["kimi-k2.6-thinking", "kimi-for-coding"], + }, + + // ── Xiaomi MiMo V2.5 (1M context, consensus across 7+ sync sources) ── + "mimo-v2.5-pro": { + maxOutputTokens: 131072, + contextWindow: 1048576, + supportsTools: true, + }, + "mimo-v2.5": { + maxOutputTokens: 131072, + contextWindow: 1048576, + supportsTools: true, + }, + "mimo-v2-omni": { + maxOutputTokens: 131072, + contextWindow: 262144, + supportsTools: true, + }, + "mimo-v2-flash": { + maxOutputTokens: 65536, + contextWindow: 262144, + supportsTools: true, + }, + // Defaults __default__: { maxOutputTokens: 8192, diff --git a/src/shared/constants/providers.ts b/src/shared/constants/providers.ts index 05dbcb5d46..dd7bd785a7 100644 --- a/src/shared/constants/providers.ts +++ b/src/shared/constants/providers.ts @@ -90,6 +90,28 @@ export const OAUTH_PROVIDERS = { color: "#5B9BD5", textIcon: "CL", }, + windsurf: { + id: "windsurf", + alias: "ws", + name: "Windsurf (Devin CLI)", + icon: "air", + color: "#00C5A0", + textIcon: "WS", + authHint: + "Sign in at windsurf.com to get your token. Visit windsurf.com/show-auth-token after logging in and paste it here, or use the device-code login flow.", + website: "https://windsurf.com", + }, + "devin-cli": { + id: "devin-cli", + alias: "dv", + name: "Devin CLI (Official)", + icon: "terminal", + color: "#6366F1", + textIcon: "DV", + authHint: + "Requires the Devin CLI binary. Run `devin auth login` to authenticate, or provide your WINDSURF_API_KEY. Install: https://cli.devin.ai", + website: "https://cli.devin.ai", + }, }; // Web / Cookie Providers @@ -162,6 +184,18 @@ export const APIKEY_PROVIDERS = { freeNote: "$200 free credits on signup - multi-model routing gateway", apiHint: "Get $200 free credits at https://agentrouter.org/register — no credit card required.", }, + "command-code": { + id: "command-code", + alias: "cmd", + name: "Command Code", + icon: "terminal", + color: "#111827", + textIcon: "CC", + website: "https://commandcode.ai/", + authHint: + "Use a Command Code API key. Requests are sent to Command Code's /alpha/generate endpoint.", + apiHint: "Create or copy an API key from Command Code, then paste it here as a Bearer token.", + }, openrouter: { id: "openrouter", alias: "openrouter", @@ -793,8 +827,9 @@ export const APIKEY_PROVIDERS = { color: "#4CAF50", textIcon: "PO", website: "https://pollinations.ai", - hasFree: false, - freeNote: "API key required. Spore tier: ~0.01 pollen/hour ($0.01/hr).", + hasFree: true, + freeNote: + "No API key required for free public endpoint. Optional Spore tier: ~0.01 pollen/hour.", }, puter: { id: "puter", @@ -1753,6 +1788,26 @@ export const SEARCH_PROVIDERS = { authHint: "API key is optional. Set your SearXNG base URL. Some instances may require a bearer token for access.", }, + "ollama-search": { + id: "ollama-search", + alias: "ollama-search", + name: "Ollama Search", + icon: "search", + color: "#58A6FF", + textIcon: "OS", + website: "https://ollama.com/settings/api-keys", + authHint: "Same API key as Ollama Cloud (from ollama.com/settings/api-keys)", + }, + "zai-search": { + id: "zai-search", + alias: "zai-search", + name: "Z.AI Coding Plan Search", + icon: "search", + color: "#2563EB", + textIcon: "ZS", + website: "https://docs.z.ai/devpack/mcp/search-mcp-server", + authHint: "Same API key as Z.AI Coding Plan (from open.bigmodel.cn or z.ai)", + }, }; // Audio Only Providers @@ -1854,6 +1909,39 @@ export const UPSTREAM_PROXY_PROVIDERS = { }, }; +export const CLOUD_AGENT_PROVIDERS = { + jules: { + id: "jules", + alias: "jules", + name: "Google Jules", + icon: "engineering", + color: "#4285F4", + textIcon: "JL", + website: "https://jules.google", + authHint: "Jules API key for creating and managing cloud coding tasks.", + }, + devin: { + id: "devin", + alias: "devin", + name: "Devin", + icon: "smart_toy", + color: "#111827", + textIcon: "DV", + website: "https://devin.ai", + authHint: "Devin API key for cloud agent sessions.", + }, + "codex-cloud": { + id: "codex-cloud", + alias: "codex-cloud", + name: "Codex Cloud", + icon: "cloud", + color: "#10A37F", + textIcon: "CC", + website: "https://openai.com/codex", + authHint: "OpenAI API key with Codex Cloud task access.", + }, +}; + export function isClaudeCodeCompatibleProvider(providerId: unknown): providerId is string { return typeof providerId === "string" && providerId.startsWith(CLAUDE_CODE_COMPATIBLE_PREFIX); } @@ -1880,6 +1968,32 @@ export function isSelfHostedChatProvider(providerId: unknown): boolean { return typeof providerId === "string" && SELF_HOSTED_CHAT_PROVIDER_IDS.has(providerId); } +export function providerAllowsOptionalApiKey(providerId: unknown): boolean { + return ( + providerId === "searxng-search" || + providerId === "petals" || + providerId === "pollinations" || + isLocalProvider(providerId) || + isSelfHostedChatProvider(providerId) || + isOpenAICompatibleProvider(providerId) || + isAnthropicCompatibleProvider(providerId) + ); +} + +// ── System Providers (virtual, not user-connectable) ────────────────────────── +export const SYSTEM_PROVIDERS = { + auto: { + id: "auto", + alias: "auto", + name: "Auto (Zero-Config)", + icon: "auto_awesome", + color: "#6366F1", + textIcon: "Auto", + systemOnly: true, + description: "Zero-config auto-routing with LKGP across all connected providers", + }, +}; + // All providers (combined) export const AI_PROVIDERS = { ...FREE_PROVIDERS, @@ -1890,6 +2004,8 @@ export const AI_PROVIDERS = { ...SEARCH_PROVIDERS, ...AUDIO_ONLY_PROVIDERS, ...UPSTREAM_PROXY_PROVIDERS, + ...CLOUD_AGENT_PROVIDERS, + ...SYSTEM_PROVIDERS, // <-- system providers included }; export type AiProviderId = keyof typeof AI_PROVIDERS; @@ -1946,9 +2062,11 @@ export const USAGE_SUPPORTED_PROVIDERS = [ "github", "codex", "claude", + "cursor", "kimi-coding", "glm", "glm-cn", + "zai", "glmt", "minimax", "minimax-cn", @@ -1968,3 +2086,4 @@ validateProviders(LOCAL_PROVIDERS, "LOCAL_PROVIDERS"); validateProviders(SEARCH_PROVIDERS, "SEARCH_PROVIDERS"); validateProviders(AUDIO_ONLY_PROVIDERS, "AUDIO_ONLY_PROVIDERS"); validateProviders(UPSTREAM_PROXY_PROVIDERS, "UPSTREAM_PROXY_PROVIDERS"); +validateProviders(CLOUD_AGENT_PROVIDERS, "CLOUD_AGENT_PROVIDERS"); diff --git a/src/shared/constants/publicApiRoutes.ts b/src/shared/constants/publicApiRoutes.ts index 4a6e41fd35..8e12f6dbd9 100644 --- a/src/shared/constants/publicApiRoutes.ts +++ b/src/shared/constants/publicApiRoutes.ts @@ -3,14 +3,16 @@ const PUBLIC_API_ROUTE_PREFIXES = [ "/api/auth/logout", "/api/auth/status", "/api/init", - "/api/settings/require-login", "/api/v1/", "/api/cloud/", "/api/sync/bundle", "/api/oauth/", ]; -const PUBLIC_READONLY_API_ROUTE_PREFIXES = ["/api/monitoring/health"]; +const PUBLIC_READONLY_API_ROUTE_PREFIXES = [ + "/api/monitoring/health", + "/api/settings/require-login", +]; const PUBLIC_READONLY_METHODS = new Set(["GET", "HEAD", "OPTIONS"]); diff --git a/src/shared/constants/sidebarVisibility.ts b/src/shared/constants/sidebarVisibility.ts index 300a75d86c..35805f7e60 100644 --- a/src/shared/constants/sidebarVisibility.ts +++ b/src/shared/constants/sidebarVisibility.ts @@ -14,6 +14,7 @@ export const HIDEABLE_SIDEBAR_ITEM_IDS = [ "limits", "cli-tools", "agents", + "cloud-agents", "memory", "skills", "translator", @@ -69,6 +70,7 @@ const PRIMARY_SIDEBAR_ITEMS: readonly SidebarItemDefinition[] = [ const CLI_SIDEBAR_ITEMS: readonly SidebarItemDefinition[] = [ { id: "cli-tools", href: "/dashboard/cli-tools", i18nKey: "cliToolsShort", icon: "terminal" }, { id: "agents", href: "/dashboard/agents", i18nKey: "agents", icon: "smart_toy" }, + { id: "cloud-agents", href: "/dashboard/cloud-agents", i18nKey: "cloudAgents", icon: "cloud" }, { id: "memory", href: "/dashboard/memory", i18nKey: "memory", icon: "psychology" }, { id: "skills", href: "/dashboard/skills", i18nKey: "skills", icon: "auto_fix_high" }, ]; diff --git a/src/shared/services/cliRuntime.ts b/src/shared/services/cliRuntime.ts index f5d9abcaae..db867849cc 100644 --- a/src/shared/services/cliRuntime.ts +++ b/src/shared/services/cliRuntime.ts @@ -67,6 +67,26 @@ const CLI_TOOLS: Record<string, any> = { healthcheckTimeoutMs: 4000, paths: {}, }, + devin: { + defaultCommand: "devin", + envBinKey: "CLI_DEVIN_BIN", + requiresBinary: true, + // devin acp cold-start can take a few seconds on first run + healthcheckTimeoutMs: 12000, + paths: { + // %APPDATA%\devin\config.json (Windows) + // ~/.config/devin/config.json (Linux/macOS) + get config() { + return isWindows() + ? path.join( + process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), + "devin", + "config.json" + ) + : path.join(os.homedir(), ".config", "devin", "config.json"); + }, + }, + }, cline: { defaultCommand: "cline", envBinKey: "CLI_CLINE_BIN", @@ -187,6 +207,13 @@ const runProcess = ( } = {} ): Promise<any> => new Promise((resolve) => { + // Guard: reject commands with shell metacharacters — command comes from + // server-controlled env vars/config, not HTTP input, but belt-and-suspenders. + if (/[;&|`$<>\n\r]/.test(command)) { + resolve({ ok: false, stdout: "", stderr: "rejected: unsafe command path", exitCode: -1 }); + return; + } + let stdout = ""; let stderr = ""; let timedOut = false; @@ -439,6 +466,10 @@ const getKnownToolPaths = (toolId: string): string[] => { ["qodercli.cmd", "qodercli"], ["qodercli.exe", "qodercli"], ], + devin: [ + ["devin.exe", "devin"], + ["devin.cmd", "devin"], + ], }; const bins = toolBins[toolId] || []; @@ -464,6 +495,11 @@ const getKnownToolPaths = (toolId: string): string[] => { paths.push(path.join(home, "bin", "droid.exe")); } + // Devin CLI installs to %LOCALAPPDATA%\devin\cli\bin\devin.exe + if (toolId === "devin" && localAppData) { + paths.push(path.join(localAppData, "devin", "cli", "bin", "devin.exe")); + } + for (const [winName] of bins) { if (npmPrefix) paths.push(path.join(npmPrefix, winName)); if (appData) { @@ -501,6 +537,12 @@ const getKnownToolPaths = (toolId: string): string[] => { if (toolId === "claude") { paths.push(path.join(home, ".claude", "bin", posixName)); } + // Devin CLI installs to ~/.local/share/devin/bin/devin (Linux) + // or via shell installer to ~/.devin/bin/devin + if (toolId === "devin") { + paths.push(path.join(home, ".local", "share", "devin", "bin", "devin")); + paths.push(path.join(home, ".devin", "bin", "devin")); + } } } diff --git a/src/shared/services/modelSyncScheduler.ts b/src/shared/services/modelSyncScheduler.ts index f6d8d8e948..fe9478cdb6 100644 --- a/src/shared/services/modelSyncScheduler.ts +++ b/src/shared/services/modelSyncScheduler.ts @@ -22,7 +22,7 @@ const INTERNAL_BASE_URL = process.env.BASE_URL || process.env.NEXT_PUBLIC_BASE_URL || process.env.NEXT_PUBLIC_APP_URL || - `http://localhost:${dashboardPort}`; + `http://127.0.0.1:${dashboardPort}`; const globalState = globalThis as typeof globalThis & { __omnirouteModelSyncInternalAuthToken?: string; diff --git a/src/shared/utils/apiAuth.ts b/src/shared/utils/apiAuth.ts index f4750750db..e4d4f75343 100644 --- a/src/shared/utils/apiAuth.ts +++ b/src/shared/utils/apiAuth.ts @@ -58,6 +58,10 @@ function isOnboardingBootstrapPath(pathname: string | null): boolean { return pathname === "/dashboard/onboarding"; } +function isRequireLoginBootstrapWritePath(pathname: string | null, method: string): boolean { + return pathname === "/api/settings/require-login" && method.toUpperCase() === "POST"; +} + function getRequestMethod(request: RequestLike | Request | null | undefined): string { if ( request && @@ -277,11 +281,16 @@ export async function isAuthRequired( if (!request) return false; const pathname = getRequestPathname(request); + const method = getRequestMethod(request); if (isOnboardingBootstrapPath(pathname)) { return false; } - if (pathname && isPublicApiRoute(pathname, getRequestMethod(request))) { + if (pathname && isPublicApiRoute(pathname, method)) { + return false; + } + + if (isRequireLoginBootstrapWritePath(pathname, method)) { return false; } diff --git a/src/shared/utils/apiKeyPolicy.ts b/src/shared/utils/apiKeyPolicy.ts index 5909d6b37f..c750f93361 100644 --- a/src/shared/utils/apiKeyPolicy.ts +++ b/src/shared/utils/apiKeyPolicy.ts @@ -17,9 +17,9 @@ import * as log from "@/sse/utils/logger"; import { checkRateLimit, RateLimitRule } from "./rateLimiter"; const DEFAULT_RATE_LIMITS: RateLimitRule[] = [ - { limit: 1000, window: 86400 }, // 1000 per day - { limit: 5000, window: 604800 }, // 5000 per week - { limit: 20000, window: 2592000 } // 20000 per month + { limit: 1000, window: 86400 }, // 1000 per day + { limit: 5000, window: 604800 }, // 5000 per week + { limit: 20000, window: 2592000 }, // 20000 per month ]; interface AccessSchedule { @@ -187,7 +187,10 @@ export async function enforceApiKeyPolicy( return { apiKey, apiKeyInfo, - rejection: errorResponse(HTTP_STATUS.FORBIDDEN, "This API key is banned due to policy violations"), + rejection: errorResponse( + HTTP_STATUS.FORBIDDEN, + "This API key is banned due to policy violations" + ), }; } @@ -260,9 +263,10 @@ export async function enforceApiKeyPolicy( // ── Check 5: Generic Multi-Window Rate Limits ── if (apiKeyInfo.id) { - const rulesToApply = (apiKeyInfo.rateLimits && apiKeyInfo.rateLimits.length > 0) - ? [...apiKeyInfo.rateLimits] - : [...DEFAULT_RATE_LIMITS]; + const rulesToApply = + apiKeyInfo.rateLimits && apiKeyInfo.rateLimits.length > 0 + ? [...apiKeyInfo.rateLimits] + : [...DEFAULT_RATE_LIMITS]; // Combine with legacy limits if they exist and custom rate limits aren't set if (!apiKeyInfo.rateLimits || apiKeyInfo.rateLimits.length === 0) { @@ -276,13 +280,16 @@ export async function enforceApiKeyPolicy( const rateLimitResult = await checkRateLimit(apiKeyInfo.id, rulesToApply); if (!rateLimitResult.allowed) { - const failedWindowStr = rateLimitResult.failedWindow - ? ` (${rateLimitResult.failedWindow}s window)` + const failedWindowStr = rateLimitResult.failedWindow + ? ` (${rateLimitResult.failedWindow}s window)` : ""; return { apiKey, apiKeyInfo, - rejection: errorResponse(HTTP_STATUS.RATE_LIMITED, `Request limit exceeded${failedWindowStr}. Please try again later.`), + rejection: errorResponse( + HTTP_STATUS.RATE_LIMITED, + `Request limit exceeded${failedWindowStr}. Please try again later.` + ), }; } } diff --git a/src/shared/utils/circuitBreaker.ts b/src/shared/utils/circuitBreaker.ts index f94d73949a..cb7b47af5a 100644 --- a/src/shared/utils/circuitBreaker.ts +++ b/src/shared/utils/circuitBreaker.ts @@ -19,6 +19,7 @@ import { deleteCircuitBreakerState, deleteAllCircuitBreakerStates, } from "../../lib/db/domainState"; +import type { FailureKind } from "./classify429"; const STATE = { CLOSED: "CLOSED", @@ -34,6 +35,25 @@ interface CircuitBreakerOptions { halfOpenRequests?: number; onStateChange?: ((name: string, oldState: string, newState: string) => void) | null; isFailure?: (error: unknown) => boolean; + /** + * Per-failure-kind cooldown override (Issue #2100). + * + * When set, `_timeUntilReset()` and `_shouldAttemptReset()` use + * `cooldownByKind[lastFailureKind]` instead of `resetTimeout` whenever + * the last failure had a known kind. Use this to give a longer cooldown + * to `quota_exhausted` (period-end may be hours away) than to + * `rate_limit` (typically 60s). + */ + cooldownByKind?: Partial<Record<FailureKind, number>>; + /** + * Optional classifier called on `execute()` errors (Issue #2100). + * Returns the kind to record. When omitted, all failures are recorded + * as `lastFailureKind = null` (existing behavior preserved). + * + * Pair with `classify429()` from `./classify429.ts` for HTTP responses, + * or supply a custom classifier for non-HTTP errors. + */ + classifyError?: (error: unknown) => FailureKind | undefined; } export class CircuitBreaker { @@ -48,6 +68,9 @@ export class CircuitBreaker { successCount: number; lastFailureTime: number | null; halfOpenAllowed: number; + cooldownByKind: Partial<Record<FailureKind, number>>; + classifyError: ((error: unknown) => FailureKind | undefined) | null; + lastFailureKind: FailureKind | null; constructor(name: string, options: CircuitBreakerOptions = {}) { this.name = name; @@ -62,6 +85,9 @@ export class CircuitBreaker { this.successCount = 0; this.lastFailureTime = null; this.halfOpenAllowed = 0; + this.cooldownByKind = options.cooldownByKind ?? {}; + this.classifyError = options.classifyError ?? null; + this.lastFailureKind = null; // Try to restore state from DB this._restoreFromDb(); @@ -122,7 +148,7 @@ export class CircuitBreaker { * @returns {Promise<T>} * @throws {Error} If circuit is OPEN */ - async execute(fn) { + async execute<T>(fn: () => Promise<T>): Promise<T> { this._refreshOpenState(); if (this.state === STATE.OPEN) { @@ -151,7 +177,17 @@ export class CircuitBreaker { return result; } catch (error) { if (this.isFailure(error)) { - this._onFailure(); + let kind: FailureKind | undefined; + if (this.classifyError) { + try { + kind = this.classifyError(error); + } catch { + // A user-supplied classifier must not mask the original error + // or change failure-counting semantics; fall back to no kind. + kind = undefined; + } + } + this._onFailure(kind); } throw error; } @@ -205,6 +241,7 @@ export class CircuitBreaker { this.failureCount = 0; this.successCount = 0; this.lastFailureTime = null; + this.lastFailureKind = null; this._persistToDb(); } @@ -218,10 +255,12 @@ export class CircuitBreaker { this.failureCount = 0; this.successCount = 0; this.lastFailureTime = null; + this.lastFailureKind = null; } else if (this.state === STATE.HALF_OPEN) { this.successCount++; this._transition(STATE.CLOSED); this.failureCount = 0; + this.lastFailureKind = null; } else { // In CLOSED state, just reset failure count this.failureCount = 0; @@ -229,9 +268,10 @@ export class CircuitBreaker { this._persistToDb(); } - _onFailure() { + _onFailure(kind?: FailureKind | null) { this.failureCount++; this.lastFailureTime = Date.now(); + this.lastFailureKind = kind ?? null; if (this.state === STATE.OPEN) { // Already OPEN — just update persistence (re-tripped by combo path) @@ -245,12 +285,31 @@ export class CircuitBreaker { _shouldAttemptReset() { if (!this.lastFailureTime) return true; - return Date.now() - this.lastFailureTime >= this.resetTimeout; + const cooldown = this._effectiveCooldown(); + return Date.now() - this.lastFailureTime >= cooldown; + } + + /** + * Resolve the cooldown for the current `lastFailureKind`. Falls back to + * `resetTimeout` when no kind was recorded, no override exists for it, + * or the override is not a finite non-negative number (NaN / Infinity / + * negative all silently fall through to `resetTimeout`). + * @private + */ + _effectiveCooldown() { + if (this.lastFailureKind !== null) { + const override = this.cooldownByKind[this.lastFailureKind]; + if (typeof override === "number" && Number.isFinite(override) && override >= 0) { + return override; + } + } + return this.resetTimeout; } _timeUntilReset() { if (!this.lastFailureTime) return 0; - return Math.max(0, this.resetTimeout - (Date.now() - this.lastFailureTime)); + const cooldown = this._effectiveCooldown(); + return Math.max(0, cooldown - (Date.now() - this.lastFailureTime)); } _refreshOpenState() { @@ -260,7 +319,7 @@ export class CircuitBreaker { } } - _transition(newState) { + _transition(newState: CircuitState) { const oldState = this.state; this.state = newState; if (newState === STATE.HALF_OPEN) { @@ -315,6 +374,18 @@ export function getCircuitBreaker(name: string, options?: CircuitBreakerOptions) if (typeof options.isFailure === "function") { breaker.isFailure = options.isFailure; } + if (options.cooldownByKind) { + // Merge keys, don't replace: callers that add different kinds + // (e.g. one sets `quota_exhausted`, another `rate_limit`) should + // not silently lose each other's overrides. + breaker.cooldownByKind = { + ...breaker.cooldownByKind, + ...options.cooldownByKind, + }; + } + if (typeof options.classifyError === "function") { + breaker.classifyError = options.classifyError; + } breaker._persistToDb(); } return breaker; diff --git a/src/shared/utils/classify429.ts b/src/shared/utils/classify429.ts new file mode 100644 index 0000000000..df0c8ea027 --- /dev/null +++ b/src/shared/utils/classify429.ts @@ -0,0 +1,243 @@ +/** + * 429 response classifier — distinguish rate-limit from quota-exhausted. + * + * Most LLM providers return HTTP 429 for two semantically different reasons: + * + * 1. **Rate-limit**: short transient back-off ("too many requests in + * the last minute"). Fix: wait the Retry-After window and retry. + * 2. **Quota-exhausted**: long-period cap hit ("daily/monthly limit + * reached"). Fix: wait until the period rolls over (could be hours + * or days). Retrying every 60s wastes calls and burns alerts. + * + * The HTTP status alone cannot disambiguate. This helper inspects the + * response body and headers to return a `FailureKind` the circuit + * breaker can use to pick the right cooldown. + * + * Companion to OmniRoute issue #2100. + * + * @module shared/utils/classify429 + */ + +export type FailureKind = "rate_limit" | "quota_exhausted" | "transient"; + +/** + * Heuristic regexes for "explicit quota exhausted" vs "rate-limited" + * detection in 429 error bodies. A 429 alone never implies quota + * exhausted — only an explicit keyword does. + * + * Patterns observed across OpenAI, Anthropic, Groq, Cerebras, Mistral, + * Google Gemini, and OpenRouter free-tier responses. + */ +const QUOTA_PATTERNS: ReadonlyArray<RegExp> = [ + /daily.*limit/i, + /daily.*quota/i, + /per.?day.*limit/i, + /monthly.*limit/i, + /monthly.*quota/i, + /per.?month.*limit/i, + /quota.*exceed/i, + /exceed.*quota/i, + /insufficient.*quota/i, + /billing.*cap/i, + /credit.*exhaust/i, + /out of credits/i, + /hard.?limit/i, + /plan.*limit/i, +]; + +/** + * Best-effort case-insensitive header lookup. + */ +function getHeader(headers: Record<string, string> | undefined, name: string): string | undefined { + if (!headers) return undefined; + const target = name.toLowerCase(); + for (const [k, v] of Object.entries(headers)) { + if (k.toLowerCase() === target) return v; + } + return undefined; +} + +/** + * Coerce a body of unknown shape to a string for keyword scanning. + * - string: returned as-is + * - object: JSON-stringified (so nested error.message gets scanned) + * - undefined/null: empty string + */ +function bodyToText(body: unknown): string { + if (typeof body === "string") return body; + if (body == null) return ""; + try { + return JSON.stringify(body); + } catch { + return ""; + } +} + +/** + * Returns true if the body looks like an explicit quota-exhausted + * error — i.e. the upstream is telling us a long-period cap was hit. + */ +export function looksLikeQuotaExhausted(body: unknown): boolean { + const text = bodyToText(body); + if (!text) return false; + return QUOTA_PATTERNS.some((pat) => pat.test(text)); +} + +/** + * Classify a 429 (or any) response into a `FailureKind`. + * + * Decision order: + * 1. status !== 429 → `"transient"` (don't pretend to know more than + * the caller does about non-429 failures). + * 2. body matches a quota keyword → `"quota_exhausted"`. + * 3. otherwise → `"rate_limit"` (default for 429 — even without + * Retry-After, a 429 is per definition a rate-limit signal). + * + * @param response - the upstream response with status, optional headers, + * optional body. Headers are looked up + * case-insensitively. + */ +export function classify429(response: { + status: number; + headers?: Record<string, string>; + body?: unknown; +}): FailureKind { + if (response.status !== 429) return "transient"; + if (looksLikeQuotaExhausted(response.body)) return "quota_exhausted"; + return "rate_limit"; +} + +/** + * Parse a `Retry-After` header value into seconds. + * + * Accepts: + * - integer seconds: `"60"` + * - HTTP date: `"Wed, 08 May 2026 03:00:00 GMT"` + * - Groq-style relative: `"60s"`, `"5m"`, `"2h"` + * + * Returns `null` if unparseable. + * + * Note: integer seconds vs Groq relative units are easy to confuse — + * `parseInt("5m", 10)` returns `5` (parses leading digits and ignores + * trailing). This helper checks the relative-unit pattern FIRST. + */ +export function parseRetryAfter(headerValue: string | undefined): number | null { + if (!headerValue) return null; + const trimmed = headerValue.trim(); + if (!trimmed) return null; + + // Groq-style relative: must check BEFORE plain int parse. + const relMatch = trimmed.match(/^(\d+)([smh])$/i); + if (relMatch) { + const n = Number(relMatch[1]); + const unit = relMatch[2].toLowerCase(); + if (Number.isFinite(n)) { + if (unit === "s") return n; + if (unit === "m") return n * 60; + if (unit === "h") return n * 3600; + } + } + + // Pure integer seconds. + if (/^\d+$/.test(trimmed)) { + const n = Number(trimmed); + return Number.isFinite(n) ? n : null; + } + + // HTTP date. + const ts = Date.parse(trimmed); + if (Number.isFinite(ts)) { + return Math.max(0, Math.floor((ts - Date.now()) / 1000)); + } + + return null; +} + +/** + * Convenience wrapper: pull the Retry-After from a response's headers + * and parse it to seconds. Returns null if absent or unparseable. + */ +export function retryAfterFromResponse(response: { + headers?: Record<string, string>; +}): number | null { + return parseRetryAfter(getHeader(response.headers, "retry-after")); +} + +/** + * Normalize an unknown headers-like value into a plain `Record<string, string>`. + * Native `Headers` (from `fetch`) does NOT respond to `Object.entries` — it + * exposes `.entries()` instead. Without this normalization, `getHeader` would + * silently miss every header on a Headers instance. + */ +function normalizeHeaders(raw: unknown): Record<string, string> | undefined { + if (raw === null || typeof raw !== "object") return undefined; + const maybeIter = (raw as { entries?: unknown }).entries; + if (typeof maybeIter === "function") { + try { + return Object.fromEntries((raw as { entries: () => Iterable<[string, string]> }).entries()); + } catch { + // fall through to plain-object treatment + } + } + return raw as Record<string, string>; +} + +/** + * Adapter that takes an error thrown by an HTTP client (fetch wrapper, axios, + * upstream SDK, etc.) and produces a {@link FailureKind} suitable for the + * `classifyError` option of the circuit breaker. + * + * Recognises the common error shapes: + * - `err.status` + `err.headers` + `err.body` (low-level fetch wrapper) + * - `err.response.status` + `err.response.headers` + `err.response.data` (axios-style) + * - `err.message` (last-resort body for keyword scan) + * + * Returns `undefined` when the error doesn't carry enough information to + * classify, so the breaker can decide what to do without a kind tag. + * + * Companion to issue #2100 follow-up. + */ +export function classify429FromError(err: unknown): FailureKind | undefined { + if (err === null || typeof err !== "object") return undefined; + const e = err as Record<string, unknown>; + + let status: number | undefined; + let headers: Record<string, string> | undefined; + let body: unknown; + + if (typeof e.status === "number") { + status = e.status; + } + if (typeof e.statusCode === "number" && status === undefined) { + status = e.statusCode; + } + + if (e.response && typeof e.response === "object") { + const resp = e.response as Record<string, unknown>; + if (typeof resp.status === "number" && status === undefined) { + status = resp.status; + } + if (resp.headers && typeof resp.headers === "object") { + headers = normalizeHeaders(resp.headers); + } + if (resp.data !== undefined) { + body = resp.data; + } else if (typeof resp.body !== "undefined") { + body = resp.body; + } + } + + if (headers === undefined && e.headers && typeof e.headers === "object") { + headers = normalizeHeaders(e.headers); + } + if (body === undefined) { + if (typeof e.body !== "undefined") { + body = e.body; + } else if (typeof e.message === "string") { + body = e.message; + } + } + + if (typeof status !== "number") return undefined; + return classify429({ status, headers, body }); +} diff --git a/src/shared/utils/fetchTimeout.ts b/src/shared/utils/fetchTimeout.ts index cfc36205ff..55efe599ac 100644 --- a/src/shared/utils/fetchTimeout.ts +++ b/src/shared/utils/fetchTimeout.ts @@ -7,7 +7,8 @@ * @module shared/utils/fetchTimeout */ -const DEFAULT_TIMEOUT_MS = 120000; // 2 minutes +const DEFAULT_TIMEOUT_MS = + parseInt(process.env.OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS || "", 10) || 120000; // 2 minutes const FETCH_TIMEOUT_MS = parseInt(process.env.FETCH_TIMEOUT_MS || "", 10) || DEFAULT_TIMEOUT_MS; interface FetchTimeoutOptions extends RequestInit { diff --git a/src/shared/utils/providerHints.ts b/src/shared/utils/providerHints.ts new file mode 100644 index 0000000000..e5a375575b --- /dev/null +++ b/src/shared/utils/providerHints.ts @@ -0,0 +1,73 @@ +/** + * Per-provider default policy for upstream 429 hint trust. + * + * @see Issue #2100 follow-up — surface a user-overridable per-profile toggle + * that decides whether the circuit breaker uses upstream 429 body / Retry-After + * hints (`classify429`, `cooldownByKind`) to differentiate rate-limit from + * quota-exhausted failure cooldowns. + * + * This helper returns the **default** answer for a given provider. The actual + * runtime decision is the user override (if any) OR this default. See + * `accountFallback.ts` / `chat.ts` / `chatHelpers.ts` for the resolution + * call sites: + * + * ```ts + * const userValue = providerProfile.useUpstream429BreakerHints; // boolean | undefined + * const useHints = userValue !== undefined + * ? userValue + * : defaultUseUpstream429BreakerHints(provider); + * ``` + * + * Default policy: direct cloud providers default `true` because their 429 + * bodies and `Retry-After` headers are authoritative. Reverse-proxy / + * self-hosted / CLI-backed providers default `false` because forwarded 429 + * metadata is often unreliable or fabricated by the proxy. + * + * @module shared/utils/providerHints + */ + +import { + UPSTREAM_PROXY_PROVIDERS, + SELF_HOSTED_CHAT_PROVIDER_IDS, + isLocalProvider, + isClaudeCodeCompatibleProvider, +} from "../constants/providers"; + +/** + * Conservative per-provider default for `useUpstream429BreakerHints`. + * + * Returns `false` for any provider whose 429 metadata may be forwarded by + * an intermediary (proxy, self-hosted runtime, CLI wrapper). Returns `true` + * for direct cloud providers where the upstream response is authoritative. + */ +export function defaultUseUpstream429BreakerHints(providerId: string): boolean { + if (Object.prototype.hasOwnProperty.call(UPSTREAM_PROXY_PROVIDERS, providerId)) { + return false; + } + if (isLocalProvider(providerId)) { + return false; + } + if (SELF_HOSTED_CHAT_PROVIDER_IDS.has(providerId)) { + return false; + } + if (isClaudeCodeCompatibleProvider(providerId)) { + return false; + } + return true; +} + +/** + * Resolve the effective `useHints` decision: the user override wins if set, + * otherwise fall back to the per-provider default. + * + * `undefined` means "not user-set" and triggers the default lookup. + */ +export function resolveUseUpstream429BreakerHints( + providerId: string, + userValue: boolean | undefined +): boolean { + if (userValue !== undefined) { + return userValue; + } + return defaultUseUpstream429BreakerHints(providerId); +} diff --git a/src/shared/utils/rateLimiter.ts b/src/shared/utils/rateLimiter.ts index 14fc5a89fe..e736c3b414 100644 --- a/src/shared/utils/rateLimiter.ts +++ b/src/shared/utils/rateLimiter.ts @@ -3,11 +3,10 @@ import Redis from "ioredis"; // Reuse existing REDIS_URL if set, or local redis via default docker-compose // Use REDIS_URL from env (Docker/Production) or fallback to local redis const REDIS_URL = process.env.REDIS_URL || "redis://localhost:6379"; -if (process.env.NODE_ENV === 'production' && !process.env.REDIS_URL) { - console.warn('[REDIS] REDIS_URL is not set in production. Falling back to default.'); +if (process.env.NODE_ENV === "production" && !process.env.REDIS_URL) { + console.warn("[REDIS] REDIS_URL is not set in production. Falling back to default."); } - let redisClient: Redis | null = null; export function getRedisClient() { @@ -17,9 +16,9 @@ export function getRedisClient() { enableReadyCheck: false, retryStrategy(times) { return Math.min(times * 50, 2000); // Exponential backoff - } + }, }); - redisClient.on('error', (err) => console.error('[REDIS] Error:', err.message)); + redisClient.on("error", (err) => console.error("[REDIS] Error:", err.message)); } return redisClient; } @@ -88,14 +87,17 @@ export function setRateLimiterTestMode(enabled: boolean) { * Checks multi-window rate limits for an API key atomically via Redis. */ export async function checkRateLimit( - keyId: string, + keyId: string, rules: RateLimitRule[] ): Promise<RateLimitResult> { if (!rules || rules.length === 0) return { allowed: true }; // ── In-memory mock for unit tests ── - const isTestMode = explicitTestMode || process.env.NODE_ENV === "test" || process.env.DISABLE_SQLITE_AUTO_BACKUP === "true"; - + const isTestMode = + explicitTestMode || + process.env.NODE_ENV === "test" || + process.env.DISABLE_SQLITE_AUTO_BACKUP === "true"; + if (isTestMode) { const now = Math.floor(Date.now() / 1000); for (const rule of rules) { @@ -116,27 +118,25 @@ export async function checkRateLimit( const redis = getRedisClient(); const args: (string | number)[] = [Math.floor(Date.now() / 1000)]; - + for (const rule of rules) { args.push(rule.limit, rule.window); } try { - const result = await redis.eval( - RATE_LIMIT_SCRIPT, - 1, - `rl:api_key:${keyId}`, - ...args - ) as [number, number]; + const result = (await redis.eval(RATE_LIMIT_SCRIPT, 1, `rl:api_key:${keyId}`, ...args)) as [ + number, + number, + ]; if (result[0] === 0) { return { allowed: false, failedWindow: result[1] }; } - + return { allowed: true }; } catch (error) { // Fail-open strategy if Redis goes down to prevent complete API outage console.error("[RATE_LIMITER] Redis eval failed, bypassing rate limit:", error); - return { allowed: true }; + return { allowed: true }; } } diff --git a/src/shared/utils/runtimeTimeouts.ts b/src/shared/utils/runtimeTimeouts.ts index 672466a1c2..67ff3e0e39 100644 --- a/src/shared/utils/runtimeTimeouts.ts +++ b/src/shared/utils/runtimeTimeouts.ts @@ -8,10 +8,11 @@ type ReadTimeoutOptions = { export const DEFAULT_FETCH_TIMEOUT_MS = 600_000; export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 600_000; +export const DEFAULT_SSE_HEARTBEAT_INTERVAL_MS = 15_000; export const DEFAULT_STREAM_READINESS_TIMEOUT_MS = 30_000; export const DEFAULT_FETCH_CONNECT_TIMEOUT_MS = 30_000; export const DEFAULT_FETCH_KEEPALIVE_TIMEOUT_MS = 4_000; -export const DEFAULT_API_BRIDGE_PROXY_TIMEOUT_MS = 30_000; +export const DEFAULT_API_BRIDGE_PROXY_TIMEOUT_MS = 600_000; export const DEFAULT_API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS = 300_000; export const DEFAULT_API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS = 60_000; export const DEFAULT_API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS = 5_000; @@ -25,6 +26,7 @@ function hasEnvValue(env: EnvSource, name: string): boolean { export type UpstreamTimeoutConfig = { fetchTimeoutMs: number; streamIdleTimeoutMs: number; + sseHeartbeatIntervalMs: number; streamReadinessTimeoutMs: number; fetchHeadersTimeoutMs: number; fetchBodyTimeoutMs: number; @@ -100,11 +102,21 @@ export function getUpstreamTimeoutConfig( logger, } ); + const sseHeartbeatIntervalMs = readTimeoutMs( + env, + "SSE_HEARTBEAT_INTERVAL_MS", + DEFAULT_SSE_HEARTBEAT_INTERVAL_MS, + { + allowZero: true, + logger, + } + ); return { fetchTimeoutMs, streamIdleTimeoutMs, streamReadinessTimeoutMs, + sseHeartbeatIntervalMs, fetchHeadersTimeoutMs: readTimeoutMs(env, "FETCH_HEADERS_TIMEOUT_MS", fetchTimeoutMs, { allowZero: true, logger, diff --git a/src/shared/validation/schemas.ts b/src/shared/validation/schemas.ts index ae5aeb25cb..2939886594 100644 --- a/src/shared/validation/schemas.ts +++ b/src/shared/validation/schemas.ts @@ -6,7 +6,7 @@ import { import { SUPPORTED_BATCH_ENDPOINTS } from "@/shared/constants/batchEndpoints"; import { MAX_REQUEST_BODY_LIMIT_MB, MIN_REQUEST_BODY_LIMIT_MB } from "@/shared/constants/bodySize"; import { COMBO_CONFIG_MODES } from "@/shared/constants/comboConfigMode"; -import { isLocalProvider } from "@/shared/constants/providers"; +import { providerAllowsOptionalApiKey } from "@/shared/constants/providers"; import { HIDEABLE_SIDEBAR_ITEM_IDS } from "@/shared/constants/sidebarVisibility"; import { isForbiddenUpstreamHeaderName } from "@/shared/constants/upstreamHeaders"; @@ -259,10 +259,7 @@ export const createProviderSchema = z }) .superRefine((data, ctx) => { const apiKey = typeof data.apiKey === "string" ? data.apiKey.trim() : ""; - const apiKeyOptional = - data.provider === "searxng-search" || - data.provider === "petals" || - isLocalProvider(data.provider); + const apiKeyOptional = providerAllowsOptionalApiKey(data.provider); if (!apiKeyOptional && apiKey.length === 0) { ctx.addIssue({ code: z.ZodIssueCode.custom, @@ -775,6 +772,11 @@ const connectionCooldownProfileSchema = z .object({ baseCooldownMs: z.number().int().min(0).optional(), useUpstreamRetryHints: z.boolean().optional(), + // Issue #2100 follow-up: per-profile toggle for upstream 429 hint trust. + // `null` is an explicit unset sentinel — PATCH handler deletes the key + // from stored settings so the per-provider default resolves at runtime. + // `undefined` (key omitted) means "leave existing value unchanged". + useUpstream429BreakerHints: z.boolean().nullable().optional(), maxBackoffSteps: z.number().int().min(0).optional(), }) .strict(); @@ -1264,6 +1266,12 @@ export const oauthPollSchema = z.object({ extraData: z.unknown().optional(), }); +/** Import a raw API token (e.g. WINDSURF_API_KEY) without going through the browser OAuth flow. */ +export const oauthImportTokenSchema = z.object({ + token: z.string().trim().min(1, "Token is required"), + connectionId: z.string().optional(), +}); + export const cursorImportSchema = z.object({ accessToken: z.string().trim().min(1, "Access token is required"), machineId: z.string().trim().optional(), @@ -1614,6 +1622,7 @@ export const providersBatchTestSchema = z "audio", "local", "upstream-proxy", + "cloud-agent", ]), // Frontend may send null when mode != 'provider' — accept and treat as missing providerId: z.string().trim().min(1).nullable().optional(), @@ -1792,9 +1801,11 @@ export const v1SearchSchema = z "tavily-search", "google-pse-search", "linkup-search", + "ollama-search", "searchapi-search", "youcom-search", "searxng-search", + "zai-search", ]) .optional(), max_results: z.coerce.number().int().min(1).max(100).default(5), diff --git a/src/shared/validation/settingsSchemas.ts b/src/shared/validation/settingsSchemas.ts index 2e4973b22b..7a5b1b3411 100644 --- a/src/shared/validation/settingsSchemas.ts +++ b/src/shared/validation/settingsSchemas.ts @@ -104,6 +104,11 @@ export const updateSettingsSchema = z.object({ lkgpEnabled: z.boolean().optional(), backgroundDegradation: z.unknown().optional(), bruteForceProtection: z.boolean().optional(), + // Auto-routing settings + autoRoutingEnabled: z.boolean().optional(), + autoRoutingDefaultVariant: z + .enum(["lkgp", "coding", "fast", "cheap", "offline", "smart"]) + .optional(), }); export const databaseSettingsSchema = z.object( diff --git a/src/sse/handlers/chat.ts b/src/sse/handlers/chat.ts index 56cbee63d9..03d257337c 100644 --- a/src/sse/handlers/chat.ts +++ b/src/sse/handlers/chat.ts @@ -3,6 +3,8 @@ import { getProviderCredentialsWithQuotaPreflight, markAccountUnavailable, extractApiKey, + isValidApiKey, + extractSessionAffinityKey, } from "../services/auth"; import { getRuntimeProviderProfile, @@ -23,6 +25,7 @@ import { getModelTargetFormat, PROVIDER_ID_TO_ALIAS, } from "@omniroute/open-sse/config/providerModels.ts"; +import type { AutoVariant } from "@omniroute/open-sse/services/autoCombo/autoPrefix.ts"; import * as log from "../utils/logger"; import { checkAndRefreshToken } from "../services/tokenRefresh"; import { deleteHandoff, getHandoff } from "@/lib/db/contextHandoffs"; @@ -43,6 +46,8 @@ import { } from "./chatHelpers"; // Pipeline integration — wired modules +import { classify429FromError, type FailureKind } from "@/shared/utils/classify429"; +import { resolveUseUpstream429BreakerHints } from "@/shared/utils/providerHints"; import { getCircuitBreaker } from "../../shared/utils/circuitBreaker"; import { markAccountExhaustedFrom429 } from "../../domain/quotaCache"; import { RequestTelemetry, recordTelemetry } from "../../shared/utils/requestTelemetry"; @@ -208,6 +213,7 @@ export async function handleChat(request: any, clientRawRequest: any = null) { // T04: client-provided external session header has priority over generated fingerprint. const externalSessionId = extractExternalSessionId(request.headers); const sessionId = externalSessionId || generateStableSessionId(body); + const sessionAffinityKey = extractSessionAffinityKey(body, request.headers) || sessionId; const requestedConnectionId = request.headers.get("x-omniroute-connection")?.trim() || null; if (sessionId) { touchSession(sessionId); @@ -229,9 +235,9 @@ export async function handleChat(request: any, clientRawRequest: any = null) { // Guardrail pre-call pipeline — prompt injection, PII masking, and future custom rules. telemetry.startPhase("validate"); const preCallGuardrails = await guardrailRegistry.runPreCallHooks(body, { - apiKeyInfo, + apiKeyInfo: apiKeyInfo as any, disabledGuardrails: resolveDisabledGuardrails({ - apiKeyInfo: apiKeyInfo as Record<string, unknown> | null, + apiKeyInfo: (apiKeyInfo ?? null) as any, body, headers: request.headers, }), @@ -295,6 +301,44 @@ export async function handleChat(request: any, clientRawRequest: any = null) { telemetry.endPhase(); } + // ── Zero-Config Auto-Routing (auto and auto/ prefix) ──────────────────────── + // If the model ID is "auto" or starts with "auto/", bypass DB combo lookup + // entirely and generate a virtual auto-combo on-the-fly from connected providers. + let autoVariant: AutoVariant | undefined; + let isAutoRouting = resolvedModelStr === "auto" || resolvedModelStr.startsWith("auto/"); + if (isAutoRouting) { + // C2: Enforce autoRoutingEnabled setting + const settings = await getSettings(); + if (settings?.autoRoutingEnabled === false) { + return errorResponse( + HTTP_STATUS.BAD_REQUEST, + "Auto routing is disabled. Enable it in Settings > Routing." + ); + } + + try { + const { parseAutoPrefix } = + await import("@omniroute/open-sse/services/autoCombo/autoPrefix.ts"); + const parsed = parseAutoPrefix(resolvedModelStr); + if (parsed.valid) { + autoVariant = parsed.variant; + // C3: Apply autoRoutingDefaultVariant from settings when bare "auto" is used + if (autoVariant === undefined && settings?.autoRoutingDefaultVariant) { + autoVariant = settings.autoRoutingDefaultVariant as AutoVariant; + } + log.info( + "AUTO", + `Zero-config routing variant: ${autoVariant || "default"} (model=${resolvedModelStr})` + ); + } else { + log.warn("AUTO", `Invalid auto prefix format: ${resolvedModelStr}`); + } + } catch (err) { + log.error("AUTO", "Failed to load auto-prefix parser", { err }); + } + } + // ──────────────────────────────────────────────────────────────────────────── + // Check if model is a combo (has multiple models with fallback) telemetry.startPhase("resolve"); let combo: any = await getComboForModel(resolvedModelStr); @@ -312,6 +356,23 @@ export async function handleChat(request: any, clientRawRequest: any = null) { } } + // Auto-prefix short-circuit: if auto/ prefix was detected, replace combo with virtual one + if (isAutoRouting && combo === null) { + try { + const { createVirtualAutoCombo } = + await import("@omniroute/open-sse/services/autoCombo/virtualFactory.ts"); + const virtualCombo = await createVirtualAutoCombo(autoVariant); + virtualCombo.name = resolvedModelStr; + virtualCombo.id = resolvedModelStr; + combo = virtualCombo; + log.info( + "AUTO", + `Virtual auto-combo created: ${combo.name} (${virtualCombo.candidatePool?.length || 0} candidates)` + ); + } catch (err) { + log.error("AUTO", "Failed to create virtual auto-combo", { err }); + } + } if (combo) { log.info( "CHAT", @@ -358,6 +419,7 @@ export async function handleChat(request: any, clientRawRequest: any = null) { allowedConnections, resolvedModel, { + sessionKey: sessionAffinityKey, ...(target?.connectionId ? { forcedConnectionId: target.connectionId } : {}), } ); @@ -388,6 +450,7 @@ export async function handleChat(request: any, clientRawRequest: any = null) { connectionId?: string | null; executionKey?: string | null; stepId?: string | null; + allowedConnectionIds?: string[] | null; } ) => handleSingleModelChat( @@ -400,6 +463,7 @@ export async function handleChat(request: any, clientRawRequest: any = null) { telemetry, { sessionId, + sessionAffinityKey, forceLiveComboTest: isComboLiveTest, forcedConnectionId: target?.connectionId ?? null, allowedConnectionIds: target?.allowedConnectionIds ?? null, @@ -450,7 +514,12 @@ export async function handleChat(request: any, clientRawRequest: any = null) { combo.name, apiKeyInfo, telemetry, - { sessionId, emergencyFallbackTried: true, forceLiveComboTest: isComboLiveTest }, + { + sessionId, + sessionAffinityKey, + emergencyFallbackTried: true, + forceLiveComboTest: isComboLiveTest, + }, combo.strategy, true ); @@ -486,6 +555,7 @@ export async function handleChat(request: any, clientRawRequest: any = null) { telemetry, { sessionId, + sessionAffinityKey, forceLiveComboTest: isComboLiveTest, forcedConnectionId: requestedConnectionId, }, @@ -524,6 +594,7 @@ async function handleSingleModelChat( emergencyFallbackTried?: boolean; forceLiveComboTest?: boolean; sessionId?: string | null; + sessionAffinityKey?: string | null; forcedConnectionId?: string | null; allowedConnectionIds?: string[] | null; comboStepId?: string | null; @@ -590,7 +661,7 @@ async function handleSingleModelChat( }); } - const { provider, model, sourceFormat, targetFormat, extendedContext } = resolved; + const { provider, model, sourceFormat, targetFormat, extendedContext, apiFormat } = resolved; const forceLiveComboTest = runtimeOptions.forceLiveComboTest === true; const hasForcedConnection = typeof runtimeOptions.forcedConnectionId === "string" && @@ -615,11 +686,25 @@ async function handleSingleModelChat( }); if (gate) return gate; + // Issue #2100 follow-up: opt-in upstream 429 hint trust per provider. + const useHints429 = resolveUseUpstream429BreakerHints( + provider, + (providerProfile as { useUpstream429BreakerHints?: boolean }).useUpstream429BreakerHints + ); const breaker = getCircuitBreaker(provider, { failureThreshold: providerProfile.failureThreshold, resetTimeout: providerProfile.resetTimeoutMs, onStateChange: (name: string, from: string, to: string) => log.info("CIRCUIT", `${name}: ${from} → ${to}`), + ...(useHints429 + ? { + cooldownByKind: { + rate_limit: 60_000, + quota_exhausted: 3_600_000, + } satisfies Partial<Record<FailureKind, number>>, + classifyError: classify429FromError, + } + : {}), }); const userAgent = request?.headers?.get("user-agent") || ""; @@ -670,6 +755,7 @@ async function handleSingleModelChat( effectiveAllowedConnections, model, { + sessionKey: runtimeOptions.sessionAffinityKey ?? runtimeOptions.sessionId ?? null, excludeConnectionIds: Array.from(excludedConnectionIds), ...(forceLiveComboTest ? { @@ -815,6 +901,7 @@ async function handleSingleModelChat( comboStepId: runtimeOptions.comboStepId ?? null, comboExecutionKey: runtimeOptions.comboExecutionKey ?? runtimeOptions.comboStepId ?? null, extendedContext, + modelApiFormat: apiFormat, providerProfile, cachedSettings: runtimeOptions.cachedSettings, }); @@ -861,6 +948,25 @@ async function handleSingleModelChat( return result.response; } + if (result.errorType === "account_semaphore_capacity") { + // Local concurrency pressure is not an upstream quota failure. Prefer another + // account when possible; pinned combo steps fall through to combo orchestration. + if (hasForcedConnection) { + return result.response; + } + + log.warn( + "AUTH", + `Account ${accountId}... at local concurrency cap, trying fallback account` + ); + excludedConnectionIds.add(credentials.connectionId); + lastError = result.error; + lastStatus = result.status; + requestRetryLastError = result.error; + requestRetryLastStatus = result.status; + continue; + } + // Emergency fallback for budget exhaustion (402 / billing / quota keywords): // reroute to a free model (default provider/model: nvidia + openai/gpt-oss-120b) exactly once. if (!runtimeOptions.emergencyFallbackTried) { @@ -959,15 +1065,18 @@ async function handleSingleModelChat( dailyQuotaExhausted = true; } - // 7. Mark account as quota-exhausted on 429 response (non-daily-quota errors) - // For providers that route quota/cooldown at model scope, a 429 on one model - // does not mean the whole connection is exhausted. - // Daily quota errors are handled above; only process regular rate_limit here + // 7. Mark account as quota-exhausted only for explicit long-window quota signals. + // A plain 429/high-traffic response should trigger fallback/cooldown, not poison + // quotaCache as exhausted for 5 minutes while usage quota may still be available. if (!dailyQuotaExhausted) { const passthroughModels = credentials.providerSpecificData?.passthroughModels; + const failureKind = + result.status === 429 + ? classify429FromError({ status: result.status, message: errorStr }) + : undefined; if ( result.status === 429 && - shouldMarkAccountExhaustedFrom429(provider, model, passthroughModels) + shouldMarkAccountExhaustedFrom429(provider, model, passthroughModels, failureKind) ) { markAccountExhaustedFrom429(credentials.connectionId, provider); } diff --git a/src/sse/handlers/chatHelpers.ts b/src/sse/handlers/chatHelpers.ts index 3792a2b26a..ec4dc2774a 100644 --- a/src/sse/handlers/chatHelpers.ts +++ b/src/sse/handlers/chatHelpers.ts @@ -25,6 +25,9 @@ import { } from "@omniroute/open-sse/utils/proxyFetch.ts"; import { resolveProxyForConnection } from "@/lib/localDb"; import { CircuitBreakerOpenError, getCircuitBreaker } from "../../shared/utils/circuitBreaker"; +import { classify429FromError, type FailureKind } from "../../shared/utils/classify429"; +import { resolveUseUpstream429BreakerHints } from "../../shared/utils/providerHints"; + import { logProxyEvent } from "../../lib/proxyLogger"; import { logTranslationEvent } from "../../lib/translatorEvents"; import { getRuntimeProviderProfile } from "@omniroute/open-sse/services/accountFallback.ts"; @@ -204,9 +207,16 @@ export async function resolveModelOrError( } const { provider, model, extendedContext } = modelInfo; + // apiFormat: optional custom-model marker — see chatCore.ts for shape narrowing rationale. + const apiFormat: string | undefined = + modelInfo && typeof modelInfo === "object" && "apiFormat" in modelInfo + ? typeof (modelInfo as { apiFormat?: unknown }).apiFormat === "string" + ? ((modelInfo as { apiFormat?: string }).apiFormat as string) + : undefined + : undefined; const providerAlias = PROVIDER_ID_TO_ALIAS[provider] || provider; let targetFormat = getModelTargetFormat(providerAlias, model) || getTargetFormat(provider); - if ((modelInfo as any).apiFormat === "responses") { + if (apiFormat === "responses") { targetFormat = "openai-responses"; log.info("ROUTING", `Custom model apiFormat=responses → targetFormat=openai-responses`); } @@ -218,7 +228,7 @@ export async function resolveModelOrError( log.info("ROUTING", `Provider: ${provider}, Model: ${model}${ctxTag}`); } - return { provider, model, sourceFormat, targetFormat, extendedContext }; + return { provider, model, sourceFormat, targetFormat, extendedContext, apiFormat }; } export async function checkPipelineGates( @@ -238,11 +248,25 @@ export async function checkPipelineGates( ) { const bypassReason = options.bypassReason || "pipeline override"; const providerProfile = options.providerProfile ?? (await getRuntimeProviderProfile(provider)); + // Issue #2100 follow-up: opt-in upstream 429 hint trust per provider. + const useHints429 = resolveUseUpstream429BreakerHints( + provider, + (providerProfile as { useUpstream429BreakerHints?: boolean }).useUpstream429BreakerHints + ); const breaker = getCircuitBreaker(provider, { failureThreshold: providerProfile.failureThreshold ?? providerProfile.circuitBreakerThreshold, resetTimeout: providerProfile.resetTimeoutMs ?? providerProfile.circuitBreakerReset, onStateChange: (name: string, from: string, to: string) => log.info("CIRCUIT", `${name}: ${from} → ${to}`), + ...(useHints429 + ? { + cooldownByKind: { + rate_limit: 60_000, + quota_exhausted: 3_600_000, + } satisfies Partial<Record<FailureKind, number>>, + classifyError: classify429FromError, + } + : {}), }); if (options.ignoreCircuitBreaker && !breaker.canExecute()) { log.info("CIRCUIT", `Bypassing OPEN circuit breaker for ${provider} (${bypassReason})`); @@ -275,6 +299,7 @@ export async function executeChatWithBreaker({ comboStepId, comboExecutionKey, extendedContext, + modelApiFormat, providerProfile, cachedSettings, }: any): Promise<{ result: any; tlsFingerprintUsed: boolean }> { @@ -285,7 +310,7 @@ export async function executeChatWithBreaker({ runWithProxyContext(proxyInfo?.proxy || null, () => (handleChatCore as any)({ body: { ...body, model: `${provider}/${model}` }, - modelInfo: { provider, model, extendedContext }, + modelInfo: { provider, model, extendedContext, apiFormat: modelApiFormat }, credentials: refreshedCredentials, log: handlerLog, clientRawRequest, diff --git a/src/sse/services/auth.ts b/src/sse/services/auth.ts index 5af85cc791..210fb66a4e 100644 --- a/src/sse/services/auth.ts +++ b/src/sse/services/auth.ts @@ -1326,21 +1326,26 @@ export async function getProviderCredentialsWithQuotaPreflight( return credentials; } - const preflight = await preflightQuota(provider, credentials.connectionId, credentials); + const connectionId = credentials.connectionId; + if (!connectionId) { + return credentials; + } + + const preflight = await preflightQuota(provider, connectionId, credentials); if (preflight.proceed) { return credentials; } blockedByPreflight.push({ - id: credentials.connectionId, + id: connectionId, quotaPercent: preflight.quotaPercent, resetAt: preflight.resetAt ?? null, }); - excludedConnectionIds.add(credentials.connectionId); + excludedConnectionIds.add(connectionId); log.info( "AUTH", - `${provider} | preflight blocked ${credentials.connectionId.slice(0, 8)}${ + `${provider} | preflight blocked ${connectionId.slice(0, 8)}${ Number.isFinite(preflight.quotaPercent) ? ` at ${Math.round((preflight.quotaPercent as number) * 100)}%` : "" diff --git a/src/sse/services/model.ts b/src/sse/services/model.ts index e1f2b64d23..68cc9f867c 100644 --- a/src/sse/services/model.ts +++ b/src/sse/services/model.ts @@ -43,6 +43,18 @@ export async function getModelInfo(modelStr) { const parsed = parseModel(modelStr); const { extendedContext } = parsed; + const attachCustomApiFormat = async (info: any) => { + if (!info?.provider || !info?.model) return info; + const apiFormat = await lookupCustomModelApiFormat(String(info.provider), String(info.model)); + if (apiFormat) { + return { + ...info, + apiFormat, + }; + } + return info; + }; + // Check custom provider nodes first (for both alias and non-alias formats) if (parsed.providerAlias || parsed.provider) { // Ensure prefixToCheck is always a concise identifier, not a full model string @@ -94,10 +106,10 @@ export async function getModelInfo(modelStr) { } if (!parsed.isAlias) { - return getModelInfoCore(modelStr, null); + return await attachCustomApiFormat(await getModelInfoCore(modelStr, null)); } - return getModelInfoCore(modelStr, getModelAliases); + return await attachCustomApiFormat(await getModelInfoCore(modelStr, getModelAliases)); } /** diff --git a/test-kiro.ts b/test-kiro.ts deleted file mode 100644 index 943462dbd2..0000000000 --- a/test-kiro.ts +++ /dev/null @@ -1,17 +0,0 @@ -import { buildKiroPayload } from "./open-sse/translator/request/openai-to-kiro.js"; - -const messages = []; -for (let i = 0; i < 2; i++) { - messages.push({ role: "user", content: `user ${i}` }); - messages.push({ role: "assistant", content: `assistant ${i}` }); -} -messages.push({ role: "user", content: "use tool" }); -messages.push({ - role: "assistant", - tool_calls: [{ id: "call_1", function: { name: "test", arguments: "{}" } }], -}); -messages.push({ role: "tool", tool_call_id: "call_1", content: "ok" }); -messages.push({ role: "user", content: "last user" }); - -const payload = buildKiroPayload("kr/claude-sonnet-4.5", { messages, tools: [] }, false, {}); -console.log(JSON.stringify(payload, null, 2)); diff --git a/tests/e2e/protocol-clients.test.ts b/tests/e2e/protocol-clients.test.ts index 0193e8bce5..912b4724f7 100644 --- a/tests/e2e/protocol-clients.test.ts +++ b/tests/e2e/protocol-clients.test.ts @@ -1,4 +1,4 @@ -import { describe, it, expect } from "vitest"; +import { beforeAll, describe, it, expect } from "vitest"; import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"; @@ -87,6 +87,14 @@ async function consumeA2AStream(response: Response): Promise<{ } describe("Protocol clients E2E", () => { + beforeAll(async () => { + const response = await apiFetch("/api/settings", { + method: "PATCH", + body: JSON.stringify({ a2aEnabled: true }), + }); + expect([200, 401]).toContain(response.status); + }); + it( "connects via MCP stdio and invokes required tools", async () => { diff --git a/tests/fixtures/cursor/.gitignore b/tests/fixtures/cursor/.gitignore index ee0bf80a07..fd10f15f69 100644 --- a/tests/fixtures/cursor/.gitignore +++ b/tests/fixtures/cursor/.gitignore @@ -1,4 +1,4 @@ -# Captured cursor wire bytes from scripts/cursor-tap.cjs. +# Captured cursor wire bytes from scripts/ad-hoc/cursor-tap.cjs. # By default these are local-only — uncomment a specific fixture to # include it in the repo as a regression baseline. *.bin diff --git a/tests/integration/batch-e2e-rate-limit.test.ts b/tests/integration/batch-e2e-rate-limit.test.ts index 35c49d0f6f..adb58a130b 100644 --- a/tests/integration/batch-e2e-rate-limit.test.ts +++ b/tests/integration/batch-e2e-rate-limit.test.ts @@ -111,26 +111,29 @@ function createServerProcess() { const stderrLines: string[] = []; let exitInfo: { code: number | null; signal: NodeJS.Signals | null } | null = null; - const child = spawn( - process.execPath, - ["node_modules/next/dist/bin/next", "dev", "--port", String(SERVER_PORT)], - { - cwd: REPO_ROOT, - env: { - DATA_DIR: TEST_DATA_DIR, - PORT: String(SERVER_PORT), - HOST: "127.0.0.1", - REQUIRE_API_KEY: "false", - API_KEY_SECRET: "batch-e2e-rl-secret", - DISABLE_SQLITE_AUTO_BACKUP: "true", - INITIAL_PASSWORD: "", - NEXT_TELEMETRY_DISABLED: "1", - OMNIROUTE_E2E_BOOTSTRAP_MODE: "open", - PATH: process.env.PATH, - }, - stdio: ["ignore", "pipe", "pipe"], - } - ); + const child = spawn(process.execPath, ["scripts/dev/run-next-playwright.mjs", "dev"], { + cwd: REPO_ROOT, + env: { + ...process.env, + DATA_DIR: TEST_DATA_DIR, + PORT: String(SERVER_PORT), + DASHBOARD_PORT: String(SERVER_PORT), + API_PORT: String(SERVER_PORT), + HOST: "127.0.0.1", + REQUIRE_API_KEY: "false", + API_KEY_SECRET: "batch-e2e-rl-secret", + DISABLE_SQLITE_AUTO_BACKUP: "true", + INITIAL_PASSWORD: "", + NEXT_TELEMETRY_DISABLED: "1", + OMNIROUTE_E2E_BOOTSTRAP_MODE: "open", + OMNIROUTE_DISABLE_BACKGROUND_SERVICES: "false", + OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK: "true", + OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK: "true", + OMNIROUTE_HIDE_HEALTHCHECK_LOGS: "true", + PATH: process.env.PATH, + }, + stdio: ["ignore", "pipe", "pipe"], + }); child.once("exit", (code, signal) => { exitInfo = { code, signal }; diff --git a/tests/integration/cursor-e2e.test.ts b/tests/integration/cursor-e2e.test.ts index 42175787bc..97fccb52fb 100644 --- a/tests/integration/cursor-e2e.test.ts +++ b/tests/integration/cursor-e2e.test.ts @@ -16,7 +16,7 @@ * node --import tsx/esm --test tests/integration/cursor-e2e.test.ts * * Capturing wire fixtures (separate workflow): - * CURSOR_TOKEN=... node scripts/cursor-tap.cjs single-turn-chat "say PING" + * CURSOR_TOKEN=... node scripts/ad-hoc/cursor-tap.cjs single-turn-chat "say PING" */ import test from "node:test"; diff --git a/tests/integration/integration-wiring.test.ts b/tests/integration/integration-wiring.test.ts index 8dfface716..9842e1c39d 100644 --- a/tests/integration/integration-wiring.test.ts +++ b/tests/integration/integration-wiring.test.ts @@ -294,8 +294,8 @@ describe("API Routes — dashboard and tool consumers", () => { it("keeps legacy usage history and raw request-log APIs explicitly classified", () => { const usageStats = readProjectFile("src/shared/components/UsageStats.tsx"); - const apiReference = readProjectFile("docs/API_REFERENCE.md"); - const openApi = readProjectFile("docs/openapi.yaml"); + const apiReference = readProjectFile("docs/reference/API_REFERENCE.md"); + const openApi = readProjectFile("docs/reference/openapi.yaml"); assert.ok(usageStats, "UsageStats compatibility component should exist"); assert.ok(apiReference, "API reference should exist"); @@ -343,7 +343,7 @@ describe("Dashboard Wiring — T05 payload rules", () => { const payloadRulesTabSrc = readProjectFile( "src/app/(dashboard)/dashboard/settings/components/PayloadRulesTab.tsx" ); - const openapiSrc = readProjectFile("docs/openapi.yaml"); + const openapiSrc = readProjectFile("docs/reference/openapi.yaml"); it("settings page should surface payload rules inside advanced settings", () => { assert.ok(settingsPageSrc, "settings page source should exist"); @@ -361,7 +361,7 @@ describe("Dashboard Wiring — T05 payload rules", () => { }); it("openapi should document the payload rules management surface", () => { - assert.ok(openapiSrc, "docs/openapi.yaml should exist"); + assert.ok(openapiSrc, "docs/reference/openapi.yaml should exist"); assert.match(openapiSrc, /\/api\/settings\/payload-rules:/); assert.match(openapiSrc, /summary:\s+Get payload rules configuration/); assert.match(openapiSrc, /ManagementSessionAuth:/); diff --git a/tests/integration/performance-regression.test.ts b/tests/integration/performance-regression.test.ts index 6c93076cb0..ad6c788a69 100644 --- a/tests/integration/performance-regression.test.ts +++ b/tests/integration/performance-regression.test.ts @@ -20,6 +20,7 @@ process.env.REQUIRE_API_KEY = "false"; // --- Dynamic imports after env setup --- const core = await import("../../src/lib/db/core.ts"); +const { createApiKey } = await import("../../src/lib/db/apiKeys.ts"); const { createMemory, listMemories, deleteMemory } = await import("../../src/lib/memory/store.ts"); const { retrieveMemories } = await import("../../src/lib/memory/retrieval.ts"); const { MemoryType } = await import("../../src/lib/memory/types.ts"); @@ -40,9 +41,11 @@ _db.exec("DROP TABLE IF EXISTS memory_fts"); // --- Constants --- const TEST_API_KEY_ID = "perf-test-api-key"; +const TEST_MACHINE_ID = "perf-test-machine"; const TEST_SESSION_ID = "perf-test-session"; const MEMORY_COUNT = 1000; const SKILL_COUNT = 100; +let managementApiKey = ""; // --- Thresholds (2x buffer for CI) --- const THRESHOLD_LIST_MEMORIES_MS = 200; @@ -204,6 +207,11 @@ describe("Performance: memory search (1000 records)", () => { // ============================================================ describe("Performance: memory API route handler (1000 records)", () => { before(async () => { + const key = await createApiKey("performance regression management", TEST_MACHINE_ID, [ + "manage", + ]); + managementApiKey = key.key; + // Bulk insert 1000 memories for (let i = 0; i < MEMORY_COUNT; i++) { await createMemory(makeMemoryData(i)); @@ -222,7 +230,10 @@ describe("Performance: memory API route handler (1000 records)", () => { // Create a mock Request object for the route handler const request = new Request( `http://localhost:20128/api/memory?limit=50&apiKeyId=${TEST_API_KEY_ID}`, - { method: "GET" } + { + method: "GET", + headers: { authorization: `Bearer ${managementApiKey}` }, + } ); const start = performance.now(); diff --git a/tests/integration/proxy-pipeline.test.ts b/tests/integration/proxy-pipeline.test.ts index b54d369aea..f591fcb58c 100644 --- a/tests/integration/proxy-pipeline.test.ts +++ b/tests/integration/proxy-pipeline.test.ts @@ -59,7 +59,7 @@ describe("Chat Pipeline — handleSingleModelChat decomposition", () => { it("handleSingleModelChat should use resolveModelOrError", () => { // Extract handleSingleModelChat body - assert.match(src, /resolveModelOrError\(modelStr/); + assert.match(src, /resolveModelOrError\(\s*modelStr/); }); it("handleSingleModelChat should use checkPipelineGates", () => { diff --git a/tests/integration/resilience-http-e2e.test.ts b/tests/integration/resilience-http-e2e.test.ts index d1d42c7439..ae3b6fb983 100644 --- a/tests/integration/resilience-http-e2e.test.ts +++ b/tests/integration/resilience-http-e2e.test.ts @@ -184,7 +184,7 @@ function createServerProcess(dataDir: string, port: number) { const stdoutLines: string[] = []; const stderrLines: string[] = []; let exitInfo: { code: number | null; signal: NodeJS.Signals | null } | null = null; - const child = spawn(process.execPath, ["scripts/run-next-playwright.mjs", "dev"], { + const child = spawn(process.execPath, ["scripts/dev/run-next-playwright.mjs", "dev"], { cwd: REPO_ROOT, env: { ...process.env, diff --git a/tests/unit/account-fallback-service.test.ts b/tests/unit/account-fallback-service.test.ts index 4d0d9e5a77..dc153c37d0 100644 --- a/tests/unit/account-fallback-service.test.ts +++ b/tests/unit/account-fallback-service.test.ts @@ -295,6 +295,21 @@ test("shouldMarkAccountExhaustedFrom429 skips connection poisoning for compatibl assert.equal(shouldMarkAccountExhaustedFrom429("claude", "claude-sonnet-4-6"), true); }); +test("shouldMarkAccountExhaustedFrom429 does not poison quota cache for transient 429s", () => { + assert.equal( + shouldMarkAccountExhaustedFrom429("kiro", "claude-opus-4.7", undefined, "rate_limit"), + false + ); + assert.equal( + shouldMarkAccountExhaustedFrom429("kiro", "claude-opus-4.7", undefined, "transient"), + false + ); + assert.equal( + shouldMarkAccountExhaustedFrom429("kiro", "claude-opus-4.7", undefined, "quota_exhausted"), + true + ); +}); + test("hasPerModelQuota returns true for GitHub Copilot provider (#1624)", () => { assert.equal(hasPerModelQuota("github"), true); assert.equal(hasPerModelQuota("github", "gpt-5.1-codex-max"), true); @@ -759,3 +774,58 @@ test("recordModelLockoutFailure uses regular backoff for non-quota reasons", () clearModelLock("modelscope", "test-conn-modelscope-2", "qwen/Qwen2.5-Coder-32B-Instruct"); } }); + +// Test for hour quota related error messages +test("checkFallbackError classifies hour quota errors correctly", () => { + // For OAuth providers (e.g., codex), hour quota errors should be QUOTA_EXHAUSTED + const result1 = checkFallbackError( + 429, + "Coding Plan hour quota has been exceeded", + 0, + null, + "codex" + ); + assert.equal(result1.shouldFallback, true); + assert.equal(result1.reason, RateLimitReason.QUOTA_EXHAUSTED); + + const result2 = checkFallbackError(429, "hour quota exceeded", 0, null, "codex"); + assert.equal(result2.shouldFallback, true); + assert.equal(result2.reason, RateLimitReason.QUOTA_EXHAUSTED); + + const result3 = checkFallbackError(429, "Your hour quota is exceeded", 0, null, "codex"); + assert.equal(result3.shouldFallback, true); + assert.equal(result3.reason, RateLimitReason.QUOTA_EXHAUSTED); + + const result4 = checkFallbackError(429, "hour quota depleted", 0, null, "codex"); + assert.equal(result4.shouldFallback, true); + assert.equal(result4.reason, RateLimitReason.QUOTA_EXHAUSTED); + + // For API-key providers with 402 status, hour quota errors should be QUOTA_EXHAUSTED + const result5 = checkFallbackError(402, "hour quota has been exceeded", 0, null, "openai"); + assert.equal(result5.shouldFallback, true); + assert.equal(result5.reason, RateLimitReason.QUOTA_EXHAUSTED); + + const result6 = checkFallbackError( + 403, + "Coding Plan hour quota has been exceeded", + 0, + null, + "openai" + ); + assert.equal(result6.shouldFallback, true); + assert.equal(result6.reason, RateLimitReason.QUOTA_EXHAUSTED); +}); + +// Test for classifyErrorText function with hour quota +test("classifyErrorText handles hour quota messages", () => { + const { classifyErrorText } = accountFallback; + + assert.equal( + classifyErrorText("Coding Plan hour quota has been exceeded"), + RateLimitReason.QUOTA_EXHAUSTED + ); + assert.equal(classifyErrorText("hour quota exceeded"), RateLimitReason.QUOTA_EXHAUSTED); + assert.equal(classifyErrorText("Your hour quota is exceeded"), RateLimitReason.QUOTA_EXHAUSTED); + assert.equal(classifyErrorText("hour quota has been exceeded"), RateLimitReason.QUOTA_EXHAUSTED); + assert.equal(classifyErrorText("quota has been exceeded"), RateLimitReason.QUOTA_EXHAUSTED); +}); diff --git a/tests/unit/antigravity-discovery-bootstrap.test.ts b/tests/unit/antigravity-discovery-bootstrap.test.ts new file mode 100644 index 0000000000..6128eec2e2 --- /dev/null +++ b/tests/unit/antigravity-discovery-bootstrap.test.ts @@ -0,0 +1,204 @@ +/** + * Tests: antigravity loadCodeAssist bootstrap before :models discovery. + * + * The Google Cloud Code Assist /v1internal:models endpoint requires a prior + * /v1internal:loadCodeAssist call to assign a project context to the OAuth + * token. Without this bootstrap, :models returns 404 for all three base URLs. + * + * These tests verify: + * 1. ensureAntigravityProjectAssigned calls loadCodeAssist before returning. + * 2. The call is memoized — repeated calls for the same token do not re-hit + * the network. + * 3. Non-fatal: if loadCodeAssist fails, the function resolves without throwing. + * 4. The loadCodeAssist request uses the correct headers (Authorization, User-Agent). + * 5. Ordering guarantee — in a full discovery flow, loadCodeAssist is called + * BEFORE any :models request. + */ + +import { test, describe, beforeEach } from "node:test"; +import assert from "node:assert/strict"; + +import { + ensureAntigravityProjectAssigned, + clearAntigravityProjectCache, + getAntigravityProjectFromCache, + getAntigravityLoadCodeAssistUrls, +} from "../../open-sse/services/antigravityProjectBootstrap.ts"; + +// Reset the module-level memoization cache between tests. +beforeEach(() => { + clearAntigravityProjectCache(); +}); + +describe("ensureAntigravityProjectAssigned", () => { + test("calls loadCodeAssist and caches the returned project id", async () => { + const calls: string[] = []; + + const mockFetch = async (url: string, _init?: RequestInit): Promise<Response> => { + calls.push(url); + if (url.endsWith(":loadCodeAssist")) { + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-from-bootstrap" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + } + return new Response("Not Found", { status: 404 }); + }; + + await ensureAntigravityProjectAssigned("fake-token-1", mockFetch); + + const loadCalls = calls.filter((u) => u.endsWith(":loadCodeAssist")); + assert.ok(loadCalls.length >= 1, ":loadCodeAssist must be called at least once"); + + const cached = getAntigravityProjectFromCache("fake-token-1"); + assert.equal(cached, "proj-from-bootstrap", "project id must be memoized after first call"); + }); + + test("subsequent calls for the same token skip the network", async () => { + let networkCalls = 0; + + const mockFetch = async (url: string, _init?: RequestInit): Promise<Response> => { + networkCalls += 1; + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-cached" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + }; + + await ensureAntigravityProjectAssigned("fake-token-2", mockFetch); + await ensureAntigravityProjectAssigned("fake-token-2", mockFetch); + await ensureAntigravityProjectAssigned("fake-token-2", mockFetch); + + assert.equal(networkCalls, 1, "network must be called exactly once for the same token"); + }); + + test("different tokens each trigger their own loadCodeAssist call", async () => { + const calledFor: string[] = []; + + const mockFetch = async (url: string, init?: RequestInit): Promise<Response> => { + const auth = new Headers(init?.headers).get("Authorization") ?? ""; + calledFor.push(auth); + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-x" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + }; + + await ensureAntigravityProjectAssigned("token-A", mockFetch); + await ensureAntigravityProjectAssigned("token-B", mockFetch); + + assert.equal(calledFor.length, 2, "each unique token should trigger one network call"); + }); + + test("does not throw when loadCodeAssist returns non-200", async () => { + const mockFetch = async (_url: string, _init?: RequestInit): Promise<Response> => { + return new Response("Service Unavailable", { status: 503 }); + }; + + // Must resolve without throwing even if all endpoints fail. + await assert.doesNotReject(ensureAntigravityProjectAssigned("fail-token", mockFetch)); + }); + + test("does not throw when fetch rejects (network error)", async () => { + const mockFetch = async (_url: string, _init?: RequestInit): Promise<Response> => { + throw new Error("ECONNREFUSED"); + }; + + await assert.doesNotReject(ensureAntigravityProjectAssigned("throw-token", mockFetch)); + }); + + test("sets Authorization header with Bearer token", async () => { + let capturedAuth: string | null = null; + + const mockFetch = async (_url: string, init?: RequestInit): Promise<Response> => { + capturedAuth = new Headers(init?.headers).get("Authorization") ?? null; + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-auth-check" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + }; + + await ensureAntigravityProjectAssigned("my-secret-token", mockFetch); + + assert.equal(capturedAuth, "Bearer my-secret-token", "Authorization header must be set"); + }); + + test("falls through to next URL when first loadCodeAssist returns 404", async () => { + const hitUrls: string[] = []; + + const mockFetch = async (url: string, _init?: RequestInit): Promise<Response> => { + hitUrls.push(url); + if (url.includes("sandbox")) { + // First URL fails + return new Response("not found", { status: 404 }); + } + // Second URL succeeds + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-fallback" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + }; + + await ensureAntigravityProjectAssigned("fallback-token", mockFetch); + + assert.ok(hitUrls.length >= 2, "should try at least two URLs on the first failure"); + const cached = getAntigravityProjectFromCache("fallback-token"); + assert.equal(cached, "proj-fallback", "should cache the project from the successful URL"); + }); + + test("getAntigravityLoadCodeAssistUrls returns URLs matching ANTIGRAVITY_BASE_URLS", () => { + const urls = getAntigravityLoadCodeAssistUrls(); + assert.ok(urls.length >= 1, "must return at least one URL"); + for (const url of urls) { + assert.ok(url.endsWith(":loadCodeAssist"), `URL must end with :loadCodeAssist, got: ${url}`); + assert.ok(url.startsWith("https://"), `URL must be HTTPS, got: ${url}`); + } + }); +}); + +// ── Ordering guarantee: loadCodeAssist BEFORE :models ───────────────────────── +// +// This test simulates the full discovery flow: a test-controlled fetch +// that records call order, and verifies that :loadCodeAssist precedes +// any :models request. The integration is verified by calling +// ensureAntigravityProjectAssigned then simulating a :models request. + +describe("ordering guarantee: loadCodeAssist before :models", () => { + test("loadCodeAssist is called before :models in a simulated discovery flow", async () => { + const callOrder: string[] = []; + + const mockFetch = async (url: string, _init?: RequestInit): Promise<Response> => { + if (url.endsWith(":loadCodeAssist")) { + callOrder.push("loadCodeAssist"); + return new Response(JSON.stringify({ cloudaicompanionProject: "proj-order-test" }), { + status: 200, + headers: { "Content-Type": "application/json" }, + }); + } + if (url.endsWith(":models")) { + callOrder.push("models"); + return new Response( + JSON.stringify({ + models: [{ id: "gemini-3-pro-antigravity", displayName: "Gemini 3 Pro" }], + }), + { status: 200, headers: { "Content-Type": "application/json" } } + ); + } + return new Response("not found", { status: 404 }); + }; + + // Step 1: bootstrap project (what route.ts now does before the models loop). + await ensureAntigravityProjectAssigned("order-token", mockFetch); + + // Step 2: simulate a :models discovery request (what the loop does). + const modelsUrl = "https://cloudcode-pa.googleapis.com/v1internal:models"; + await mockFetch(modelsUrl); + + const loadIdx = callOrder.indexOf("loadCodeAssist"); + const modelsIdx = callOrder.indexOf("models"); + + assert.ok(loadIdx >= 0, ":loadCodeAssist must be called"); + assert.ok(modelsIdx >= 0, ":models must be called"); + assert.ok(loadIdx < modelsIdx, ":loadCodeAssist must be called BEFORE :models"); + }); +}); diff --git a/tests/unit/antigravity-projectid.test.ts b/tests/unit/antigravity-projectid.test.ts new file mode 100644 index 0000000000..b888f0e24a --- /dev/null +++ b/tests/unit/antigravity-projectid.test.ts @@ -0,0 +1,26 @@ +import { describe, it } from "node:test"; +import assert from "node:assert"; +import { updateProviderConnectionSchema } from "../../src/shared/validation/schemas.js"; + +describe("Antigravity Project ID Schema Validation", () => { + it("should accept projectId and providerSpecificData.projectId", () => { + const result = updateProviderConnectionSchema.safeParse({ + projectId: "anti-project", + providerSpecificData: { projectId: "anti-project" }, + }); + assert.strictEqual(result.success, true); + }); + + it("should accept null projectId and preserve nested null through JSON serialization", () => { + const payload = { + projectId: null, + providerSpecificData: { projectId: null }, + }; + + const serialized = JSON.stringify(payload); + assert.match(serialized, /"projectId":null/); + + const result = updateProviderConnectionSchema.safeParse(payload); + assert.strictEqual(result.success, true); + }); +}); diff --git a/tests/unit/api-auth.test.ts b/tests/unit/api-auth.test.ts index 4ac3ca42bb..5ced7ec13e 100644 --- a/tests/unit/api-auth.test.ts +++ b/tests/unit/api-auth.test.ts @@ -278,11 +278,13 @@ test("requireManagementAuth returns 401 with no credentials", async () => { assert.equal(res.status, 401); }); -test("requireManagementAuth returns 401 for an invalid API key", async () => { +test("requireManagementAuth returns 403 for an invalid management token", async () => { await setupAuth(); const res = await requireManagementAuth(managementRequest("sk-not-a-real-key")); assert.ok(res); - assert.equal(res.status, 401); + assert.equal(res.status, 403); + const body = await res.json(); + assert.equal(body.error?.message, "Invalid management token"); }); test("requireManagementAuth returns 403 for valid key without manage scope", async () => { @@ -314,13 +316,15 @@ test("requireManagementAuth returns null for OMNIROUTE_API_KEY env passthrough", } }); -test("requireManagementAuth returns 401 for revoked key with manage scope", async () => { +test("requireManagementAuth returns 403 for revoked key with manage scope", async () => { await setupAuth(); const key = await apiKeysDb.createApiKey("revoked-admin", "machine-test", ["manage"]); await apiKeysDb.revokeApiKey(key.id); const res = await requireManagementAuth(managementRequest(key.key)); assert.ok(res); - assert.equal(res.status, 401); + assert.equal(res.status, 403); + const body = await res.json(); + assert.equal(body.error?.message, "Invalid management token"); }); test("requireManagementAuth returns null for valid JWT cookie", async () => { diff --git a/tests/unit/api-key-regeneration.test.ts b/tests/unit/api-key-regeneration.test.ts index d7624811ca..a492424498 100644 --- a/tests/unit/api-key-regeneration.test.ts +++ b/tests/unit/api-key-regeneration.test.ts @@ -41,15 +41,15 @@ test("regenerateApiKey creates a new key and invalidates the old one", async () const result = await apiKeysDb.regenerateApiKey(oldId); assert.ok(result?.key); const regenerated = result!.key; - + assert.notEqual(regenerated, oldKey); - + // New key should be valid assert.equal(await apiKeysDb.validateApiKey(regenerated), true); - + // Old key should be invalid assert.equal(await apiKeysDb.validateApiKey(oldKey), false); - + // Name and machineId should persist const md = await apiKeysDb.getApiKeyMetadata(regenerated); assert.equal(md?.name, "Regen Test"); diff --git a/tests/unit/api/sync-models-readiness.test.ts b/tests/unit/api/sync-models-readiness.test.ts new file mode 100644 index 0000000000..941a970db1 --- /dev/null +++ b/tests/unit/api/sync-models-readiness.test.ts @@ -0,0 +1,250 @@ +import { test, beforeEach } from "node:test"; +import assert from "node:assert/strict"; +import { + selfFetchWithRetry, + ensureLoopbackServerReady, + __resetLoopbackReadinessForTests, +} from "../../../src/app/api/providers/[id]/sync-models/route.ts"; + +// --------------------------------------------------------------------------- +// Test 1: retry succeeds on attempt 3 +// --------------------------------------------------------------------------- +test("self-fetch retries with backoff and succeeds on attempt 3", async () => { + let attempts = 0; + const fetchMock: typeof fetch = async () => { + attempts++; + if (attempts < 3) { + throw new Error("fetch failed"); + } + return new Response(JSON.stringify({ models: [{ id: "model-1" }] }), { status: 200 }); + }; + + let inProcCalls = 0; + const inProcMock = async () => { + inProcCalls++; + return new Response(JSON.stringify({ models: [] }), { status: 200 }); + }; + + const result = await selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-1/models", { + fetch: fetchMock, + maxRetries: 5, + backoffMs: 5, + inProcessFallback: inProcMock, + skipReadinessGate: true, + }); + + assert.equal(attempts, 3, "should have retried twice before succeeding on attempt 3"); + assert.equal(inProcCalls, 0, "should not have called in-process route"); + assert.equal(result.ok, true, "response should be ok"); +}); + +// --------------------------------------------------------------------------- +// Test 2: falls back to in-process after maxRetries failures +// --------------------------------------------------------------------------- +test("self-fetch falls back to in-process route after maxRetries failures", async () => { + let attempts = 0; + const fetchMock: typeof fetch = async () => { + attempts++; + throw new Error("fetch failed"); + }; + + let inProcCalls = 0; + const inProcMock = async () => { + inProcCalls++; + return new Response(JSON.stringify({ models: [{ id: "in-proc-model" }] }), { status: 200 }); + }; + + const result = await selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-2/models", { + fetch: fetchMock, + maxRetries: 3, + backoffMs: 5, + connectionId: "conn-2", + inProcessFallback: inProcMock, + skipReadinessGate: true, + }); + + assert.equal(attempts, 3, "should retry exactly maxRetries times"); + assert.equal(inProcCalls, 1, "should fall back to in-process exactly once"); + const body = await result.json(); + assert.equal(body.models[0].id, "in-proc-model"); +}); + +// --------------------------------------------------------------------------- +// Test 3: HTTP error responses are returned as-is (no retry on HTTP errors) +// +// Retry contract: only network-level failures (ECONNREFUSED, "fetch failed") +// are retried. HTTP responses (even 4xx/5xx) mean the server IS up and +// returned an error that should be propagated as-is to the caller. +// --------------------------------------------------------------------------- +test("self-fetch returns HTTP error responses immediately without retrying", async () => { + // 5xx HTTP response: server is up but returned error + { + let attempts = 0; + const fetchMock: typeof fetch = async () => { + attempts++; + return new Response("server error", { status: 503 }); + }; + const inProcMock = async () => new Response(JSON.stringify({ models: [] }), { status: 200 }); + + const res = await selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-3/models", { + fetch: fetchMock, + maxRetries: 5, + backoffMs: 5, + inProcessFallback: inProcMock, + skipReadinessGate: true, + }); + + assert.equal(attempts, 1, "5xx HTTP response should NOT retry (got " + attempts + ")"); + assert.equal(res.status, 503, "should propagate the 503 response as-is"); + } + + // 4xx HTTP response: also returned immediately without retry + { + let attempts = 0; + const fetchMock: typeof fetch = async () => { + attempts++; + return new Response("not found", { status: 404 }); + }; + const inProcMock = async () => new Response(JSON.stringify({ models: [] }), { status: 200 }); + + const res = await selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-4/models", { + fetch: fetchMock, + maxRetries: 5, + backoffMs: 5, + inProcessFallback: inProcMock, + skipReadinessGate: true, + }); + + assert.equal(attempts, 1, "4xx HTTP response should NOT retry (got " + attempts + ")"); + assert.equal(res.status, 404, "should propagate the 404 response as-is"); + } +}); + +// --------------------------------------------------------------------------- +// Readiness gate tests +// --------------------------------------------------------------------------- + +test("ensureLoopbackServerReady: 17 concurrent callers trigger exactly ONE probe sequence", async () => { + __resetLoopbackReadinessForTests(); + let probeCalls = 0; + let serverIsUp = false; + // Server becomes ready after 30ms + setTimeout(() => { + serverIsUp = true; + }, 30); + const mockFetch = async (_url) => { + probeCalls++; + if (!serverIsUp) throw new Error("fetch failed"); + return new Response("", { status: 200 }); + }; + + await Promise.all( + Array.from({ length: 17 }, () => + ensureLoopbackServerReady({ fetch: mockFetch, pollMs: 5, maxWaitMs: 1000 }) + ) + ); + + // Probe may have polled multiple times before server came up -- that is fine. + // What matters: 17 concurrent callers share ONE probe sequence. + // Expected: roughly (30ms / 5ms) = ~6 attempts, not 17 x 6 = 102. + assert.ok(probeCalls <= 15, "single shared probe expected <=15 attempts, got " + probeCalls); +}); + +test("ensureLoopbackServerReady: rejects after maxWaitMs with consistent network errors", async () => { + __resetLoopbackReadinessForTests(); + const mockFetch = async (_url) => { + throw new Error("ECONNREFUSED"); + }; + await assert.rejects( + () => + ensureLoopbackServerReady({ + fetch: mockFetch, + maxWaitMs: 50, + pollMs: 10, + }), + /loopback server not ready/ + ); +}); + +test("ensureLoopbackServerReady: resolves on 4xx (any HTTP status confirms server is up)", async () => { + __resetLoopbackReadinessForTests(); + let calls = 0; + const mockFetch = async (_url) => { + calls++; + return new Response("not found", { status: 404 }); + }; + // Should not throw: 404 means the server is dispatching + await ensureLoopbackServerReady({ fetch: mockFetch, maxWaitMs: 500, pollMs: 10 }); + assert.equal(calls, 1, "resolved after exactly 1 probe (server immediately responded 404)"); +}); + +test("selfFetchWithRetry with gate: 17 concurrent callers produce one probe + one fetch each", async () => { + __resetLoopbackReadinessForTests(); + let probeCalls = 0; + let modelFetchCalls = 0; + let serverIsUp = false; + setTimeout(() => { + serverIsUp = true; + }, 30); + + const mockFetch = async (url) => { + const isReadinessProbe = url.includes("__readiness_probe__"); + if (isReadinessProbe) { + probeCalls++; + if (!serverIsUp) throw new Error("fetch failed"); + return new Response("", { status: 404 }); + } + modelFetchCalls++; + if (!serverIsUp) throw new Error("fetch failed"); + return new Response(JSON.stringify({ models: [{ id: "model-x" }] }), { status: 200 }); + }; + + await Promise.all( + Array.from({ length: 17 }, (_, i) => + selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-" + i + "/models", { + fetch: mockFetch, + maxRetries: 3, + backoffMs: 5, + }) + ) + ); + + // After readiness gate succeeds, each connection makes EXACTLY one model fetch + assert.equal(modelFetchCalls, 17, "each connection fetches its own models exactly once"); + // Probe may have polled several times but NOT 17 x poll-count + assert.ok(probeCalls <= 15, "probe should be shared, got " + probeCalls + " attempts"); +}); + +// Sanity check: disabling the gate shows amplification (verifies the gate is doing work) +test("sanity: without readiness gate, 17 callers retry independently (amplification confirmed)", async () => { + __resetLoopbackReadinessForTests(); + let modelFetchCalls = 0; + let serverIsUp = false; + setTimeout(() => { + serverIsUp = true; + }, 30); + + const mockFetch = async (_url) => { + modelFetchCalls++; + if (!serverIsUp) throw new Error("fetch failed"); + return new Response(JSON.stringify({ models: [{ id: "model-x" }] }), { status: 200 }); + }; + + await Promise.all( + Array.from({ length: 17 }, (_, i) => + selfFetchWithRetry("http://127.0.0.1:20128/api/providers/conn-" + i + "/models", { + fetch: mockFetch, + maxRetries: 5, + backoffMs: 5, + skipReadinessGate: true, + }) + ) + ); + + // Without gate: each of the 17 callers retries independently during boot race. + // Expect well above 17 total fetch attempts. + assert.ok( + modelFetchCalls > 17, + "without gate, callers retry independently, got " + modelFetchCalls + " (expected >17)" + ); +}); diff --git a/tests/unit/audio-speech-handler.test.ts b/tests/unit/audio-speech-handler.test.ts index 0cd3f39ead..49d24998c9 100644 --- a/tests/unit/audio-speech-handler.test.ts +++ b/tests/unit/audio-speech-handler.test.ts @@ -2,6 +2,7 @@ import test from "node:test"; import assert from "node:assert/strict"; const { handleAudioSpeech } = await import("../../open-sse/handlers/audioSpeech.ts"); +const { AUDIO_SPEECH_PROVIDERS } = await import("../../open-sse/config/audioRegistry.ts"); test("handleAudioSpeech requires model", async () => { const response = await handleAudioSpeech({ @@ -486,7 +487,7 @@ test("handleAudioSpeech maps Inworld requests to basic auth and wav output", asy try { const response = await handleAudioSpeech({ body: { - model: "inworld/inworld-tts-1.5-max", + model: "inworld/inworld-tts-2", input: "inworld text", voice: "voice-9", response_format: "wav", @@ -498,8 +499,8 @@ test("handleAudioSpeech maps Inworld requests to basic auth and wav output", asy assert.deepEqual(captured.body, { text: "inworld text", voiceId: "voice-9", - modelId: "inworld-tts-1.5-max", - audioConfig: { audioEncoding: "LINEAR16" }, + modelId: "inworld-tts-2", + audioConfig: { audioEncoding: "WAV" }, }); assert.equal(response.headers.get("content-type"), "audio/wav"); assert.deepEqual(Array.from(new Uint8Array(await response.arrayBuffer())), [1, 2, 3, 4]); @@ -508,6 +509,60 @@ test("handleAudioSpeech maps Inworld requests to basic auth and wav output", asy } }); +test("Inworld speech registry exposes supported formats without flac", () => { + assert.deepEqual(AUDIO_SPEECH_PROVIDERS.inworld.supportedFormats, ["mp3", "wav", "opus", "pcm"]); +}); + +test("handleAudioSpeech maps Inworld opus output and rejects flac", async () => { + const originalFetch = globalThis.fetch; + let captured; + let callCount = 0; + + globalThis.fetch = async (_url, options = {}) => { + callCount += 1; + captured = JSON.parse(String(options.body || "{}")); + + return new Response(JSON.stringify({ audioContent: "BQY=", contentType: "audio/opus" }), { + status: 200, + headers: { "content-type": "application/json" }, + }); + }; + + try { + const opusResponse = await handleAudioSpeech({ + body: { + model: "inworld/inworld-tts-2", + input: "inworld text", + response_format: "opus", + }, + credentials: { apiKey: "encoded-basic-token" }, + }); + + assert.deepEqual(captured.audioConfig, { audioEncoding: "OPUS" }); + assert.equal(opusResponse.headers.get("content-type"), "audio/opus"); + assert.deepEqual(Array.from(new Uint8Array(await opusResponse.arrayBuffer())), [5, 6]); + + const flacResponse = await handleAudioSpeech({ + body: { + model: "inworld/inworld-tts-2", + input: "inworld text", + response_format: "flac", + }, + credentials: { apiKey: "encoded-basic-token" }, + }); + const payload = (await flacResponse.json()) as any; + + assert.equal(flacResponse.status, 400); + assert.equal( + payload.error.message, + "Inworld TTS supports response_format mp3, wav, opus, or pcm only" + ); + assert.equal(callCount, 1); + } finally { + globalThis.fetch = originalFetch; + } +}); + test("handleAudioSpeech supports local Coqui providers without credentials", async () => { const originalFetch = globalThis.fetch; let captured; diff --git a/tests/unit/authz/classify.test.ts b/tests/unit/authz/classify.test.ts index 7f6021992e..c32719cedd 100644 --- a/tests/unit/authz/classify.test.ts +++ b/tests/unit/authz/classify.test.ts @@ -16,7 +16,7 @@ const cases: Case[] = [ { name: "root /", path: "/", expectedClass: "MANAGEMENT", expectedNormalized: "/" }, { name: "dashboard root", path: "/dashboard", expectedClass: "MANAGEMENT" }, { name: "dashboard nested", path: "/dashboard/settings", expectedClass: "MANAGEMENT" }, - { name: "dashboard onboarding", path: "/dashboard/onboarding", expectedClass: "MANAGEMENT" }, + { name: "dashboard onboarding", path: "/dashboard/onboarding", expectedClass: "PUBLIC" }, { name: "/api/v1 base", @@ -35,6 +35,7 @@ const cases: Case[] = [ { name: "/api/v1/files", path: "/api/v1/files", expectedClass: "CLIENT_API" }, { name: "/api/v1/batches", path: "/api/v1/batches", expectedClass: "CLIENT_API" }, { name: "/api/v1/ws", path: "/api/v1/ws", expectedClass: "CLIENT_API" }, + { name: "/api/mcp/* stays management", path: "/api/mcp/status", expectedClass: "MANAGEMENT" }, { name: "/v1 alias", diff --git a/tests/unit/authz/pipeline.test.ts b/tests/unit/authz/pipeline.test.ts index a0e52d4d60..079dd836f8 100644 --- a/tests/unit/authz/pipeline.test.ts +++ b/tests/unit/authz/pipeline.test.ts @@ -98,7 +98,7 @@ test("runAuthzPipeline allows onboarding when login is required but no password ); assert.equal(response.status, 200); - assert.equal(response.headers.get("x-omniroute-route-class"), "MANAGEMENT"); + assert.equal(response.headers.get("x-omniroute-route-class"), "PUBLIC"); }); test("runAuthzPipeline allows first password writes when login is required but no password exists", async () => { @@ -115,7 +115,7 @@ test("runAuthzPipeline allows first password writes when login is required but n ); assert.equal(response.status, 200); - assert.equal(response.headers.get("x-omniroute-route-class"), "PUBLIC"); + assert.equal(response.headers.get("x-omniroute-route-class"), "MANAGEMENT"); }); test("runAuthzPipeline keeps management API rejections as JSON", async () => { diff --git a/tests/unit/auto-update-runtime.test.ts b/tests/unit/auto-update-runtime.test.ts index 1ca8761a0f..5d107c10bd 100644 --- a/tests/unit/auto-update-runtime.test.ts +++ b/tests/unit/auto-update-runtime.test.ts @@ -130,7 +130,7 @@ describe("buildSourceUpdateScript", () => { assert.match(script, /git fetch --tags 'upstream'/); assert.match(script, /git checkout "v3\.2\.6"/); - assert.match(script, /node scripts\/sync-env\.mjs 2>\/dev\/null \|\| true/); + assert.match(script, /node scripts\/dev\/sync-env\.mjs 2>\/dev\/null \|\| true/); assert.match(script, /pm2 restart omniroute --update-env \|\| true/); }); }); diff --git a/tests/unit/auto-update.test.ts b/tests/unit/auto-update.test.ts index 2f4e2b5e57..cbc0a475f4 100644 --- a/tests/unit/auto-update.test.ts +++ b/tests/unit/auto-update.test.ts @@ -254,7 +254,7 @@ test("auto update script builders generate npm, source, and docker-compose scrip const sourceScript = autoUpdate.buildSourceUpdateScript("3.6.0", "upstream"); assert.match(sourceScript, /git fetch --tags 'upstream'/); assert.match(sourceScript, /git stash --include-untracked/); - assert.match(sourceScript, /node scripts\/sync-env\.mjs 2>\/dev\/null \|\| true/); + assert.match(sourceScript, /node scripts\/dev\/sync-env\.mjs 2>\/dev\/null \|\| true/); assert.match(sourceScript, /Successfully updated to v3\.6\.0/); const dockerScript = autoUpdate.buildDockerComposeUpdateScript({ diff --git a/tests/unit/autoPrefix.test.ts b/tests/unit/autoPrefix.test.ts new file mode 100644 index 0000000000..cb0588dc61 --- /dev/null +++ b/tests/unit/autoPrefix.test.ts @@ -0,0 +1,89 @@ +import { parseAutoPrefix } from "../../open-sse/services/autoCombo/autoPrefix.ts"; +import assert from "node:assert/strict"; +import { describe, it } from "node:test"; + +describe("parseAutoPrefix", () => { + it('should return valid for "auto" with no variant', () => { + const result = parseAutoPrefix("auto"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, undefined); + }); + + it('should return valid for "auto/" with no variant', () => { + const result = parseAutoPrefix("auto/"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, undefined); + }); + + it('should return valid for "auto/coding" with coding variant', () => { + const result = parseAutoPrefix("auto/coding"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "coding"); + }); + + it('should return valid for "auto/fast" with fast variant', () => { + const result = parseAutoPrefix("auto/fast"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "fast"); + }); + + it('should return valid for "auto/cheap" with cheap variant', () => { + const result = parseAutoPrefix("auto/cheap"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "cheap"); + }); + + it('should return valid for "auto/offline" with offline variant', () => { + const result = parseAutoPrefix("auto/offline"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "offline"); + }); + + it('should return valid for "auto/smart" with smart variant', () => { + const result = parseAutoPrefix("auto/smart"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "smart"); + }); + + it('should return valid for "auto/lkgp" with lkgp variant', () => { + const result = parseAutoPrefix("auto/lkgp"); + assert.strictEqual(result.valid, true); + assert.strictEqual(result.variant, "lkgp"); + }); + + it('should return invalid for "autocoding" (invalid format)', () => { + const result = parseAutoPrefix("autocoding"); + assert.strictEqual(result.valid, false); + assert.match(result.error || "", /Invalid auto prefix format/); + }); + + it('should return invalid for "auto/unknown" (invalid variant)', () => { + const result = parseAutoPrefix("auto/unknown"); + assert.strictEqual(result.valid, false); + assert.match(result.error || "", /Invalid auto variant: unknown/); + }); + + it("should return invalid for a non-auto prefixed model", () => { + const result = parseAutoPrefix("otherModel"); + assert.strictEqual(result.valid, false); + assert.match(result.error || "", /Not an auto-prefixed model/); + }); + + it("should return invalid for empty string", () => { + const result = parseAutoPrefix(""); + assert.strictEqual(result.valid, false); + assert.match(result.error || "", /Not an auto-prefixed model/); + }); + + it("should return invalid for null/undefined input (handled by TS but for robustness)", () => { + // @ts-ignore testing invalid input that TS normally prevents + const result = parseAutoPrefix(null); + assert.strictEqual(result.valid, false); + assert.match(result.error || "", /Not an auto-prefixed model/); + + // @ts-ignore + const result2 = parseAutoPrefix(undefined); + assert.strictEqual(result2.valid, false); + assert.match(result2.error || "", /Not an auto-prefixed model/); + }); +}); diff --git a/tests/unit/bailian-coding-plan-provider.test.ts b/tests/unit/bailian-coding-plan-provider.test.ts index 4897ab343d..217458d32a 100644 --- a/tests/unit/bailian-coding-plan-provider.test.ts +++ b/tests/unit/bailian-coding-plan-provider.test.ts @@ -206,12 +206,12 @@ test("updateProviderConnectionSchema accepts http protocol", () => { const { getStaticModelsForProvider } = await import("../../src/app/api/providers/[id]/models/route.ts"); -test("getStaticModelsForProvider returns 8 models for bailian-coding-plan", () => { +test("getStaticModelsForProvider returns 6 models for bailian-coding-plan", () => { const models = getStaticModelsForProvider("bailian-coding-plan"); assert.ok(models, "Should return models for bailian-coding-plan"); assert.ok(Array.isArray(models), "Should return an array"); - assert.equal(models.length, 8, "Should return exactly 8 models"); + assert.equal(models.length, 6, "Should return exactly 6 models"); }); test("getStaticModelsForProvider returns correct model IDs for bailian-coding-plan", () => { @@ -223,14 +223,12 @@ test("getStaticModelsForProvider returns correct model IDs for bailian-coding-pl } const expectedIds = [ + "qwen3.6-plus", "qwen3.5-plus", "qwen3-max-2026-01-23", - "qwen3-coder-next", - "qwen3-coder-plus", - "MiniMax-M2.5", - "glm-5", - "glm-4.7", "kimi-k2.5", + "glm-5", + "MiniMax-M2.5", ]; const actualIds = models.map((m) => m.id); diff --git a/tests/unit/base-executor-sanitize-effort.test.ts b/tests/unit/base-executor-sanitize-effort.test.ts new file mode 100644 index 0000000000..e07958f47c --- /dev/null +++ b/tests/unit/base-executor-sanitize-effort.test.ts @@ -0,0 +1,125 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { sanitizeReasoningEffortForProvider } = await import("../../open-sse/executors/base.ts"); + +function makeLog() { + const messages: Array<[string, string]> = []; + return { + info: (tag: string, msg: string) => messages.push([tag, msg]), + messages, + }; +} + +test("sanitizeReasoningEffortForProvider: xiaomi-mimo downgrades xhigh → high", () => { + const log = makeLog(); + const body = { + model: "mimo-v2.5-pro", + reasoning_effort: "xhigh", + messages: [{ role: "user", content: "hi" }], + }; + const result = sanitizeReasoningEffortForProvider(body, "xiaomi-mimo", "mimo-v2.5-pro", log); + assert.notEqual(result, body, "must return a new object when mutating"); + assert.equal((result as any).reasoning_effort, "high"); + assert.equal((result as any).model, "mimo-v2.5-pro", "other fields preserved"); + assert.ok( + log.messages.some(([tag, m]) => tag === "REASONING_SANITIZE" && /xhigh → high/.test(m)), + "logs the downgrade" + ); +}); + +test("sanitizeReasoningEffortForProvider: xiaomi-mimo downgrades xhigh in nested reasoning.effort", () => { + const body = { + model: "mimo-v2.5-pro", + reasoning: { effort: "xhigh", summary: "auto" }, + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "xiaomi-mimo", "mimo-v2.5-pro", null); + assert.equal((result as any).reasoning.effort, "high"); + assert.equal((result as any).reasoning.summary, "auto", "other reasoning fields preserved"); +}); + +test("sanitizeReasoningEffortForProvider: mistral/devstral strips reasoning_effort entirely", () => { + const log = makeLog(); + const body = { + model: "devstral-2512", + reasoning_effort: "medium", + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "mistral", "devstral-2512", log); + assert.equal((result as any).reasoning_effort, undefined, "reasoning_effort must be stripped"); + assert.ok( + log.messages.some(([tag, m]) => tag === "REASONING_SANITIZE" && /removed/.test(m)), + "logs the removal" + ); +}); + +test("sanitizeReasoningEffortForProvider: github/claude-opus strips reasoning_effort entirely", () => { + const body = { + model: "claude-opus-4-6", + reasoning_effort: "high", + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "github", "claude-opus-4-6", null); + assert.equal((result as any).reasoning_effort, undefined); +}); + +test("sanitizeReasoningEffortForProvider: mistral/devstral strips reasoning object when only effort present", () => { + const body = { + model: "devstral-2512", + reasoning: { effort: "medium" }, + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "mistral", "devstral-2512", null); + assert.equal((result as any).reasoning, undefined, "reasoning object dropped when emptied"); +}); + +test("sanitizeReasoningEffortForProvider: mistral/devstral preserves reasoning when other fields remain", () => { + const body = { + model: "devstral-2512", + reasoning: { effort: "medium", summary: "auto" }, + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "mistral", "devstral-2512", null); + assert.deepEqual((result as any).reasoning, { summary: "auto" }); +}); + +test("sanitizeReasoningEffortForProvider: codex with xhigh passes through unchanged when model supports it", () => { + // codex/gpt-5.5-xhigh and related Claude opus models are flagged + // supportsXHighEffort:true in providerRegistry. They must not be downgraded. + const body = { + model: "gpt-5.5-xhigh", + reasoning_effort: "xhigh", + messages: [], + }; + const result = sanitizeReasoningEffortForProvider(body, "codex", "gpt-5.5-xhigh", null); + // Either passes through unchanged (supportsXHighEffort=true) + // or the registry doesn't flag it — in which case downgrade is acceptable. + // We assert no error and that some reasoning_effort is present. + assert.ok( + (result as any).reasoning_effort === "xhigh" || (result as any).reasoning_effort === "high", + "either preserved (xhigh) or downgraded (high)" + ); +}); + +test("sanitizeReasoningEffortForProvider: no-op when reasoning_effort absent", () => { + const body = { model: "mimo-v2.5-pro", messages: [] }; + const result = sanitizeReasoningEffortForProvider(body, "xiaomi-mimo", "mimo-v2.5-pro", null); + assert.equal(result, body, "returns original body unchanged"); +}); + +test("sanitizeReasoningEffortForProvider: handles unknown providers as pass-through", () => { + const body = { model: "some-model", reasoning_effort: "xhigh", messages: [] }; + const result = sanitizeReasoningEffortForProvider(body, "unknown-provider", "some-model", null); + // unknown provider + xhigh + model not in registry → supportsXHighEffort returns false → downgrade + // OR unknown provider isn't in the strip list → returns xhigh + // Both are acceptable behavior; we just assert no exception thrown. + assert.ok(result !== undefined); +}); + +test("sanitizeReasoningEffortForProvider: non-object body returns unchanged", () => { + assert.equal(sanitizeReasoningEffortForProvider(null, "xiaomi-mimo", "x", null), null); + assert.equal(sanitizeReasoningEffortForProvider("string", "xiaomi-mimo", "x", null), "string"); + const arr: unknown[] = []; + assert.equal(sanitizeReasoningEffortForProvider(arr, "xiaomi-mimo", "x", null), arr); +}); diff --git a/tests/unit/bootstrap-env.test.ts b/tests/unit/bootstrap-env.test.ts index 43e20bfd7c..d606db7ac2 100644 --- a/tests/unit/bootstrap-env.test.ts +++ b/tests/unit/bootstrap-env.test.ts @@ -5,7 +5,7 @@ import os from "node:os"; import path from "node:path"; import Database from "better-sqlite3"; -import { bootstrapEnv } from "../../scripts/bootstrap-env.mjs"; +import { bootstrapEnv } from "../../scripts/build/bootstrap-env.mjs"; function withTempEnv(fn) { const originalCwd = process.cwd(); diff --git a/tests/unit/build-next-isolated.test.ts b/tests/unit/build-next-isolated.test.ts index e5e8c93284..89e67156e7 100644 --- a/tests/unit/build-next-isolated.test.ts +++ b/tests/unit/build-next-isolated.test.ts @@ -11,7 +11,7 @@ const { pruneStandaloneArtifacts, resolveNextBuildEnv, syncStandaloneNativeAssets, -} = await import("../../scripts/build-next-isolated.mjs"); +} = await import("../../scripts/build/build-next-isolated.mjs"); async function withTempDir(fn) { const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "omniroute-build-next-isolated-")); diff --git a/tests/unit/cc-compatible-provider.test.ts b/tests/unit/cc-compatible-provider.test.ts index 0f03139ddf..5eac9493c8 100644 --- a/tests/unit/cc-compatible-provider.test.ts +++ b/tests/unit/cc-compatible-provider.test.ts @@ -571,6 +571,91 @@ test("handleChatCore forces SSE upstream for CC compatible providers while retur assert.equal(payload.usage.completion_tokens, 5); }); +test("handleChatCore stops buffering CC-compatible SSE once a non-stream response completes", async () => { + const encoder = new TextEncoder(); + let upstreamCancelled = false; + const upstreamChunks = [ + "data:\n\n", + [ + "event: message_start", + 'data: {"type":"message_start","message":{"id":"msg_3","type":"message","role":"assistant","model":"claude-sonnet-4-6","usage":{"input_tokens":4,"output_tokens":0}}}', + "", + "event: content_block_delta", + 'data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Finished but connection stayed open"}}', + "", + "event: message_delta", + 'data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":6}}', + "", + "event: message_stop", + 'data: {"type":"message_stop"}', + "", + ].join("\n"), + ]; + let chunkIndex = 0; + + globalThis.fetch = async () => + new Response( + new ReadableStream<Uint8Array>({ + pull(controller) { + if (chunkIndex < upstreamChunks.length) { + controller.enqueue(encoder.encode(upstreamChunks[chunkIndex++])); + } + }, + cancel() { + upstreamCancelled = true; + }, + }), + { + status: 200, + headers: { + "content-type": "text/event-stream", + }, + } + ); + + const result = await handleChatCore({ + body: { + model: "claude-sonnet-4-6", + messages: [{ role: "user", content: "Ping" }], + stream: false, + }, + modelInfo: { + provider: "anthropic-compatible-cc-test", + model: "claude-sonnet-4-6", + extendedContext: false, + }, + credentials: { + apiKey: "sk-test", + providerSpecificData: { + baseUrl: "https://proxy.example.com", + chatPath: CLAUDE_CODE_COMPATIBLE_DEFAULT_CHAT_PATH, + }, + }, + clientRawRequest: { + endpoint: "/v1/chat/completions", + body: { + model: "claude-sonnet-4-6", + messages: [{ role: "user", content: "Ping" }], + stream: false, + }, + headers: new Headers({ accept: "application/json" }), + }, + userAgent: "unit-test", + log: { + debug() {}, + info() {}, + warn() {}, + error() {}, + }, + }); + + assert.equal(result.success, true); + assert.equal(upstreamCancelled, true); + const payload = (await result.response.json()) as any; + assert.equal(payload.choices[0].message.content, "Finished but connection stayed open"); + assert.equal(payload.usage.completion_tokens, 6); +}); + test("handleChatCore preserves client cache markers for Claude Code requests to CC-compatible providers", async () => { const calls = []; globalThis.fetch = async (url, init = {}) => { diff --git a/tests/unit/chatcore-translation-paths.test.ts b/tests/unit/chatcore-translation-paths.test.ts index 944ab8b6c3..d5779e5583 100644 --- a/tests/unit/chatcore-translation-paths.test.ts +++ b/tests/unit/chatcore-translation-paths.test.ts @@ -1354,6 +1354,25 @@ test("chatCore attaches OmniRoute response metadata headers to non-stream respon assert.match(String(result.response.headers.get("X-OmniRoute-Response-Cost")), /^\d+\.\d{10}$/); }); +test("chatCore does not expose provider request credentials in non-stream response headers", async () => { + const { result } = await invokeChatCore({ + provider: "openai", + model: "gpt-4o-mini", + body: { + model: "gpt-4o-mini", + stream: false, + messages: [{ role: "user", content: "hide provider credentials" }], + }, + responseFormat: "openai", + }); + + assert.equal(result.success, true); + assert.equal(result.response.headers.get("authorization"), null); + assert.equal(result.response.headers.get("x-api-key"), null); + assert.equal(result.response.headers.get("Content-Type"), "application/json"); + assert.equal(result.response.headers.get("X-OmniRoute-Cache"), "MISS"); +}); + test("chatCore normalizes tool finish reasons and estimates usage when upstream omits it", async () => { const { result } = await invokeChatCore({ provider: "openai", diff --git a/tests/unit/check-env-doc-sync.test.ts b/tests/unit/check-env-doc-sync.test.ts new file mode 100644 index 0000000000..2db6a62c87 --- /dev/null +++ b/tests/unit/check-env-doc-sync.test.ts @@ -0,0 +1,191 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +import { + parseEnvExampleVars, + parseEnvDocVars, + runEnvDocSync, +} from "../../scripts/check/check-env-doc-sync.mjs"; + +test("parseEnvExampleVars: extracts uncommented assignments", () => { + const text = ` +JWT_SECRET=abc123 +FOO_BAR=baz + # SKIPPED_VAR=leading whitespace before hash is rejected +`; + const vars = parseEnvExampleVars(text); + assert.ok(vars.has("JWT_SECRET")); + assert.ok(vars.has("FOO_BAR")); + // The regex anchors `^#?` so leading whitespace before `#` prevents a match. + assert.equal(vars.has("SKIPPED_VAR"), false); +}); + +test("parseEnvExampleVars: extracts commented examples", () => { + const text = ` +#OPTIONAL_KEY=value +# OPTIONAL_OTHER=value-with-space +ACTIVE=1 +`; + const vars = parseEnvExampleVars(text); + assert.ok(vars.has("OPTIONAL_KEY")); + assert.ok(vars.has("OPTIONAL_OTHER")); + assert.ok(vars.has("ACTIVE")); +}); + +test("parseEnvExampleVars: ignores prose", () => { + const text = ` +# This file documents env vars. Don't put values here. +Some narrative paragraph mentions PORT and DATA_DIR in passing. +PORT=20128 +`; + const vars = parseEnvExampleVars(text); + assert.deepEqual([...vars].sort(), ["PORT"]); +}); + +test("parseEnvDocVars: extracts SHOUTY_NAMES from inline backticks", () => { + const md = "Set `FOO_BAR` to enable the thing. Defaults to `BAR_BAZ_QUX`."; + const vars = parseEnvDocVars(md); + assert.deepEqual([...vars].sort(), ["BAR_BAZ_QUX", "FOO_BAR"]); +}); + +test("parseEnvDocVars: ignores values like `7s` or two-letter codes", () => { + const md = "TTL is `60s` and the type is `JSON`. Real var: `OMNIROUTE_TTL_MS`."; + const vars = parseEnvDocVars(md); + assert.deepEqual([...vars].sort(), ["JSON", "OMNIROUTE_TTL_MS"]); +}); + +test("runEnvDocSync: matched fixture passes", () => { + const envExampleText = ` +JWT_SECRET=secret +#OPTIONAL_VAR=value +ANOTHER_VAR=1 +`; + const envDocText = ` +# Reference + +| Variable | Default | Description | +| --- | --- | --- | +| \`JWT_SECRET\` | _(none)_ | required | +| \`OPTIONAL_VAR\` | _(unset)_ | optional | +| \`ANOTHER_VAR\` | 1 | enabled by default | +`; + const codeVars = new Set(["JWT_SECRET", "OPTIONAL_VAR", "ANOTHER_VAR"]); + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars, + ignore: new Set(), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, true); + assert.deepEqual(result.problems.codeMissingEnv, []); + assert.deepEqual(result.problems.envMissingDoc, []); + assert.deepEqual(result.problems.docMissingEnv, []); +}); + +test("runEnvDocSync: drift in code is flagged", () => { + const envExampleText = `JWT_SECRET=secret\n`; + const envDocText = "| `JWT_SECRET` | _(none)_ | required |"; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET", "NEW_VAR"]), + ignore: new Set(), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, false); + assert.deepEqual(result.problems.codeMissingEnv, ["NEW_VAR"]); +}); + +test("runEnvDocSync: drift in doc is flagged", () => { + const envExampleText = `JWT_SECRET=secret\nNEW_VAR=value\n`; + const envDocText = "| `JWT_SECRET` | _(none)_ | required |"; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET", "NEW_VAR"]), + ignore: new Set(), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, false); + assert.deepEqual(result.problems.envMissingDoc, ["NEW_VAR"]); +}); + +test("runEnvDocSync: drift in env (doc-only var) is flagged", () => { + const envExampleText = `JWT_SECRET=secret\n`; + const envDocText = ` +| \`JWT_SECRET\` | _(none)_ | required | +| \`OBSOLETE_VAR\` | _(unset)_ | docs-only legacy | +`; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET"]), + ignore: new Set(), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, false); + assert.deepEqual(result.problems.docMissingEnv, ["OBSOLETE_VAR"]); +}); + +test("runEnvDocSync: docOnlyAllowlist absolves doc-only entries", () => { + const envExampleText = `JWT_SECRET=secret\n`; + const envDocText = ` +| \`JWT_SECRET\` | _(none)_ | required | +| \`LEGACY_ALIAS\` | _(unset)_ | documented but not in env.example | +`; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET"]), + ignore: new Set(), + docOnlyAllowlist: new Set(["LEGACY_ALIAS"]), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, true); + assert.deepEqual(result.problems.docMissingEnv, []); +}); + +test("runEnvDocSync: envOnlyAllowlist absolves env-only entries", () => { + const envExampleText = `JWT_SECRET=secret\nFOO_BAR=bar\n`; + const envDocText = "| `JWT_SECRET` | _(none)_ | required |"; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET", "FOO_BAR"]), + ignore: new Set(), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(["FOO_BAR"]), + }); + assert.equal(result.ok, true); + assert.deepEqual(result.problems.envMissingDoc, []); +}); + +test("runEnvDocSync: ignore set skips a code-referenced var", () => { + const envExampleText = `JWT_SECRET=secret\n`; + const envDocText = "| `JWT_SECRET` | _(none)_ | required |"; + const result = runEnvDocSync({ + envExampleText, + envDocText, + codeVars: new Set(["JWT_SECRET", "PATH", "HOME"]), + ignore: new Set(["PATH", "HOME"]), + docOnlyAllowlist: new Set(), + envOnlyAllowlist: new Set(), + }); + assert.equal(result.ok, true); +}); + +test("repository contract is in sync (live data)", () => { + // Uses the real .env.example, docs/ENVIRONMENT.md, and the bundled + // allowlists. This is the same check that runs in pre-commit / CI. + const result = runEnvDocSync(); + if (!result.ok) { + const summary = JSON.stringify(result.problems, null, 2); + assert.fail(`Env/docs contract drift detected:\n${summary}`); + } + assert.equal(result.ok, true); +}); diff --git a/tests/unit/circuit-breaker-failure-kind.test.ts b/tests/unit/circuit-breaker-failure-kind.test.ts new file mode 100644 index 0000000000..d9498f1a0a --- /dev/null +++ b/tests/unit/circuit-breaker-failure-kind.test.ts @@ -0,0 +1,231 @@ +/** + * Tests for circuit breaker per-failure-kind cooldowns (Issue #2100). + * + * Each test creates a uniquely-named breaker so SQLite-backed state from + * `loadCircuitBreakerState()` cannot leak between tests when run in any + * order or with --test-concurrency > 1. + */ +import { test } from "node:test"; +import assert from "node:assert/strict"; +import { + CircuitBreaker, + resetAllCircuitBreakers, + getCircuitBreaker, +} from "../../src/shared/utils/circuitBreaker.ts"; +import type { FailureKind } from "../../src/shared/utils/classify429.ts"; + +const uniqueName = (suffix: string) => + `cb-test-#2100-${suffix}-${Date.now()}-${Math.floor(Math.random() * 1e6)}`; + +test("default behavior unchanged when neither cooldownByKind nor classifyError is set", () => { + const cb = new CircuitBreaker(uniqueName("legacy"), { + failureThreshold: 2, + resetTimeout: 30_000, + }); + cb._onFailure(); + cb._onFailure(); + assert.equal(cb.state, "OPEN"); + assert.equal(cb.lastFailureKind, null); + // Cooldown is the legacy resetTimeout — not biased by kind. + const t = cb._timeUntilReset(); + assert.ok(t > 29_000 && t <= 30_000, `expected ~30s, got ${t}`); + cb.reset(); +}); + +test("cooldownByKind: quota_exhausted gets longer cooldown than rate_limit", () => { + const cb = new CircuitBreaker(uniqueName("kind-cooldown"), { + failureThreshold: 1, + resetTimeout: 30_000, + cooldownByKind: { + rate_limit: 60_000, + quota_exhausted: 3_600_000, + }, + }); + + cb._onFailure("rate_limit"); + assert.equal(cb.state, "OPEN"); + assert.equal(cb.lastFailureKind, "rate_limit"); + const tRate = cb._timeUntilReset(); + assert.ok(tRate > 59_000 && tRate <= 60_000, `rate_limit cooldown: expected ~60s, got ${tRate}`); + + cb.reset(); + cb._onFailure("quota_exhausted"); + const tQuota = cb._timeUntilReset(); + assert.ok( + tQuota > 3_599_000 && tQuota <= 3_600_000, + `quota_exhausted cooldown: expected ~3600s, got ${tQuota}` + ); + + cb.reset(); +}); + +test("cooldownByKind falls back to resetTimeout when no override for the kind", () => { + const cb = new CircuitBreaker(uniqueName("partial-cooldown"), { + failureThreshold: 1, + resetTimeout: 45_000, + cooldownByKind: { + quota_exhausted: 3_600_000, + // rate_limit intentionally omitted — should use resetTimeout + }, + }); + cb._onFailure("rate_limit"); + const t = cb._timeUntilReset(); + assert.ok(t > 44_000 && t <= 45_000, `expected ~45s fallback, got ${t}`); + cb.reset(); +}); + +test("cooldownByKind falls back to resetTimeout when lastFailureKind is null", () => { + const cb = new CircuitBreaker(uniqueName("null-kind"), { + failureThreshold: 1, + resetTimeout: 30_000, + cooldownByKind: { + rate_limit: 60_000, + quota_exhausted: 3_600_000, + }, + }); + // Old-style call site that doesn't classify — kind stays null. + cb._onFailure(); + assert.equal(cb.lastFailureKind, null); + const t = cb._timeUntilReset(); + assert.ok(t > 29_000 && t <= 30_000, `expected resetTimeout fallback, got ${t}`); + cb.reset(); +}); + +test("classifyError on execute() routes errors to the correct kind", async () => { + const cb = new CircuitBreaker(uniqueName("classifier"), { + failureThreshold: 1, + resetTimeout: 1_000, + cooldownByKind: { quota_exhausted: 600_000 }, + classifyError: (err: unknown): FailureKind | undefined => { + if (err instanceof Error && err.message.includes("daily limit")) { + return "quota_exhausted"; + } + return "transient"; + }, + }); + + await assert.rejects(async () => { + await cb.execute(async () => { + throw new Error("You exceeded your daily limit"); + }); + }); + + assert.equal(cb.state, "OPEN"); + assert.equal(cb.lastFailureKind, "quota_exhausted"); + const t = cb._timeUntilReset(); + assert.ok(t > 599_000 && t <= 600_000, `expected ~600s quota cooldown, got ${t}`); + cb.reset(); +}); + +test("_onSuccess clears lastFailureKind on close transition", () => { + const cb = new CircuitBreaker(uniqueName("success-clear"), { + failureThreshold: 1, + resetTimeout: 100, + cooldownByKind: { rate_limit: 100 }, + }); + cb._onFailure("rate_limit"); + assert.equal(cb.lastFailureKind, "rate_limit"); + // simulate elapsed time & success path through _onSuccess (which the + // combo path uses); after success, kind should clear and breaker close. + cb._onSuccess(); + assert.equal(cb.lastFailureKind, null); + assert.equal(cb.state, "CLOSED"); +}); + +test("reset() clears lastFailureKind", () => { + const cb = new CircuitBreaker(uniqueName("reset-clear"), { + failureThreshold: 1, + cooldownByKind: { rate_limit: 60_000 }, + }); + cb._onFailure("rate_limit"); + assert.equal(cb.lastFailureKind, "rate_limit"); + cb.reset(); + assert.equal(cb.lastFailureKind, null); +}); + +test("getCircuitBreaker registry merges new options on subsequent calls", () => { + const name = uniqueName("registry-merge"); + const cb1 = getCircuitBreaker(name, { failureThreshold: 5 }); + // First call: no cooldownByKind, classifyError null + assert.deepEqual(cb1.cooldownByKind, {}); + assert.equal(cb1.classifyError, null); + // Second call: add overrides + const cb2 = getCircuitBreaker(name, { + cooldownByKind: { rate_limit: 60_000 }, + classifyError: () => "rate_limit" as FailureKind, + }); + assert.equal(cb1, cb2, "registry returns same instance"); + assert.deepEqual(cb1.cooldownByKind, { rate_limit: 60_000 }); + assert.ok(typeof cb1.classifyError === "function"); + cb1.reset(); +}); + +test("registry MERGES cooldownByKind across calls (does not replace)", () => { + // Regression test for codex audit MEDIUM #1: if two registrations supply + // disjoint keys, both must survive. Without spread-merge the second call + // wiped the first. + const name = uniqueName("registry-merge-keys"); + const cb1 = getCircuitBreaker(name, { + cooldownByKind: { quota_exhausted: 3_600_000 }, + }); + assert.deepEqual(cb1.cooldownByKind, { quota_exhausted: 3_600_000 }); + const cb2 = getCircuitBreaker(name, { + cooldownByKind: { rate_limit: 60_000 }, + }); + assert.equal(cb1, cb2); + assert.deepEqual(cb1.cooldownByKind, { + quota_exhausted: 3_600_000, + rate_limit: 60_000, + }); + cb1.reset(); +}); + +test("classifyError throwing does not mask original error or skip _onFailure", async () => { + // Regression test for codex audit MEDIUM #2. + const cb = new CircuitBreaker(uniqueName("classifier-throws"), { + failureThreshold: 1, + resetTimeout: 1_000, + classifyError: () => { + throw new Error("classifier itself blew up"); + }, + }); + let caught: unknown; + try { + await cb.execute(async () => { + throw new Error("original error"); + }); + } catch (e) { + caught = e; + } + assert.ok(caught instanceof Error); + assert.equal((caught as Error).message, "original error"); + assert.equal(cb.state, "OPEN", "failure was still recorded"); + assert.equal(cb.lastFailureKind, null, "kind defaults to null when classifier throws"); + cb.reset(); +}); + +test("invalid cooldownByKind values (NaN, Infinity, negative) fall back to resetTimeout", () => { + // Regression test for codex audit MEDIUM #3. + const cb = new CircuitBreaker(uniqueName("invalid-cooldown"), { + failureThreshold: 1, + resetTimeout: 30_000, + cooldownByKind: { + rate_limit: NaN, + quota_exhausted: -5_000, + transient: Number.POSITIVE_INFINITY, + }, + }); + for (const kind of ["rate_limit", "quota_exhausted", "transient"] as const) { + cb.reset(); + cb._onFailure(kind); + const t = cb._timeUntilReset(); + assert.ok(t > 29_000 && t <= 30_000, `expected resetTimeout fallback for ${kind}, got ${t}`); + } + cb.reset(); +}); + +// Cleanup: clear the registry (and SQLite-persisted breaker state) so this +// test file does not leak into others when --test-concurrency=10. +test("teardown — reset all circuit breakers", () => { + resetAllCircuitBreakers(); +}); diff --git a/tests/unit/classify429.test.ts b/tests/unit/classify429.test.ts new file mode 100644 index 0000000000..a57b04e134 --- /dev/null +++ b/tests/unit/classify429.test.ts @@ -0,0 +1,163 @@ +import { test } from "node:test"; +import assert from "node:assert/strict"; +import { + classify429, + looksLikeQuotaExhausted, + parseRetryAfter, + retryAfterFromResponse, + type FailureKind, +} from "../../src/shared/utils/classify429.ts"; + +test("classify429: non-429 status returns 'transient'", () => { + const out: FailureKind = classify429({ status: 500 }); + assert.equal(out, "transient"); +}); + +test("classify429: 429 with no body or hints returns 'rate_limit'", () => { + assert.equal(classify429({ status: 429 }), "rate_limit"); + assert.equal(classify429({ status: 429, body: "" }), "rate_limit"); + assert.equal(classify429({ status: 429, body: undefined }), "rate_limit"); +}); + +test("classify429: 429 with quota keyword in string body returns 'quota_exhausted'", () => { + assert.equal( + classify429({ status: 429, body: "You exceeded your daily limit." }), + "quota_exhausted" + ); + assert.equal( + classify429({ status: 429, body: "Monthly quota reached. Resets on the 1st." }), + "quota_exhausted" + ); + assert.equal( + classify429({ status: 429, body: "Out of credits — top up your account." }), + "quota_exhausted" + ); + assert.equal(classify429({ status: 429, body: "plan limit reached" }), "quota_exhausted"); +}); + +test("classify429: 429 with quota keyword in nested object body returns 'quota_exhausted'", () => { + assert.equal( + classify429({ + status: 429, + body: { error: { message: "You have exceeded your monthly quota." } }, + }), + "quota_exhausted" + ); + assert.equal( + classify429({ + status: 429, + body: { error: { type: "insufficient_quota", message: "..." } }, + }), + "quota_exhausted" + ); +}); + +test("classify429: 429 without quota keyword returns 'rate_limit'", () => { + // Plain rate-limit message — keyword 'rate' alone is NOT in QUOTA_PATTERNS + // so classifier should default to "rate_limit" for any 429. + assert.equal( + classify429({ status: 429, body: "Too many requests. Try again in 60s." }), + "rate_limit" + ); + assert.equal( + classify429({ + status: 429, + body: "Rate limit reached for requests. Please retry.", + }), + "rate_limit" + ); + assert.equal( + classify429({ + status: 429, + body: "I am experiencing high traffic, please try again shortly.", + }), + "rate_limit" + ); +}); + +test("looksLikeQuotaExhausted: detects all known keyword variants", () => { + for (const body of [ + "daily limit exceeded", + "daily quota reached", + "per-day limit reached", + "monthly limit", + "monthly quota", + "per-month limit", + "quota exceeded", + "exceeded quota", + "insufficient_quota", + "billing cap reached", + "credit exhausted", + "out of credits", + "hard limit", + "hard-limit", + "plan limit", + ]) { + assert.equal(looksLikeQuotaExhausted(body), true, `failed for: ${body}`); + } +}); + +test("looksLikeQuotaExhausted: rejects empty / null / non-quota text", () => { + assert.equal(looksLikeQuotaExhausted(undefined), false); + assert.equal(looksLikeQuotaExhausted(null), false); + assert.equal(looksLikeQuotaExhausted(""), false); + assert.equal(looksLikeQuotaExhausted("rate limit, please retry in 60s"), false); + assert.equal(looksLikeQuotaExhausted("server error 500"), false); +}); + +test("ambiguous 'daily rate limit' messages classify as quota_exhausted (intentional)", () => { + // Codex audit LOW: messages combining 'daily' or 'monthly' with 'limit' + // match the quota regex even when paired with 'rate'. This is intentional + // because daily/monthly caps semantically warrant a long cooldown — even + // when the upstream calls them "rate limits". Locking it down here so a + // future regex tweak doesn't silently change the behavior. + assert.equal(classify429({ status: 429, body: "daily rate limit exceeded" }), "quota_exhausted"); + assert.equal( + classify429({ status: 429, body: "monthly rate limit exceeded" }), + "quota_exhausted" + ); +}); + +test("parseRetryAfter: integer seconds", () => { + assert.equal(parseRetryAfter("60"), 60); + assert.equal(parseRetryAfter("3600"), 3600); + assert.equal(parseRetryAfter("0"), 0); +}); + +test("parseRetryAfter: Groq-style relative units", () => { + // Regression for the parseInt-trap: parseInt("5m", 10) returns 5, + // which would be wrong (5s instead of 300s). The relative-unit + // pattern must be checked BEFORE plain integer parse. + assert.equal(parseRetryAfter("60s"), 60); + assert.equal(parseRetryAfter("5m"), 300); + assert.equal(parseRetryAfter("2h"), 7200); + assert.equal(parseRetryAfter("1H"), 3600); +}); + +test("parseRetryAfter: HTTP-date in the future", () => { + const future = new Date(Date.now() + 60_000).toUTCString(); + const secs = parseRetryAfter(future); + assert.ok(secs !== null); + assert.ok(secs! >= 50 && secs! <= 65, `expected ~60, got ${secs}`); +}); + +test("parseRetryAfter: HTTP-date in the past clamps to 0", () => { + const past = new Date(Date.now() - 5 * 60_000).toUTCString(); + assert.equal(parseRetryAfter(past), 0); +}); + +test("parseRetryAfter: unparseable returns null", () => { + assert.equal(parseRetryAfter(undefined), null); + assert.equal(parseRetryAfter(""), null); + assert.equal(parseRetryAfter(" "), null); + assert.equal(parseRetryAfter("not-a-date"), null); + assert.equal(parseRetryAfter("60xyz"), null); +}); + +test("retryAfterFromResponse: case-insensitive header lookup", () => { + assert.equal(retryAfterFromResponse({ headers: { "Retry-After": "30" } }), 30); + assert.equal(retryAfterFromResponse({ headers: { "retry-after": "45" } }), 45); + assert.equal(retryAfterFromResponse({ headers: { "RETRY-AFTER": "60s" } }), 60); + assert.equal(retryAfterFromResponse({ headers: {} }), null); + assert.equal(retryAfterFromResponse({}), null); +}); diff --git a/tests/unit/cli-keys-command.test.ts b/tests/unit/cli-keys-command.test.ts new file mode 100644 index 0000000000..c1b08bc284 --- /dev/null +++ b/tests/unit/cli-keys-command.test.ts @@ -0,0 +1,92 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import Database from "better-sqlite3"; + +const ORIGINAL_DATA_DIR = process.env.DATA_DIR; +const ORIGINAL_STORAGE_ENCRYPTION_KEY = process.env.STORAGE_ENCRYPTION_KEY; +const ORIGINAL_FETCH = globalThis.fetch; + +interface ProviderConnectionRow { + provider: string; + auth_type: string; + name: string; + api_key: string; + is_active: number; + created_at: string; + updated_at: string; +} + +interface CountRow { + count: number; +} + +function createTempDataDir() { + return fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-cli-keys-")); +} + +async function withCliKeysEnv(fn: (dataDir: string, dbPath: string) => Promise<void>) { + const dataDir = createTempDataDir(); + const dbPath = path.join(dataDir, "storage.sqlite"); + process.env.DATA_DIR = dataDir; + delete process.env.STORAGE_ENCRYPTION_KEY; + globalThis.fetch = (async () => { + throw new Error("server offline"); + }) as typeof fetch; + + const originalLog = console.log; + console.log = () => {}; + + try { + new Database(dbPath).close(); + await fn(dataDir, dbPath); + } finally { + console.log = originalLog; + globalThis.fetch = ORIGINAL_FETCH; + fs.rmSync(dataDir, { recursive: true, force: true }); + + if (ORIGINAL_DATA_DIR === undefined) delete process.env.DATA_DIR; + else process.env.DATA_DIR = ORIGINAL_DATA_DIR; + + if (ORIGINAL_STORAGE_ENCRYPTION_KEY === undefined) delete process.env.STORAGE_ENCRYPTION_KEY; + else process.env.STORAGE_ENCRYPTION_KEY = ORIGINAL_STORAGE_ENCRYPTION_KEY; + } +} + +test("legacy keys command writes and removes provider_connections with the real schema", async () => { + await withCliKeysEnv(async (_dataDir, dbPath) => { + const { runSubcommand } = await import("../../bin/cli-commands.mjs"); + + await runSubcommand("keys", ["add", "openai", "sk-test-cli-key"]); + + let db = new Database(dbPath); + let row = db + .prepare( + "SELECT provider, auth_type, name, api_key, is_active, created_at, updated_at FROM provider_connections WHERE provider = ?" + ) + .get("openai") as ProviderConnectionRow | undefined; + db.close(); + + assert.ok(row); + assert.equal(row.provider, "openai"); + assert.equal(row.auth_type, "apikey"); + assert.equal(row.name, "openai"); + assert.equal(row.api_key, "sk-test-cli-key"); + assert.equal(row.is_active, 1); + assert.ok(row.created_at); + assert.ok(row.updated_at); + + await runSubcommand("keys", ["list"]); + await runSubcommand("keys", ["remove", "openai"]); + + db = new Database(dbPath); + const countRow = db + .prepare("SELECT COUNT(*) AS count FROM provider_connections WHERE provider = ?") + .get("openai") as CountRow; + db.close(); + + assert.equal(countRow.count, 0); + }); +}); diff --git a/tests/unit/cliproxyapi-executor.test.ts b/tests/unit/cliproxyapi-executor.test.ts index cc37ccb8a3..c5f1aab86c 100644 --- a/tests/unit/cliproxyapi-executor.test.ts +++ b/tests/unit/cliproxyapi-executor.test.ts @@ -129,6 +129,72 @@ describe("CliproxyapiExecutor", () => { const result = exec.transformRequest("model", null, true, {}); assert.equal(result, null); }); + + it("preserves Anthropic-valid thinking shape on /v1/messages routing", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + system: [{ type: "text", text: "Be helpful" }], + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + thinking: { type: "enabled", budget_tokens: 10240 }, + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + assert.deepEqual(result.thinking, { type: "enabled", budget_tokens: 10240 }); + }); + + it("preserves disabled thinking shape on /v1/messages routing", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + system: [{ type: "text", text: "x" }], + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + thinking: { type: "disabled", budget_tokens: 0 }, + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + assert.deepEqual(result.thinking, { type: "disabled", budget_tokens: 0 }); + }); + + it("strips Capy-style adaptive thinking on /v1/messages routing", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + system: [{ type: "text", text: "x" }], + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + thinking: { type: "adaptive", display: "summarized" }, + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + assert.equal(result.thinking, undefined); + }); + + it("strips thinking carrying display field even with enabled type", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + system: [{ type: "text", text: "x" }], + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + thinking: { type: "enabled", budget_tokens: 10240, display: "summarized" }, + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + assert.equal(result.thinking, undefined); + }); + + it("does not strip OpenAI-shape bodies (no thinking, no system, string content)", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "gpt-5.5", + messages: [ + { role: "system", content: "be brief" }, + { role: "user", content: "hi" }, + ], + reasoning_effort: "medium", + }; + const result = exec.transformRequest("gpt-5.5", body, true, {}); + // No Anthropic indicators present, so strips are skipped. Body + // passes through with its OpenAI fields preserved. + assert.equal(result.reasoning_effort, "medium"); + assert.equal(result.thinking, undefined); + assert.equal(result.output_config, undefined); + }); }); describe("execute", () => { @@ -229,4 +295,204 @@ describe("CliproxyapiExecutor", () => { assert.ok(result.transformedBody); }); }); + + describe("healthCheck", () => { + it("probes /v1/models instead of /health", async () => { + process.env.CLIPROXYAPI_HOST = "127.0.0.1"; + process.env.CLIPROXYAPI_PORT = "8317"; + + let capturedUrl; + globalThis.fetch = async (url) => { + capturedUrl = String(url); + return new Response(JSON.stringify({ data: [] }), { status: 200 }); + }; + + const exec = new CliproxyapiExecutor(); + const result = await exec.healthCheck(); + + assert.equal(capturedUrl, "http://127.0.0.1:8317/v1/models"); + assert.equal(result.ok, true); + assert.equal(result.error, undefined); + assert.ok(result.latencyMs >= 0); + }); + }); + + describe("Anthropic-shape detection", () => { + it("detects Anthropic-shape when top-level system field present", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + system: [{ type: "text", text: "You are helpful" }], + messages: [{ role: "user", content: "hi" }], + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + // Anthropic-shape: system field stripped (Capy extras behavior) vs preserved + // The key assertion is that it does NOT try to send to /v1/chat/completions path + // (verified by output_config being stripped when present) + assert.equal(result.system !== undefined || result.messages !== undefined, true); + }); + + it("detects Anthropic-shape when messages[0].content is an array (no system field)", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "claude-opus-4-7", + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + output_config: { effort: "max" }, + }; + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + assert.equal( + result.output_config, + undefined, + "output_config should be stripped for Anthropic-shape" + ); + }); + + it("treats OpenAI-shape (string content, no system) as non-Anthropic passthrough", () => { + const exec = new CliproxyapiExecutor(); + const body = { + model: "gpt-5.5", + messages: [{ role: "user", content: "hi" }], + output_config: { effort: "max" }, + }; + const result = exec.transformRequest("gpt-5.5", body, true, {}); + assert.deepEqual( + result.output_config, + { effort: "max" }, + "output_config preserved for OpenAI-shape" + ); + }); + }); + + describe("Capy extras strip on Anthropic-shape bodies", () => { + function anthropicBody(extras: Record<string, unknown>) { + return { + model: "claude-opus-4-7", + system: [{ type: "text", text: "x" }], + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + ...extras, + }; + } + + it("strips output_config", () => { + const exec = new CliproxyapiExecutor(); + const result = exec.transformRequest( + "claude-opus-4-7", + anthropicBody({ output_config: { effort: "max" } }), + true, + {} + ); + assert.equal(result.output_config, undefined); + }); + + it("strips metadata", () => { + const exec = new CliproxyapiExecutor(); + const result = exec.transformRequest( + "claude-opus-4-7", + anthropicBody({ metadata: { user_id: "abc" } }), + true, + {} + ); + assert.equal(result.metadata, undefined); + }); + + it("strips client_info", () => { + const exec = new CliproxyapiExecutor(); + const result = exec.transformRequest( + "claude-opus-4-7", + anthropicBody({ client_info: { name: "Capy" } }), + true, + {} + ); + assert.equal(result.client_info, undefined); + }); + + it("strips prompt_cache_key", () => { + const exec = new CliproxyapiExecutor(); + const result = exec.transformRequest( + "claude-opus-4-7", + anthropicBody({ prompt_cache_key: "key123" }), + true, + {} + ); + assert.equal(result.prompt_cache_key, undefined); + }); + + it("strips safety_identifier", () => { + const exec = new CliproxyapiExecutor(); + const result = exec.transformRequest( + "claude-opus-4-7", + anthropicBody({ safety_identifier: "sid" }), + true, + {} + ); + assert.equal(result.safety_identifier, undefined); + }); + }); + + describe("mcp_ tool name rewrite on Anthropic-shape bodies", () => { + function anthropicBodyWithTools(tools: unknown[], messages: unknown[] = []) { + return { + model: "claude-opus-4-7", + system: [{ type: "text", text: "x" }], + tools, + messages: + messages.length > 0 + ? messages + : [{ role: "user", content: [{ type: "text", text: "hi" }] }], + }; + } + + it("rewrites mcp_* tool definition names (tool defs)", () => { + const exec = new CliproxyapiExecutor(); + const body = anthropicBodyWithTools([ + { name: "mcp_filesystem_read", description: "Read file", input_schema: {} }, + ]); + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + const toolName = (result.tools as Array<{ name: string }>)[0].name; + assert.notEqual(toolName, "mcp_filesystem_read", "mcp_ tool name should be rewritten"); + assert.match( + toolName, + /^[A-Z]/, + "rewritten name should start with uppercase or differ from mcp_" + ); + }); + + it("does not rewrite non-mcp_ tool names", () => { + const exec = new CliproxyapiExecutor(); + const body = anthropicBodyWithTools([ + { name: "my_tool", description: "My tool", input_schema: {} }, + ]); + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + const toolName = (result.tools as Array<{ name: string }>)[0].name; + assert.equal(toolName, "my_tool"); + }); + + it("rewrites mcp_* tool_use names in assistant message history", () => { + const exec = new CliproxyapiExecutor(); + const body = anthropicBodyWithTools( + [{ name: "mcp_github_create_issue", description: "d", input_schema: {} }], + [ + { + role: "assistant", + content: [{ type: "tool_use", id: "tu_1", name: "mcp_github_create_issue", input: {} }], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "tu_1", content: "ok" }] }, + ] + ); + const result = exec.transformRequest("claude-opus-4-7", body, true, {}); + const assistantMsg = (result.messages as Array<{ role: string; content: unknown[] }>).find( + (m) => m.role === "assistant" + ); + const toolUseBlock = assistantMsg?.content.find( + (b): b is { type: string; name: string } => + typeof b === "object" && b !== null && (b as Record<string, unknown>).type === "tool_use" + ); + assert.ok(toolUseBlock, "tool_use block should exist in assistant message"); + assert.notEqual( + toolUseBlock.name, + "mcp_github_create_issue", + "tool_use name should be rewritten" + ); + }); + }); }); diff --git a/tests/unit/cloud-agent-tasks-route-auth.test.ts b/tests/unit/cloud-agent-tasks-route-auth.test.ts new file mode 100644 index 0000000000..c23fe9366b --- /dev/null +++ b/tests/unit/cloud-agent-tasks-route-auth.test.ts @@ -0,0 +1,77 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { makeManagementSessionRequest } from "../helpers/managementSession.ts"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-cloud-agent-auth-")); +const ORIGINAL_DATA_DIR = process.env.DATA_DIR; +const ORIGINAL_INITIAL_PASSWORD = process.env.INITIAL_PASSWORD; +const ORIGINAL_JWT_SECRET = process.env.JWT_SECRET; + +process.env.DATA_DIR = TEST_DATA_DIR; + +const core = await import("../../src/lib/db/core.ts"); +const settingsDb = await import("../../src/lib/db/settings.ts"); +const route = await import("../../src/app/api/v1/agents/tasks/route.ts"); + +type TasksGetRequest = Parameters<typeof route.GET>[0]; +type ErrorBody = { error: { message: string } }; + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +async function enableManagementAuth() { + process.env.INITIAL_PASSWORD = "cloud-agent-password"; + await settingsDb.updateSettings({ requireLogin: true, password: "" }); +} + +test.beforeEach(async () => { + await resetStorage(); + await enableManagementAuth(); +}); + +test.after(async () => { + await resetStorage(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + + if (ORIGINAL_DATA_DIR === undefined) delete process.env.DATA_DIR; + else process.env.DATA_DIR = ORIGINAL_DATA_DIR; + + if (ORIGINAL_INITIAL_PASSWORD === undefined) delete process.env.INITIAL_PASSWORD; + else process.env.INITIAL_PASSWORD = ORIGINAL_INITIAL_PASSWORD; + + if (ORIGINAL_JWT_SECRET === undefined) delete process.env.JWT_SECRET; + else process.env.JWT_SECRET = ORIGINAL_JWT_SECRET; +}); + +test("cloud agent task list requires management auth when auth is enabled", async () => { + const unauthenticated = await route.GET( + new Request("http://localhost/api/v1/agents/tasks") as TasksGetRequest + ); + const invalidToken = await route.GET( + new Request("http://localhost/api/v1/agents/tasks", { + headers: { authorization: "Bearer anything" }, + }) as TasksGetRequest + ); + const authenticated = await route.GET( + (await makeManagementSessionRequest("http://localhost/api/v1/agents/tasks")) as TasksGetRequest + ); + + assert.equal(unauthenticated.status, 401); + assert.equal( + ((await unauthenticated.json()) as ErrorBody).error.message, + "Authentication required" + ); + assert.equal(invalidToken.status, 403); + assert.equal( + ((await invalidToken.json()) as ErrorBody).error.message, + "Invalid management token" + ); + assert.equal(authenticated.status, 200); + assert.deepEqual(await authenticated.json(), { data: [] }); +}); diff --git a/tests/unit/cloudAgent-types.test.ts b/tests/unit/cloudAgent-types.test.ts new file mode 100644 index 0000000000..6bc9b74fed --- /dev/null +++ b/tests/unit/cloudAgent-types.test.ts @@ -0,0 +1,166 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { CLOUD_AGENT_STATUS, CloudAgentStatusSchema } = + await import("../../src/lib/cloudAgent/types.ts"); +const { CreateCloudAgentTaskSchema, UpdateCloudAgentTaskSchema } = + await import("../../src/lib/cloudAgent/types.ts"); +const { isCloudAgentProvider, getAgent, getAvailableAgents } = + await import("../../src/lib/cloudAgent/registry.ts"); + +test("CLOUD_AGENT_STATUS has correct values", () => { + assert.strictEqual(CLOUD_AGENT_STATUS.QUEUED, "queued"); + assert.strictEqual(CLOUD_AGENT_STATUS.RUNNING, "running"); + assert.strictEqual(CLOUD_AGENT_STATUS.AWAITING_APPROVAL, "awaiting_approval"); + assert.strictEqual(CLOUD_AGENT_STATUS.COMPLETED, "completed"); + assert.strictEqual(CLOUD_AGENT_STATUS.FAILED, "failed"); + assert.strictEqual(CLOUD_AGENT_STATUS.CANCELLED, "cancelled"); +}); + +test("CloudAgentStatusSchema validates valid statuses", () => { + const validStatuses = [ + "queued", + "running", + "awaiting_approval", + "completed", + "failed", + "cancelled", + ]; + for (const status of validStatuses) { + const result = CloudAgentStatusSchema.safeParse(status); + assert.strictEqual(result.success, true, `Status ${status} should be valid`); + } +}); + +test("CloudAgentStatusSchema rejects invalid status", () => { + const result = CloudAgentStatusSchema.safeParse("invalid"); + assert.strictEqual(result.success, false); +}); + +test("CreateCloudAgentTaskSchema validates valid input", () => { + const validInput = { + providerId: "jules", + prompt: "Fix the bug in auth.ts", + source: { + repoName: "my-repo", + repoUrl: "https://github.com/user/my-repo", + branch: "main", + }, + options: { + autoCreatePr: true, + planApprovalRequired: true, + }, + }; + const result = CreateCloudAgentTaskSchema.safeParse(validInput); + assert.strictEqual(result.success, true); +}); + +test("CreateCloudAgentTaskSchema rejects missing required fields", () => { + const invalidInput = { + providerId: "jules", + }; + const result = CreateCloudAgentTaskSchema.safeParse(invalidInput); + assert.strictEqual(result.success, false); +}); + +test("CreateCloudAgentTaskSchema rejects invalid providerId", () => { + const invalidInput = { + providerId: "invalid-provider", + prompt: "Test", + source: { + repoName: "test", + repoUrl: "https://github.com/test/test", + }, + }; + const result = CreateCloudAgentTaskSchema.safeParse(invalidInput); + assert.strictEqual(result.success, false); +}); + +test("CreateCloudAgentTaskSchema rejects invalid repoUrl", () => { + const invalidInput = { + providerId: "jules", + prompt: "Test", + source: { + repoName: "test", + repoUrl: "not-a-url", + }, + }; + const result = CreateCloudAgentTaskSchema.safeParse(invalidInput); + assert.strictEqual(result.success, false); +}); + +test("UpdateCloudAgentTaskSchema validates approve action", () => { + const validInput = { + id: "123e4567-e89b-12d3-a456-426614174000", + action: "approve", + }; + const result = UpdateCloudAgentTaskSchema.safeParse(validInput); + assert.strictEqual(result.success, true); +}); + +test("UpdateCloudAgentTaskSchema validates cancel action", () => { + const validInput = { + id: "123e4567-e89b-12d3-a456-426614174000", + action: "cancel", + }; + const result = UpdateCloudAgentTaskSchema.safeParse(validInput); + assert.strictEqual(result.success, true); +}); + +test("UpdateCloudAgentTaskSchema validates message action with content", () => { + const validInput = { + id: "123e4567-e89b-12d3-a456-426614174000", + action: "message", + message: "Please continue with the next step", + }; + const result = UpdateCloudAgentTaskSchema.safeParse(validInput); + assert.strictEqual(result.success, true); +}); + +test("UpdateCloudAgentTaskSchema allows message without content (optional)", () => { + const validInput = { + id: "123e4567-e89b-12d3-a456-426614174000", + action: "message", + }; + const result = UpdateCloudAgentTaskSchema.safeParse(validInput); + assert.strictEqual(result.success, true); +}); + +test("getAvailableAgents returns all registered agents", () => { + const agents = getAvailableAgents(); + assert.strictEqual(agents.includes("jules"), true); + assert.strictEqual(agents.includes("devin"), true); + assert.strictEqual(agents.includes("codex-cloud"), true); + assert.strictEqual(agents.length, 3); +}); + +test("getAgent returns correct agent for valid providerId", () => { + const jules = getAgent("jules"); + assert.notStrictEqual(jules, null); + assert.strictEqual(jules?.providerId, "jules"); + + const devin = getAgent("devin"); + assert.notStrictEqual(devin, null); + assert.strictEqual(devin?.providerId, "devin"); + + const codex = getAgent("codex-cloud"); + assert.notStrictEqual(codex, null); + assert.strictEqual(codex?.providerId, "codex-cloud"); +}); + +test("getAgent returns null for invalid providerId", () => { + const result = getAgent("invalid-provider"); + assert.strictEqual(result, null); +}); + +test("isCloudAgentProvider returns true for valid providers", () => { + assert.strictEqual(isCloudAgentProvider("jules"), true); + assert.strictEqual(isCloudAgentProvider("devin"), true); + assert.strictEqual(isCloudAgentProvider("codex-cloud"), true); +}); + +test("isCloudAgentProvider returns false for invalid providers", () => { + assert.strictEqual(isCloudAgentProvider("openai"), false); + assert.strictEqual(isCloudAgentProvider("anthropic"), false); + assert.strictEqual(isCloudAgentProvider("invalid"), false); +}); diff --git a/tests/unit/combo-routing-engine.test.ts b/tests/unit/combo-routing-engine.test.ts index e90993bcdb..82f8e758cf 100644 --- a/tests/unit/combo-routing-engine.test.ts +++ b/tests/unit/combo-routing-engine.test.ts @@ -1503,7 +1503,7 @@ test("handleComboChat auto strategy honors LKGP after filtering to tool-capable name: "auto-lkgp", strategy: "auto", models: ["openai/gpt-oss-120b", "openai/gpt-4o-mini", "claude/claude-sonnet-4-6"], - autoConfig: { routingStrategy: "lkgp" }, + autoConfig: { routerStrategy: "lkgp" }, }, handleSingleModel: async (_body: any, modelStr: any) => { calls.push(modelStr); @@ -1621,7 +1621,7 @@ test("handleComboChat auto strategy falls back to the full pool when tool filter name: "auto-cost-fallback", strategy: "auto", models: ["openai/gpt-oss-120b", "deepseek/reasoner"], - autoConfig: { routingStrategy: "cost" }, + autoConfig: { routerStrategy: "cost" }, }, handleSingleModel: async (_body: any, modelStr: any) => { calls.push(modelStr); @@ -1658,7 +1658,7 @@ test("handleComboChat auto strategy falls back to rules when a custom router str name: "auto-throwing-strategy", strategy: "auto", models: ["openai/gpt-4o-mini"], - autoConfig: { routingStrategy: "throwing-test" }, + autoConfig: { routerStrategy: "throwing-test" }, }, handleSingleModel: async (_body: any, modelStr: any) => { calls.push(modelStr); diff --git a/tests/unit/command-code-auth-assist.test.ts b/tests/unit/command-code-auth-assist.test.ts new file mode 100644 index 0000000000..f8ca2c8a66 --- /dev/null +++ b/tests/unit/command-code-auth-assist.test.ts @@ -0,0 +1,231 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-command-code-auth-")); +process.env.DATA_DIR = TEST_DATA_DIR; +process.env.STORAGE_ENCRYPTION_KEY = "test-command-code-auth-encryption-key"; +delete process.env.INITIAL_PASSWORD; + +const core = await import("../../src/lib/db/core.ts"); +const startRoute = await import("../../src/app/api/providers/command-code/auth/start/route.ts"); +const callbackRoute = + await import("../../src/app/api/providers/command-code/auth/callback/route.ts"); +const statusRoute = await import("../../src/app/api/providers/command-code/auth/status/route.ts"); +const applyRoute = await import("../../src/app/api/providers/command-code/auth/apply/route.ts"); +const providersDb = await import("../../src/lib/db/providers.ts"); + +function resetDb() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +function jsonRequest(url: string, body: unknown, headers: HeadersInit = {}) { + return new Request(url, { + method: "POST", + headers: { "content-type": "application/json", ...headers }, + body: JSON.stringify(body), + }); +} + +test.beforeEach(() => { + delete process.env.OMNIROUTE_PUBLIC_BASE_URL; + delete process.env.OMNIROUTE_BASE_URL; + delete process.env.BASE_URL; + delete process.env.NEXT_PUBLIC_BASE_URL; + delete process.env.COMMAND_CODE_CALLBACK_PORT; + resetDb(); +}); + +test.after(() => { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); +}); + +test("Command Code auth assist start/callback/status/apply keeps state hash and key private", async () => { + const startResponse = await startRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/start", { + method: "POST", + headers: { origin: "http://localhost:20128" }, + }) + ); + assert.equal(startResponse.status, 200); + assert.equal(startResponse.headers.get("cache-control"), "no-store"); + const startBody = await startResponse.json(); + assert.equal(typeof startBody.state, "string"); + assert.ok(startBody.authUrl.startsWith("https://commandcode.ai/studio/auth/cli?")); + assert.ok(!("stateHash" in startBody)); + + const authUrl = new URL(startBody.authUrl); + const callbackUrl = authUrl.searchParams.get("callback"); + assert.ok(callbackUrl); + assert.equal(callbackUrl, startBody.callbackUrl); + assert.equal(callbackUrl, "http://localhost:5959/callback"); + assert.equal(startBody.mode, "manual"); + + const optionsResponse = await callbackRoute.OPTIONS( + new Request("http://localhost:20128/api/providers/command-code/auth/callback", { + method: "OPTIONS", + headers: { + origin: "https://commandcode.ai", + "access-control-request-headers": "content-type, x-command-code", + }, + }) + ); + assert.equal(optionsResponse.status, 204); + assert.equal( + optionsResponse.headers.get("access-control-allow-origin"), + "https://commandcode.ai" + ); + assert.equal(optionsResponse.headers.get("access-control-allow-methods"), "POST, OPTIONS"); + assert.equal(optionsResponse.headers.get("access-control-allow-private-network"), "true"); + assert.equal( + optionsResponse.headers.get("access-control-allow-headers"), + "content-type, x-command-code" + ); + + const callbackResponse = await callbackRoute.POST( + jsonRequest( + "http://localhost:20128/api/providers/command-code/auth/callback", + { + apiKey: "cc_test_secret", + state: startBody.state, + userId: "user-1", + userName: "Ada", + keyName: "Studio Key", + }, + { origin: "https://commandcode.ai" } + ) + ); + assert.equal(callbackResponse.status, 200); + const callbackBody = await callbackResponse.json(); + assert.equal(callbackBody.success, true); + + const statusResponse = await statusRoute.GET( + new Request( + `http://localhost:20128/api/providers/command-code/auth/status?state=${encodeURIComponent( + startBody.state + )}` + ) + ); + assert.equal(statusResponse.status, 200); + const statusBody = await statusResponse.json(); + assert.equal(statusBody.status, "received"); + assert.equal(statusBody.metadata.userName, "Ada"); + assert.ok(!JSON.stringify(statusBody).includes("cc_test_secret")); + assert.ok(!("stateHash" in statusBody)); + + const applyResponse = await applyRoute.POST( + jsonRequest("http://localhost:20128/api/providers/command-code/auth/apply", { + state: startBody.state, + name: "Command Code Studio", + setDefault: true, + }) + ); + assert.equal(applyResponse.status, 200); + const applyBody = await applyResponse.json(); + assert.equal(applyBody.status, "applied"); + assert.equal(applyBody.connection.provider, "command-code"); + assert.equal(applyBody.connection.authType, "apikey"); + assert.ok(!JSON.stringify(applyBody).includes("cc_test_secret")); + assert.ok(!("apiKey" in applyBody.connection)); + assert.ok(!("stateHash" in applyBody)); + + const connections = await providersDb.getProviderConnections({ provider: "command-code" }); + assert.equal(connections.length, 1); + assert.equal(connections[0].apiKey, "cc_test_secret"); + + const secondApplyResponse = await applyRoute.POST( + jsonRequest("http://localhost:20128/api/providers/command-code/auth/apply", { + state: startBody.state, + }) + ); + assert.equal(secondApplyResponse.status, 409); +}); + +test("Command Code auth assist keeps auth URL callback on CLI localhost contract", async () => { + process.env.OMNIROUTE_PUBLIC_BASE_URL = "https://omniroute.example.com/base-path"; + + const startResponse = await startRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/start", { + method: "POST", + headers: { origin: "http://localhost:20128" }, + }) + ); + assert.equal(startResponse.status, 200); + const startBody = await startResponse.json(); + const authUrl = new URL(startBody.authUrl); + + assert.equal(authUrl.searchParams.get("callback"), "http://localhost:5959/callback"); + assert.equal(startBody.callbackUrl, authUrl.searchParams.get("callback")); +}); + +test("Command Code auth assist allows only configured CLI callback port range", async () => { + process.env.COMMAND_CODE_CALLBACK_PORT = "5962"; + const configuredPortResponse = await startRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/start", { + method: "POST", + headers: { origin: "http://localhost:20128" }, + }) + ); + const configuredPortBody = await configuredPortResponse.json(); + assert.equal( + new URL(configuredPortBody.authUrl).searchParams.get("callback"), + "http://localhost:5962/callback" + ); + + resetDb(); + process.env.COMMAND_CODE_CALLBACK_PORT = "20128"; + const invalidPortResponse = await startRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/start", { + method: "POST", + headers: { origin: "http://localhost:20128" }, + }) + ); + const invalidPortBody = await invalidPortResponse.json(); + assert.equal( + new URL(invalidPortBody.authUrl).searchParams.get("callback"), + "http://localhost:5959/callback" + ); + + resetDb(); + process.env.COMMAND_CODE_CALLBACK_PORT = "5962abc"; + const partialPortResponse = await startRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/start", { + method: "POST", + headers: { origin: "http://localhost:20128" }, + }) + ); + const partialPortBody = await partialPortResponse.json(); + assert.equal( + new URL(partialPortBody.authUrl).searchParams.get("callback"), + "http://localhost:5959/callback" + ); +}); + +test("Command Code callback rejects disallowed origins and oversized bodies", async () => { + const disallowed = await callbackRoute.POST( + jsonRequest( + "http://localhost:20128/api/providers/command-code/auth/callback", + { apiKey: "secret", state: "x".repeat(32) }, + { origin: "https://evil.example" } + ) + ); + assert.equal(disallowed.status, 403); + assert.equal((await disallowed.json()).success, false); + assert.equal(disallowed.headers.get("access-control-allow-origin"), null); + + const tooLarge = await callbackRoute.POST( + new Request("http://localhost:20128/api/providers/command-code/auth/callback", { + method: "POST", + headers: { "content-type": "application/json", origin: "https://commandcode.ai" }, + body: JSON.stringify({ apiKey: "x".repeat(11 * 1024), state: "s".repeat(64) }), + }) + ); + assert.equal(tooLarge.status, 413); + assert.equal((await tooLarge.json()).success, false); + assert.equal(tooLarge.headers.get("access-control-allow-origin"), "https://commandcode.ai"); +}); diff --git a/tests/unit/command-code-executor.test.ts b/tests/unit/command-code-executor.test.ts new file mode 100644 index 0000000000..97335d5177 --- /dev/null +++ b/tests/unit/command-code-executor.test.ts @@ -0,0 +1,249 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-command-code-executor-")); +process.env.DATA_DIR = TEST_DATA_DIR; + +const { REGISTRY, getRegistryEntry } = await import("../../open-sse/config/providerRegistry.ts"); +const { CommandCodeExecutor } = await import("../../open-sse/executors/commandCode.ts"); +const { getExecutor, hasSpecializedExecutor } = await import("../../open-sse/executors/index.ts"); +const core = await import("../../src/lib/db/core.ts"); + +const originalFetch = globalThis.fetch; + +const PINNED_COMMAND_CODE_MODELS = [ + "claude-opus-4-7", + "claude-opus-4-6", + "claude-sonnet-4-6", + "claude-haiku-4-5-20251001", + "gpt-5.5", + "gpt-5.4", + "gpt-5.3-codex", + "gpt-5.4-mini", + "deepseek/deepseek-v4-pro", + "deepseek/deepseek-v4-flash", + "moonshotai/Kimi-K2.6", + "moonshotai/Kimi-K2.5", + "zai-org/GLM-5.1", + "zai-org/GLM-5", + "MiniMaxAI/MiniMax-M2.7", + "MiniMaxAI/MiniMax-M2.5", + "Qwen/Qwen3.6-Max-Preview", + "Qwen/Qwen3.6-Plus", +]; + +function commandCodeStream(lines: unknown[], { sse = false } = {}) { + const text = lines + .map((line) => { + const json = JSON.stringify(line); + return sse ? `data: ${json}\n\n` : `${json}\n`; + }) + .join(""); + return new Response(text, { status: 200, headers: { "Content-Type": "application/x-ndjson" } }); +} + +function toPlainHeaders(headers: any) { + if (headers instanceof Headers) return Object.fromEntries(headers.entries()); + return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key, String(value)])); +} + +function parseSsePayloads(sse: string) { + return sse + .split("\n") + .filter((line) => line.startsWith("data: ")) + .map((line) => line.slice(6).trim()) + .filter((line) => line && line !== "[DONE]") + .map((line) => JSON.parse(line)); +} + +test.afterEach(() => { + globalThis.fetch = originalFetch; +}); + +test.after(() => { + globalThis.fetch = originalFetch; + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); +}); + +test("Command Code provider catalog has pinned models and alias lookup", () => { + const entry = REGISTRY["command-code"]; + assert.ok(entry); + assert.equal(entry.alias, "cmd"); + assert.equal(entry.executor, "command-code"); + assert.equal(entry.baseUrl, "https://api.commandcode.ai"); + assert.equal(entry.chatPath, "/alpha/generate"); + assert.deepEqual( + entry.models.map((model) => model.id), + PINNED_COMMAND_CODE_MODELS + ); + assert.equal(getRegistryEntry("cmd"), entry); +}); + +test("getExecutor returns the specialized Command Code executor", () => { + assert.equal(hasSpecializedExecutor("command-code"), true); + assert.ok(getExecutor("command-code") instanceof CommandCodeExecutor); + assert.ok(getExecutor("cmd") instanceof CommandCodeExecutor); +}); + +test("Command Code executor posts wrapped body and required headers to alpha/generate", async () => { + const calls: any[] = []; + globalThis.fetch = async (url, init = {}) => { + calls.push({ url: String(url), init }); + return commandCodeStream([{ type: "text-delta", text: "hello" }, { type: "finish" }]); + }; + + const executor = getExecutor("command-code"); + const { response, url, headers, transformedBody } = await executor.execute({ + model: "gpt-5.4-mini", + stream: false, + credentials: { apiKey: "cc_test_key" }, + body: { + stream: false, + messages: [ + { role: "system", content: "You are concise." }, + { role: "user", content: "Hi" }, + ], + tools: [{ type: "function", function: { name: "lookup", parameters: { type: "object" } } }], + max_tokens: 42, + }, + }); + + assert.equal(url, "https://api.commandcode.ai/alpha/generate"); + assert.equal(calls.length, 1); + assert.equal(calls[0].url, "https://api.commandcode.ai/alpha/generate"); + assert.equal(calls[0].init.method, "POST"); + assert.equal(headers.Authorization, "Bearer cc_test_key"); + assert.equal(headers["x-command-code-version"], "0.24.1"); + assert.equal(headers["x-cli-environment"], "external"); + assert.equal(headers["x-project-slug"], "pi-cc"); + assert.equal(headers["x-taste-learning"], "false"); + assert.equal(headers["x-co-flag"], "false"); + assert.equal(typeof headers["x-session-id"], "string"); + + const posted = JSON.parse(String(calls[0].init.body)); + assert.deepEqual(posted, transformedBody); + for (const key of ["config", "memory", "taste", "permissionMode", "params"]) { + assert.ok(key in posted, `missing ${key}`); + } + assert.equal(posted.params.model, "gpt-5.4-mini"); + assert.equal(posted.params.stream, false); + assert.equal(posted.params.system, "You are concise."); + assert.equal(posted.params.messages[0].role, "user"); + assert.equal(posted.params.tools[0].name, "lookup"); + + const json = await response.json(); + assert.equal(json.choices[0].message.content, "hello"); +}); + +test("Command Code raw NDJSON stream becomes OpenAI chat SSE chunks", async () => { + globalThis.fetch = async () => + commandCodeStream([ + { type: "text-delta", text: "Hello" }, + { type: "reasoning-delta", text: "thinking" }, + { type: "tool-call", toolCallId: "call_1", toolName: "search", input: { q: "docs" } }, + { type: "finish", finishReason: "tool-calls" }, + ]); + + const { response } = await getExecutor("command-code").execute({ + model: "gpt-5.4", + stream: true, + credentials: { apiKey: "cc_test_key" }, + body: { messages: [{ role: "user", content: "Hi" }] }, + }); + + assert.equal(response.headers.get("Content-Type"), "text/event-stream; charset=utf-8"); + const sse = await response.text(); + assert.match(sse, /data: \[DONE\]/); + const chunks = parseSsePayloads(sse); + assert.equal(chunks[0].object, "chat.completion.chunk"); + assert.deepEqual(chunks[0].choices[0].delta, { role: "assistant" }); + assert.equal(chunks[1].choices[0].delta.content, "Hello"); + assert.equal(chunks[2].choices[0].delta.reasoning_content, "thinking"); + assert.equal(chunks[3].choices[0].delta.tool_calls[0].function.name, "search"); + assert.equal(chunks.at(-1).choices[0].finish_reason, "tool_calls"); +}); + +test("Command Code data: SSE lines aggregate into non-stream ChatCompletion JSON", async () => { + globalThis.fetch = async () => + commandCodeStream( + [ + { type: "text-delta", text: "Hel" }, + { type: "text-delta", text: "lo" }, + { type: "reasoning-delta", text: "because" }, + { type: "tool-call", id: "call_2", name: "lookup", arguments: { id: 7 } }, + { + type: "finish", + finishReason: "max_tokens", + totalUsage: { + inputTokens: 3, + inputTokenDetails: { cacheReadTokens: 2 }, + outputTokens: 5, + }, + }, + ], + { sse: true } + ); + + const { response } = await getExecutor("command-code").execute({ + model: "gpt-5.4-mini", + stream: false, + credentials: { apiKey: "cc_test_key" }, + body: { messages: [{ role: "user", content: "Hi" }] }, + }); + + assert.equal(response.headers.get("Content-Type"), "application/json"); + const json = await response.json(); + assert.equal(json.object, "chat.completion"); + assert.equal(json.choices[0].message.content, "Hello"); + assert.equal(json.choices[0].message.reasoning_content, "because"); + assert.equal(json.choices[0].message.tool_calls[0].function.arguments, JSON.stringify({ id: 7 })); + assert.equal(json.choices[0].finish_reason, "length"); + assert.deepEqual(json.usage, { prompt_tokens: 5, completion_tokens: 5, total_tokens: 10 }); +}); + +test("Command Code executor surfaces upstream and streamed errors", async () => { + globalThis.fetch = async () => + new Response("bad key", { status: 401, statusText: "Unauthorized" }); + const upstreamFailure = await getExecutor("command-code").execute({ + model: "gpt-5.4-mini", + stream: false, + credentials: { apiKey: "cc_test_key" }, + body: { messages: [{ role: "user", content: "Hi" }] }, + }); + assert.equal(upstreamFailure.response.status, 401); + assert.equal(await upstreamFailure.response.text(), "bad key"); + + globalThis.fetch = async () => commandCodeStream([{ type: "error", error: { message: "boom" } }]); + await assert.rejects(async () => { + await getExecutor("command-code").execute({ + model: "gpt-5.4-mini", + stream: false, + credentials: { apiKey: "cc_test_key" }, + body: { messages: [{ role: "user", content: "Hi" }] }, + }); + }, /boom/); +}); + +test("Command Code non-stream aggregation throws when the final error event lacks a trailing newline", async () => { + globalThis.fetch = async () => + new Response( + `${JSON.stringify({ type: "text-delta", text: "Hello" })}\n${JSON.stringify({ + type: "error", + error: { message: "boom" }, + })}`, + { status: 200, headers: { "Content-Type": "application/x-ndjson" } } + ); + + await assert.rejects(async () => { + await getExecutor("command-code").execute({ + model: "gpt-5.4-mini", + stream: false, + credentials: { apiKey: "cc_test_key" }, + body: { messages: [{ role: "user", content: "Hi" }] }, + }); + }, /boom/); +}); diff --git a/tests/unit/compression/rtk-code-stripper.test.ts b/tests/unit/compression/rtk-code-stripper.test.ts index a191d31160..bba15c0264 100644 --- a/tests/unit/compression/rtk-code-stripper.test.ts +++ b/tests/unit/compression/rtk-code-stripper.test.ts @@ -23,7 +23,7 @@ describe("RTK code stripper", () => { ); assert.ok(js.text.includes("// comment")); - assert.match(js.text, /https:\/\/example\.com\/a\/\/b/); + assert.ok(js.text.includes("https://example.com/a//b")); assert.ok(js.text.includes("/* block */")); }); diff --git a/tests/unit/context-manager.test.ts b/tests/unit/context-manager.test.ts index a9ad714794..7950930fa5 100644 --- a/tests/unit/context-manager.test.ts +++ b/tests/unit/context-manager.test.ts @@ -27,7 +27,7 @@ test("getTokenLimit: detects gemini", () => { }); test("getTokenLimit: uses GPT-5.5 Codex model context", () => { - assert.equal(getTokenLimit("codex", "gpt-5.5"), 1050000); + assert.equal(getTokenLimit("codex", "gpt-5.5"), 400000); }); test("getTokenLimit: default fallback", () => { diff --git a/tests/unit/cursor-usage-fetcher.test.ts b/tests/unit/cursor-usage-fetcher.test.ts new file mode 100644 index 0000000000..60cc78d63c --- /dev/null +++ b/tests/unit/cursor-usage-fetcher.test.ts @@ -0,0 +1,238 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const usageService = await import("../../open-sse/services/usage.ts"); + +const CURSOR_USAGE_URL = "https://cursor.com/api/dashboard/get-current-period-usage"; + +function makeJwt(payload: Record<string, unknown>): string { + const b64url = (input: string) => + Buffer.from(input) + .toString("base64") + .replace(/=+$/, "") + .replace(/\+/g, "-") + .replace(/\//g, "_"); + const header = b64url(JSON.stringify({ alg: "HS256", typ: "JWT" })); + const body = b64url(JSON.stringify(payload)); + return `${header}.${body}.signature`; +} + +const SAMPLE_RESPONSE = { + billingCycleStart: "1776672371000", + billingCycleEnd: "1779264371000", + planUsage: { + totalSpend: 1529, + includedSpend: 1529, + remaining: 471, + limit: 2000, + autoPercentUsed: 13.20952380952381, + apiPercentUsed: 3.155555555555556, + totalPercentUsed: 10.193333333333333, + }, + spendLimitUsage: { limitType: "user" }, + enabled: true, +}; + +interface CapturedRequest { + url: string; + init: RequestInit; +} + +function installFetchMock( + responder: (url: string, init: RequestInit) => Response | Promise<Response> +): { restore: () => void; calls: CapturedRequest[] } { + const calls: CapturedRequest[] = []; + const original = globalThis.fetch; + globalThis.fetch = (async (input: any, init: RequestInit = {}) => { + const url = typeof input === "string" ? input : (input as Request).url; + calls.push({ url, init }); + return await responder(url, init); + }) as typeof fetch; + return { + restore: () => { + globalThis.fetch = original; + }, + calls, + }; +} + +test("cursor usage: happy path returns three windows with correct percentages and reset", async () => { + const userId = "user_01TESTSTOREDID"; + const accessToken = makeJwt({ sub: `google-oauth2|${userId}` }); + + const mock = installFetchMock( + async () => + new Response(JSON.stringify(SAMPLE_RESPONSE), { + status: 200, + headers: { "content-type": "application/json" }, + }) + ); + + try { + const usage = await usageService.getUsageForProvider({ + provider: "cursor", + accessToken, + providerSpecificData: { userId }, + }); + + assert.equal(usage.plan, "Cursor Pro"); + assert.deepEqual(Object.keys(usage.quotas), ["Total", "Auto + Composer", "API"]); + + const total = usage.quotas.Total; + assert.equal(total.total, 20); // limit 2000 cents = $20 + assert.equal(total.used, 15.29); // totalSpend 1529 cents = $15.29 + assert.equal(total.remaining, 4.71); + assert.ok(Math.abs(total.remainingPercentage - (100 - 10.193333333333333)) < 1e-6); + assert.equal(total.unlimited, false); + assert.equal(total.resetAt, new Date(Number("1779264371000")).toISOString()); + + const auto = usage.quotas["Auto + Composer"]; + assert.equal(auto.total, 20); + // 2000 cents * 13.2095% ≈ 264 cents = $2.64 + assert.equal(auto.used, 2.64); + assert.ok(Math.abs(auto.remainingPercentage - (100 - 13.20952380952381)) < 1e-6); + + const api = usage.quotas.API; + assert.equal(api.total, 20); + // 2000 cents * 3.1556% ≈ 63 cents = $0.63 + assert.equal(api.used, 0.63); + assert.ok(Math.abs(api.remainingPercentage - (100 - 3.155555555555556)) < 1e-6); + } finally { + mock.restore(); + } +}); + +test("cursor usage: sends correct cookie, origin, body, and method", async () => { + const userId = "user_01HEADERCHECK"; + const accessToken = makeJwt({ sub: userId }); + + const mock = installFetchMock( + async () => + new Response(JSON.stringify(SAMPLE_RESPONSE), { + status: 200, + headers: { "content-type": "application/json" }, + }) + ); + + try { + await usageService.getUsageForProvider({ + provider: "cursor", + accessToken, + providerSpecificData: { userId }, + }); + + assert.equal(mock.calls.length, 1); + const { url, init } = mock.calls[0]; + assert.equal(url, CURSOR_USAGE_URL); + assert.equal(init.method, "POST"); + assert.equal(init.body, "{}"); + + const headers = init.headers as Record<string, string>; + assert.equal(headers.Cookie, `WorkosCursorSessionToken=${userId}::${accessToken}`); + assert.equal(headers.Origin, "https://cursor.com"); + assert.match(headers.Referer, /^https:\/\/cursor\.com\/dashboard/); + assert.equal(headers["Content-Type"], "application/json"); + assert.ok(headers["User-Agent"]); + } finally { + mock.restore(); + } +}); + +test("cursor usage: falls back to JWT sub when providerSpecificData.userId is missing", async () => { + const userId = "user_01JWTFALLBACK"; + const accessToken = makeJwt({ sub: `google-oauth2|${userId}` }); + + const mock = installFetchMock( + async () => + new Response(JSON.stringify(SAMPLE_RESPONSE), { + status: 200, + headers: { "content-type": "application/json" }, + }) + ); + + try { + const usage = await usageService.getUsageForProvider({ + provider: "cursor", + accessToken, + providerSpecificData: {}, + }); + + assert.equal(usage.plan, "Cursor Pro"); + assert.equal(mock.calls.length, 1); + const headers = mock.calls[0].init.headers as Record<string, string>; + // Cookie should use the full sub claim (google-oauth2|user_...) since Cursor accepts both forms. + assert.equal( + headers.Cookie, + `WorkosCursorSessionToken=google-oauth2|${userId}::${accessToken}` + ); + } finally { + mock.restore(); + } +}); + +test("cursor usage: returns message and skips fetch when userId is unrecoverable", async () => { + const mock = installFetchMock(async () => new Response("should not be called", { status: 500 })); + + try { + const usage = await usageService.getUsageForProvider({ + provider: "cursor", + accessToken: "not-a-jwt-and-too-short", + providerSpecificData: {}, + }); + + assert.equal(mock.calls.length, 0); + assert.match(usage.message, /missing user id/i); + assert.equal(usage.quotas, undefined); + } finally { + mock.restore(); + } +}); + +test("cursor usage: 307 redirect surfaces as expired session message", async () => { + const accessToken = makeJwt({ sub: "user_01EXPIRED" }); + const mock = installFetchMock( + async () => + new Response("", { + status: 307, + headers: { Location: "https://api.workos.com/user_management/authorize?..." }, + }) + ); + + try { + const usage = await usageService.getUsageForProvider({ + provider: "cursor", + accessToken, + providerSpecificData: { userId: "user_01EXPIRED" }, + }); + + assert.equal(usage.plan, "Cursor"); + assert.match(usage.message, /session expired|Re-import/i); + assert.equal(usage.quotas, undefined); + } finally { + mock.restore(); + } +}); + +test("cursor usage: empty planUsage returns informational message", async () => { + const accessToken = makeJwt({ sub: "user_01EMPTY" }); + const mock = installFetchMock( + async () => + new Response( + JSON.stringify({ billingCycleStart: "0", billingCycleEnd: "0", planUsage: {} }), + { status: 200, headers: { "content-type": "application/json" } } + ) + ); + + try { + const usage = await usageService.getUsageForProvider({ + provider: "cursor", + accessToken, + providerSpecificData: { userId: "user_01EMPTY" }, + }); + + assert.equal(usage.plan, "Cursor"); + assert.match(usage.message, /No active plan usage/i); + } finally { + mock.restore(); + } +}); diff --git a/tests/unit/db-migration-runner.test.ts b/tests/unit/db-migration-runner.test.ts index a0595ad532..519fcebf74 100644 --- a/tests/unit/db-migration-runner.test.ts +++ b/tests/unit/db-migration-runner.test.ts @@ -857,6 +857,141 @@ test( } ); +test( + "runMigrations ignores superseded 041 session affinity duplicate when 050 exists", + serial, + async () => { + const runner = await importFresh("src/lib/db/migrationRunner.ts"); + const db = createDb(); + + try { + const count = withMockedMigrationFs( + { + "038_compression_analytics.sql": ` + CREATE TABLE compression_analytics ( + id TEXT PRIMARY KEY, + request_id TEXT + ); + `, + "041_compression_receipts.sql": "-- handled by migrationRunner", + "041_session_account_affinity.sql": ` + CREATE TABLE duplicate_041_session_account_affinity (id TEXT PRIMARY KEY); + `, + "050_session_account_affinity.sql": ` + CREATE TABLE IF NOT EXISTS session_account_affinity ( + session_key TEXT NOT NULL, + provider TEXT NOT NULL, + connection_id TEXT NOT NULL, + created_at INTEGER NOT NULL, + last_seen_at INTEGER NOT NULL, + PRIMARY KEY (session_key, provider) + ); + `, + }, + () => runner.runMigrations(db) + ); + + assert.equal(count, 3); + assert.equal( + db.prepare("SELECT name FROM _omniroute_migrations WHERE version = ?").get("041")?.name, + "compression_receipts" + ); + assert.equal( + db.prepare("SELECT name FROM _omniroute_migrations WHERE version = ?").get("050")?.name, + "session_account_affinity" + ); + assert.deepEqual( + db + .prepare( + "SELECT name FROM sqlite_master WHERE type = 'table' AND name IN (?, ?) ORDER BY name" + ) + .all("duplicate_041_session_account_affinity", "session_account_affinity"), + [{ name: "session_account_affinity" }] + ); + } finally { + db.close(); + } + } +); + +test( + "reconcileRenumberedMigrations moves legacy 041 session affinity marker to 050", + serial, + async () => { + const runner = await importFresh("src/lib/db/migrationRunner.ts"); + const db = createDb(); + + try { + db.exec(` + CREATE TABLE _omniroute_migrations ( + version TEXT PRIMARY KEY, + name TEXT NOT NULL, + applied_at TEXT NOT NULL DEFAULT (datetime('now')) + ); + CREATE TABLE compression_analytics ( + id TEXT PRIMARY KEY, + request_id TEXT + ); + `); + db.prepare("INSERT INTO _omniroute_migrations (version, name) VALUES (?, ?)").run( + "041", + "session_account_affinity" + ); + + const consoleErrors: string[] = []; + const originalError = console.error; + console.error = (...args: any[]) => { + consoleErrors.push(args.map(String).join(" ")); + }; + + try { + const count = withMockedMigrationFs( + { + "041_compression_receipts.sql": "-- handled by migrationRunner", + "041_session_account_affinity.sql": ` + CREATE TABLE duplicate_041_session_account_affinity (id TEXT PRIMARY KEY); + `, + "050_session_account_affinity.sql": ` + CREATE TABLE IF NOT EXISTS session_account_affinity ( + session_key TEXT NOT NULL, + provider TEXT NOT NULL, + connection_id TEXT NOT NULL, + created_at INTEGER NOT NULL, + last_seen_at INTEGER NOT NULL, + PRIMARY KEY (session_key, provider) + ); + `, + }, + () => runner.runMigrations(db) + ); + + assert.equal(count, 1); + assert.equal( + db.prepare("SELECT name FROM _omniroute_migrations WHERE version = ?").get("041")?.name, + "compression_receipts" + ); + assert.equal( + db.prepare("SELECT name FROM _omniroute_migrations WHERE version = ?").get("050")?.name, + "session_account_affinity" + ); + + const renumberingWarnings = consoleErrors.filter( + (e) => e.includes("CRITICAL") && e.includes("renumbered") + ); + assert.equal( + renumberingWarnings.length, + 0, + `Expected no renumbering warnings, got: ${renumberingWarnings.join("; ")}` + ); + } finally { + console.error = originalError; + } + } finally { + db.close(); + } + } +); + test( "full upgrade simulation: all 3 renumbered migrations reconciled without CRITICAL warnings", serial, diff --git a/tests/unit/docs-site-overhaul.test.ts b/tests/unit/docs-site-overhaul.test.ts index 202422f4e0..584c828268 100644 --- a/tests/unit/docs-site-overhaul.test.ts +++ b/tests/unit/docs-site-overhaul.test.ts @@ -18,13 +18,14 @@ test("docsNavigation has expected sections", () => { assert.deepEqual( docsNavigation.map((section) => section.title), [ - "Getting Started", - "Features", - "API & Protocols", - "Deployment", - "Operations", - "Development", - "Other", + "Architecture", + "Guides", + "Reference", + "Frameworks", + "Routing", + "Security", + "Compression", + "Ops", ] ); }); @@ -55,7 +56,7 @@ test("getDocItemBySlug returns section title and item for known slug", () => { const result = getDocItemBySlug("setup-guide"); assert.ok(result, "setup-guide should be found"); assert.equal(result.item.slug, "setup-guide"); - assert.equal(result.sectionTitle, "Getting Started"); + assert.equal(result.sectionTitle, "Guides"); }); test("getDocItemBySlug returns null for unknown slug", () => { @@ -313,23 +314,31 @@ test("WhatsNewSection is importable", async () => { }); // ────────────────────────────────────────────── -// i18n locale system +// i18n locale system (next-intl + config/i18n.json) // ────────────────────────────────────────────── -test("DocsI18n is importable", async () => { - const mod = await import("../../src/app/docs/components/DocsI18n"); - assert.ok(mod.useLocalizedSectionTitle, "useLocalizedSectionTitle should be exported"); - assert.ok(mod.getAvailableLocales, "getAvailableLocales should be exported"); - assert.ok(mod.LOCALE_NAMES, "LOCALE_NAMES should be exported"); - assert.equal(mod.LOCALE_NAMES.en, "English"); - assert.equal(mod.LOCALE_NAMES["zh-CN"], "简体中文"); +test("docs locale handling uses the shared next-intl config", async () => { + const cfg = await import("../../src/i18n/config"); + assert.ok(Array.isArray(cfg.LANGUAGES), "LANGUAGES should be exported"); + assert.ok(cfg.LANGUAGES.length >= 10, "LANGUAGES should cover all configured locales"); + const codes = cfg.LANGUAGES.map((l) => l.code); + assert.ok(codes.includes("en")); + assert.ok(codes.includes("pt-BR")); + assert.ok(codes.includes("zh-CN")); + const en = cfg.LANGUAGES.find((l) => l.code === "en"); + const zh = cfg.LANGUAGES.find((l) => l.code === "zh-CN"); + assert.equal(en?.english, "English"); + assert.equal(zh?.native, "中文 (简体)"); }); -test("getAvailableLocales returns 10 locales", async () => { - const { getAvailableLocales } = await import("../../src/app/docs/components/DocsI18n"); - const locales = getAvailableLocales(); - assert.equal(locales.length, 10); - assert.ok(locales.includes("en")); - assert.ok(locales.includes("pt-BR")); - assert.ok(locales.includes("zh-CN")); +test("docs language selector reuses the global LanguageSelector component", async () => { + const selector = await import("../../src/shared/components/LanguageSelector"); + assert.ok(selector.default, "LanguageSelector default export should exist"); +}); + +test("DocsI18n shim is no longer present (replaced by next-intl)", async () => { + await assert.rejects( + async () => import("../../src/app/docs/components/DocsI18n"), + "DocsI18n.tsx should be removed; docs UI uses next-intl directly" + ); }); diff --git a/tests/unit/electron-smoke-script.test.ts b/tests/unit/electron-smoke-script.test.ts index 183d621f31..f2fdcbe3d2 100644 --- a/tests/unit/electron-smoke-script.test.ts +++ b/tests/unit/electron-smoke-script.test.ts @@ -5,7 +5,7 @@ import { buildSmokeEnv, FATAL_LOG_PATTERNS, LINUX_EXECUTABLE_NAMES, -} from "../../scripts/smoke-electron-packaged.mjs"; +} from "../../scripts/dev/smoke-electron-packaged.mjs"; test("electron smoke discovers the default Linux executable name", () => { assert.ok(LINUX_EXECUTABLE_NAMES.includes("omniroute-desktop")); diff --git a/tests/unit/error-message-sanitization.test.ts b/tests/unit/error-message-sanitization.test.ts new file mode 100644 index 0000000000..b304d1ec55 --- /dev/null +++ b/tests/unit/error-message-sanitization.test.ts @@ -0,0 +1,203 @@ +/** + * Verifies that API routes sanitize error messages (CodeQL js/stack-trace-exposure) + * and that security-critical helpers behave correctly. + */ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-err-sanitize-")); +process.env.DATA_DIR = TEST_DATA_DIR; +process.env.API_KEY_SECRET = "test-api-key-secret-32chars-long!!"; + +const core = await import("../../src/lib/db/core.ts"); +const combosDb = await import("../../src/lib/db/combos.ts"); +const mappingsRoute = await import("../../src/app/api/model-combo-mappings/route.ts"); +const mappingsIdRoute = await import("../../src/app/api/model-combo-mappings/[id]/route.ts"); +const syncTokens = await import("../../src/lib/sync/tokens.ts"); + +function makeRequest(url: string, options: { method?: string; body?: unknown } = {}) { + const { method = "GET", body } = options; + return new Request(url, { + method, + headers: body !== undefined ? { "content-type": "application/json" } : undefined, + body: body !== undefined ? JSON.stringify(body) : undefined, + }); +} + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +test.beforeEach(async () => { + await resetStorage(); +}); + +test.after(() => { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); +}); + +async function createCombo(name: string, model: string) { + return combosDb.createCombo({ + name, + models: [{ provider: "openai", model }], + strategy: "priority", + config: {}, + }); +} + +// ── model-combo-mappings routes ────────────────────────────────────────────── + +test("GET /model-combo-mappings returns empty list on fresh DB", async () => { + const res = await mappingsRoute.GET(); + assert.equal(res.status, 200); + const body = (await res.json()) as any; + assert.ok(Array.isArray(body.mappings), "body.mappings must be an array"); + assert.equal(body.mappings.length, 0); + assert.ok(!("error" in body), "success response must not contain error field"); +}); + +test("GET /model-combo-mappings error response never leaks raw error.message", async () => { + const res = await mappingsRoute.GET(); + // In the success case, there is no error field at all + const body = (await res.json()) as any; + if (res.status >= 500) { + assert.equal(body.error, "Failed to list model-combo mappings"); + assert.ok(!("stack" in body), "stack trace must not be present in response"); + } +}); + +test("POST /model-combo-mappings returns 400 for empty pattern", async () => { + const res = await mappingsRoute.POST( + makeRequest("http://localhost/api/model-combo-mappings", { + method: "POST", + body: { pattern: "", comboId: "combo-1" }, + }) + ); + assert.equal(res.status, 400); + const body = (await res.json()) as any; + assert.ok("error" in body); + assert.ok(!("stack" in body), "400 response must not contain stack trace"); +}); + +test("POST /model-combo-mappings returns 400 for missing comboId", async () => { + const res = await mappingsRoute.POST( + makeRequest("http://localhost/api/model-combo-mappings", { + method: "POST", + body: { pattern: "gpt-*" }, + }) + ); + assert.equal(res.status, 400); +}); + +test("POST /model-combo-mappings creates a mapping and response has no error field", async () => { + const combo = await createCombo("test-combo", "gpt-4o"); + const res = await mappingsRoute.POST( + makeRequest("http://localhost/api/model-combo-mappings", { + method: "POST", + body: { pattern: "gpt-*", comboId: combo.id }, + }) + ); + assert.equal(res.status, 201); + const body = (await res.json()) as any; + assert.ok("mapping" in body, "response must have mapping field"); + assert.ok(!("error" in body), "success response must not contain error field"); + assert.ok(!("stack" in body)); + assert.equal(body.mapping.pattern, "gpt-*"); +}); + +test("GET /model-combo-mappings/[id] returns 404 for non-existent id", async () => { + const res = await mappingsIdRoute.GET( + makeRequest("http://localhost/api/model-combo-mappings/nonexistent"), + { params: Promise.resolve({ id: "nonexistent" }) } + ); + assert.equal(res.status, 404); + const body = (await res.json()) as any; + assert.equal(body.error, "Mapping not found"); + assert.ok(!("stack" in body), "404 response must not contain stack trace"); +}); + +test("GET /model-combo-mappings/[id] error response never leaks internal details", async () => { + const res = await mappingsIdRoute.GET( + makeRequest("http://localhost/api/model-combo-mappings/some-id"), + { params: Promise.resolve({ id: "some-id" }) } + ); + const body = (await res.json()) as any; + if (res.status >= 500) { + assert.equal(body.error, "Failed to get mapping"); + assert.ok(!body.error.includes("SQLITE"), "SQLite internals must not be exposed"); + assert.ok(!("stack" in body)); + } +}); + +test("DELETE /model-combo-mappings/[id] returns 404 for non-existent mapping", async () => { + const res = await mappingsIdRoute.DELETE( + makeRequest("http://localhost/api/model-combo-mappings/nonexistent", { method: "DELETE" }), + { params: Promise.resolve({ id: "nonexistent" }) } + ); + assert.equal(res.status, 404); + const body = (await res.json()) as any; + assert.equal(body.error, "Mapping not found"); + assert.ok(!("stack" in body)); +}); + +test("PUT /model-combo-mappings/[id] returns 404 for non-existent mapping", async () => { + const res = await mappingsIdRoute.PUT( + makeRequest("http://localhost/api/model-combo-mappings/nonexistent", { + method: "PUT", + body: { pattern: "new-*" }, + }), + { params: Promise.resolve({ id: "nonexistent" }) } + ); + assert.equal(res.status, 404); + const body = (await res.json()) as any; + assert.equal(body.error, "Mapping not found"); + assert.ok(!("stack" in body)); +}); + +// ── sync token hashing (src/lib/sync/tokens.ts) ────────────────────────────── + +test("hashSyncToken returns a 64-character hex string (SHA-256 output)", () => { + const token = syncTokens.generatePlaintextSyncToken(); + const hash = syncTokens.hashSyncToken(token); + assert.match(hash, /^[0-9a-f]{64}$/, "hash must be 64 lowercase hex chars"); +}); + +test("hashSyncToken is deterministic — same input always produces same output", () => { + const token = syncTokens.generatePlaintextSyncToken(); + assert.equal( + syncTokens.hashSyncToken(token), + syncTokens.hashSyncToken(token), + "hashing the same token twice must yield the same result" + ); +}); + +test("hashSyncToken produces different hashes for different tokens", () => { + const a = syncTokens.generatePlaintextSyncToken(); + const b = syncTokens.generatePlaintextSyncToken(); + assert.notEqual( + syncTokens.hashSyncToken(a), + syncTokens.hashSyncToken(b), + "different tokens must produce different hashes" + ); +}); + +test("generatePlaintextSyncToken starts with osync_ prefix", () => { + const token = syncTokens.generatePlaintextSyncToken(); + assert.ok( + token.startsWith("osync_"), + `token must start with 'osync_', got: ${token.slice(0, 10)}` + ); +}); + +test("hashSyncToken output is never the plain token (not stored in clear text)", () => { + const token = syncTokens.generatePlaintextSyncToken(); + const hash = syncTokens.hashSyncToken(token); + assert.notEqual(hash, token, "hash must differ from plaintext token"); + assert.ok(!hash.startsWith("osync_"), "hash must not start with the token prefix"); +}); diff --git a/tests/unit/executor-antigravity.test.ts b/tests/unit/executor-antigravity.test.ts index ab2898dc9a..b0e89c155f 100644 --- a/tests/unit/executor-antigravity.test.ts +++ b/tests/unit/executor-antigravity.test.ts @@ -9,6 +9,32 @@ import { seedAntigravityVersionCache, } from "../../open-sse/services/antigravityVersion.ts"; +type AntigravityTransformResult = Exclude< + Awaited<ReturnType<AntigravityExecutor["transformRequest"]>>, + Response +>; + +type ErrorPayload = { + error: { + code?: string; + message: string; + }; + retryAfterMs?: number; +}; + +type ChatCompletionPayload = { + object?: string; + choices: Array<{ + message: { content: string }; + finish_reason: string; + }>; + usage?: { + prompt_tokens: number; + completion_tokens: number; + total_tokens: number; + }; +}; + async function withEnv<T>( name: string, value: string | undefined, @@ -115,8 +141,10 @@ test("AntigravityExecutor.transformRequest normalizes model, project and content assert.match(result.requestId, /^agent\/\d+\/[0-9a-f]{8}$/); assert.deepEqual(result.enabledCreditTypes, ["GOOGLE_ONE_AI"]); assert.ok(result.request.sessionId); - assert.equal(result.request.generationConfig.topK, 40); - assert.equal(result.request.generationConfig.topP, 1.0); + const request = result.request as { generationConfig?: { topK?: number; topP?: number } }; + const generationConfig = request.generationConfig || {}; + assert.equal(generationConfig.topK, 40); + assert.equal(generationConfig.topP, 1.0); assert.deepEqual(result.request.toolConfig, { functionCallingConfig: { mode: "VALIDATED" }, }); @@ -198,13 +226,96 @@ test("AntigravityExecutor.transformRequest returns a structured error response w true, {} ); - const payload = (await result.json()) as any; + if (!(result instanceof Response)) throw new Error("Expected Response from transformRequest"); + const payload = (await result.json()) as ErrorPayload; assert.equal(result.status, 422); assert.equal(payload.error.code, "missing_project_id"); assert.match(payload.error.message, /Missing Google projectId/); }); +test("AntigravityExecutor.transformRequest prefers top-level credentials projectId over nested providerSpecificData", async () => { + const executor = new AntigravityExecutor(); + const result = await executor.transformRequest( + "antigravity/gemini-2.5-pro", + { + project: "body-project", + request: { + contents: [{ role: "user", parts: [{ text: "Hello" }] }], + }, + }, + true, + { + projectId: "credential-project", + providerSpecificData: { projectId: "nested-project" }, + } + ); + + if (result instanceof Response) throw new Error("Unexpected Response from transformRequest"); + assert.equal(result.project, "credential-project"); +}); + +test("AntigravityExecutor.transformRequest uses nested providerSpecificData projectId when top-level is absent", async () => { + const executor = new AntigravityExecutor(); + const result = await executor.transformRequest( + "antigravity/gemini-2.5-pro", + { + request: { + contents: [{ role: "user", parts: [{ text: "Hello" }] }], + }, + }, + true, + { + providerSpecificData: { projectId: "nested-project" }, + } + ); + + if (result instanceof Response) throw new Error("Unexpected Response from transformRequest"); + assert.equal(result.project, "nested-project"); +}); + +test("AntigravityExecutor.transformRequest treats whitespace-only project values as missing", async () => { + const executor = new AntigravityExecutor(); + + const nestedFallback = await executor.transformRequest( + "antigravity/gemini-2.5-pro", + { + project: " ", + request: { + contents: [{ role: "user", parts: [{ text: "Hello" }] }], + }, + }, + true, + { + projectId: " ", + providerSpecificData: { projectId: " nested-project " }, + } + ); + + if (nestedFallback instanceof Response) + throw new Error("Unexpected Response from transformRequest"); + assert.equal(nestedFallback.project, "nested-project"); + + const bodyFallback = await executor.transformRequest( + "antigravity/gemini-2.5-pro", + { + project: " body-project ", + request: { + contents: [{ role: "user", parts: [{ text: "Hello" }] }], + }, + }, + true, + { + projectId: " ", + providerSpecificData: { projectId: " " }, + } + ); + + if (bodyFallback instanceof Response) + throw new Error("Unexpected Response from transformRequest"); + assert.equal(bodyFallback.project, "body-project"); +}); + test("AntigravityExecutor.transformRequest allows body project overrides when the env flag is enabled", async () => { const executor = new AntigravityExecutor(); @@ -277,7 +388,7 @@ test("AntigravityExecutor.collectStreamToResponse turns SSE Gemini chunks into a { Authorization: "Bearer ag-token" }, { request: {} } ); - const payload = (await result.response.json()) as any; + const payload = (await result.response.json()) as ChatCompletionPayload; assert.equal(result.response.status, 200); assert.equal(payload.object, "chat.completion"); @@ -343,7 +454,7 @@ test("AntigravityExecutor.collectStreamToResponse parses fragmented SSE lines in { Authorization: "Bearer ag-token" }, { request: {} } ); - const payload = (await result.response.json()) as any; + const payload = (await result.response.json()) as ChatCompletionPayload; assert.equal(payload.choices[0].message.content, "Fragmented"); assert.equal(payload.choices[0].finish_reason, "stop"); @@ -423,10 +534,10 @@ test("AntigravityExecutor.execute auto-retries short 429 responses and collects model: "antigravity/gemini-2.5-flash", body: { request: { contents: [] } }, stream: false, - credentials: { accessToken: "token", projectId: "project-1" } as any, + credentials: { accessToken: "token", projectId: "project-1" }, log: { debug() {}, warn() {} }, }); - const payload = (await result.response.json()) as any; + const payload = (await result.response.json()) as ChatCompletionPayload; assert.equal(calls.length, 2); assert.equal(result.response.status, 200); @@ -465,10 +576,10 @@ test("AntigravityExecutor.execute embeds retryAfterMs when the upstream asks for model: "antigravity/gemini-2.5-flash", body: { request: { contents: [] } }, stream: true, - credentials: { accessToken: "token", projectId: "project-1" } as any, + credentials: { accessToken: "token", projectId: "project-1" }, log: { debug() {}, warn() {} }, }); - const payload = (await result.response.json()) as any; + const payload = (await result.response.json()) as ErrorPayload; assert.equal(result.response.status, 429); assert.equal(payload.retryAfterMs, 7_200_000); @@ -519,7 +630,7 @@ test("AntigravityExecutor.execute applies CLI fingerprint when enabled", async ( model: "antigravity/gemini-2.5-flash", body: { request: { contents: [] } }, stream: false, - credentials: { accessToken: "token", projectId: "project-1" } as any, + credentials: { accessToken: "token", projectId: "project-1" }, log: { debug() {}, warn() {}, info() {} }, }) ); @@ -556,7 +667,7 @@ test("AntigravityExecutor.transformRequest maps Claude models through Gemini con const result = (await executor.transformRequest("antigravity/claude-sonnet-4-6", body, true, { projectId: "project-1", - })) as any; + })) as AntigravityTransformResult; assert.equal(result.project, "project-1"); assert.equal(result.model, "claude-sonnet-4-6"); diff --git a/tests/unit/executor-azure-ai-responses.test.ts b/tests/unit/executor-azure-ai-responses.test.ts new file mode 100644 index 0000000000..72f9a6bbf0 --- /dev/null +++ b/tests/unit/executor-azure-ai-responses.test.ts @@ -0,0 +1,93 @@ +/** + * Tests for Azure AI Foundry + OCI generic-OpenAI providers with + * apiFormat=responses routing (PR #2236). + * + * Covers: + * 1. transformRequest strips stream_options when routing to /responses. + * 2. buildUrl picks the /responses path when + * providerSpecificData._omnirouteForceResponsesUpstream === true. + * 3. The default chat path is preserved for non-responses requests. + */ +import test from "node:test"; +import assert from "node:assert/strict"; + +import { DefaultExecutor } from "@omniroute/open-sse/executors/default.ts"; + +test("DefaultExecutor.transformRequest strips stream_options for openai-responses target (azure-ai)", () => { + const executor = new DefaultExecutor("azure-ai"); + const body = { + model: "gpt-4.1", + input: "hi", + stream_options: { include_usage: true }, + }; + + // providerSpecificData with apiType=responses signals openai-responses target. + const result = executor.transformRequest("gpt-4.1", body, true, { + providerSpecificData: { + baseUrl: "https://example-resource.services.ai.azure.com/openai/v1", + apiType: "responses", + }, + }); + + assert.equal( + (result as { stream_options?: unknown }).stream_options, + undefined, + "stream_options must be stripped on /responses path" + ); +}); + +test("DefaultExecutor.buildUrl forces /responses path when _omnirouteForceResponsesUpstream=true", () => { + const executor = new DefaultExecutor("azure-ai"); + + const forced = executor.buildUrl("gpt-4.1", true, 0, { + providerSpecificData: { + baseUrl: "https://example-resource.services.ai.azure.com/openai/v1", + _omnirouteForceResponsesUpstream: true, + }, + }); + + // Even without apiType: "responses" on credentials, the force flag must win. + assert.match( + forced, + /\/responses(\?|$)/, + "Forced upstream flag must route to the /responses endpoint" + ); + + const defaultPath = executor.buildUrl("gpt-4.1", true, 0, { + providerSpecificData: { + baseUrl: "https://example-resource.services.ai.azure.com/openai/v1", + }, + }); + + assert.match( + defaultPath, + /\/chat\/completions(\?|$)/, + "Default azure-ai path must be /chat/completions when force flag is absent" + ); +}); + +test("DefaultExecutor: apiType=responses on credentials still routes to /responses (azure-ai)", () => { + const executor = new DefaultExecutor("azure-ai"); + + const result = executor.buildUrl("gpt-4.1", true, 0, { + providerSpecificData: { + baseUrl: "https://example-resource.services.ai.azure.com/openai/v1", + apiType: "responses", + }, + }); + + assert.match(result, /\/responses(\?|$)/); +}); + +test("DefaultExecutor: OCI generic-OpenAI honors force-responses flag", () => { + const executor = new DefaultExecutor("oci"); + + const forced = executor.buildUrl("openai.gpt-oss-20b", true, 0, { + providerSpecificData: { + baseUrl: "https://inference.generativeai.us-ashburn-1.oci.oraclecloud.com", + _omnirouteForceResponsesUpstream: true, + }, + }); + + assert.match(forced, /\/responses(\?|$)/, "OCI must also honor the responses force flag"); +}); diff --git a/tests/unit/executor-default-base.test.ts b/tests/unit/executor-default-base.test.ts index 055a35955a..ebfeecd209 100644 --- a/tests/unit/executor-default-base.test.ts +++ b/tests/unit/executor-default-base.test.ts @@ -96,6 +96,20 @@ test("DefaultExecutor.buildUrl handles Gemini, Claude and Qwen variants", () => ); }); +test("DefaultExecutor.buildUrl uses full chat endpoints for hosted OpenAI-compatible providers", () => { + const bazaarlink = new DefaultExecutor("bazaarlink"); + const completions = new DefaultExecutor("completions"); + + assert.equal( + bazaarlink.buildUrl("auto:free", true), + "https://bazaarlink.ai/api/v1/chat/completions" + ); + assert.equal( + completions.buildUrl("gpt-4.1", true), + "https://completions.me/api/v1/chat/completions" + ); +}); + test("DefaultExecutor.buildUrl handles openai-compatible and anthropic-compatible providers", () => { const openAICompat = new DefaultExecutor("openai-compatible-test"); const openAIResponsesCompat = new DefaultExecutor("openai-compatible-responses-test"); @@ -178,7 +192,7 @@ test("DefaultExecutor.buildUrl normalizes configurable chat-openai-compat base U baseUrl: "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1", }, }), - "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1/messages?beta=true" + "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1/messages" ); assert.equal( heroku.buildUrl("claude-4-sonnet", true, 0, { diff --git a/tests/unit/executor-gemini-cli.test.ts b/tests/unit/executor-gemini-cli.test.ts index 4179c4ab8d..34ca694920 100644 --- a/tests/unit/executor-gemini-cli.test.ts +++ b/tests/unit/executor-gemini-cli.test.ts @@ -82,7 +82,7 @@ test("GeminiCLIExecutor.buildHeaders derives the User-Agent from the request mod assert.notEqual(flashHeaders["User-Agent"], proHeaders["User-Agent"]); }); -test("GeminiCLIExecutor.refreshProject caches loadCodeAssist lookups and transformRequest preserves existing body.project", async () => { +test("GeminiCLIExecutor.refreshProject caches loadCodeAssist lookups and transformRequest refreshes stale body.project", async () => { const executor = new GeminiCLIExecutor(); const originalFetch = globalThis.fetch; let calls = 0; @@ -107,7 +107,7 @@ test("GeminiCLIExecutor.refreshProject caches loadCodeAssist lookups and transfo assert.equal(first, "fresh-project-id"); assert.equal(second, "fresh-project-id"); assert.equal(calls, 1); - assert.equal(transformed.project, "stale-project"); + assert.equal(transformed.project, "fresh-project-id"); } finally { globalThis.fetch = originalFetch; } @@ -368,7 +368,7 @@ test("GeminiCLIExecutor.execute applies CLI fingerprint to the final Cloud Code "Authorization", ]); assert.equal(finalBody.model, "gemini-3.1-pro-preview"); - assert.equal(finalBody.project, "old-project"); + assert.equal(finalBody.project, "project-live"); assert.match(finalBody.user_prompt_id, /^agent-/); assert.match(finalBody.request.session_id, /^-\d+$/); assert.match(finalCall.headers["User-Agent"], /^GeminiCLI\/0\.41\.2\/gemini-3\.1-pro-preview /); diff --git a/tests/unit/fix-2130-system-passthrough.test.ts b/tests/unit/fix-2130-system-passthrough.test.ts new file mode 100644 index 0000000000..f45fe072f8 --- /dev/null +++ b/tests/unit/fix-2130-system-passthrough.test.ts @@ -0,0 +1,103 @@ +/** + * Regression test for #2130: system prompt missing for Claude Code OAuth on Linux. + * + * Claude Code sends requests to /v1/chat/completions with `body.system` as a + * native Anthropic array (not as role="system" messages). The openai→claude + * translator must preserve body.system when no role="system" messages exist. + */ +import { describe, it } from "node:test"; +import assert from "node:assert/strict"; +import { openaiToClaudeRequest } from "../../open-sse/translator/request/openai-to-claude.ts"; + +describe("#2130: body.system passthrough in openai→claude translator", () => { + it("preserves body.system array when no role=system messages exist", () => { + const body = { + model: "claude-opus-4-7", + max_tokens: 2048, + stream: false, + messages: [ + { + role: "user", + content: [{ type: "text", text: "hi" }], + }, + ], + system: [ + { + type: "text", + text: "You are Claude Code, Anthropic's official CLI for Claude.", + }, + ], + }; + + const result = openaiToClaudeRequest("claude-opus-4-7", body, false); + + assert.ok(result.system, "result.system must be defined"); + assert.ok(Array.isArray(result.system), "result.system must be an array"); + assert.ok( + result.system.some((b) => b.text && b.text.includes("You are Claude Code")), + "result.system must contain the Claude Code system prompt" + ); + }); + + it("preserves body.system string when no role=system messages exist", () => { + const body = { + model: "claude-sonnet-4-6", + max_tokens: 4096, + messages: [{ role: "user", content: "hello" }], + system: "You are a helpful assistant.", + }; + + const result = openaiToClaudeRequest("claude-sonnet-4-6", body, true); + + assert.ok(result.system, "result.system must be defined"); + assert.ok(Array.isArray(result.system), "result.system must be an array"); + assert.equal(result.system[0].text, "You are a helpful assistant."); + }); + + it("merges body.system with role=system messages", () => { + const body = { + model: "claude-opus-4-7", + max_tokens: 2048, + messages: [ + { role: "system", content: "Be concise." }, + { role: "user", content: "hi" }, + ], + system: [ + { + type: "text", + text: "You are Claude Code, Anthropic's official CLI for Claude.", + }, + ], + }; + + const result = openaiToClaudeRequest("claude-opus-4-7", body, false); + + assert.ok(result.system, "result.system must be defined"); + assert.ok(Array.isArray(result.system), "result.system must be an array"); + // Should have the original body.system + the extracted role=system text + assert.ok( + result.system.some((b) => b.text && b.text.includes("You are Claude Code")), + "must contain the body.system content" + ); + assert.ok( + result.system.some((b) => b.text && b.text.includes("Be concise")), + "must contain the role=system message content" + ); + }); + + it("works correctly when neither body.system nor role=system messages exist", () => { + const body = { + model: "claude-sonnet-4-6", + max_tokens: 2048, + messages: [{ role: "user", content: "hello" }], + }; + + const result = openaiToClaudeRequest("claude-sonnet-4-6", body, true); + + assert.equal( + result.system, + undefined, + "result.system should be undefined when no system input exists" + ); + }); +}); diff --git a/tests/unit/limiter-lifecycle.test.ts b/tests/unit/limiter-lifecycle.test.ts new file mode 100644 index 0000000000..1f6bf66cf9 --- /dev/null +++ b/tests/unit/limiter-lifecycle.test.ts @@ -0,0 +1,164 @@ +/** + * TDD regression test — Section B fix: + * limiter lifecycle: no .stop() during runtime reset, evict cache only. + * + * Bug: calling .stop() on a Bottleneck instance permanently rejects future + * .schedule() calls with "This limiter has been stopped". In-flight requests + * holding a reference to the now-stopped limiter cannot be redirected, causing + * spurious 502 bursts during container recreation / model registry refresh. + * + * Observed incidents (2026-05-12): + * - xiaomi-mimo: 13x burst at 17:14:28 (reset 3s) + * - mistral: 13x burst at 15:42:36 (reset 3s) + * - claude: 1 hit at 19:01:00 (post reboot) + * + * Design note: tests B and C use `wait(0)` instead of `wait(50)` to avoid + * creating a long-running Promise that can interfere with the Node.js v25 + * test runner IPC serialization window. + */ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-limiter-lifecycle-")); +process.env.DATA_DIR = TEST_DATA_DIR; + +const core = await import("../../src/lib/db/core.ts"); +const rateLimitManager = await import("../../open-sse/services/rateLimitManager.ts"); + +function wait(ms) { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +test.beforeEach(async () => { + await resetStorage(); +}); + +test.afterEach(async () => { + await rateLimitManager.__resetRateLimitManagerForTests(); +}); + +test.after(async () => { + await rateLimitManager.__resetRateLimitManagerForTests(); + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); +}); + +/** + * Core regression: after disableRateLimitProtection + enableRateLimitProtection, + * the next withRateLimit must succeed on a fresh limiter instance. + * + * Bug vector: disableRateLimitProtection() called limiter.stop({dropWaitingJobs:true}). + */ +test("after disable+re-enable, withRateLimit must succeed without stopped-limiter error", async () => { + const provider = "openai"; + const connectionId = "lifecycle-test-conn-a"; + + rateLimitManager.enableRateLimitProtection(connectionId); + const r1 = await rateLimitManager.withRateLimit( + provider, + connectionId, + null, + async () => "job-1" + ); + assert.equal(r1, "job-1"); + + // Reset cycle: disable then re-enable (hot-reload / container recreation scenario) + rateLimitManager.disableRateLimitProtection(connectionId); + rateLimitManager.enableRateLimitProtection(connectionId); + + let error = null; + let r2 = null; + try { + r2 = await rateLimitManager.withRateLimit(provider, connectionId, null, async () => "job-2"); + } catch (err) { + error = err; + } + + assert.equal( + error, + null, + "Expected no error after disable+re-enable, but got: " + (error && error.message) + ); + assert.equal(r2, "job-2", "post-reset request must return its value"); +}); + +/** + * In-flight safety: a job started BEFORE disable must still complete. + * Uses wait(0) (immediate tick) to minimize cross-test async interference. + * + * Bug vector: disableRateLimitProtection() called limiter.stop({dropWaitingJobs:true}). + */ +test("in-flight job before disable must complete without stopped-limiter error", async () => { + const provider = "openai"; + const connectionId = "lifecycle-test-conn-b"; + + rateLimitManager.enableRateLimitProtection(connectionId); + + // Start job (completes in next tick), disable immediately + const jobPromise = rateLimitManager.withRateLimit(provider, connectionId, null, () => + wait(0).then(() => "in-flight-ok") + ); + + // Disable before the job resolves (it's queued/executing in Bottleneck) + rateLimitManager.disableRateLimitProtection(connectionId); + + let error = null; + let result = null; + try { + result = await jobPromise; + } catch (err) { + error = err; + } + + assert.equal( + error, + null, + "In-flight job must not throw after disable, but got: " + (error && error.message) + ); + assert.equal(result, "in-flight-ok", "in-flight job must return its value"); +}); + +/** + * 429 teardown: after a 429 evicts the limiter, the next request must succeed. + * + * Bug vector: updateFromHeaders() 429 path called limiter.stop() before this fix. + */ +test("after 429 teardown, next withRateLimit must get a fresh limiter and succeed", async () => { + const provider = "openai"; + const connectionId = "lifecycle-test-conn-c"; + + rateLimitManager.enableRateLimitProtection(connectionId); + await rateLimitManager.withRateLimit(provider, connectionId, null, async () => "pre-429"); + + // Simulate 429 — evicts the limiter from cache + rateLimitManager.updateFromHeaders(provider, connectionId, { "retry-after": "1s" }, 429, null); + + let error = null; + let result = null; + try { + result = await rateLimitManager.withRateLimit( + provider, + connectionId, + null, + async () => "post-429" + ); + } catch (err) { + error = err; + } + + assert.equal( + error, + null, + "Post-429 request must not throw, but got: " + (error && error.message) + ); + assert.equal(result, "post-429", "post-429 request must return its value"); +}); diff --git a/tests/unit/local-aliases-precedence.test.ts b/tests/unit/local-aliases-precedence.test.ts new file mode 100644 index 0000000000..54df2e1b8f --- /dev/null +++ b/tests/unit/local-aliases-precedence.test.ts @@ -0,0 +1,74 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +import { getModelInfoCore } from "../../open-sse/services/model.ts"; + +// These tests cover the early-return path added in this PR (open-sse/services/model.ts): +// when a local alias map provides a slashful string target (e.g. "openai/gpt-4o"), +// the alias target is parsed directly as <provider>/<model> and returned +// immediately, before shouldTreatAsExactModelId() / cross-proxy inference can +// misclassify the target. + +test("local alias with slashful string target returns provider/model directly", async () => { + const result = await getModelInfoCore("my-alias", { + "my-alias": "openai/gpt-4o", + }); + assert.deepEqual(result, { + provider: "openai", + model: "gpt-4o", + extendedContext: false, + }); +}); + +test("local alias early-return preserves extendedContext from [1m] suffix on input", async () => { + const result = await getModelInfoCore("my-alias[1m]", { + "my-alias": "openai/gpt-4o", + }); + assert.deepEqual(result, { + provider: "openai", + model: "gpt-4o", + extendedContext: true, + }); +}); + +test("local alias early-return preserves the slashful target's model part verbatim (no cross-proxy normalization)", async () => { + // The early-return is intentionally narrower than the object-target path: + // it only applies provider-scoped alias resolution, not the global + // cross-proxy normalization (CROSS_PROXY_MODEL_ALIASES). This mirrors the + // PR's intent — "user-provided 2nd arg wins, parsed directly" — and avoids + // double-resolving aliases the user already pinned to a canonical pair. + const result = await getModelInfoCore("sf-qwen", { + "sf-qwen": "siliconflow/qwen3-coder:480b", + }); + assert.deepEqual(result, { + provider: "siliconflow", + model: "qwen3-coder:480b", + extendedContext: false, + }); +}); + +test("local alias with non-slashful string target falls through to standard alias resolution", async () => { + // No "/" in the target → early-return guard doesn't fire; existing + // resolveModelAliasTarget path handles it. We assert that the legacy path + // still works and isn't shadowed by the new shortcut. + const result = await getModelInfoCore("legacy-alias", { + "legacy-alias": "gpt-oss:120b", + }); + // The legacy path resolves through cross-proxy / provider inference; + // we only assert that the early-return did NOT trip (model is normalized, + // not returned verbatim with provider=null,model="gpt-oss:120b"). + assert.notEqual(result.model, "gpt-oss:120b"); +}); + +test("local alias with object target (not string) falls through to standard resolution", async () => { + // The early-return guard checks `typeof aliases[parsed.model] === "string"`. + // Object targets must keep going through resolveModelAliasTarget. + const result = await getModelInfoCore("sf-qwen-obj", { + "sf-qwen-obj": { provider: "siliconflow", model: "qwen3-coder:480b" }, + }); + assert.deepEqual(result, { + provider: "siliconflow", + model: "Qwen/Qwen3-Coder-480B-A35B-Instruct", + extendedContext: false, + }); +}); diff --git a/tests/unit/management-auth-hardening.test.ts b/tests/unit/management-auth-hardening.test.ts index 2b14e81a3e..dd9540b3a5 100644 --- a/tests/unit/management-auth-hardening.test.ts +++ b/tests/unit/management-auth-hardening.test.ts @@ -43,3 +43,76 @@ test("compression analytics route requires management authentication before retu content.indexOf("getCompressionAnalyticsSummary(") ); }); + +test("administrative pricing and routing routes require management authentication", () => { + const routePaths = [ + "src/app/api/pricing/route.ts", + "src/app/api/pricing/sync/route.ts", + "src/app/api/model-combo-mappings/route.ts", + "src/app/api/model-combo-mappings/[id]/route.ts", + ]; + + for (const routePath of routePaths) { + const content = fs.readFileSync(routePath, "utf8"); + assert.ok(content.includes('from "@/lib/api/requireManagementAuth"'), routePath); + assert.ok( + content.includes("const authError = await requireManagementAuth(request);"), + routePath + ); + assert.ok(content.includes("if (authError) return authError;"), routePath); + } +}); + +test("memory management routes require management authentication", () => { + const routePaths = ["src/app/api/memory/route.ts", "src/app/api/memory/[id]/route.ts"]; + + for (const routePath of routePaths) { + const content = fs.readFileSync(routePath, "utf8"); + assert.ok(content.includes('from "@/lib/api/requireManagementAuth"'), routePath); + assert.ok( + content.includes("const authError = await requireManagementAuth(request);"), + routePath + ); + assert.ok(content.includes("if (authError) return authError;"), routePath); + } +}); + +test("provider validation routes require management authentication before reading credentials", () => { + const routePaths = [ + "src/app/api/provider-nodes/validate/route.ts", + "src/app/api/providers/validate/route.ts", + ]; + + for (const routePath of routePaths) { + const content = fs.readFileSync(routePath, "utf8"); + assert.ok(content.includes('from "@/lib/api/requireManagementAuth"'), routePath); + assert.ok( + content.includes("const authError = await requireManagementAuth(request);"), + routePath + ); + assert.ok(content.includes("if (authError) return authError;"), routePath); + assert.ok( + content.indexOf("requireManagementAuth(request)") < content.indexOf("request.json()"), + `${routePath} should authenticate before parsing submitted provider credentials` + ); + } +}); + +test("usage analytics and request log routes require management authentication", () => { + const routePaths = [ + "src/app/api/usage/analytics/route.ts", + "src/app/api/usage/history/route.ts", + "src/app/api/usage/request-logs/route.ts", + "src/app/api/usage/logs/route.ts", + ]; + + for (const routePath of routePaths) { + const content = fs.readFileSync(routePath, "utf8"); + assert.ok(content.includes('from "@/lib/api/requireManagementAuth"'), routePath); + assert.ok( + content.includes("const authError = await requireManagementAuth(request);"), + routePath + ); + assert.ok(content.includes("if (authError) return authError;"), routePath); + } +}); diff --git a/tests/unit/model-alias-route.test.ts b/tests/unit/model-alias-route.test.ts index ccc90c024d..4682bdd25f 100644 --- a/tests/unit/model-alias-route.test.ts +++ b/tests/unit/model-alias-route.test.ts @@ -80,8 +80,8 @@ test("model alias route requires a dashboard session when management auth is ena assert.equal(unauthenticated.status, 401); assert.equal(unauthenticatedBody.error.message, "Authentication required"); - assert.equal(invalidToken.status, 401); - assert.equal(invalidTokenBody.error.message, "Invalid API key"); + assert.equal(invalidToken.status, 403); + assert.equal(invalidTokenBody.error.message, "Invalid management token"); assert.match(unauthenticated.headers.get("X-Model-Catalog-Version") || "", /^model-metadata-v1:/); }); diff --git a/tests/unit/model-capabilities-registry.test.ts b/tests/unit/model-capabilities-registry.test.ts index 96d3f6c87c..c81007360a 100644 --- a/tests/unit/model-capabilities-registry.test.ts +++ b/tests/unit/model-capabilities-registry.test.ts @@ -104,10 +104,14 @@ test("canonical model capability resolver lets exact synced metadata override gl ); const codexGpt55 = modelCapabilities.getResolvedModelCapabilities("codex/gpt-5.5"); - assert.equal(codexGpt55.contextWindow, 1050000); + assert.equal(codexGpt55.contextWindow, 400000); + assert.equal(codexGpt55.maxInputTokens, 400000); assert.equal(codexGpt55.maxOutputTokens, 128000); assert.equal(codexGpt55.supportsThinking, true); assert.equal(codexGpt55.supportsVision, true); + + const bareGpt55 = modelCapabilities.getResolvedModelCapabilities("gpt-5.5"); + assert.equal(bareGpt55.contextWindow, 1050000); }); test("GPT OSS and DeepSeek Reasoner models support tool calling", () => { diff --git a/tests/unit/model-cooldowns-route-auth.test.ts b/tests/unit/model-cooldowns-route-auth.test.ts new file mode 100644 index 0000000000..77ebf02ea4 --- /dev/null +++ b/tests/unit/model-cooldowns-route-auth.test.ts @@ -0,0 +1,94 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { makeManagementSessionRequest } from "../helpers/managementSession.ts"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-cooldown-auth-")); +const ORIGINAL_DATA_DIR = process.env.DATA_DIR; +const ORIGINAL_INITIAL_PASSWORD = process.env.INITIAL_PASSWORD; +const ORIGINAL_JWT_SECRET = process.env.JWT_SECRET; + +process.env.DATA_DIR = TEST_DATA_DIR; + +const core = await import("../../src/lib/db/core.ts"); +const settingsDb = await import("../../src/lib/db/settings.ts"); +const route = await import("../../src/app/api/resilience/model-cooldowns/route.ts"); +const modelAvailability = await import("../../src/domain/modelAvailability.ts"); +const accountFallback = await import("@omniroute/open-sse/services/accountFallback"); + +const { getAvailabilityReport } = modelAvailability; +const { clearModelLock, lockModel } = accountFallback; + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +async function enableManagementAuth() { + process.env.INITIAL_PASSWORD = "cooldown-password"; + await settingsDb.updateSettings({ requireLogin: true, password: "" }); +} + +test.beforeEach(async () => { + clearModelLock("cooldown-auth-provider", "cooldown-auth-conn", "cooldown-auth-model"); + await resetStorage(); + await enableManagementAuth(); +}); + +test.after(async () => { + clearModelLock("cooldown-auth-provider", "cooldown-auth-conn", "cooldown-auth-model"); + await resetStorage(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + + if (ORIGINAL_DATA_DIR === undefined) delete process.env.DATA_DIR; + else process.env.DATA_DIR = ORIGINAL_DATA_DIR; + + if (ORIGINAL_INITIAL_PASSWORD === undefined) delete process.env.INITIAL_PASSWORD; + else process.env.INITIAL_PASSWORD = ORIGINAL_INITIAL_PASSWORD; + + if (ORIGINAL_JWT_SECRET === undefined) delete process.env.JWT_SECRET; + else process.env.JWT_SECRET = ORIGINAL_JWT_SECRET; +}); + +test("model cooldown reset requires management auth", async () => { + lockModel( + "cooldown-auth-provider", + "cooldown-auth-conn", + "cooldown-auth-model", + "quota_exhausted", + 60_000, + {} + ); + + const unauthenticated = await route.DELETE( + new Request("http://localhost/api/resilience/model-cooldowns", { + method: "DELETE", + body: JSON.stringify({ all: true }), + }) + ); + + assert.equal(unauthenticated.status, 401); + assert.ok( + getAvailabilityReport().some( + (entry) => + entry.provider === "cooldown-auth-provider" && entry.model === "cooldown-auth-model" + ) + ); + + const authenticated = await route.DELETE( + await makeManagementSessionRequest("http://localhost/api/resilience/model-cooldowns", { + method: "DELETE", + body: { all: true }, + }) + ); + + assert.equal(authenticated.status, 200); + assert.deepEqual(await authenticated.json(), { ok: true, clearedAll: true }); + assert.equal( + getAvailabilityReport().some((entry) => entry.provider === "cooldown-auth-provider"), + false + ); +}); diff --git a/tests/unit/model-cooldowns-route.test.ts b/tests/unit/model-cooldowns-route.test.ts new file mode 100644 index 0000000000..255c7229df --- /dev/null +++ b/tests/unit/model-cooldowns-route.test.ts @@ -0,0 +1,61 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import { + getAvailabilityReport, + clearModelUnavailability, + resetAllAvailability, +} from "../../src/domain/modelAvailability.ts"; +import { lockModel, clearModelLock } from "@omniroute/open-sse/services/accountFallback"; + +const TEST_CONN = "test-conn-001"; + +function seed(provider: string, model: string, cooldownMs = 60_000) { + lockModel(provider, TEST_CONN, model, "quota_exhausted", cooldownMs, {}); +} + +function cleanup(provider: string, model: string) { + clearModelLock(provider, TEST_CONN, model); +} + +test("getAvailabilityReport: returns empty array when no lockouts", () => { + const report = getAvailabilityReport(); + const forProvider = report.filter((e) => e.provider === "test-empty-provider"); + assert.equal(forProvider.length, 0); +}); + +test("getAvailabilityReport: returns active lockout with positive remainingMs", () => { + seed("test-prov", "test-model"); + try { + const report = getAvailabilityReport(); + const entry = report.find((e) => e.provider === "test-prov" && e.model === "test-model"); + assert.ok(entry, "lockout should appear in report"); + assert.ok(entry.remainingMs > 0, "remainingMs should be positive"); + } finally { + cleanup("test-prov", "test-model"); + } +}); + +test("clearModelUnavailability: removes matching lockout and returns true", () => { + seed("prov-clear", "model-clear"); + const removed = clearModelUnavailability("prov-clear", "model-clear"); + assert.equal(removed, true); + const report = getAvailabilityReport(); + const stillThere = report.find((e) => e.provider === "prov-clear" && e.model === "model-clear"); + assert.equal(stillThere, undefined); +}); + +test("clearModelUnavailability: returns false when no matching lockout", () => { + const removed = clearModelUnavailability("nonexistent-prov", "nonexistent-model"); + assert.equal(removed, false); +}); + +test("resetAllAvailability: clears all seeded lockouts", () => { + seed("reset-prov-a", "reset-model-a"); + seed("reset-prov-b", "reset-model-b"); + resetAllAvailability(); + const report = getAvailabilityReport(); + const a = report.find((e) => e.provider === "reset-prov-a"); + const b = report.find((e) => e.provider === "reset-prov-b"); + assert.equal(a, undefined); + assert.equal(b, undefined); +}); diff --git a/tests/unit/model-cross-proxy-compat.test.ts b/tests/unit/model-cross-proxy-compat.test.ts index 70dff4f056..f1553418e5 100644 --- a/tests/unit/model-cross-proxy-compat.test.ts +++ b/tests/unit/model-cross-proxy-compat.test.ts @@ -50,3 +50,17 @@ test("explicit provider routes can still normalize cross-proxy model dialects", extendedContext: false, }); }); + +test("Kiro Claude Code-style model aliases resolve without polluting the visible catalog", async () => { + assert.deepEqual(await getModelInfoCore("kr/claude-opus-4-7", {}), { + provider: "kiro", + model: "claude-opus-4.7", + extendedContext: false, + }); + + assert.deepEqual(await getModelInfoCore("kiro/claude-sonnet-4-6", {}), { + provider: "kiro", + model: "claude-sonnet-4.6", + extendedContext: false, + }); +}); diff --git a/tests/unit/model-sync-route.test.ts b/tests/unit/model-sync-route.test.ts index 6d5f8aff1d..ab60e1a734 100644 --- a/tests/unit/model-sync-route.test.ts +++ b/tests/unit/model-sync-route.test.ts @@ -24,6 +24,14 @@ const originalFetch = globalThis.fetch; async function resetStorage() { delete process.env.INITIAL_PASSWORD; globalThis.fetch = originalFetch; + // Reset the shared loopback readiness gate between tests so the cached + // promise from a previous test doesn't poison this one (PR #2221 adds + // an __loopbackReadyPromise module-level cache that, once resolved, is + // reused for the rest of the process). Without this reset, the very + // first test's mock-fetch resolution (or rejection) leaks into every + // subsequent test, causing the route to use in-process fallback instead + // of the test's mocked self-fetch. + modelSyncRoute.__resetLoopbackReadinessForTests(); core.resetDbInstance(); apiKeysDb.resetApiKeyState(); fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); @@ -63,9 +71,10 @@ test("model sync route skips success log when fetched models do not change store const originalFetch = globalThis.fetch; globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [{ id: "custom-model-1", name: "Custom Model 1" }], @@ -107,9 +116,10 @@ test("model sync route stores the real provider while keeping the account label" const originalFetch = globalThis.fetch; globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [{ id: "custom-model-2", name: "Custom Model 2" }], @@ -191,9 +201,10 @@ test("model sync route propagates upstream failures and records an error log ent }); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ error: "Provider upstream unavailable" }, { status: 502 }); }; @@ -227,9 +238,10 @@ test("model sync route falls back to the upstream HTTP status when the models pa }); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({}, { status: 429 }); }; @@ -262,9 +274,10 @@ test("model sync route reports invalid JSON /models responses without losing ups }); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return new Response("<html>bad gateway</html>", { status: 200, @@ -309,9 +322,10 @@ test("model sync route preserves previously synced models when the upstream omit ]); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({}); }; @@ -352,9 +366,10 @@ test("model sync route writes synced available models for Gemini connections", a }); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [ @@ -415,9 +430,10 @@ test("model sync route writes synced available models for non-Gemini providers t }); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [ @@ -470,9 +486,10 @@ test("model sync route import mode merges discovered models without deleting man await localDb.setModelAlias("manual-only", "openrouter/manual-only"); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [{ id: "router-v4", name: "Router V4" }], @@ -535,9 +552,10 @@ test("model sync route import mode ignores supported endpoint ordering changes", ]); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [ @@ -598,9 +616,10 @@ test("model sync route import mode reports updates without counting them as new ]); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [ @@ -671,9 +690,10 @@ test("model sync route records added, removed, and updated model diffs with fall ]); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [ @@ -749,9 +769,10 @@ test("model sync route forwards cookies, filters built-ins, and syncs aliases fo await localDb.setModelAlias("router-v2", "other-provider/router-v2"); globalThis.fetch = async (url, init = {}) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); assert.equal(init.headers.cookie, "session=test-cookie"); assert.equal( @@ -813,9 +834,10 @@ test("model sync route reports synced managed models separately from preserved m await modelsDb.addCustomModel("openrouter", "router-v4", "Manual Router V4", "manual"); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [{ id: "router-v4", name: "Router V4" }], @@ -877,9 +899,10 @@ test("model sync route uses provider-node prefixes when syncing compatible-provi await localDb.setModelAlias("sonnet-4-6", "some-other-provider/sonnet-4-6"); globalThis.fetch = async (url) => { + if (String(url).includes("__readiness_probe__")) return new Response(null, { status: 404 }); assert.equal( String(url), - `http://localhost/api/providers/${connection.id}/models?refresh=true` + `http://127.0.0.1:20128/api/providers/${connection.id}/models?refresh=true` ); return Response.json({ models: [{ id: "sonnet-4-6", name: "Sonnet 4.6" }], @@ -919,9 +942,19 @@ test("model sync route falls back to in-process discovery when internal self-fet }, }); + // Reset shared readiness gate so this test exercises the probe path cleanly. + modelSyncRoute.__resetLoopbackReadinessForTests(); + const fetchCalls: string[] = []; globalThis.fetch = async (url) => { const urlString = String(url); + + // Loopback readiness probe: respond 404 so the gate opens immediately. + // (Any HTTP response confirms the server is up — see ensureLoopbackServerReady.) + if (urlString.includes("__readiness_probe__")) { + return new Response(null, { status: 404 }); + } + fetchCalls.push(urlString); if (urlString === `http://localhost/api/providers/${connection.id}/models?refresh=true`) { @@ -965,8 +998,18 @@ test("model sync route falls back to in-process discovery when internal self-fet availableModels.map((model) => ({ id: model.id, source: model.source })), [{ id: "aio-model", source: "imported" }] ); - assert.deepEqual(fetchCalls, [ - `http://localhost/api/providers/${connection.id}/models?refresh=true`, - "https://api.bltcy.ai/v1/models", - ]); + // selfFetchWithRetry default maxRetries=3: all 3 attempts throw, then in-process + // fallback fires (which triggers the upstream bltcy.ai fetch). So fetchCalls + // contains 3 self-fetch URLs followed by 1 upstream URL. + // Route forces IPv4 origin (http://127.0.0.1:PORT) — never "localhost" — to avoid + // ::1 (IPv6) resolution issues in containers. PORT defaults to 20128 when env unset. + const expectedPort = process.env.OMNIROUTE_PORT || process.env.PORT || "20128"; + const selfFetchUrl = `http://127.0.0.1:${expectedPort}/api/providers/${connection.id}/models?refresh=true`; + assert.equal( + fetchCalls.slice(0, 3).every((u) => u === selfFetchUrl), + true, + "first 3 calls should be self-fetch retries" + ); + assert.equal(fetchCalls[3], "https://api.bltcy.ai/v1/models", "4th call should be upstream"); + assert.equal(fetchCalls.length, 4, "should have exactly 3 retries + 1 upstream call"); }); diff --git a/tests/unit/model-test-route.test.ts b/tests/unit/model-test-route.test.ts index cfa92d793a..54445f54d3 100644 --- a/tests/unit/model-test-route.test.ts +++ b/tests/unit/model-test-route.test.ts @@ -94,8 +94,8 @@ test("model test route requires management auth when login protection is enabled assert.equal(unauthenticated.status, 401); assert.equal(unauthenticatedBody.error.message, "Authentication required"); - assert.equal(invalidToken.status, 401); - assert.equal(invalidTokenBody.error.message, "Invalid API key"); + assert.equal(invalidToken.status, 403); + assert.equal(invalidTokenBody.error.message, "Invalid management token"); }); test("model test route ignores forwarded hosts and works in strict API-key mode", async () => { diff --git a/tests/unit/models-catalog-route.test.ts b/tests/unit/models-catalog-route.test.ts index 432a45f966..e0e33cdf52 100644 --- a/tests/unit/models-catalog-route.test.ts +++ b/tests/unit/models-catalog-route.test.ts @@ -24,19 +24,42 @@ async function resetStorage() { fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); } -async function seedConnection(provider, overrides = {}) { +async function seedConnection(provider: string, overrides: Record<string, unknown> = {}) { return providersDb.createProviderConnection({ provider, - authType: overrides.authType || "apikey", - name: overrides.name || `${provider}-${Math.random().toString(16).slice(2, 8)}`, - apiKey: overrides.apiKey || "sk-test", - accessToken: overrides.accessToken, - isActive: overrides.isActive ?? true, - testStatus: overrides.testStatus || "active", - providerSpecificData: overrides.providerSpecificData || {}, + authType: (overrides.authType as string) || "apikey", + name: (overrides.name as string) || `${provider}-${Math.random().toString(16).slice(2, 8)}`, + apiKey: (overrides.apiKey as string) || "sk-test", + accessToken: overrides.accessToken as string | undefined, + isActive: (overrides.isActive as boolean) ?? true, + testStatus: (overrides.testStatus as string) || "active", + providerSpecificData: (overrides.providerSpecificData as Record<string, unknown>) || {}, }); } +function capability(overrides = {}) { + return { + tool_call: null, + reasoning: null, + attachment: null, + structured_output: null, + temperature: null, + modalities_input: JSON.stringify([]), + modalities_output: JSON.stringify([]), + knowledge_cutoff: null, + release_date: null, + last_updated: null, + status: null, + family: null, + open_weights: null, + limit_context: null, + limit_input: null, + limit_output: null, + interleaved_field: null, + ...overrides, + }; +} + test.beforeEach(async () => { await resetStorage(); }); @@ -228,6 +251,263 @@ test("v1 models catalog keeps only visible combos when no providers are active", ); }); +test("v1 models catalog derives combo metadata from known targets conservatively", async () => { + try { + modelsDevSync.saveModelsDevCapabilities({ + openai: { + "combo-alpha": capability({ + tool_call: true, + reasoning: true, + attachment: true, + structured_output: true, + temperature: false, + modalities_input: JSON.stringify(["text", "image"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 1000, + limit_input: 900, + limit_output: 120, + }), + }, + gemini: { + "combo-beta": capability({ + tool_call: true, + reasoning: true, + attachment: false, + structured_output: true, + temperature: false, + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 800, + limit_input: 700, + limit_output: 90, + }), + }, + }); + + await combosDb.createCombo({ + name: "metadata-router", + strategy: "priority", + models: ["openai/combo-alpha", "gemini/combo-beta"], + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const combo = body.data.find((item) => item.id === "metadata-router"); + + assert.equal(response.status, 200); + assert.ok(combo); + assert.equal(combo.context_length, 800); + assert.equal(combo.max_input_tokens, 700); + assert.equal(combo.max_output_tokens, 90); + assert.deepEqual(combo.input_modalities, ["text"]); + assert.deepEqual(combo.output_modalities, ["text"]); + assert.equal(combo.capabilities.structured_output, true); + assert.equal(combo.capabilities.temperature, false); + assert.equal(combo.capabilities.tool_calling, true); + assert.equal(combo.capabilities.reasoning, true); + assert.equal(combo.capabilities.thinking, true); + assert.equal("vision" in combo.capabilities, false); + assert.equal("attachment" in combo.capabilities, false); + assert.equal("architecture" in combo, false); + assert.equal("top_provider" in combo, false); + assert.equal("supported_parameters" in combo, false); + } finally { + modelsDevSync.saveModelsDevCapabilities({}); + } +}); + +test("v1 models catalog lets explicit combo context override derived context", async () => { + try { + modelsDevSync.saveModelsDevCapabilities({ + openai: { + "context-alpha": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 1000, + limit_input: 900, + limit_output: 120, + }), + }, + gemini: { + "context-beta": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 800, + limit_input: 700, + limit_output: 90, + }), + }, + }); + + const combo = await combosDb.createCombo({ + name: "context-router", + strategy: "priority", + models: ["openai/context-alpha", "gemini/context-beta"], + }); + await combosDb.updateCombo((combo as any).id, { context_length: 12345 }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const listed = body.data.find((item) => item.id === "context-router"); + + assert.equal(response.status, 200); + assert.equal(listed.context_length, 12345); + assert.equal(listed.max_input_tokens, 700); + assert.equal(listed.max_output_tokens, 90); + } finally { + modelsDevSync.saveModelsDevCapabilities({}); + } +}); + +test("v1 models catalog keeps unknown combo targets visible without guessed metadata", async () => { + await combosDb.createCombo({ + name: "unknown-router", + strategy: "priority", + models: ["openai/no-known-metadata"], + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const combo = body.data.find((item) => item.id === "unknown-router"); + + assert.equal(response.status, 200); + assert.ok(combo); + assert.equal("context_length" in combo, false); + assert.equal("max_input_tokens" in combo, false); + assert.equal("max_output_tokens" in combo, false); + assert.equal("input_modalities" in combo, false); + assert.equal("output_modalities" in combo, false); + assert.equal("capabilities" in combo, false); +}); + +test("v1 models catalog aggregates nested combos and keeps hidden child combos unlisted", async () => { + try { + modelsDevSync.saveModelsDevCapabilities({ + openai: { + "nested-alpha": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 1000, + limit_input: 900, + limit_output: 120, + }), + }, + gemini: { + "nested-beta": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 800, + limit_input: 700, + limit_output: 90, + }), + }, + }); + + await combosDb.createCombo({ + name: "hidden-child-router", + strategy: "priority", + models: ["openai/nested-alpha", "gemini/nested-beta"], + isHidden: true, + }); + await combosDb.createCombo({ + name: "parent-router", + strategy: "priority", + models: ["hidden-child-router"], + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const parent = body.data.find((item) => item.id === "parent-router"); + + assert.equal(response.status, 200); + assert.ok(parent); + assert.equal(parent.context_length, 800); + assert.equal(parent.max_output_tokens, 90); + assert.equal( + body.data.some((item) => item.id === "hidden-child-router"), + false + ); + } finally { + modelsDevSync.saveModelsDevCapabilities({}); + } +}); + +test("v1 models catalog resolves provider aliases without corrupting slashful model ids", async () => { + try { + modelsDevSync.saveModelsDevCapabilities({ + claude: { + "alias-model": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 2000, + limit_input: 1900, + limit_output: 200, + }), + }, + openrouter: { + "Qwen/Qwen3-Coder": capability({ + modalities_input: JSON.stringify(["text"]), + modalities_output: JSON.stringify(["text"]), + limit_context: 1600, + limit_input: 1500, + limit_output: 150, + }), + }, + }); + + await combosDb.createCombo({ + name: "alias-and-slash-router", + strategy: "priority", + models: [ + { kind: "model", providerId: "claude", model: "cc/alias-model" }, + { kind: "model", providerId: "openrouter", model: "Qwen/Qwen3-Coder" }, + ], + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const combo = body.data.find((item) => item.id === "alias-and-slash-router"); + + assert.equal(response.status, 200); + assert.ok(combo); + assert.equal(combo.context_length, 1600); + assert.equal(combo.max_input_tokens, 1500); + assert.equal(combo.max_output_tokens, 150); + } finally { + modelsDevSync.saveModelsDevCapabilities({}); + } +}); + +test("v1 models catalog does not final-enrich combo names as real models", async () => { + await combosDb.createCombo({ + name: "gpt-5.5", + strategy: "priority", + models: ["openai/no-known-metadata"], + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const combo = body.data.find((item) => item.id === "gpt-5.5"); + + assert.equal(response.status, 200); + assert.ok(combo); + assert.equal(combo.owned_by, "combo"); + assert.equal("max_output_tokens" in combo, false); + assert.equal("capabilities" in combo, false); +}); + test("v1 models catalog exposes claude alias and provider-prefixed built-in models with vision metadata", async () => { await seedConnection("claude", { authType: "oauth", @@ -956,6 +1236,63 @@ test("v1 models catalog auto-calculates combo context_length from targets when n ); }); +test("v1 models catalog includes context_length for individual chat models", async () => { + await seedConnection("openai", { name: "openai-context" }); + await seedConnection("claude", { + authType: "oauth", + name: "claude-context", + apiKey: null, + accessToken: "claude-access", + }); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const chatModels = body.data.filter((item) => !item.type || item.type === "chat"); + + assert.equal(response.status, 200); + assert.ok(chatModels.length > 0, "should have at least one chat model"); + + for (const model of chatModels) { + assert.ok( + typeof model.context_length === "number" && model.context_length > 0, + `chat model ${model.id} should have a positive context_length, got ${model.context_length}` + ); + } +}); + +test("v1 models catalog falls back to getTokenLimit for models without registry defaultContextLength", async () => { + // opencode-go has defaultContextLength in REGISTRY, but we test the fallback + // path by verifying models from the synced path still get context_length + const connection = await seedConnection("opencode-go", { + name: "opencode-go-context-fallback", + apiKey: "go-key", + }); + + await modelsDb.replaceSyncedAvailableModelsForConnection("opencode-go", (connection as any).id, [ + { + id: "test-model-no-context", + name: "Test Model No Context", + source: "imported", + supportedEndpoints: ["chat"], + }, + ]); + + const response = await v1ModelsCatalog.getUnifiedModelsResponse( + new Request("http://localhost/api/v1/models") + ); + const body = (await response.json()) as any; + const model = body.data.find((item) => item.id === "opencode-go/test-model-no-context"); + + assert.equal(response.status, 200); + assert.ok(model, "synced model should appear"); + assert.ok( + typeof model.context_length === "number" && model.context_length > 0, + `synced model without inputTokenLimit should get context_length via getTokenLimit fallback, got ${model.context_length}` + ); +}); + test("v1 models catalog prefers manual combo context_length over auto-calculated", async () => { await seedConnection("openai", { name: "openai-manual-context" }); diff --git a/tests/unit/modelscope-policy.test.ts b/tests/unit/modelscope-policy.test.ts new file mode 100644 index 0000000000..39ea704f85 --- /dev/null +++ b/tests/unit/modelscope-policy.test.ts @@ -0,0 +1,64 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { + classifyModelScope429, + getModelScopeRetryDelayMs, + isModelScopeProvider, + parseModelScopeRateLimitHeaders, +} = await import("../../open-sse/services/modelscopePolicy.ts"); + +test("ModelScope policy detects provider ids and ModelScope host markers", () => { + assert.equal(isModelScopeProvider("modelscope"), true); + assert.equal( + isModelScopeProvider("openai-compatible-custom", { + baseUrl: "https://api-inference.modelscope.cn/v1", + }), + true + ); + assert.equal(isModelScopeProvider("openai", { baseUrl: "https://api.openai.com/v1" }), false); +}); + +test("ModelScope policy parses per-model and total rate-limit headers", () => { + const snapshot = parseModelScopeRateLimitHeaders( + new Headers({ + "modelscope-ratelimit-model-requests-remaining": "0", + "modelscope-ratelimit-model-requests-limit": "10", + "modelscope-ratelimit-requests-remaining": "17", + "modelscope-ratelimit-requests-limit": "20", + }) + ); + + assert.deepEqual(snapshot, { + modelRemaining: 0, + modelLimit: 10, + totalRemaining: 17, + totalLimit: 20, + }); +}); + +test("ModelScope policy keeps temporary 429 headers retryable", () => { + const decision = classifyModelScope429( + "Throttling: current batch requests reached the limit", + new Headers({ + "modelscope-ratelimit-model-requests-remaining": "0", + "modelscope-ratelimit-model-requests-limit": "10", + }) + ); + + assert.equal(decision.kind, "rate_limited"); + assert.equal(decision.retryable, true); + assert.equal(decision.snapshot.modelRemaining, 0); +}); + +test("ModelScope policy treats explicit free quota exhaustion as terminal", () => { + const decision = classifyModelScope429("Free allocated quota exceeded", new Headers()); + + assert.equal(decision.kind, "quota_exhausted"); + assert.equal(decision.retryable, false); +}); + +test("ModelScope retry delay respects Retry-After seconds before backoff fallback", () => { + assert.equal(getModelScopeRetryDelayMs(new Headers({ "retry-after": "2.5" }), 0), 2500); + assert.equal(getModelScopeRetryDelayMs(new Headers(), 1), 6000); +}); diff --git a/tests/unit/native-binary-compat.test.ts b/tests/unit/native-binary-compat.test.ts index 73d0a86bd7..120c5e7853 100644 --- a/tests/unit/native-binary-compat.test.ts +++ b/tests/unit/native-binary-compat.test.ts @@ -7,7 +7,7 @@ import { tmpdir } from "node:os"; import { detectNativeBinaryTarget, isNativeBinaryCompatible, -} from "../../scripts/native-binary-compat.mjs"; +} from "../../scripts/build/native-binary-compat.mjs"; function makeElfBinary(machine) { const buffer = Buffer.alloc(64); diff --git a/tests/unit/oauth-providers-config.test.ts b/tests/unit/oauth-providers-config.test.ts index 806b6addb4..15ac535ec6 100644 --- a/tests/unit/oauth-providers-config.test.ts +++ b/tests/unit/oauth-providers-config.test.ts @@ -42,6 +42,7 @@ const { PROVIDERS: OAUTH_PROVIDER_IDS, QODER_CONFIG, QWEN_CONFIG, + WINDSURF_CONFIG, } = oauthModule; const { REGISTRY } = registryModule; @@ -62,6 +63,8 @@ const EXPECTED_PROVIDER_KEYS = [ "cursor", "kilocode", "cline", + "windsurf", + "devin-cli", ]; const EXPECTED_CONFIG_BY_PROVIDER = { @@ -79,6 +82,8 @@ const EXPECTED_CONFIG_BY_PROVIDER = { cursor: CURSOR_CONFIG, kilocode: KILOCODE_CONFIG, cline: CLINE_CONFIG, + windsurf: WINDSURF_CONFIG, + "devin-cli": WINDSURF_CONFIG, }; const REQUIRED_FIELDS_BY_PROVIDER = { @@ -123,6 +128,8 @@ const REQUIRED_FIELDS_BY_PROVIDER = { cursor: ["apiEndpoint", "api3Endpoint", "agentEndpoint", "agentNonPrivacyEndpoint", "dbKeys"], kilocode: ["apiBaseUrl", "initiateUrl", "pollUrlBase"], cline: ["appBaseUrl", "apiBaseUrl", "authorizeUrl", "tokenExchangeUrl", "refreshUrl"], + windsurf: ["authorizeUrl", "apiServerUrl", "exchangePath", "inferenceUrl"], + "devin-cli": ["authorizeUrl", "apiServerUrl", "exchangePath", "inferenceUrl"], }; function getByPath(object, path) { diff --git a/tests/unit/pack-artifact-policy.test.ts b/tests/unit/pack-artifact-policy.test.ts index e47925474f..0f6c42f992 100644 --- a/tests/unit/pack-artifact-policy.test.ts +++ b/tests/unit/pack-artifact-policy.test.ts @@ -10,12 +10,12 @@ import { findMissingArtifactPaths, findUnexpectedArtifactPaths, normalizeArtifactPath, -} from "../../scripts/pack-artifact-policy.ts"; +} from "../../scripts/build/pack-artifact-policy.ts"; test("normalizeArtifactPath normalizes slashes and leading relative markers", () => { assert.equal( - normalizeArtifactPath("./app\\scripts\\scratch\\test.js"), - "app/scripts/scratch/test.js" + normalizeArtifactPath("./app\\scripts\\ad-hoc\\test.js"), + "app/scripts/ad-hoc/test.js" ); }); @@ -25,7 +25,7 @@ test("findUnexpectedArtifactPaths flags staged app files outside the allowlist", "open-sse/services/compression/engines/rtk/filters/generic-output.json", "open-sse/services/compression/rules/en/filler.json", "package-lock.json", - "scripts/sync-env.mjs", + "scripts/dev/sync-env.mjs", "server.js", ], { @@ -43,8 +43,8 @@ test("findUnexpectedArtifactPaths flags app pack files outside the allowlist", ( "app/open-sse/services/compression/engines/rtk/filters/generic-output.json", "app/open-sse/services/compression/rules/en/filler.json", "app/server.js", - "app/scripts/sync-env.mjs", - "app/scripts/prepublish.mjs", + "app/scripts/dev/sync-env.mjs", + "app/scripts/build/prepublish.mjs", "docs/extra.md", ], { @@ -53,7 +53,7 @@ test("findUnexpectedArtifactPaths flags app pack files outside the allowlist", ( } ); - assert.deepEqual(unexpectedPaths, ["app/scripts/prepublish.mjs", "docs/extra.md"]); + assert.deepEqual(unexpectedPaths, ["app/scripts/build/prepublish.mjs", "docs/extra.md"]); }); test("findMissingArtifactPaths flags missing root runtime files in the tarball", () => { @@ -62,8 +62,8 @@ test("findMissingArtifactPaths flags missing root runtime files in the tarball", "app/server.js", "bin/omniroute.mjs", "package.json", - "scripts/postinstall.mjs", - "scripts/postinstallSupport.mjs", + "scripts/build/postinstall.mjs", + "scripts/build/postinstallSupport.mjs", ], PACK_ARTIFACT_REQUIRED_PATHS ); @@ -73,9 +73,11 @@ test("findMissingArtifactPaths flags missing root runtime files in the tarball", "app/open-sse/services/compression/rules/en/filler.json", "app/responses-ws-proxy.mjs", "app/server-ws.mjs", + "bin/cli-commands.mjs", + "bin/cli/index.mjs", "bin/mcp-server.mjs", "bin/nodeRuntimeSupport.mjs", - "scripts/native-binary-compat.mjs", + "scripts/build/native-binary-compat.mjs", "src/shared/utils/nodeRuntimeSupport.ts", ]); }); diff --git a/tests/unit/payload-rules-route.test.ts b/tests/unit/payload-rules-route.test.ts index 2d6b17302e..9db6cf0117 100644 --- a/tests/unit/payload-rules-route.test.ts +++ b/tests/unit/payload-rules-route.test.ts @@ -91,8 +91,8 @@ test("payload rules route requires a dashboard session when management auth is e assert.equal(unauthenticated.status, 401); assert.equal(unauthenticatedBody.error.message, "Authentication required"); - assert.equal(invalidToken.status, 401); - assert.equal(invalidTokenBody.error.message, "Invalid API key"); + assert.equal(invalidToken.status, 403); + assert.equal(invalidTokenBody.error.message, "Invalid management token"); assert.equal(authenticated.status, 200); assert.deepEqual(authenticatedBody, { default: [], diff --git a/tests/unit/plan3-p0.test.ts b/tests/unit/plan3-p0.test.ts index 16e0a683da..7c4a786dcf 100644 --- a/tests/unit/plan3-p0.test.ts +++ b/tests/unit/plan3-p0.test.ts @@ -40,8 +40,8 @@ test("getModelInfoCore keeps unprefixed gpt-5.5 on the OpenAI fallback", async ( assert.equal(info.model, "gpt-5.5"); }); -test("getModelInfoCore keeps explicit gpt-5.5-medium separate from gpt-5.5", async () => { - const info = await getModelInfoCore("gpt-5.5-medium", {}); +test("getModelInfoCore keeps explicit cx/gpt-5.5-medium separate from gpt-5.5", async () => { + const info = await getModelInfoCore("cx/gpt-5.5-medium", {}); assert.equal(info.provider, "codex"); assert.equal(info.model, "gpt-5.5-medium"); }); diff --git a/tests/unit/postinstall-support.test.ts b/tests/unit/postinstall-support.test.ts index 65b972ef92..55472d8aae 100644 --- a/tests/unit/postinstall-support.test.ts +++ b/tests/unit/postinstall-support.test.ts @@ -4,7 +4,7 @@ import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs"; import { join } from "node:path"; import { tmpdir } from "node:os"; -import { hasStandaloneAppBundle } from "../../scripts/postinstallSupport.mjs"; +import { hasStandaloneAppBundle } from "../../scripts/build/postinstallSupport.mjs"; test("hasStandaloneAppBundle returns false for source checkout without standalone app", () => { const root = mkdtempSync(join(tmpdir(), "omniroute-postinstall-src-")); diff --git a/tests/unit/provider-header-profiles.test.ts b/tests/unit/provider-header-profiles.test.ts index df7e79b340..46e2f0a0da 100644 --- a/tests/unit/provider-header-profiles.test.ts +++ b/tests/unit/provider-header-profiles.test.ts @@ -2,7 +2,6 @@ import test from "node:test"; import assert from "node:assert/strict"; import { - CURSOR_REGISTRY_VERSION, GITHUB_COPILOT_API_VERSION, GITHUB_COPILOT_CHAT_PLUGIN_VERSION, GITHUB_COPILOT_CHAT_USER_AGENT, @@ -12,7 +11,6 @@ import { KIRO_AMZ_USER_AGENT, KIRO_SDK_USER_AGENT, QWEN_CLI_VERSION, - getCursorUsageHeaders, getQwenCliUserAgent, getGitHubCopilotChatHeaders, getGitHubCopilotInternalUserHeaders, @@ -39,7 +37,7 @@ test("provider header profiles expose current GitHub chat and internal headers", assert.equal(internalHeaders["X-GitHub-Api-Version"], GITHUB_COPILOT_API_VERSION); }); -test("provider header profiles expose dedicated refresh, qwen, qoder, kiro and cursor variants", () => { +test("provider header profiles expose dedicated refresh, qwen, qoder and kiro variants", () => { const refreshHeaders = getGitHubCopilotRefreshHeaders("token gh-access"); assert.equal(refreshHeaders.Authorization, "token gh-access"); assert.equal(refreshHeaders["User-Agent"], GITHUB_COPILOT_REFRESH_USER_AGENT); @@ -65,12 +63,6 @@ test("provider header profiles expose dedicated refresh, qwen, qoder, kiro and c assert.equal(kiroHeaders.Accept, "application/json"); assert.equal(kiroHeaders["User-Agent"], KIRO_SDK_USER_AGENT); assert.equal(kiroHeaders["X-Amz-User-Agent"], KIRO_AMZ_USER_AGENT); - - const cursorHeaders = getCursorUsageHeaders("cursor-token"); - assert.equal(cursorHeaders.Authorization, "Bearer cursor-token"); - assert.equal(cursorHeaders["User-Agent"], `Cursor/${CURSOR_REGISTRY_VERSION}`); - assert.equal(cursorHeaders["x-cursor-user-agent"], `Cursor/${CURSOR_REGISTRY_VERSION}`); - assert.equal(cursorHeaders["x-cursor-client-version"], CURSOR_REGISTRY_VERSION); }); test("provider header profiles tolerate browser-like process shims", async () => { diff --git a/tests/unit/provider-hints.test.ts b/tests/unit/provider-hints.test.ts new file mode 100644 index 0000000000..ddbf966753 --- /dev/null +++ b/tests/unit/provider-hints.test.ts @@ -0,0 +1,58 @@ +import { test } from "node:test"; +import assert from "node:assert/strict"; +import { + defaultUseUpstream429BreakerHints, + resolveUseUpstream429BreakerHints, +} from "../../src/shared/utils/providerHints.ts"; + +test("defaultUseUpstream429BreakerHints: direct cloud providers default true", () => { + for (const id of ["openai", "anthropic", "groq", "cerebras", "mistral", "google"]) { + assert.equal(defaultUseUpstream429BreakerHints(id), true, `expected true for ${id}`); + } +}); + +test("defaultUseUpstream429BreakerHints: cliproxyapi defaults false", () => { + assert.equal(defaultUseUpstream429BreakerHints("cliproxyapi"), false); +}); + +test("defaultUseUpstream429BreakerHints: self-hosted chat providers default false", () => { + for (const id of [ + "lm-studio", + "vllm", + "lemonade", + "llamafile", + "triton", + "xinference", + "oobabooga", + ]) { + assert.equal(defaultUseUpstream429BreakerHints(id), false, `expected false for ${id}`); + } +}); + +test("defaultUseUpstream429BreakerHints: claude-code-* prefix defaults false", () => { + for (const id of [ + "anthropic-compatible-cc-direct", + "anthropic-compatible-cc-bedrock", + "anthropic-compatible-cc-vertex", + ]) { + assert.equal(defaultUseUpstream429BreakerHints(id), false, `expected false for ${id}`); + } +}); + +test("resolveUseUpstream429BreakerHints: user override wins (both directions)", () => { + // Cloud provider with user override OFF → false + assert.equal(resolveUseUpstream429BreakerHints("openai", false), false); + // Cloud provider with user override ON → true (no-op vs default) + assert.equal(resolveUseUpstream429BreakerHints("openai", true), true); + // Proxy provider with user override ON → true (user explicitly trusted it) + assert.equal(resolveUseUpstream429BreakerHints("cliproxyapi", true), true); + // Proxy provider with user override OFF → false (no-op vs default) + assert.equal(resolveUseUpstream429BreakerHints("cliproxyapi", false), false); +}); + +test("resolveUseUpstream429BreakerHints: undefined falls back to per-provider default", () => { + // Critical: this is the v3 regression-test for the v1 default-vs-gate bug. + assert.equal(resolveUseUpstream429BreakerHints("openai", undefined), true); + assert.equal(resolveUseUpstream429BreakerHints("cliproxyapi", undefined), false); + assert.equal(resolveUseUpstream429BreakerHints("lm-studio", undefined), false); +}); diff --git a/tests/unit/provider-models-config.test.ts b/tests/unit/provider-models-config.test.ts index 5149eaa5d4..961e660e5e 100644 --- a/tests/unit/provider-models-config.test.ts +++ b/tests/unit/provider-models-config.test.ts @@ -81,7 +81,10 @@ test("Kiro registry exposes the current CLI model lineup with context windows", const byId = new Map(kiroModels.map((model) => [model.id, model])); assert.ok(byId.has("claude-opus-4.7")); - assert.equal(byId.get("claude-opus-4.7")?.contextLength, undefined); // Uses default + assert.equal(byId.get("claude-opus-4.7")?.contextLength, 1000000); assert.ok(byId.has("claude-sonnet-4.6")); assert.ok(byId.has("claude-haiku-4.5")); + assert.equal(byId.has("claude-opus-4-7"), false); + assert.equal(byId.has("claude-sonnet-4-6"), false); + assert.equal(byId.has("claude-haiku-4-5"), false); }); diff --git a/tests/unit/provider-models-route.test.ts b/tests/unit/provider-models-route.test.ts index abfd620f07..b15540876e 100644 --- a/tests/unit/provider-models-route.test.ts +++ b/tests/unit/provider-models-route.test.ts @@ -12,6 +12,7 @@ const providersDb = await import("../../src/lib/db/providers.ts"); const modelsDb = await import("../../src/lib/db/models.ts"); const providerModelsRoute = await import("../../src/app/api/providers/[id]/models/route.ts"); const antigravityVersion = await import("../../open-sse/services/antigravityVersion.ts"); +const providerRegistry = await import("../../open-sse/config/providerRegistry.ts"); const originalFetch = globalThis.fetch; const originalAllowPrivateProviderUrls = process.env.OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS; @@ -205,7 +206,11 @@ test("provider models route returns static catalog entries for providers with ha assert.equal(response.status, 200); assert.equal(body.provider, "bailian-coding-plan"); - assert.equal(body.models.length, 8); + assert.equal(body.models.length, providerRegistry.REGISTRY["bailian-coding-plan"].models?.length); + assert.deepEqual( + body.models.map((model) => model.id), + providerRegistry.REGISTRY["bailian-coding-plan"].models?.map((model) => model.id) + ); }); test("provider models route returns AWS Polly speech engines from the audio registry", async () => { @@ -640,11 +645,18 @@ test("provider models route retries Antigravity discovery endpoints before retur accessToken: "ag-access", apiKey: null, }); - const seenUrls = []; + const seenUrls: string[] = []; antigravityVersion.seedAntigravityVersionCache("1.22.2"); globalThis.fetch = async (url, init = {}) => { - seenUrls.push(String(url)); + const urlString = String(url); + // After PR #2219, the discovery flow calls loadCodeAssist first as a project + // bootstrap; treat all bootstrap calls as non-fatal failures so the test + // exercises the discovery retry path. + if (urlString.includes("/v1internal:loadCodeAssist")) { + return new Response("nope", { status: 503 }); + } + seenUrls.push(urlString); if (seenUrls.length === 1) { return new Response("unavailable", { status: 503 }); } @@ -659,13 +671,20 @@ test("provider models route retries Antigravity discovery endpoints before retur const response = await callRoute(connection.id); const body = (await response.json()) as any; - const discoveryUrls = seenUrls.filter((url) => url.includes("/v1internal:models")); + // After PR #2219, the route tries `:fetchAvailableModels` URLs before + // `:models` URLs. The test mock returns 503 on the first call and success + // on the second, so only the first two `:fetchAvailableModels` URLs are + // hit — `:models` URLs are never reached. Assert on the actual discovery + // sequence the route follows. + const discoveryUrls = seenUrls.filter( + (url) => url.includes("/v1internal:fetchAvailableModels") || url.includes("/v1internal:models") + ); assert.equal(response.status, 200); assert.equal(body.source, "api"); assert.deepEqual(discoveryUrls, [ - "https://daily-cloudcode-pa.sandbox.googleapis.com/v1internal:models", - "https://daily-cloudcode-pa.googleapis.com/v1internal:models", + "https://daily-cloudcode-pa.sandbox.googleapis.com/v1internal:fetchAvailableModels", + "https://daily-cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels", ]); assert.deepEqual(body.models, [{ id: "gemini-3-flash-preview", name: "Gemini 3 Flash" }]); }); diff --git a/tests/unit/provider-route-schemas.test.ts b/tests/unit/provider-route-schemas.test.ts new file mode 100644 index 0000000000..ca61c4f28d --- /dev/null +++ b/tests/unit/provider-route-schemas.test.ts @@ -0,0 +1,27 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { createProviderSchema, providersBatchTestSchema } = + await import("../../src/shared/validation/schemas.ts"); +const { providerAllowsOptionalApiKey } = await import("../../src/shared/constants/providers.ts"); + +test("Pollinations is treated as a keyless-capable provider", () => { + assert.equal(providerAllowsOptionalApiKey("pollinations"), true); +}); + +test("createProviderSchema allows Pollinations without apiKey", () => { + const result = createProviderSchema.safeParse({ + provider: "pollinations", + name: "Pollinations", + }); + + assert.equal(result.success, true); +}); + +test("providersBatchTestSchema accepts cloud-agent batch mode", () => { + const result = providersBatchTestSchema.safeParse({ + mode: "cloud-agent", + }); + + assert.equal(result.success, true); +}); diff --git a/tests/unit/provider-scoped-models-route.test.ts b/tests/unit/provider-scoped-models-route.test.ts new file mode 100644 index 0000000000..55b40205cb --- /dev/null +++ b/tests/unit/provider-scoped-models-route.test.ts @@ -0,0 +1,119 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-provider-models-")); +process.env.DATA_DIR = TEST_DATA_DIR; + +const core = await import("../../src/lib/db/core.ts"); +const providersDb = await import("../../src/lib/db/providers.ts"); +const combosDb = await import("../../src/lib/db/combos.ts"); +const providerModelsRoute = + await import("../../src/app/api/v1/providers/[provider]/models/route.ts"); + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +async function seedConnection(provider: string, overrides: Record<string, any> = {}) { + return providersDb.createProviderConnection({ + provider, + authType: overrides.authType || "apikey", + name: overrides.name || `${provider}-${Math.random().toString(16).slice(2, 8)}`, + apiKey: overrides.apiKey || "sk-test", + accessToken: overrides.accessToken, + isActive: overrides.isActive ?? true, + testStatus: overrides.testStatus || "active", + providerSpecificData: overrides.providerSpecificData || {}, + }); +} + +test.beforeEach(async () => { + await resetStorage(); +}); + +test.after(async () => { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); +}); + +test("provider models route returns only selected provider models with unprefixed ids", async () => { + await seedConnection("openai", { name: "openai-main" }); + await seedConnection("claude", { + authType: "oauth", + name: "claude-main", + apiKey: null, + accessToken: "claude-access", + }); + await combosDb.createCombo({ + name: "team-router", + strategy: "priority", + models: ["openai/gpt-4o"], + }); + + const response = await providerModelsRoute.GET( + new Request("http://localhost/api/v1/providers/openai/models"), + { + params: Promise.resolve({ provider: "openai" }), + } + ); + + const body = (await response.json()) as any; + const ids = body.data.map((model: any) => model.id); + + assert.equal(response.status, 200); + assert.ok(ids.length > 0); + assert.equal( + ids.some((id: string) => id.includes("/")), + false + ); + assert.equal( + body.data.some((model: any) => model.owned_by !== "openai"), + false + ); + assert.equal(ids.includes("team-router"), false); +}); + +test("provider models route accepts provider alias in path", async () => { + await seedConnection("claude", { + authType: "oauth", + name: "claude-main", + apiKey: null, + accessToken: "claude-access", + }); + + const response = await providerModelsRoute.GET( + new Request("http://localhost/api/v1/providers/cc/models"), + { + params: Promise.resolve({ provider: "cc" }), + } + ); + + const body = (await response.json()) as any; + const ids = body.data.map((model: any) => model.id); + + assert.equal(response.status, 200); + assert.ok(ids.includes("claude-sonnet-4-6")); + assert.equal( + ids.some((id: string) => id.startsWith("cc/") || id.startsWith("claude/")), + false + ); +}); + +test("provider models route returns 400 for unknown provider", async () => { + const response = await providerModelsRoute.GET( + new Request("http://localhost/api/v1/providers/nope/models"), + { + params: Promise.resolve({ provider: "nope" }), + } + ); + + const body = (await response.json()) as any; + + assert.equal(response.status, 400); + assert.equal(body.error.code, "invalid_provider"); +}); diff --git a/tests/unit/provider-validation-specialty.test.ts b/tests/unit/provider-validation-specialty.test.ts index 215b636654..f1ec82f768 100644 --- a/tests/unit/provider-validation-specialty.test.ts +++ b/tests/unit/provider-validation-specialty.test.ts @@ -1,8 +1,11 @@ import test from "node:test"; import assert from "node:assert/strict"; -const { validateProviderApiKey, validateClaudeCodeCompatibleProvider } = - await import("../../src/lib/providers/validation.ts"); +const { + validateProviderApiKey, + validateClaudeCodeCompatibleProvider, + validateCommandCodeProvider, +} = await import("../../src/lib/providers/validation.ts"); const originalFetch = globalThis.fetch; @@ -10,6 +13,13 @@ test.afterEach(() => { globalThis.fetch = originalFetch; }); +function toPlainHeaders(headers: any) { + if (headers instanceof Headers) return Object.fromEntries(headers.entries()); + return Object.fromEntries( + Object.entries(headers || {}).map(([key, value]) => [key, String(value)]) + ); +} + function metaAiSseText(content: string, streamingState = "DONE") { return `event: next data: ${JSON.stringify({ @@ -73,6 +83,28 @@ test("specialty provider validators cover Deepgram, AssemblyAI, NanoBanana, Elev assert.equal(inworld.valid, true); }); +test("validateCommandCodeProvider ignores caller baseUrl and chatPath overrides", async () => { + globalThis.fetch = async (url, init = {}) => { + assert.equal(String(url), "https://api.commandcode.ai/alpha/generate"); + const headers = init.headers as Record<string, string>; + assert.equal(headers.Authorization, "Bearer cc-key"); + const body = JSON.parse(String(init.body)); + assert.equal(body.params.model, "command-code-validation-model"); + return new Response(JSON.stringify({ ok: true }), { status: 200 }); + }; + + const result = await validateCommandCodeProvider({ + apiKey: "cc-key", + providerSpecificData: { + baseUrl: "https://evil.example/api", + chatPath: "/v1/chat/completions", + validationModelId: "command-code-validation-model", + }, + }); + + assert.equal(result.valid, true); +}); + test("specialty providers surface network failures and non-auth upstream failures", async () => { globalThis.fetch = async (url) => { const target = String(url); @@ -1876,3 +1908,63 @@ test("specialty validator rejects invalid Runway credentials", async () => { assert.equal(runway.error, "Invalid API key"); }); + +test("validateCommandCodeProvider sends Command Code probe URL, headers, and wrapper body", async () => { + const calls: any[] = []; + globalThis.fetch = async (url, init = {}) => { + calls.push({ + url: String(url), + method: init.method, + headers: toPlainHeaders(init.headers), + body: JSON.parse(String(init.body)), + }); + return new Response("", { status: 400 }); + }; + + const result = await validateCommandCodeProvider({ + apiKey: "cc_test_key", + providerSpecificData: { validationModelId: "gpt-5.4-mini" }, + }); + + assert.deepEqual(result, { valid: true, error: null }); + assert.equal(calls.length, 1); + assert.equal(calls[0].url, "https://api.commandcode.ai/alpha/generate"); + assert.equal(calls[0].method, "POST"); + assert.equal(calls[0].headers.Authorization, "Bearer cc_test_key"); + assert.equal(calls[0].headers["Content-Type"], "application/json"); + assert.equal(calls[0].headers["x-command-code-version"], "0.24.1"); + assert.equal(calls[0].headers["x-cli-environment"], "external"); + assert.equal(calls[0].headers["x-project-slug"], "pi-cc"); + assert.equal(calls[0].headers["x-taste-learning"], "false"); + assert.equal(calls[0].headers["x-co-flag"], "false"); + assert.equal(typeof calls[0].headers["x-session-id"], "string"); + assert.equal(calls[0].body.config.environment, "external"); + assert.equal(calls[0].body.permissionMode, "standard"); + assert.equal(calls[0].body.params.model, "gpt-5.4-mini"); + assert.equal(calls[0].body.params.stream, false); + assert.equal(calls[0].body.params.max_tokens, 1); +}); + +for (const status of [400, 422, 429]) { + test(`validateCommandCodeProvider accepts ${status} as direct validator auth success`, async () => { + globalThis.fetch = async () => new Response("", { status }); + assert.deepEqual(await validateCommandCodeProvider({ apiKey: "cc_test_key" }), { + valid: true, + error: null, + }); + }); +} + +test("validateCommandCodeProvider rejects auth failures and provider outages", async () => { + globalThis.fetch = async () => new Response("unauthorized", { status: 401 }); + assert.deepEqual(await validateCommandCodeProvider({ apiKey: "bad" }), { + valid: false, + error: "Invalid API key", + }); + + globalThis.fetch = async () => new Response("server down", { status: 500 }); + assert.deepEqual(await validateCommandCodeProvider({ apiKey: "cc_test_key" }), { + valid: false, + error: "Provider unavailable (500)", + }); +}); diff --git a/tests/unit/proxy-connection-test.test.ts b/tests/unit/proxy-connection-test.test.ts index 3d07ad1c99..4f5c0f9a49 100644 --- a/tests/unit/proxy-connection-test.test.ts +++ b/tests/unit/proxy-connection-test.test.ts @@ -1,5 +1,9 @@ import test from "node:test"; import assert from "node:assert/strict"; +import { + providerAllowsOptionalApiKey, + SELF_HOSTED_CHAT_PROVIDER_IDS, +} from "@/shared/constants/providers"; // ── Import test targets from connection test route ────────────────────────── @@ -322,6 +326,46 @@ test("OAuth test config covers all expected providers", () => { } }); +// ── testApiKeyConnection requiresApiKey Check ────────────────────────────── +// Uses the centralized providerAllowsOptionalApiKey from providers.ts + +test("testApiKeyConnection: searxng-search with empty API key does NOT require API key", () => { + assert.equal(providerAllowsOptionalApiKey("searxng-search"), true); +}); + +test("testApiKeyConnection: petals with empty API key does NOT require API key", () => { + assert.equal(providerAllowsOptionalApiKey("petals"), true); +}); + +test("testApiKeyConnection: self-hosted chat providers with empty API key do NOT require API key", () => { + for (const provider of SELF_HOSTED_CHAT_PROVIDER_IDS) { + assert.equal( + providerAllowsOptionalApiKey(provider), + true, + `Expected ${provider} to not require API key` + ); + } +}); + +test("testApiKeyConnection: openai-compatible providers with empty API key do NOT require API key", () => { + assert.equal(providerAllowsOptionalApiKey("openai-compatible-chat-test"), true); +}); + +test("testApiKeyConnection: anthropic-compatible providers with empty API key do NOT require API key", () => { + assert.equal(providerAllowsOptionalApiKey("anthropic-compatible-chat-test"), true); +}); + +test("testApiKeyConnection: providers requiring an API key are correctly identified", () => { + const providersThatRequireKeys = ["openai", "groq", "gemini", "unknown-provider"]; + for (const provider of providersThatRequireKeys) { + assert.equal( + providerAllowsOptionalApiKey(provider), + false, + `Expected ${provider} to require an API key` + ); + } +}); + test("Refreshable OAuth providers are correctly identified", () => { const refreshable = [ "codex", diff --git a/tests/unit/proxy-management-v1-route.test.ts b/tests/unit/proxy-management-v1-route.test.ts index 66d8e2809f..8fa6b8e760 100644 --- a/tests/unit/proxy-management-v1-route.test.ts +++ b/tests/unit/proxy-management-v1-route.test.ts @@ -133,7 +133,7 @@ test("v1 management proxies main route covers auth, lookup variants, update and }), }) ); - assert.equal(postAuthRes.status, 401); + assert.equal(postAuthRes.status, 403); const patchAuthRes = await proxyV1Route.PATCH( new Request("http://localhost/api/v1/management/proxies", { @@ -142,7 +142,7 @@ test("v1 management proxies main route covers auth, lookup variants, update and body: JSON.stringify({ id: "proxy-1", notes: "denied" }), }) ); - assert.equal(patchAuthRes.status, 401); + assert.equal(patchAuthRes.status, 403); const deleteAuthRes = await proxyV1Route.DELETE( new Request("http://localhost/api/v1/management/proxies?id=proxy-1", { diff --git a/tests/unit/proxyfetch-undici-retry.test.ts b/tests/unit/proxyfetch-undici-retry.test.ts new file mode 100644 index 0000000000..e78e9acd40 --- /dev/null +++ b/tests/unit/proxyfetch-undici-retry.test.ts @@ -0,0 +1,115 @@ +// Tests for the undici dispatcher retry logic in proxyFetch. +// +// Approach B (dependency injection): proxyFetch.ts exports a named `proxyFetch` function +// that accepts optional `deps: ProxyFetchDeps` for injecting mock undici/native fetch +// implementations. This makes retry count assertions precise and deterministic without +// requiring mock.module() (which is unavailable in this Node 25 / tsx/ESM setup). +// +// All three tests MUST fail when the retry loop is removed from proxyFetch.ts (sanity check). + +import { test } from "node:test"; +import assert from "node:assert/strict"; +import { proxyFetch } from "../../open-sse/utils/proxyFetch.ts"; + +function makeUndiciError(msg = "fetch failed", code = "UND_ERR_SOCKET"): Error { + const err = new Error(msg) as Error & { code?: string }; + err.code = code; + return err; +} + +test("undici is called exactly twice then native fallback fires once (both undici attempts fail)", async () => { + let undiciCalls = 0; + let nativeCalls = 0; + + const mockUndici = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + undiciCalls++; + throw makeUndiciError("fetch failed"); + }; + + const mockNative = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + nativeCalls++; + return new Response("native-fallback-body", { status: 200 }); + }; + + const res = await proxyFetch( + "https://example.invalid/test", + { method: "GET" }, + { undiciFetch: mockUndici, nativeFetch: mockNative } + ); + + assert.equal(undiciCalls, 2, "undici must be called exactly twice (initial + retry)"); + assert.equal( + nativeCalls, + 1, + "native fallback must fire exactly once after both undici attempts fail" + ); + assert.equal(await res.text(), "native-fallback-body"); +}); + +test("retry-succeeds: undici fails once then succeeds, native fallback is NOT invoked", async () => { + let undiciCalls = 0; + let nativeCalls = 0; + + const mockUndici = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + undiciCalls++; + if (undiciCalls === 1) { + throw makeUndiciError("fetch failed"); + } + return new Response("undici-retry-success", { status: 200 }); + }; + + const mockNative = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + nativeCalls++; + return new Response("should-not-be-called", { status: 200 }); + }; + + const res = await proxyFetch( + "https://example.invalid/test", + { method: "GET" }, + { undiciFetch: mockUndici, nativeFetch: mockNative } + ); + + assert.equal( + undiciCalls, + 2, + "undici must be called exactly twice (initial fail + retry success)" + ); + assert.equal(nativeCalls, 0, "native fallback must NOT be invoked when retry succeeds"); + assert.equal(await res.text(), "undici-retry-success"); +}); + +test("does not retry when body is a ReadableStream (non-replayable body)", async () => { + let undiciCalls = 0; + let nativeCalls = 0; + + const mockUndici = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + undiciCalls++; + throw makeUndiciError("fetch failed"); + }; + + const mockNative = async (_input: RequestInfo | URL, _init?: RequestInit): Promise<Response> => { + nativeCalls++; + return new Response("native-stream-fallback", { status: 200 }); + }; + + const stream = new ReadableStream({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])); + controller.close(); + }, + }); + + const res = await proxyFetch( + "https://example.invalid/test", + { method: "POST", body: stream }, + { undiciFetch: mockUndici, nativeFetch: mockNative } + ); + + assert.equal( + undiciCalls, + 1, + "undici must NOT retry when body is a ReadableStream (called exactly once)" + ); + assert.equal(nativeCalls, 1, "native fallback fires after single undici attempt"); + assert.equal(await res.text(), "native-stream-fallback"); +}); diff --git a/tests/unit/public-api-routes.test.ts b/tests/unit/public-api-routes.test.ts index 755cec0cbb..e30b1f809e 100644 --- a/tests/unit/public-api-routes.test.ts +++ b/tests/unit/public-api-routes.test.ts @@ -18,7 +18,7 @@ test("isPublicApiRoute allows readonly health and require-login bootstrap routes assert.equal(isPublicApiRoute("/api/settings/require-login", "GET"), true); assert.equal(isPublicApiRoute("/api/settings/require-login", "HEAD"), true); assert.equal(isPublicApiRoute("/api/settings/require-login", "OPTIONS"), true); - assert.equal(isPublicApiRoute("/api/settings/require-login", "POST"), true); + assert.equal(isPublicApiRoute("/api/settings/require-login", "POST"), false); }); test("isPublicApiRoute rejects non-public management routes", () => { diff --git a/tests/unit/reasoning-cache.test.ts b/tests/unit/reasoning-cache.test.ts index b2dcf6d496..af1126c702 100644 --- a/tests/unit/reasoning-cache.test.ts +++ b/tests/unit/reasoning-cache.test.ts @@ -19,6 +19,7 @@ process.env.DATA_DIR = mkdtempSync(join(tmpdir(), "omniroute-reasoning-")); import { cacheReasoningFromAssistantMessage, cacheReasoning, + cacheReasoningByKey, cacheReasoningBatch, deleteReasoningCacheEntry, getReasoningCacheServiceEntries, @@ -26,11 +27,13 @@ import { recordReplay, getReasoningCacheServiceStats, clearReasoningCacheAll, + isDeepSeekReasoningModel, requiresReasoningReplay, cleanupReasoningCache, } from "../../open-sse/services/reasoningCache.ts"; import { translateRequest } from "../../open-sse/translator/index.ts"; import { FORMATS } from "../../open-sse/translator/formats.ts"; +import { ensureToolCallIds } from "../../open-sse/translator/helpers/toolCallHelper.ts"; import { getDbInstance } from "../../src/lib/db/core.ts"; import { getReasoningCache, setReasoningCache } from "../../src/lib/db/reasoningCache.ts"; import { DELETE, GET } from "../../src/app/api/cache/reasoning/route.ts"; @@ -124,6 +127,37 @@ describe("Reasoning Replay Cache — Service Layer", () => { assert.equal(lookupReasoning("call_capture_2"), "Captured assistant reasoning"); }); + it("should keep request message cache keys stable when tool call IDs change", () => { + clearReasoningCacheAll(); + + const requestId = "req_reasoning_stable"; + const messageIndex = 2; + const cacheKey = `${requestId}:${messageIndex}`; + const body = { + messages: [ + { + role: "assistant", + tool_calls: [ + { + id: "call_before_normalization", + type: "function", + function: { name: "lookup", arguments: { city: "Seoul" } }, + }, + ], + }, + { role: "tool", content: "Sunny" }, + ], + }; + + cacheReasoning(cacheKey, "deepseek", "deepseek-reasoner", "Stable cached reasoning"); + const originalToolCallId = body.messages[0].tool_calls[0].id; + + ensureToolCallIds(body, { use9CharId: true }); + + assert.notEqual(body.messages[0].tool_calls[0].id, originalToolCallId); + assert.equal(lookupReasoning(cacheKey), "Stable cached reasoning"); + }); + it("should capture provider reasoning alias when reasoning_content is absent", () => { clearReasoningCacheAll(); @@ -141,6 +175,53 @@ describe("Reasoning Replay Cache — Service Layer", () => { assert.equal(lookupReasoning("call_capture_alias"), "Alias reasoning"); }); + it("should cache assistant reasoning without tool calls by request and message index", () => { + clearReasoningCacheAll(); + + const cached = cacheReasoningFromAssistantMessage( + { + role: "assistant", + reasoning_content: "No tool call reasoning", + }, + "deepseek", + "deepseek-reasoner", + { requestId: "req_no_tools", messageIndex: 3 } + ); + + assert.equal(cached, 1); + assert.equal(lookupReasoning("request:req_no_tools:message:3"), "No tool call reasoning"); + }); + + it("should skip assistant reasoning without tool calls when stable key context is absent", () => { + clearReasoningCacheAll(); + + const cached = cacheReasoningFromAssistantMessage( + { + role: "assistant", + reasoning_content: "Missing key context", + }, + "deepseek", + "deepseek-reasoner" + ); + + assert.equal(cached, 0); + assert.equal(lookupReasoning("request:req_missing:message:0"), null); + }); + + it("should store arbitrary reasoning cache keys", () => { + clearReasoningCacheAll(); + + cacheReasoningByKey( + "request:req_direct:message:1", + "deepseek", + "deepseek-reasoner", + "Keyed plan" + ); + + assert.equal(lookupReasoning("request:req_direct:message:1"), "Keyed plan"); + assert.equal(getReasoningCache("request:req_direct:message:1")?.reasoning, "Keyed plan"); + }); + it("should not overwrite if same tool_call_id is cached again", () => { cacheReasoning("call_overwrite", "deepseek", "deepseek-chat", "First reasoning"); cacheReasoning("call_overwrite", "deepseek", "deepseek-chat", "Updated reasoning"); @@ -311,47 +392,114 @@ describe("Reasoning Replay Cache — Service Layer", () => { describe("Reasoning Replay Cache — Provider Detection", () => { it("should detect deepseek as requiring replay", () => { - assert.equal(requiresReasoningReplay("deepseek", "deepseek-chat"), true); + assert.equal(requiresReasoningReplay({ provider: "deepseek", model: "deepseek-chat" }), true); }); it("should detect opencode-go as requiring replay", () => { - assert.equal(requiresReasoningReplay("opencode-go", "some-model"), true); + assert.equal(requiresReasoningReplay({ provider: "opencode-go", model: "some-model" }), true); }); it("should detect siliconflow as requiring replay", () => { - assert.equal(requiresReasoningReplay("siliconflow", "deepseek-r1"), true); + assert.equal(requiresReasoningReplay({ provider: "siliconflow", model: "deepseek-r1" }), true); }); it("should detect deepseek-r1 model pattern", () => { - assert.equal(requiresReasoningReplay("unknown-provider", "deepseek-r1"), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "deepseek-r1" }), + true + ); }); it("should detect deepseek-reasoner model pattern", () => { - assert.equal(requiresReasoningReplay("unknown-provider", "deepseek-reasoner"), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "deepseek-reasoner" }), + true + ); + }); + + it("should detect DeepSeek V4 model pattern", () => { + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "deepseek/v4-pro" }), + true + ); + }); + + it("should detect DeepSeek V4 thinking mode explicitly", () => { + assert.equal( + isDeepSeekReasoningModel({ + provider: "unknown-provider", + model: "deepseek-v4.flash", + thinkingEnabled: true, + }), + true + ); + }); + + it("should NOT detect DeepSeek V4 when thinking mode is disabled", () => { + assert.equal( + isDeepSeekReasoningModel({ + provider: "unknown-provider", + model: "deepseek-v4.flash", + thinkingEnabled: false, + }), + false + ); }); it("should detect kimi-k2 model pattern", () => { - assert.equal(requiresReasoningReplay("unknown-provider", "kimi-k2.5"), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "kimi-k2.5" }), + true + ); }); it("should detect qwq model pattern", () => { - assert.equal(requiresReasoningReplay("unknown-provider", "qwq-32b-preview"), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "qwq-32b-preview" }), + true + ); }); it("should detect qwen-thinking model pattern", () => { - assert.equal(requiresReasoningReplay("unknown-provider", "qwen3-thinking-235b"), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "qwen3-thinking-235b" }), + true + ); }); it("should detect GLM thinking model pattern", () => { - assert.equal(requiresReasoningReplay("glm", "glm-5-thinking"), true); + assert.equal(requiresReasoningReplay({ provider: "glm", model: "glm-5-thinking" }), true); + }); + + it("should detect xiaomi-mimo provider", () => { + // MiMo enforces reasoning_content echo on subsequent turns; without + // replay the upstream returns 400 "Param Incorrect: The reasoning_content + // in the thinking mode must be passed back to the API." + assert.equal( + requiresReasoningReplay({ provider: "xiaomi-mimo", model: "mimo-v2.5-pro" }), + true + ); + assert.equal(requiresReasoningReplay({ provider: "XIAOMI-MIMO", model: "mimo-v2.5" }), true); + }); + + it("should detect mimo-v* model pattern under any provider id", () => { + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "mimo-v2.5-pro" }), + true + ); + assert.equal(requiresReasoningReplay({ provider: "unknown-provider", model: "mimo-v3" }), true); + assert.equal( + requiresReasoningReplay({ provider: "unknown-provider", model: "MimoV2.5-pro" }), + true + ); }); it("should NOT detect a generic openai model", () => { - assert.equal(requiresReasoningReplay("openai", "gpt-4o"), false); + assert.equal(requiresReasoningReplay({ provider: "openai", model: "gpt-4o" }), false); }); it("should NOT detect claude as requiring replay", () => { - assert.equal(requiresReasoningReplay("anthropic", "claude-opus-4"), false); + assert.equal(requiresReasoningReplay({ provider: "anthropic", model: "claude-opus-4" }), false); }); }); diff --git a/tests/unit/request-logger-bounded-clone.test.ts b/tests/unit/request-logger-bounded-clone.test.ts new file mode 100644 index 0000000000..bcaa8b6cc4 --- /dev/null +++ b/tests/unit/request-logger-bounded-clone.test.ts @@ -0,0 +1,51 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { cloneBoundedForLog, MAX_LOG_ARRAY_ITEMS } = + await import("../../open-sse/utils/requestLogger.ts"); + +test("cloneBoundedForLog: tools array is exempt from truncation (debug-critical)", () => { + const tools = Array.from({ length: 45 }, (_, i) => ({ + name: `tool_${String(i).padStart(2, "0")}`, + description: `Tool ${i} description`, + })); + const result = cloneBoundedForLog({ tools }) as { tools: Array<Record<string, unknown>> }; + assert.equal(result.tools.length, 45); + assert.equal(result.tools[0].name, "tool_00"); + assert.equal(result.tools[44].name, "tool_44"); + // No truncation marker should appear inside tools + assert.ok( + !("_omniroute_truncated_array" in result.tools[0]), + "tools array should NOT have truncation marker" + ); +}); + +test("cloneBoundedForLog: other large arrays still truncated to MAX_LOG_ARRAY_ITEMS", () => { + const messages = Array.from({ length: 45 }, (_, i) => ({ role: "user", content: `msg ${i}` })); + const result = cloneBoundedForLog({ messages }) as { messages: Array<Record<string, unknown>> }; + assert.equal(result.messages.length, MAX_LOG_ARRAY_ITEMS + 1, "1 marker + tail items"); + const marker = result.messages[0]; + assert.equal(marker._omniroute_truncated_array, true); + assert.equal(marker.originalLength, 45); + assert.equal(marker.retainedTailItems, MAX_LOG_ARRAY_ITEMS); +}); + +test("cloneBoundedForLog: nested tools field still exempt", () => { + const body = { + body: { tools: Array.from({ length: 30 }, (_, i) => ({ name: `t_${i}` })) }, + }; + const result = cloneBoundedForLog(body) as { body: { tools: unknown[] } }; + assert.equal(result.body.tools.length, 30); +}); + +test("cloneBoundedForLog: top-level array without key context still truncated", () => { + const arr = Array.from({ length: 45 }, (_, i) => i); + const result = cloneBoundedForLog(arr) as unknown[]; + assert.equal(result.length, MAX_LOG_ARRAY_ITEMS + 1); +}); + +test("cloneBoundedForLog: small tools array (<=MAX) passes through unchanged", () => { + const tools = Array.from({ length: 10 }, (_, i) => ({ name: `t_${i}` })); + const result = cloneBoundedForLog({ tools }) as { tools: unknown[] }; + assert.equal(result.tools.length, 10); +}); diff --git a/tests/unit/resilience-settings-upstream429-breaker.test.ts b/tests/unit/resilience-settings-upstream429-breaker.test.ts new file mode 100644 index 0000000000..b22a2d95c9 --- /dev/null +++ b/tests/unit/resilience-settings-upstream429-breaker.test.ts @@ -0,0 +1,96 @@ +import { test } from "node:test"; +import assert from "node:assert/strict"; +import { + DEFAULT_RESILIENCE_SETTINGS, + mergeResilienceSettings, + resolveResilienceSettings, + type ResilienceSettings, +} from "../../src/lib/resilience/settings.ts"; + +function cloneDefaults(): ResilienceSettings { + // structuredClone is enough for the plain-object settings shape. + return structuredClone(DEFAULT_RESILIENCE_SETTINGS); +} + +test("defaults: useUpstream429BreakerHints omitted (undefined) on both profiles", () => { + const settings = cloneDefaults(); + assert.equal(settings.connectionCooldown.oauth.useUpstream429BreakerHints, undefined); + assert.equal(settings.connectionCooldown.apikey.useUpstream429BreakerHints, undefined); +}); + +test("mergeResilienceSettings: explicit true is stored", () => { + const current = cloneDefaults(); + const next = mergeResilienceSettings(current, { + connectionCooldown: { oauth: { useUpstream429BreakerHints: true } }, + }); + assert.equal(next.connectionCooldown.oauth.useUpstream429BreakerHints, true); + // apikey unchanged + assert.equal(next.connectionCooldown.apikey.useUpstream429BreakerHints, undefined); +}); + +test("mergeResilienceSettings: explicit false is stored", () => { + const current = cloneDefaults(); + const next = mergeResilienceSettings(current, { + connectionCooldown: { apikey: { useUpstream429BreakerHints: false } }, + }); + assert.equal(next.connectionCooldown.apikey.useUpstream429BreakerHints, false); +}); + +test("mergeResilienceSettings: null sentinel deletes the field (back to undefined)", () => { + // Start with explicit false on oauth + const start = mergeResilienceSettings(cloneDefaults(), { + connectionCooldown: { oauth: { useUpstream429BreakerHints: false } }, + }); + assert.equal(start.connectionCooldown.oauth.useUpstream429BreakerHints, false); + // PATCH with null should reset to undefined + const next = mergeResilienceSettings(start, { + connectionCooldown: { + oauth: { useUpstream429BreakerHints: null as unknown as boolean }, + }, + }); + assert.equal(next.connectionCooldown.oauth.useUpstream429BreakerHints, undefined); + // Key should not appear in JSON + const serialized = JSON.parse(JSON.stringify(next.connectionCooldown.oauth)); + assert.equal( + "useUpstream429BreakerHints" in serialized, + false, + "key should be absent in serialized JSON" + ); +}); + +test("mergeResilienceSettings: omitted key (partial-merge) leaves existing value", () => { + // Start with explicit true on apikey + const start = mergeResilienceSettings(cloneDefaults(), { + connectionCooldown: { apikey: { useUpstream429BreakerHints: true } }, + }); + // PATCH oauth only — apikey must keep its value + const next = mergeResilienceSettings(start, { + connectionCooldown: { oauth: { baseCooldownMs: 5000 } }, + }); + assert.equal(next.connectionCooldown.apikey.useUpstream429BreakerHints, true); +}); + +test("resolveResilienceSettings: omitted field in record stays undefined (no toBoolean coercion)", () => { + const record = { + connectionCooldown: { + oauth: { baseCooldownMs: 1000, useUpstreamRetryHints: true, maxBackoffSteps: 5 }, + apikey: { baseCooldownMs: 2000, useUpstreamRetryHints: false, maxBackoffSteps: 3 }, + }, + }; + const resolved = resolveResilienceSettings( + record as Parameters<typeof resolveResilienceSettings>[0] + ); + assert.equal(resolved.connectionCooldown.oauth.useUpstream429BreakerHints, undefined); + assert.equal(resolved.connectionCooldown.apikey.useUpstream429BreakerHints, undefined); +}); + +test("mixed-provider round-trip: oauth=false + apikey=true survives merge", () => { + const next = mergeResilienceSettings(cloneDefaults(), { + connectionCooldown: { + oauth: { useUpstream429BreakerHints: false }, + apikey: { useUpstream429BreakerHints: true }, + }, + }); + assert.equal(next.connectionCooldown.oauth.useUpstream429BreakerHints, false); + assert.equal(next.connectionCooldown.apikey.useUpstream429BreakerHints, true); +}); diff --git a/tests/unit/response-sanitizer.test.ts b/tests/unit/response-sanitizer.test.ts index 72a1ced0b6..718fda3070 100644 --- a/tests/unit/response-sanitizer.test.ts +++ b/tests/unit/response-sanitizer.test.ts @@ -37,7 +37,7 @@ test("sanitizeOpenAIResponse strips non-standard fields and preserves required t }); }); -test("sanitizeOpenAIResponse extracts thinking, collapses newlines, strips final reasoning_content, and preserves tool calls", () => { +test("sanitizeOpenAIResponse extracts thinking, collapses newlines, preserves reasoning_content with tool_calls, and preserves tool calls", () => { const sanitized = sanitizeOpenAIResponse({ id: "chatcmpl_test", model: "gpt-4.1", @@ -58,7 +58,7 @@ test("sanitizeOpenAIResponse extracts thinking, collapses newlines, strips final assert.equal((sanitized as any).choices[0].index, 2); assert.equal((sanitized as any).choices[0].finish_reason, "tool_calls"); (assert as any).equal((sanitized as any).choices[0].message.content, "Hello\n\nworld"); - assert.equal((sanitized as any).choices[0].message.reasoning_content, undefined); + assert.equal((sanitized as any).choices[0].message.reasoning_content, "internal chain"); (assert as any).deepEqual((sanitized as any).choices[0].message.tool_calls, [{ id: "call_1" }]); assert.deepEqual((sanitized as any).choices[0].message.function_call, { name: "legacy" }); }); @@ -121,6 +121,61 @@ test("sanitizeOpenAIResponse strips reasoning_details-derived reasoning_content assert.equal((sanitized as any).choices[0].message.reasoning_content, undefined); }); +test("sanitizeOpenAIResponse preserves DeepSeek V4 reasoning_content with visible text", () => { + const sanitized = sanitizeOpenAIResponse({ + model: "deepseek-v4-pro", + choices: [ + { + message: { + role: "assistant", + content: "Visible answer", + reasoning_content: "DeepSeek reasoning", + }, + }, + ], + }); + + assert.equal((sanitized as any).choices[0].message.content, "Visible answer"); + assert.equal((sanitized as any).choices[0].message.reasoning_content, "DeepSeek reasoning"); +}); + +test("sanitizeOpenAIResponse preserves DeepSeek V4 reasoning_details with visible text", () => { + const sanitized = sanitizeOpenAIResponse({ + model: "deepseek-v4/reasoner", + choices: [ + { + message: { + role: "assistant", + content: "Visible answer", + reasoning_details: [ + { type: "reasoning.text", text: "first " }, + { type: "thinking", content: "second" }, + ], + }, + }, + ], + }); + + assert.equal((sanitized as any).choices[0].message.reasoning_content, "first second"); +}); + +test("sanitizeOpenAIResponse still strips non-DeepSeek reasoning_content with visible text", () => { + const sanitized = sanitizeOpenAIResponse({ + model: "o3-mini", + choices: [ + { + message: { + role: "assistant", + content: "Visible answer", + reasoning_content: "OpenAI reasoning", + }, + }, + ], + }); + + assert.equal((sanitized as any).choices[0].message.reasoning_content, undefined); +}); + test("sanitizeOpenAIResponse keeps reasoning_details-derived reasoning_content for reasoning-only messages", () => { const sanitized = sanitizeOpenAIResponse({ model: "openrouter/model", @@ -309,6 +364,91 @@ test("sanitizeStreamingChunk preserves Copilot reasoning_text deltas", () => { assert.equal((sanitized as any).choices[0].delta.reasoning_text, "copilot reasoning"); }); +test("sanitizeOpenAIResponse preserves reasoning_content when tool_calls are present", () => { + // Bug fix: Kimi and other thinking-enabled providers require reasoning_content + // on assistant messages that contain tool_calls. The sanitizer was stripping + // reasoning_content whenever visible content existed, breaking subsequent + // requests with "thinking is enabled but reasoning_content is missing". + const sanitized = sanitizeOpenAIResponse({ + model: "kimi-k2.6-thinking", + choices: [ + { + message: { + role: "assistant", + content: "Let me search for that.", + reasoning_content: "I need to use the web search tool to find current information.", + tool_calls: [ + { + id: "call_search_1", + type: "function", + function: { + name: "web_search", + arguments: '{"query":"latest news"}', + }, + }, + ], + }, + }, + ], + }); + + const message = (sanitized as any).choices[0].message; + assert.equal(message.content, "Let me search for that."); + assert.equal( + message.reasoning_content, + "I need to use the web search tool to find current information.", + "reasoning_content must be preserved when tool_calls are present" + ); + assert.equal(message.tool_calls.length, 1); + assert.equal(message.tool_calls[0].id, "call_search_1"); +}); + +test("sanitizeOpenAIResponse still strips reasoning_content when no tool_calls exist", () => { + // When there are no tool_calls, the original behavior should remain: + // reasoning_content is stripped to avoid client rendering issues. + const sanitized = sanitizeOpenAIResponse({ + model: "gpt-4.1", + choices: [ + { + message: { + role: "assistant", + content: "Hello world", + reasoning_content: "Some internal reasoning", + }, + }, + ], + }); + + const message = (sanitized as any).choices[0].message; + assert.equal(message.content, "Hello world"); + assert.equal(message.reasoning_content, undefined); +}); + +test("sanitizeOpenAIResponse preserves reasoning_content when legacy function_call is present", () => { + const sanitized = sanitizeOpenAIResponse({ + model: "kimi-k2.6-thinking", + choices: [ + { + message: { + role: "assistant", + content: "Let me calculate that.", + reasoning_content: "I need to use the calculator function.", + function_call: { name: "calculate", arguments: '{"expr":"1+1"}' }, + }, + }, + ], + }); + + const message = (sanitized as any).choices[0].message; + assert.equal(message.content, "Let me calculate that."); + assert.equal( + message.reasoning_content, + "I need to use the calculator function.", + "reasoning_content must be preserved when legacy function_call is present" + ); + assert.deepEqual(message.function_call, { name: "calculate", arguments: '{"expr":"1+1"}' }); +}); + test("sanitize functions return non-object inputs unchanged", () => { assert.equal(sanitizeOpenAIResponse(null), null); assert.equal(sanitizeStreamingChunk("raw text"), "raw text"); diff --git a/tests/unit/responses-handler.test.ts b/tests/unit/responses-handler.test.ts index f76a4d4881..743faea99a 100644 --- a/tests/unit/responses-handler.test.ts +++ b/tests/unit/responses-handler.test.ts @@ -224,6 +224,45 @@ test("handleResponsesCore transforms upstream OpenAI SSE into Responses API SSE" assert.match(sse, /data: \[DONE\]/); }); +test("handleResponsesCore transforms Command Code executor SSE through Responses shim", async () => { + const { call, result } = await invokeResponsesCore({ + provider: "command-code", + model: "gpt-5.4-mini", + credentials: { apiKey: "cc_test_key", providerSpecificData: {} }, + body: { + model: "gpt-5.4-mini", + input: "hello command code", + }, + responseFactory() { + return new Response( + [ + `data: ${JSON.stringify({ type: "text-delta", text: "command" })}`, + "", + `data: ${JSON.stringify({ type: "reasoning-delta", text: "thinking" })}`, + "", + `data: ${JSON.stringify({ type: "finish", finishReason: "stop" })}`, + "", + ].join("\n"), + { status: 200, headers: { "Content-Type": "application/x-ndjson" } } + ); + }, + }); + + assert.equal(result.success, true); + assert.equal(call.url, "https://api.commandcode.ai/alpha/generate"); + assert.equal(call.headers.Authorization, "Bearer cc_test_key"); + assert.equal(call.headers["x-command-code-version"], "0.24.1"); + assert.equal(call.body.params.model, "gpt-5.4-mini"); + assert.equal(call.body.params.stream, true); + + const sse = await result.response.text(); + assert.match(sse, /event: response\.created/); + assert.match(sse, /event: response\.output_text\.delta/); + assert.match(sse, /command/); + assert.match(sse, /event: response\.completed/); + assert.match(sse, /data: \[DONE\]/); +}); + test("handleResponsesCore propagates upstream failures from chatCore unchanged", async () => { const { result } = await invokeResponsesCore({ body: { @@ -267,7 +306,10 @@ test("handleResponsesCore rejects invalid Responses API input that cannot be tra ); }); -test("handleResponsesCore injects SSE keepalive comments for Responses streams", async (t) => { +test("handleResponsesCore injects SSE keepalive frames for Responses streams", async (t) => { + // PR #2233 changed the Responses-API heartbeat shape from a SSE comment + // (`: keepalive ...`) to a `data: {"type":"response.in_progress"}` frame, + // because strict proxies only count `data:` lines as activity. t.mock.timers.enable({ apis: ["setInterval"] }); try { const { result } = await invokeResponsesCore({ @@ -282,7 +324,7 @@ test("handleResponsesCore injects SSE keepalive comments for Responses streams", const sse = await result.response.text(); - assert.match(sse, /^: keepalive .*$/m); + assert.match(sse, /data: \{"type":"response\.in_progress"\}/); assert.match(sse, /event: response\.created/); assert.match(sse, /data: \[DONE\]/); } finally { diff --git a/tests/unit/responses-translation-fixes.test.ts b/tests/unit/responses-translation-fixes.test.ts index 1abf64d3eb..644c4882a4 100644 --- a/tests/unit/responses-translation-fixes.test.ts +++ b/tests/unit/responses-translation-fixes.test.ts @@ -406,7 +406,7 @@ test("Responses→Chat streaming: reasoning delta emits reasoning_content in Cha }; const result = openaiResponsesToOpenAIResponse(chunk, state); assert.ok(result, "should return a chunk"); - assert.equal(result.choices[0].delta.reasoning.summary, "thinking step..."); + assert.equal(result.choices[0].delta.reasoning_content, "thinking step..."); }); test("Responses→Chat streaming: Copilot mode emits reasoning_text for summary deltas", () => { diff --git a/tests/unit/responses-ws-proxy.test.mjs b/tests/unit/responses-ws-proxy.test.mjs index b2c02ce845..382ced9b9c 100644 --- a/tests/unit/responses-ws-proxy.test.mjs +++ b/tests/unit/responses-ws-proxy.test.mjs @@ -2,7 +2,7 @@ import test from "node:test"; import assert from "node:assert/strict"; import http from "node:http"; -const { createResponsesWsProxy } = await import("../../scripts/responses-ws-proxy.mjs"); +const { createResponsesWsProxy } = await import("../../scripts/dev/responses-ws-proxy.mjs"); function listen(server) { return new Promise((resolve) => { diff --git a/tests/unit/route-edge-coverage.test.ts b/tests/unit/route-edge-coverage.test.ts index 5b95e12125..87380832a7 100644 --- a/tests/unit/route-edge-coverage.test.ts +++ b/tests/unit/route-edge-coverage.test.ts @@ -174,8 +174,8 @@ test("api keys route covers auth, create, masking, pagination fallback and cloud assert.equal(unauthenticated.status, 401); assert.equal(unauthenticatedBody.error.message, "Authentication required"); - assert.equal(invalidToken.status, 401); - assert.equal(invalidTokenBody.error.message, "Invalid API key"); + assert.equal(invalidToken.status, 403); + assert.equal(invalidTokenBody.error.message, "Invalid management token"); assert.equal(created.status, 201); assert.equal(createdBody.name, "Key / Prod #1"); @@ -595,8 +595,8 @@ test("management proxies route covers auth, pagination, lookup, where-used, patc assert.equal(unauthenticated.status, 401); assert.equal(unauthenticatedBody.error.message, "Authentication required"); - assert.equal(invalidToken.status, 401); - assert.equal(invalidTokenBody.error.message, "Invalid API key"); + assert.equal(invalidToken.status, 403); + assert.equal(invalidTokenBody.error.message, "Invalid management token"); assert.equal(createdResponse.status, 201); assert.equal(pagedList.status, 200); assert.equal(pagedListBody.page.limit, 200); diff --git a/tests/unit/run-next-playwright.test.ts b/tests/unit/run-next-playwright.test.ts index 4bd2665915..9b66bca43d 100644 --- a/tests/unit/run-next-playwright.test.ts +++ b/tests/unit/run-next-playwright.test.ts @@ -4,7 +4,7 @@ import fs from "node:fs"; import os from "node:os"; import path from "node:path"; -const playwrightRunner = await import("../../scripts/run-next-playwright.mjs"); +const playwrightRunner = await import("../../scripts/dev/run-next-playwright.mjs"); test("resolvePlaywrightAppBackupDir uses a per-run backup when a stale backup already exists", () => { const cwd = "/tmp/omniroute-playwright-runner"; diff --git a/tests/unit/runtime-env.test.ts b/tests/unit/runtime-env.test.ts index 216831349e..6c98fdfd2c 100644 --- a/tests/unit/runtime-env.test.ts +++ b/tests/unit/runtime-env.test.ts @@ -7,7 +7,7 @@ import { pathToFileURL } from "node:url"; const require = createRequire(import.meta.url); const childProcess = require("node:child_process"); -const modulePath = path.join(process.cwd(), "scripts/runtime-env.mjs"); +const modulePath = path.join(process.cwd(), "scripts/build/runtime-env.mjs"); const originalSpawn = childProcess.spawn; const originalProcessOn = process.on; diff --git a/tests/unit/runtime-ports.test.ts b/tests/unit/runtime-ports.test.ts index fedea0a3b5..8804330658 100644 --- a/tests/unit/runtime-ports.test.ts +++ b/tests/unit/runtime-ports.test.ts @@ -3,7 +3,7 @@ import assert from "node:assert/strict"; // We test the standalone (scripts/) version of port resolution since // the src/ version uses @/ alias that requires the full Next.js build. -import { parsePort, resolveRuntimePorts } from "../../scripts/runtime-env.mjs"; +import { parsePort, resolveRuntimePorts } from "../../scripts/build/runtime-env.mjs"; describe("parsePort", () => { it("parses a valid port number", () => { diff --git a/tests/unit/runtime-timeouts.test.ts b/tests/unit/runtime-timeouts.test.ts index 3ac71b5de6..ec7927fe79 100644 --- a/tests/unit/runtime-timeouts.test.ts +++ b/tests/unit/runtime-timeouts.test.ts @@ -12,6 +12,7 @@ test("upstream timeout config derives hidden fetch timeouts from FETCH_TIMEOUT_M assert.deepEqual(config, { fetchTimeoutMs: 600000, streamIdleTimeoutMs: 600000, + sseHeartbeatIntervalMs: 15000, streamReadinessTimeoutMs: 30000, fetchHeadersTimeoutMs: 600000, fetchBodyTimeoutMs: 600000, @@ -94,3 +95,33 @@ test("API bridge timeouts align request timeout with long proxy timeout by defau serverSocketTimeoutMs: 0, }); }); + +test("idle timeout default stays at 10min (600_000) for slow-thinking model safety", () => { + // NOTE: PR #2233 originally lowered this to 300_000, but the reviewer asked to keep + // the legacy default (slow thinking models, long Anthropic extended-thinking runs). + // The heartbeat-shape change is preserved; only the idle-timeout default revert remains. + assert.equal(runtimeTimeouts.DEFAULT_STREAM_IDLE_TIMEOUT_MS, 600_000); + assert.equal(runtimeTimeouts.getUpstreamTimeoutConfig({}).streamIdleTimeoutMs, 600_000); +}); + +test("heartbeat interval default = 15s, env-overridable", () => { + assert.equal(runtimeTimeouts.DEFAULT_SSE_HEARTBEAT_INTERVAL_MS, 15_000); + assert.equal(runtimeTimeouts.getUpstreamTimeoutConfig({}).sseHeartbeatIntervalMs, 15_000); + assert.equal( + runtimeTimeouts.getUpstreamTimeoutConfig({ SSE_HEARTBEAT_INTERVAL_MS: "8000" }) + .sseHeartbeatIntervalMs, + 8_000 + ); + assert.equal( + runtimeTimeouts.getUpstreamTimeoutConfig({ SSE_HEARTBEAT_INTERVAL_MS: "0" }) + .sseHeartbeatIntervalMs, + 0 + ); +}); + +test("API bridge proxy timeout defaults to the long upstream request window", () => { + const config = runtimeTimeouts.getApiBridgeTimeoutConfig({}); + + assert.equal(config.proxyTimeoutMs, 600000); + assert.equal(config.serverRequestTimeoutMs, 600000); +}); diff --git a/tests/unit/schema-coercion.test.ts b/tests/unit/schema-coercion.test.ts index 669a6249e5..511310e5b6 100644 --- a/tests/unit/schema-coercion.test.ts +++ b/tests/unit/schema-coercion.test.ts @@ -3,6 +3,7 @@ import assert from "node:assert"; import { coerceSchemaNumericFields, coerceToolSchemas, + injectEmptyReasoningContentForToolCalls, sanitizeToolDescription, sanitizeToolDescriptions, } from "../../open-sse/translator/helpers/schemaCoercion.ts"; @@ -112,3 +113,32 @@ test("sanitizeToolDescriptions works on arrays", () => { assert.strictEqual(result[0].description, ""); assert.strictEqual(result[1].function.description, "42"); }); + +test("injectEmptyReasoningContentForToolCalls supports DeepSeek V4 models across providers", () => { + const messages = [ + { role: "user", content: "hello" }, + { role: "assistant", tool_calls: [{ id: "call_1" }] }, + ]; + + for (const provider of ["openrouter", "fireworks", "deepinfra"]) { + const result = injectEmptyReasoningContentForToolCalls( + messages, + provider, + "accounts/fireworks/models/deepseek-v4-pro" + ) as Array<{ reasoning_content?: string }>; + + assert.equal(result[1].reasoning_content, ""); + } +}); + +test("injectEmptyReasoningContentForToolCalls skips non-DeepSeek V4 models", () => { + const messages = [{ role: "assistant", tool_calls: [{ id: "call_1" }] }]; + + const result = injectEmptyReasoningContentForToolCalls( + messages, + "deepseek", + "deepseek-reasoner" + ) as Array<{ reasoning_content?: string }>; + + assert.equal(result[0].reasoning_content, undefined); +}); diff --git a/tests/unit/search-handler-extended.test.ts b/tests/unit/search-handler-extended.test.ts index c295560179..5a0e206a44 100644 --- a/tests/unit/search-handler-extended.test.ts +++ b/tests/unit/search-handler-extended.test.ts @@ -709,3 +709,415 @@ test("handleSearch does not fail over on non-retriable upstream errors", async ( globalThis.fetch = originalFetch; } }); + +// ─── Ollama Search Tests ────────────────────────────────── + +test("handleSearch builds Ollama POST request with bearer auth", async () => { + const originalFetch = globalThis.fetch; + let captured; + + globalThis.fetch = async (url, init = {}) => { + captured = { + url: String(url), + headers: init.headers, + body: JSON.parse(String(init.body || "{}")), + }; + + return new Response( + JSON.stringify({ + results: [ + { title: "Ollama result", url: "https://ollama.example.com", content: "Test content" }, + ], + }), + { status: 200, headers: { "content-type": "application/json" } } + ); + }; + + try { + const result = await handleSearch({ + query: "latest AI news", + provider: "ollama-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "ollama-token-123" }, + log: null, + }); + + assert.equal(captured.url, "https://ollama.com/api/web_search"); + assert.equal(captured.headers["Content-Type"], "application/json"); + assert.equal(captured.headers.Authorization, "Bearer ollama-token-123"); + assert.deepEqual(captured.body, { query: "latest AI news", max_results: 5 }); + assert.equal(result.success, true); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch normalizes Ollama response fields and full_text content", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async () => { + return new Response( + JSON.stringify({ + results: [ + { + title: "Ollama Web Search", + url: "https://ollama.com/blog/web-search", + content: "Ollama now supports native web search capabilities", + }, + { + title: "Getting Started", + url: "https://ollama.com/docs", + content: "Learn how to use Ollama for LLM inference", + }, + ], + }), + { status: 200, headers: { "content-type": "application/json" } } + ); + }; + + try { + const result = await handleSearch({ + query: "ollama query", + provider: "ollama-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "ollama-key" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(result.data.results.length, 2); + assert.equal(result.data.metrics.total_results_available, 2); + + assert.equal(result.data.results[0].title, "Ollama Web Search"); + assert.equal(result.data.results[0].url, "https://ollama.com/blog/web-search"); + assert.equal( + result.data.results[0].snippet, + "Ollama now supports native web search capabilities" + ); + assert.equal( + result.data.results[0].content.text, + "Ollama now supports native web search capabilities" + ); + assert.equal(result.data.results[0].content.format, "text"); + assert.equal(result.data.results[0].position, 1); + assert.equal(result.data.results[0].citation.provider, "ollama-search"); + assert.equal(result.data.results[0].citation.rank, 1); + + assert.equal(result.data.results[1].title, "Getting Started"); + assert.equal(result.data.results[1].position, 2); + assert.equal(result.data.results[1].citation.rank, 2); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch handles empty Ollama results array", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async () => { + return new Response(JSON.stringify({ results: [] }), { + status: 200, + headers: { "content-type": "application/json" }, + }); + }; + + try { + const result = await handleSearch({ + query: "empty query", + provider: "ollama-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "ollama-key" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(result.data.results.length, 0); + assert.equal(result.data.metrics.total_results_available, 0); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch handles Ollama response with missing results field", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async () => { + return new Response(JSON.stringify({ unrelated: "data" }), { + status: 200, + headers: { "content-type": "application/json" }, + }); + }; + + try { + const result = await handleSearch({ + query: "some query", + provider: "ollama-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "ollama-key" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(result.data.results.length, 0); + assert.equal(result.data.metrics.total_results_available, 0); + } finally { + globalThis.fetch = originalFetch; + } +}); + +// ─── Z.AI Coding Plan Search Tests ──────────────────── + +const ZAI_MOCK_RESULTS = [ + { + title: "Z.AI Coding Plan Search", + link: "https://docs.z.ai/search", + content: "Z.AI now supports web search capabilities via Coding Plan", + publish_date: "2026-04-20T10:00:00Z", + icon: "https://docs.z.ai/favicon.ico", + media: "web", + }, + { + title: "Getting Started with Z.AI", + link: "https://docs.z.ai/getting-started", + content: "Learn how to use Z.AI for search and inference", + publish_date: "2026-04-18T08:00:00Z", + icon: "https://docs.z.ai/favicon.ico", + media: "web", + }, +]; + +test("handleSearch searches with Z.AI Coding Plan via MCP", async () => { + const originalFetch = globalThis.fetch; + const calls: { url: string; init: RequestInit }[] = []; + let capturedArgs: Record<string, unknown> = {}; + + globalThis.fetch = async (url, init = {}) => { + calls.push({ url: String(url), init }); + const body = init.body ? JSON.parse(String(init.body)) : {}; + + // MCP initialize handshake + if (body.method === "initialize") { + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + protocolVersion: "2024-11-05", + capabilities: {}, + serverInfo: { name: "zai-mcp", version: "1.0" }, + }, + id: body.id, + }), + { + status: 200, + headers: { "content-type": "application/json", "mcp-session-id": "session-abc-123" }, + } + ); + } + + // notifications/initialized + if (body.method === "notifications/initialized") { + return new Response(null, { status: 202 }); + } + + // tools/call + if (body.method === "tools/call") { + capturedArgs = body.params.arguments; + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + content: [{ type: "text", text: JSON.stringify(JSON.stringify(ZAI_MOCK_RESULTS)) }], + }, + id: body.id, + }), + { status: 200, headers: { "content-type": "application/json" } } + ); + } + + // GET (initial probe / transport check) + return new Response(null, { status: 405 }); + }; + + try { + const result = await handleSearch({ + query: "zai mcp search", + provider: "zai-search", + maxResults: 2, + searchType: "web", + credentials: { apiKey: "zai-token-abc" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(capturedArgs.search_query, "zai mcp search"); + assert.equal(result.data.provider, "zai-search"); + assert.equal(result.data.results.length, 2); + assert.equal(result.data.results[0].title, "Z.AI Coding Plan Search"); + assert.equal(result.data.results[0].url, "https://docs.z.ai/search"); + assert.equal( + result.data.results[0].snippet, + "Z.AI now supports web search capabilities via Coding Plan" + ); + assert.equal(result.data.results[0].display_url, "docs.z.ai/search"); + assert.equal(result.data.results[0].favicon_url, "https://docs.z.ai/favicon.ico"); + assert.equal(result.data.results[0].citation.provider, "zai-search"); + assert.equal(result.data.results[1].title, "Getting Started with Z.AI"); + assert.equal(result.data.results[1].citation.provider, "zai-search"); + assert.equal(result.data.usage.queries_used, 1); + assert.equal(result.data.usage.search_cost_usd, 0); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch handles Z.AI Coding Plan empty MCP results", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async (url, init = {}) => { + const body = init.body ? JSON.parse(String(init.body)) : {}; + + if (body.method === "initialize") { + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + protocolVersion: "2024-11-05", + capabilities: {}, + serverInfo: { name: "zai-mcp", version: "1.0" }, + }, + id: body.id, + }), + { + status: 200, + headers: { "content-type": "application/json", "mcp-session-id": "session-empty" }, + } + ); + } + + if (body.method === "notifications/initialized") { + return new Response(null, { status: 202 }); + } + + if (body.method === "tools/call") { + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + content: [{ type: "text", text: JSON.stringify(JSON.stringify([])) }], + }, + id: body.id, + }), + { status: 200, headers: { "content-type": "application/json" } } + ); + } + + return new Response(null, { status: 405 }); + }; + + try { + const result = await handleSearch({ + query: "empty zai mcp result", + provider: "zai-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "zai-key" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(result.data.provider, "zai-search"); + assert.equal(result.data.results.length, 0); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch handles Z.AI Coding Plan MCP connection error", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async () => { + throw new Error("Connection refused"); + }; + + try { + const result = await handleSearch({ + query: "zai mcp error", + provider: "zai-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "zai-key" }, + log: null, + }); + + assert.equal(result.success, false); + assert.equal(result.status, 502); + assert.ok(result.error.includes("error")); + } finally { + globalThis.fetch = originalFetch; + } +}); + +test("handleSearch handles Z.AI Coding Plan non-array MCP result", async () => { + const originalFetch = globalThis.fetch; + + globalThis.fetch = async (url, init = {}) => { + const body = init.body ? JSON.parse(String(init.body)) : {}; + + if (body.method === "initialize") { + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + protocolVersion: "2024-11-05", + capabilities: {}, + serverInfo: { name: "zai-mcp", version: "1.0" }, + }, + id: body.id, + }), + { + status: 200, + headers: { "content-type": "application/json", "mcp-session-id": "session-nonarray" }, + } + ); + } + + if (body.method === "notifications/initialized") { + return new Response(null, { status: 202 }); + } + + if (body.method === "tools/call") { + return new Response( + JSON.stringify({ + jsonrpc: "2.0", + result: { + content: [{ type: "text", text: JSON.stringify(JSON.stringify({ not: "an array" })) }], + }, + id: body.id, + }), + { status: 200, headers: { "content-type": "application/json" } } + ); + } + + return new Response(null, { status: 405 }); + }; + + try { + const result = await handleSearch({ + query: "zai non-array", + provider: "zai-search", + maxResults: 5, + searchType: "web", + credentials: { apiKey: "zai-key" }, + log: null, + }); + + assert.equal(result.success, true); + assert.equal(result.data.results.length, 0); + } finally { + globalThis.fetch = originalFetch; + } +}); diff --git a/tests/unit/search-registry.test.ts b/tests/unit/search-registry.test.ts index aa77867a0e..8c21f07926 100644 --- a/tests/unit/search-registry.test.ts +++ b/tests/unit/search-registry.test.ts @@ -19,7 +19,7 @@ const { computeCacheKey, getOrCoalesce, getCacheStats, SEARCH_CACHE_DEFAULT_TTL_ // ─── Registry Tests ────────────────────────────────────────── -test("SEARCH_PROVIDERS has all 10 providers", () => { +test("SEARCH_PROVIDERS has all 11 providers", () => { assert.ok(SEARCH_PROVIDERS["serper-search"], "serper should exist"); assert.ok(SEARCH_PROVIDERS["brave-search"], "brave should exist"); assert.ok(SEARCH_PROVIDERS["perplexity-search"], "perplexity-search should exist"); @@ -30,7 +30,9 @@ test("SEARCH_PROVIDERS has all 10 providers", () => { assert.ok(SEARCH_PROVIDERS["searchapi-search"], "searchapi should exist"); assert.ok(SEARCH_PROVIDERS["youcom-search"], "youcom should exist"); assert.ok(SEARCH_PROVIDERS["searxng-search"], "searxng should exist"); - assert.equal(Object.keys(SEARCH_PROVIDERS).length, 10); + assert.ok(SEARCH_PROVIDERS["ollama-search"], "ollama-search should exist"); + assert.ok(SEARCH_PROVIDERS["zai-search"], "zai should exist"); + assert.equal(Object.keys(SEARCH_PROVIDERS).length, 12); }); test("serper-search config is correct", () => { @@ -63,6 +65,17 @@ test("perplexity-search config is correct", () => { assert.deepEqual(p.searchTypes, ["web"]); }); +test("ollama-search config is correct", () => { + const o = SEARCH_PROVIDERS["ollama-search"]; + assert.equal(o.id, "ollama-search"); + assert.equal(o.baseUrl, "https://ollama.com/api/web_search"); + assert.equal(o.method, "POST"); + assert.equal(o.authType, "apikey"); + assert.equal(o.authHeader, "bearer"); + assert.equal(o.maxMaxResults, 10); + assert.deepEqual(o.searchTypes, ["web"]); +}); + test("getSearchProvider returns config for valid ID", () => { const config = getSearchProvider("serper-search"); assert.ok(config); @@ -128,9 +141,20 @@ test("searxng-search config is correct", () => { assert.deepEqual(s.searchTypes, ["web", "news"]); }); +test("zai-search config is correct", () => { + const z = SEARCH_PROVIDERS["zai-search"]; + assert.equal(z.id, "zai-search"); + assert.equal(z.method, "POST"); + assert.equal(z.authHeader, "bearer"); + assert.equal(z.baseUrl, "https://api.z.ai/api/mcp/web_search_prime/mcp"); + assert.equal(z.costPerQuery, 0); + assert.equal(z.freeMonthlyQuota, 0); + assert.deepEqual(z.searchTypes, ["web"]); +}); + test("getAllSearchProviders returns flat list", () => { const all = getAllSearchProviders(); - assert.equal(all.length, 10); + assert.equal(all.length, 12); assert.ok(all.some((p) => p.id === "serper-search")); assert.ok(all.some((p) => p.id === "brave-search")); assert.ok(all.some((p) => p.id === "perplexity-search")); @@ -141,6 +165,8 @@ test("getAllSearchProviders returns flat list", () => { assert.ok(all.some((p) => p.id === "searchapi-search")); assert.ok(all.some((p) => p.id === "youcom-search")); assert.ok(all.some((p) => p.id === "searxng-search")); + assert.ok(all.some((p) => p.id === "ollama-search")); + assert.ok(all.some((p) => p.id === "zai-search")); // Each entry should have id, name, searchTypes for (const p of all) { assert.ok(p.id); @@ -337,6 +363,7 @@ test("v1SearchSchema accepts new search providers", async () => { "searchapi-search", "youcom-search", "searxng-search", + "ollama-search", ] as const; for (const provider of providers) { diff --git a/tests/unit/search-route.test.ts b/tests/unit/search-route.test.ts index 36ca742fc7..08ba7c9598 100644 --- a/tests/unit/search-route.test.ts +++ b/tests/unit/search-route.test.ts @@ -45,14 +45,14 @@ test.after(() => { fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); }); -test("v1 search GET lists all 10 search providers", async () => { +test("v1 search GET lists all 12 search providers", async () => { const response = await searchRoute.GET(); const body = (await response.json()) as any; const ids = body.data.map((item: { id: string }) => item.id); assert.equal(response.status, 200); assert.equal(body.object, "list"); - assert.equal(body.data.length, 10); + assert.equal(body.data.length, 12); assert.deepEqual(ids, [ "serper-search", "brave-search", @@ -64,6 +64,8 @@ test("v1 search GET lists all 10 search providers", async () => { "searchapi-search", "youcom-search", "searxng-search", + "ollama-search", + "zai-search", ]); }); diff --git a/tests/unit/shared/components/AutoRoutingBanner.test.tsx b/tests/unit/shared/components/AutoRoutingBanner.test.tsx new file mode 100644 index 0000000000..d7a8153812 --- /dev/null +++ b/tests/unit/shared/components/AutoRoutingBanner.test.tsx @@ -0,0 +1,96 @@ +// @vitest-environment jsdom +import React from "react"; +import { act } from "react"; +import { createRoot } from "react-dom/client"; +import { afterEach, beforeEach, describe, expect, it } from "vitest"; + +const cleanupCallbacks: Array<() => void> = []; + +function makeContainer(): HTMLElement { + const container = document.createElement("div"); + document.body.appendChild(container); + cleanupCallbacks.push(() => { + container.remove(); + }); + return container; +} + +describe("AutoRoutingBanner", () => { + beforeEach(() => { + ( + globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean } + ).IS_REACT_ACT_ENVIRONMENT = true; + localStorage.clear(); + }); + + afterEach(() => { + while (cleanupCallbacks.length > 0) { + cleanupCallbacks.pop()?.(); + } + document.body.innerHTML = ""; + localStorage.clear(); + }); + + it("renders banner on first mount", async () => { + const { default: AutoRoutingBanner } = await import("@/shared/components/AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeTruthy(); + expect(container.textContent).toContain("Auto-Routing Active"); + }); + + it("includes link to Combos page", async () => { + const { default: AutoRoutingBanner } = await import("@/shared/components/AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + const link = container.querySelector('a[href="/dashboard/combos"]'); + expect(link).toBeTruthy(); + }); + + it("can be dismissed by clicking close button", async () => { + const { default: AutoRoutingBanner } = await import("@/shared/components/AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeTruthy(); + const closeButton = container.querySelector('button[aria-label="Dismiss auto-routing banner"]'); + expect(closeButton).toBeTruthy(); + await act(async () => { + closeButton?.click(); + }); + expect(container.querySelector('[role="banner"]')).toBeFalsy(); + }); + + it("persists dismissal to localStorage", async () => { + const { default: AutoRoutingBanner } = await import("@/shared/components/AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + const closeButton = container.querySelector('button[aria-label="Dismiss auto-routing banner"]'); + await act(async () => { + closeButton?.click(); + }); + expect(localStorage.getItem("auto-routing-banner-dismissed")).toBe("true"); + }); + + it("remains hidden after dismissal on remount", async () => { + localStorage.setItem("auto-routing-banner-dismissed", "true"); + const { default: AutoRoutingBanner } = await import("@/shared/components/AutoRoutingBanner"); + const container = makeContainer(); + const root = createRoot(container); + await act(async () => { + root.render(<AutoRoutingBanner />); + }); + expect(container.querySelector('[role="banner"]')).toBeFalsy(); + }); +}); diff --git a/tests/unit/sse-auth.test.ts b/tests/unit/sse-auth.test.ts index 7ac60df468..2e13bea7ee 100644 --- a/tests/unit/sse-auth.test.ts +++ b/tests/unit/sse-auth.test.ts @@ -14,7 +14,6 @@ const settingsDb = await import("../../src/lib/db/settings.ts"); const apiKeysDb = await import("../../src/lib/db/apiKeys.ts"); const auth = await import("../../src/sse/services/auth.ts"); const quotaCache = await import("../../src/domain/quotaCache.ts"); -const { COOLDOWN_MS } = await import("../../open-sse/config/constants.ts"); async function resetStorage() { core.resetDbInstance(); @@ -45,7 +44,6 @@ async function seedConnection(provider: string, overrides: any = {}) { lastErrorSource: overrides.lastErrorSource, errorCode: overrides.errorCode, backoffLevel: overrides.backoffLevel, - maxConcurrent: overrides.maxConcurrent, providerSpecificData: overrides.providerSpecificData || {}, lastUsedAt: overrides.lastUsedAt, consecutiveUseCount: overrides.consecutiveUseCount, @@ -135,7 +133,7 @@ test("getProviderCredentials enforces generic quota policy unless explicitly byp }, }); const resetAt = futureIso(); - quotaCache.setQuotaCache((connection as any).id, "openai", { + quotaCache.setQuotaCache(connection.id, "openai", { daily: { remainingPercentage: 10, resetAt }, }); @@ -179,38 +177,6 @@ test("getProviderCredentialsWithQuotaPreflight skips exhausted preflight account assert.equal((selected as any).connectionId, healthy.id); }); -test("getProviderCredentials includes per-account maxConcurrent caps", async () => { - const connection = await seedConnection("openai", { - name: "openai-concurrency-cap", - maxConcurrent: 2, - }); - - const selected = await auth.getProviderCredentials("openai"); - - assert.equal(selected.connectionId, connection.id); - assert.equal(selected.maxConcurrent, 2); -}); - -test("getProviderCredentials skips connections that exclude the requested model and selects the next eligible account", async () => { - const excluded = await seedConnection("openai", { - name: "excluded-first", - priority: 1, - providerSpecificData: { - excludedModels: ["gpt-4o*"], - }, - }); - const allowed = await seedConnection("openai", { - name: "allowed-second", - priority: 2, - apiKey: "sk-allowed", - }); - - const selected = await auth.getProviderCredentials("openai", null, null, "gpt-4o-mini"); - - assert.equal(selected.connectionId, allowed.id); - assert.notEqual(selected.connectionId, excluded.id); -}); - test("getProviderCredentialsWithQuotaPreflight returns allRateLimited when a forced connection is blocked by preflight", async () => { const blocked = await seedConnection("openai", { name: "quota-preflight-forced", @@ -237,6 +203,62 @@ test("getProviderCredentialsWithQuotaPreflight returns allRateLimited when a for assert.match(selected.lastError, /quota preflight/i); }); +test("getProviderCredentials keeps separate codex affinity per session", async () => { + await settingsDb.updateSettings({ fallbackStrategy: "round-robin", stickyRoundRobinLimit: 10 }); + const first = await seedConnection("codex", { + name: "codex-affinity-a", + lastUsedAt: new Date(Date.now() - 20_000).toISOString(), + }); + const second = await seedConnection("codex", { + name: "codex-affinity-b", + lastUsedAt: new Date(Date.now() - 10_000).toISOString(), + }); + + const sessionA1 = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-a", + }); + const sessionB1 = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-b", + }); + const sessionA2 = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-a", + }); + const sessionB2 = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-b", + }); + + assert.equal(sessionA1.connectionId, first.id); + assert.equal(sessionB1.connectionId, second.id); + assert.equal(sessionA2.connectionId, first.id); + assert.equal(sessionB2.connectionId, second.id); +}); + +test("getProviderCredentials rebinds codex session when affinity connection is excluded", async () => { + await settingsDb.updateSettings({ fallbackStrategy: "round-robin", stickyRoundRobinLimit: 10 }); + const first = await seedConnection("codex", { + name: "codex-affinity-excluded-a", + lastUsedAt: new Date(Date.now() - 20_000).toISOString(), + }); + const second = await seedConnection("codex", { + name: "codex-affinity-excluded-b", + lastUsedAt: new Date(Date.now() - 10_000).toISOString(), + }); + + const initial = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-excluded", + }); + const rebound = await auth.getProviderCredentials("codex", first.id, null, "gpt-5.5", { + sessionKey: "session-excluded", + }); + const sticky = await auth.getProviderCredentials("codex", null, null, "gpt-5.5", { + sessionKey: "session-excluded", + }); + + assert.equal(initial.connectionId, first.id); + assert.equal(rebound.connectionId, second.id); + assert.equal(sticky.connectionId, second.id); +}); + test("resolveQuotaLimitPolicy normalizes Codex windows, thresholds, and defaults", () => { const normalized = auth.resolveQuotaLimitPolicy("codex", { limitPolicy: { @@ -314,17 +336,17 @@ test("getProviderCredentials round-robin stays on the current account while belo priority: 2, }); - await providersDb.updateProviderConnection((current as any).id, { + await providersDb.updateProviderConnection(current.id, { lastUsedAt: new Date().toISOString(), consecutiveUseCount: 1, }); - await providersDb.updateProviderConnection((other as any).id, { + await providersDb.updateProviderConnection(other.id, { lastUsedAt: new Date(Date.now() - 60_000).toISOString(), consecutiveUseCount: 0, }); const selected = await auth.getProviderCredentials("openai"); - const updated = await providersDb.getProviderConnectionById((current as any).id); + const updated = await providersDb.getProviderConnectionById(current.id); assert.equal(selected.connectionId, current.id); assert.equal(updated.consecutiveUseCount, 2); @@ -428,7 +450,7 @@ test("getProviderCredentials retains terminal accounts for combo live tests", as const bypassed = await auth.getProviderCredentials("openai", null, null, null, { allowSuppressedConnections: true, }); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(blocked, null); assert.equal(bypassed.connectionId, connection.id); @@ -469,15 +491,9 @@ test("getProviderCredentials reports allRateLimited when every account is model- name: "gemini-model-lock-second", }); + await auth.markAccountUnavailable(first.id, 429, "too many requests", "gemini", "gemini-2.5-pro"); await auth.markAccountUnavailable( - (first as any).id, - 429, - "too many requests", - "gemini", - "gemini-2.5-pro" - ); - await auth.markAccountUnavailable( - (second as any).id, + second.id, 429, "too many requests", "gemini", @@ -504,7 +520,7 @@ test("getProviderCredentials auto-decays stale backoff metadata for recovered ac const selected = await auth.getProviderCredentials("openai"); await flushWrites(); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(selected.connectionId, connection.id); assert.equal(updated.backoffLevel, 0); @@ -522,7 +538,7 @@ test("getProviderCredentials falls back to a five-minute retry window when quota }, }); - quotaCache.setQuotaCache((connection as any).id, "openai", { + quotaCache.setQuotaCache(connection.id, "openai", { daily: { remainingPercentage: 0, resetAt: null }, }); @@ -547,10 +563,10 @@ test("getProviderCredentials prioritizes accounts that still have quota availabl apiKey: "sk-available", }); - quotaCache.setQuotaCache((exhausted as any).id, "openai", { + quotaCache.setQuotaCache(exhausted.id, "openai", { daily: { remainingPercentage: 0, resetAt: futureIso() }, }); - quotaCache.setQuotaCache((available as any).id, "openai", { + quotaCache.setQuotaCache(available.id, "openai", { daily: { remainingPercentage: 65, resetAt: futureIso() }, }); @@ -574,17 +590,17 @@ test("getProviderCredentials round-robin switches to the least recently used acc priority: 2, }); - await providersDb.updateProviderConnection((current as any).id, { + await providersDb.updateProviderConnection(current.id, { lastUsedAt: new Date().toISOString(), consecutiveUseCount: 2, }); - await providersDb.updateProviderConnection((fallback as any).id, { + await providersDb.updateProviderConnection(fallback.id, { lastUsedAt: new Date(Date.now() - 120_000).toISOString(), consecutiveUseCount: 0, }); const selected = await auth.getProviderCredentials("openai"); - const updated = await providersDb.getProviderConnectionById((fallback as any).id); + const updated = await providersDb.getProviderConnectionById(fallback.id); assert.equal(selected.connectionId, fallback.id); assert.equal(updated.consecutiveUseCount, 1); @@ -604,17 +620,17 @@ test("getProviderCredentials round-robin fallback mode excludes the failed accou priority: 2, }); - await providersDb.updateProviderConnection((failed as any).id, { + await providersDb.updateProviderConnection(failed.id, { lastUsedAt: new Date().toISOString(), consecutiveUseCount: 3, }); - await providersDb.updateProviderConnection((fallback as any).id, { + await providersDb.updateProviderConnection(fallback.id, { lastUsedAt: new Date(Date.now() - 120_000).toISOString(), consecutiveUseCount: 0, }); - const selected = await auth.getProviderCredentials("openai" as any, (failed as any).id); - const updated = await providersDb.getProviderConnectionById((fallback as any).id); + const selected = await auth.getProviderCredentials("openai", failed.id); + const updated = await providersDb.getProviderConnectionById(fallback.id); assert.equal(selected.connectionId, fallback.id); assert.equal(updated.consecutiveUseCount, 1); @@ -644,10 +660,10 @@ test("getProviderCredentials least-used prefers accounts that were never used", name: "least-used-never", priority: 9, }); - await providersDb.updateProviderConnection((recentlyUsed as any).id, { + await providersDb.updateProviderConnection(recentlyUsed.id, { lastUsedAt: new Date().toISOString(), }); - await providersDb.updateProviderConnection((neverUsed as any).id, { + await providersDb.updateProviderConnection(neverUsed.id, { lastUsedAt: null, }); @@ -668,10 +684,10 @@ test("getProviderCredentials least-used prefers the oldest timestamp when all ac priority: 1, }); - await providersDb.updateProviderConnection((oldest as any).id, { + await providersDb.updateProviderConnection(oldest.id, { lastUsedAt: new Date(Date.now() - 120_000).toISOString(), }); - await providersDb.updateProviderConnection((newest as any).id, { + await providersDb.updateProviderConnection(newest.id, { lastUsedAt: new Date().toISOString(), }); @@ -723,10 +739,10 @@ test("getProviderCredentials p2c prefers the account with more quota headroom ov }, }); - (quotaCache as any).setQuotaCache(nearLimit.id, "openai", { + quotaCache.setQuotaCache(nearLimit.id, "openai", { daily: { remainingPercentage: 12, resetAt: futureIso(180_000) }, }); - (quotaCache as any).setQuotaCache(healthy.id, "openai", { + quotaCache.setQuotaCache(healthy.id, "openai", { daily: { remainingPercentage: 78, resetAt: futureIso(180_000) }, }); @@ -786,7 +802,7 @@ test("getProviderCredentials exposes copilotToken when present in providerSpecif assert.equal(selected.copilotToken, "copilot-token-value"); }); -test("markAccountUnavailable keeps local 404 failures model-scoped with the local not-found cooldown", async () => { +test("markAccountUnavailable uses configured cooldowns for local 404 model lockouts", async () => { await settingsDb.updateSettings({ providerProfiles: { apikey: { @@ -807,13 +823,13 @@ test("markAccountUnavailable keeps local 404 failures model-scoped with the loca }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 404, "model not found", "openai", "local-model" ); - const updated = await (providersDb as any).getProviderConnectionById(connection.id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.equal(result.cooldownMs, 250); @@ -829,14 +845,14 @@ test("markAccountUnavailable applies a model-only lockout for Gemini 429 respons }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 429, "too many requests", "gemini", "gemini-2.5-pro" ); await flushWrites(); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); @@ -852,14 +868,14 @@ test("markAccountUnavailable applies a model-only lockout for compatible provide }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 429, "The upstream compatible service exhausted its capacity", "openai-compatible-custom-node", "custom-model-a" ); await flushWrites(); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); @@ -869,7 +885,7 @@ test("markAccountUnavailable applies a model-only lockout for compatible provide assert.equal(Number(updated.errorCode), 429); }); -test("markAccountUnavailable uses the unified configured api-key connection cooldown", async () => { +test("markAccountUnavailable honors configured api-key rate-limit cooldowns", async () => { await settingsDb.updateSettings({ providerProfiles: { apikey: { @@ -887,7 +903,7 @@ test("markAccountUnavailable uses the unified configured api-key connection cool }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 429, "too many requests", "openai", @@ -909,20 +925,20 @@ test("markAccountUnavailable stores Codex scope-specific cooldowns without a glo }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 429, "quota reached", "codex", "codex-spark-mini" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); const selected = await auth.getProviderCredentials("codex", null, null, "codex-spark-mini"); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); assert.equal(updated.testStatus, "unavailable"); assert.equal(updated.rateLimitedUntil, undefined); - assert.ok((updated.providerSpecificData as any).codexScopeRateLimitedUntil.spark); + assert.ok(updated.providerSpecificData.codexScopeRateLimitedUntil.spark); assert.equal(selected.allRateLimited, true); }); @@ -932,13 +948,13 @@ test("markAccountUnavailable returns without fallback on bad requests", async () }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 400, "schema mismatch", "openai", "gpt-4o" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.deepEqual(result, { shouldFallback: false, cooldownMs: 0 }); assert.equal(updated.testStatus, "active"); @@ -952,13 +968,8 @@ test("markAccountUnavailable preserves terminal statuses without overwriting the rateLimitedUntil: null, }); - const result = await auth.markAccountUnavailable( - (connection as any).id, - 503, - "upstream error", - "openai" - ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const result = await auth.markAccountUnavailable(connection.id, 503, "upstream error", "openai"); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.equal(result.cooldownMs, 0); @@ -973,13 +984,8 @@ test("markAccountUnavailable reuses an existing connection-wide cooldown", async rateLimitedUntil: retryAfter, }); - const result = await auth.markAccountUnavailable( - (connection as any).id, - 503, - "upstream error", - "openai" - ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const result = await auth.markAccountUnavailable(connection.id, 503, "upstream error", "openai"); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); @@ -1003,21 +1009,18 @@ test("markAccountUnavailable reuses an existing Codex scope cooldown", async () }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 429, "quota reached", "codex", "codex-spark-mini" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); assert.equal(updated.rateLimitedUntil, undefined); - (assert as any).equal( - (updated.providerSpecificData as any).codexScopeRateLimitedUntil.spark, - retryAfter - ); + assert.equal(updated.providerSpecificData.codexScopeRateLimitedUntil.spark, retryAfter); }); test("markAccountUnavailable uses a connection-wide cooldown for non-local 404 errors", async () => { @@ -1029,13 +1032,13 @@ test("markAccountUnavailable uses a connection-wide cooldown for non-local 404 e }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 404, "model not found", "openai", "gpt-missing" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.ok(result.cooldownMs > 0); @@ -1050,13 +1053,13 @@ test("markAccountUnavailable auto-disables permanently banned accounts when the }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 401, "Verify your account to continue", "openai", "gpt-4o" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.equal(updated.isActive, false); @@ -1070,13 +1073,13 @@ test("markAccountUnavailable leaves permanently banned accounts active when auto }); const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 401, "Verify your account to continue", "openai", "gpt-4o" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.equal(updated.isActive, true); @@ -1114,13 +1117,13 @@ test("markAccountUnavailable swallows auto-disable persistence errors", async () try { const result = await auth.markAccountUnavailable( - (connection as any).id, + connection.id, 401, "Verify your account to continue", "openai", "gpt-4o" ); - const updated = await providersDb.getProviderConnectionById((connection as any).id); + const updated = await providersDb.getProviderConnectionById(connection.id); assert.equal(result.shouldFallback, true); assert.equal(updated.isActive, true); diff --git a/tests/unit/sse-heartbeat-integration.test.ts b/tests/unit/sse-heartbeat-integration.test.ts new file mode 100644 index 0000000000..9c36ec5f91 --- /dev/null +++ b/tests/unit/sse-heartbeat-integration.test.ts @@ -0,0 +1,124 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { createSseHeartbeatTransform, HEARTBEAT_SHAPES, shapeForClientFormat } = + await import("../../open-sse/utils/sseHeartbeat.ts"); + +const STREAM_TS_STRIP_RE = /^event:\s*keepalive\b/i; + +function decodeChunk(value) { + return typeof value === "string" ? value : new TextDecoder().decode(value); +} + +test("integration: anthropic-ping heartbeat reaches downstream and does NOT trigger stream.ts strip", async () => { + // Build a fake upstream that emits one chunk then idles indefinitely + let cancelled = false; + const upstream = new ReadableStream({ + start(controller) { + controller.enqueue(new TextEncoder().encode("event: message_start\ndata: {}\n\n")); + // never close — let heartbeat fire + }, + cancel() { + cancelled = true; + }, + }); + + const transform = createSseHeartbeatTransform({ + intervalMs: 20, + shape: HEARTBEAT_SHAPES.ANTHROPIC_PING, + }); + + const piped = upstream.pipeThrough(transform); + const reader = piped.getReader(); + + // Read first (real) chunk + const { value: first } = await reader.read(); + assert.match(decodeChunk(first), /event: message_start/); + + // Wait for at least one heartbeat (interval = 20ms, give it 60ms slack) + const startedAt = Date.now(); + let sawPing = false; + while (Date.now() - startedAt < 200) { + const { value, done } = await reader.read(); + if (done) break; + const chunk = decodeChunk(value); + if (/^event: ping\b/m.test(chunk)) { + sawPing = true; + // Verify it does NOT match the strip regex + for (const line of chunk.split("\n")) { + assert.ok( + !STREAM_TS_STRIP_RE.test(line.trim()), + `heartbeat chunk produced a stream.ts-strippable line: ${line}` + ); + } + break; + } + } + + await reader.cancel(); + assert.ok(sawPing, "expected to receive at least one event: ping heartbeat within 200ms"); +}); + +test("integration: openai-chunk heartbeat is valid JSON parseable by SDKs", async () => { + const upstream = new ReadableStream({ + start(controller) { + controller.enqueue( + new TextEncoder().encode( + `data: {"id":"chatcmpl-1","object":"chat.completion.chunk","choices":[]}\n\n` + ) + ); + }, + }); + + const transform = createSseHeartbeatTransform({ + intervalMs: 20, + shape: HEARTBEAT_SHAPES.OPENAI_CHUNK, + }); + + const piped = upstream.pipeThrough(transform); + const reader = piped.getReader(); + + await reader.read(); // skip first real chunk + + const startedAt = Date.now(); + let sawValidChunk = false; + while (Date.now() - startedAt < 200) { + const { value, done } = await reader.read(); + if (done) break; + const chunk = decodeChunk(value); + if (chunk.startsWith("data: ") && chunk.includes("omniroute-keepalive")) { + const jsonStr = chunk.slice(6, chunk.indexOf("\n\n")); + const parsed = JSON.parse(jsonStr); // must not throw + assert.equal(parsed.object, "chat.completion.chunk"); + assert.equal(parsed.choices[0].finish_reason, null); + sawValidChunk = true; + break; + } + } + + await reader.cancel(); + assert.ok(sawValidChunk, "expected to receive a valid openai-chunk heartbeat within 200ms"); +}); + +test("integration: shapeForClientFormat + createSseHeartbeatTransform pipeline (claude path)", async () => { + // Simulates what chatCore.ts does at line 4276 + const shape = shapeForClientFormat("claude"); + assert.equal(shape, HEARTBEAT_SHAPES.ANTHROPIC_PING); + + const transform = createSseHeartbeatTransform({ + intervalMs: 20, + shape, + }); + + const upstream = new ReadableStream({ + start(controller) { + controller.enqueue(new TextEncoder().encode("event: hello\ndata: {}\n\n")); + }, + }); + + const reader = upstream.pipeThrough(transform).getReader(); + await reader.read(); // first real + const { value } = await reader.read(); + assert.match(decodeChunk(value), /^event: ping\ndata: \{\}\n\n$/); + await reader.cancel(); +}); diff --git a/tests/unit/sse-heartbeat.test.ts b/tests/unit/sse-heartbeat.test.ts index 4c7442615a..3700137adc 100644 --- a/tests/unit/sse-heartbeat.test.ts +++ b/tests/unit/sse-heartbeat.test.ts @@ -85,3 +85,170 @@ test("createSseHeartbeatTransform clears the interval when aborted", async () => await reader.cancel(); }); }); + +const { shapeForClientFormat } = await import("../../open-sse/utils/sseHeartbeat.ts"); + +test("shape: anthropic-ping emits event: ping with empty JSON data", async () => { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ intervalMs: 100, shape: "anthropic-ping" }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + await intervals[0].callback(...intervals[0].args); + await writer.close(); + await pump; + + assert.equal(emitted[0], "event: ping\ndata: {}\n\n"); + }); +}); + +test("shape: openai-chunk emits valid chat.completion.chunk with empty delta", async () => { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ intervalMs: 100, shape: "openai-chunk" }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + await intervals[0].callback(...intervals[0].args); + await writer.close(); + await pump; + + assert.ok(emitted[0].startsWith("data: "), `expected data: prefix, got: ${emitted[0]}`); + assert.ok(emitted[0].endsWith("\n\n"), "expected trailing \n\n"); + const jsonStr = emitted[0].slice("data: ".length, -"\n\n".length); + const json = JSON.parse(jsonStr); + assert.equal(json.object, "chat.completion.chunk"); + assert.ok(Array.isArray(json.choices) && json.choices.length === 1); + assert.equal(typeof json.choices[0].delta, "object"); + assert.equal(Object.keys(json.choices[0].delta).length, 0); + assert.equal(json.choices[0].finish_reason, null); + }); +}); + +test("shape: openai-responses-in-progress emits response.in_progress data event", async () => { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ + intervalMs: 100, + shape: "openai-responses-in-progress", + }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + await intervals[0].callback(...intervals[0].args); + await writer.close(); + await pump; + + assert.equal(emitted[0], 'data: {"type":"response.in_progress"}\n\n'); + }); +}); + +test("shape default is comment (back-compat)", async () => { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ intervalMs: 100 }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + await intervals[0].callback(...intervals[0].args); + await writer.close(); + await pump; + + assert.match(emitted[0], /^: keepalive /); + }); +}); + +test("intervalMs <= 0 returns passthrough (no setInterval, no heartbeat)", async () => { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ intervalMs: 0 }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + assert.equal(intervals.length, 0); + + await writer.write(new TextEncoder().encode('data: {"chunk":"x"}\n\n')); + await writer.close(); + await pump; + + assert.equal(emitted.length, 1); + assert.equal(emitted[0], 'data: {"chunk":"x"}\n\n'); + }); +}); + +test("shapeForClientFormat maps formats correctly", () => { + assert.equal(shapeForClientFormat("claude"), "anthropic-ping"); + assert.equal(shapeForClientFormat("openai"), "openai-chunk"); + assert.equal(shapeForClientFormat("openai-responses"), "openai-responses-in-progress"); + assert.equal(shapeForClientFormat("gemini"), "comment"); + assert.equal(shapeForClientFormat(undefined), "comment"); + assert.equal(shapeForClientFormat(null), "comment"); +}); + +test("no shape collides with stream.ts event: keepalive strip regex", async () => { + const shapes = ["comment", "anthropic-ping", "openai-chunk", "openai-responses-in-progress"]; + for (const shape of shapes) { + await withFakeIntervals(async (intervals) => { + const transform = createSseHeartbeatTransform({ intervalMs: 100, shape }); + const writer = transform.writable.getWriter(); + const reader = transform.readable.getReader(); + const emitted = []; + const pump = (async () => { + while (true) { + const { value, done } = await reader.read(); + if (done) break; + emitted.push(decodeChunk(value)); + } + })(); + + await intervals[0].callback(...intervals[0].args); + await writer.close(); + await pump; + + const lines = emitted[0].split("\n"); + for (const line of lines) { + assert.doesNotMatch( + line.trim(), + /^event:\s*keepalive\b/i, + `shape ${shape} produced forbidden line: ${line}` + ); + } + }); + } +}); diff --git a/tests/unit/sse-parser.test.ts b/tests/unit/sse-parser.test.ts index 82b4fd655f..3d8bbfdf7f 100644 --- a/tests/unit/sse-parser.test.ts +++ b/tests/unit/sse-parser.test.ts @@ -114,6 +114,26 @@ test("parseSSEToClaudeResponse parses text, thinking, tool_use, and usage events assert.deepEqual(parsed.usage, { input_tokens: 10, output_tokens: 4 }); }); +test("parseSSEToClaudeResponse tolerates event-only types and missing blank separators", () => { + const rawSSE = [ + "event: message_start", + 'data: {"message":{"id":"msg_event_fallback","model":"claude-sonnet-4-6","role":"assistant","usage":{"input_tokens":3}}}', + "event: content_block_delta", + 'data: {"index":0,"delta":{"text":"event fallback ok"}}', + "event: message_delta", + 'data: {"delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":2}}', + "event: message_stop", + "data: {}", + ].join("\n"); + + const parsed = parseSSEToClaudeResponse(rawSSE, "fallback-model"); + + assert.equal(parsed.id, "msg_event_fallback"); + assert.equal(parsed.model, "claude-sonnet-4-6"); + assert.equal((parsed.content[0] as any).text, "event fallback ok"); + assert.deepEqual(parsed.usage, { input_tokens: 3, output_tokens: 2 }); +}); + test("parseSSEToClaudeResponse ignores malformed payloads and returns null when nothing valid remains", () => { const parsed = parseSSEToClaudeResponse( ["event: content_block_delta", "data: not-json", "", "data: [DONE]"].join("\n"), diff --git a/tests/unit/stream-readiness.test.ts b/tests/unit/stream-readiness.test.ts index a86c37dd31..15eb22654d 100644 --- a/tests/unit/stream-readiness.test.ts +++ b/tests/unit/stream-readiness.test.ts @@ -3,6 +3,7 @@ import assert from "node:assert/strict"; import { ensureStreamReadiness, + hasStreamReadinessSignal, hasUsefulStreamContent, } from "../../open-sse/utils/streamReadiness.ts"; @@ -20,6 +21,46 @@ function streamFromChunks(chunks: string[], delayMs = 0): ReadableStream<Uint8Ar }); } +function delayedClaudeStartStream(): ReadableStream<Uint8Array> { + return new ReadableStream<Uint8Array>({ + async start(controller) { + controller.enqueue( + encoder.encode( + [ + "event: message_start", + `data: ${JSON.stringify({ + message: { + id: "msg_1", + type: "message", + role: "assistant", + model: "claude-sonnet-4-6", + usage: { input_tokens: 10, output_tokens: 0 }, + }, + })}`, + "", + ].join("\n") + ) + ); + + await new Promise((resolve) => setTimeout(resolve, 30)); + controller.enqueue( + encoder.encode( + [ + "event: content_block_delta", + `data: ${JSON.stringify({ + type: "content_block_delta", + index: 0, + delta: { type: "text_delta", text: "slow hello" }, + })}`, + "", + ].join("\n") + ) + ); + controller.close(); + }, + }); +} + test("hasUsefulStreamContent ignores keepalives and lifecycle-only chunks", () => { assert.equal(hasUsefulStreamContent(": keepalive\n\n"), false); assert.equal(hasUsefulStreamContent("event: ping\ndata: {}\n\n"), false); @@ -80,6 +121,51 @@ test("hasUsefulStreamContent detects text, reasoning, and tool deltas", () => { ); }); +test("hasStreamReadinessSignal accepts Claude stream start events", () => { + assert.equal(hasStreamReadinessSignal(": keepalive\n\n"), false); + assert.equal(hasStreamReadinessSignal("event: ping\ndata: {}\n\n"), false); + assert.equal( + hasStreamReadinessSignal(`data: ${JSON.stringify({ type: "response.created" })}\n\n`), + false + ); + assert.equal( + hasStreamReadinessSignal( + `event: message_start\ndata: ${JSON.stringify({ + type: "message_start", + message: { + id: "msg_1", + type: "message", + role: "assistant", + model: "claude-sonnet-4-6", + }, + })}\n\n` + ), + true + ); + assert.equal( + hasStreamReadinessSignal( + `event: message_start\ndata: ${JSON.stringify({ + message: { + id: "msg_2", + type: "message", + role: "assistant", + model: "claude-sonnet-4-6", + }, + })}\n\n` + ), + true + ); + assert.equal( + hasStreamReadinessSignal( + `event: content_block_start\ndata: ${JSON.stringify({ + index: 0, + content_block: { type: "text", text: "" }, + })}\n\n` + ), + true + ); +}); + test("ensureStreamReadiness preserves buffered chunks when stream starts", async () => { const response = new Response( streamFromChunks([ @@ -98,6 +184,23 @@ test("ensureStreamReadiness preserves buffered chunks when stream starts", async assert.match(text, / world/); }); +test("ensureStreamReadiness hands off long Claude streams after message_start", async () => { + const response = new Response(delayedClaudeStartStream(), { + status: 200, + headers: { "Content-Type": "text/event-stream" }, + }); + + const result = await ensureStreamReadiness(response, { + timeoutMs: 10, + provider: "anthropic-compatible-cc-test", + model: "claude-sonnet-4-6", + }); + assert.equal(result.ok, true); + const text = await result.response.text(); + assert.match(text, /message_start/); + assert.match(text, /slow hello/); +}); + test("ensureStreamReadiness returns 504 when no useful content arrives before timeout", async () => { const response = new Response( streamFromChunks( diff --git a/tests/unit/stream-utils.test.ts b/tests/unit/stream-utils.test.ts index e552551ebe..4c3d902115 100644 --- a/tests/unit/stream-utils.test.ts +++ b/tests/unit/stream-utils.test.ts @@ -561,6 +561,62 @@ test("createSSEStream passthrough injects a synthetic Claude text block for empt ); }); +test("createSSEStream passthrough does not emit [DONE] for Claude SSE clients", async () => { + const text = await readTransformed( + [ + `event: message_start\ndata: ${JSON.stringify({ + type: "message_start", + message: { + id: "msg_claude_done_gate", + type: "message", + role: "assistant", + model: "claude-sonnet-4", + content: [], + stop_reason: null, + stop_sequence: null, + usage: { input_tokens: 3, output_tokens: 0 }, + }, + })}\n\n`, + `event: content_block_start\ndata: ${JSON.stringify({ + type: "content_block_start", + index: 0, + content_block: { type: "text", text: "" }, + })}\n\n`, + `event: content_block_delta\ndata: ${JSON.stringify({ + type: "content_block_delta", + index: 0, + delta: { type: "text_delta", text: "Claude client stream" }, + })}\n\n`, + `event: content_block_stop\ndata: ${JSON.stringify({ + type: "content_block_stop", + index: 0, + })}\n\n`, + `event: message_delta\ndata: ${JSON.stringify({ + type: "message_delta", + delta: { stop_reason: "end_turn", stop_sequence: null }, + usage: { output_tokens: 3 }, + })}\n\n`, + `event: message_stop\ndata: ${JSON.stringify({ + type: "message_stop", + })}\n\n`, + ], + { + mode: "passthrough", + sourceFormat: FORMATS.CLAUDE, + clientResponseFormat: FORMATS.CLAUDE, + provider: "claude", + model: "claude-sonnet-4", + body: { + messages: [{ role: "user", content: "hello" }], + }, + } + ); + + assert.match(text, /event: message_stop/); + assert.match(text, /Claude client stream/); + assert.doesNotMatch(text, /\[DONE\]/); +}); + test("createSSEStream translate mode injects a synthetic Claude text block when OpenAI finishes empty", async () => { let onCompletePayload = null; const text = await readTransformed( diff --git a/tests/unit/sync-env.test.ts b/tests/unit/sync-env.test.ts index c47cd0ad7b..d5bedcbd7d 100644 --- a/tests/unit/sync-env.test.ts +++ b/tests/unit/sync-env.test.ts @@ -4,7 +4,7 @@ import fs from "node:fs"; import os from "node:os"; import path from "node:path"; -const { syncEnv } = (await import("../../scripts/sync-env.mjs")) as { +const { syncEnv } = (await import("../../scripts/dev/sync-env.mjs")) as { syncEnv: (opts?: { rootDir?: string; quiet?: boolean; scope?: string }) => { created: boolean; added: number; diff --git a/tests/unit/thinking-budget.test.ts b/tests/unit/thinking-budget.test.ts index 12b59ce8f2..1195f6c694 100644 --- a/tests/unit/thinking-budget.test.ts +++ b/tests/unit/thinking-budget.test.ts @@ -129,6 +129,40 @@ test("CUSTOM: budget 0 disables Claude thinking", () => { setThinkingBudgetConfig(DEFAULT_THINKING_CONFIG); }); +test("ADAPTIVE: Opus 4.7 budget capped within Anthropic-allowed range", () => { + // Capy sends `output_config.effort=max` (baseline 65536) on a long + // conversation (13 messages, 25 tools, recent tool_use). Multiplier + // stacks to 2.3× — raw budget would be ~150K, exceeding Anthropic's + // [1024, 128000] range for Opus 4.7 and triggering a 400. + // capThinkingBudget MUST cap at the model's thinkingBudgetCap. + setThinkingBudgetConfig({ mode: ThinkingMode.ADAPTIVE, effortLevel: "medium" }); + const messages = Array.from({ length: 13 }, (_, i) => ({ + role: i % 2 === 0 ? "user" : "assistant", + content: + i === 11 + ? [{ type: "tool_use", id: "t1", name: "x", input: {} }] + : [{ type: "text", text: "hi" }], + })); + const tools = Array.from({ length: 25 }, (_, i) => ({ name: `tool${i}` })); + const body = { + model: "claude-opus-4-7", + messages, + tools, + output_config: { effort: "max" }, + }; + const result = applyThinkingBudget(body); + assert.equal(result.thinking.type, "enabled"); + assert.ok( + result.thinking.budget_tokens <= 128000, + `budget ${result.thinking.budget_tokens} must be ≤ Anthropic limit 128000` + ); + assert.ok( + result.thinking.budget_tokens >= 1024, + `budget ${result.thinking.budget_tokens} must be ≥ Anthropic minimum 1024` + ); + setThinkingBudgetConfig(DEFAULT_THINKING_CONFIG); +}); + // ─── ADAPTIVE Mode ────────────────────────────────────────────────────────── test("ADAPTIVE: simple request gets base budget", () => { @@ -244,7 +278,13 @@ test("ensureThinkingConfig: auto-injects for -thinking suffix model", () => { }; const result = ensureThinkingConfig(body); assert.equal(result.thinking.type, "enabled"); - assert.equal(result.thinking.budget_tokens, EFFORT_BUDGETS.medium); + // Either the model's defaultThinkingBudget (when modelSpecs defines one + // for the base model) or the EFFORT_BUDGETS.medium fallback. Both are + // valid auto-inject outcomes. + assert.ok( + result.thinking.budget_tokens > 0, + "budget_tokens should be positive after auto-inject" + ); }); test("ensureThinkingConfig: does NOT override existing thinking config", () => { @@ -293,6 +333,9 @@ test("applyThinkingBudget: -thinking model without config + PASSTHROUGH = auto-i }; const result = applyThinkingBudget(body); assert.equal(result.thinking.type, "enabled"); - assert.equal(result.thinking.budget_tokens, EFFORT_BUDGETS.medium); + assert.ok( + result.thinking.budget_tokens > 0, + "budget_tokens should be positive after auto-inject" + ); setThinkingBudgetConfig(DEFAULT_THINKING_CONFIG); }); diff --git a/tests/unit/tool-request-sanitization.test.ts b/tests/unit/tool-request-sanitization.test.ts index 08e458b7b1..e406d657a7 100644 --- a/tests/unit/tool-request-sanitization.test.ts +++ b/tests/unit/tool-request-sanitization.test.ts @@ -159,8 +159,12 @@ test("tool sanitization: injects empty reasoning_content only for DeepSeek tool- }, ]; - const deepseekMessages = injectEmptyReasoningContentForToolCalls(messages, "deepseek"); - const openaiMessages = injectEmptyReasoningContentForToolCalls(messages, "openai"); + const deepseekMessages = injectEmptyReasoningContentForToolCalls( + messages, + "deepseek", + "deepseek-v4-flash" + ); + const openaiMessages = injectEmptyReasoningContentForToolCalls(messages, "openai", "gpt-4o"); assert.equal(deepseekMessages[1].reasoning_content, ""); assert.equal(openaiMessages[1].reasoning_content, undefined); @@ -170,7 +174,7 @@ test("translateRequest injects reasoning_content for DeepSeek assistant tool cal const translated = translateRequest( FORMATS.OPENAI, FORMATS.OPENAI, - "deepseek-reasoner", + "deepseek-v4-flash", { messages: [ { role: "user", content: "hello" }, diff --git a/tests/unit/translator-claude-helper-thinking.test.ts b/tests/unit/translator-claude-helper-thinking.test.ts new file mode 100644 index 0000000000..a01a0b4b98 --- /dev/null +++ b/tests/unit/translator-claude-helper-thinking.test.ts @@ -0,0 +1,329 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { prepareClaudeRequest, NON_ANTHROPIC_THINKING_PLACEHOLDER: PLACEHOLDER } = await import("../../open-sse/translator/helpers/claudeHelper.ts"); +const { DEFAULT_THINKING_CLAUDE_SIGNATURE } = + await import("../../open-sse/config/defaultThinkingSignature.ts"); +const reasoningCache = await import("../../open-sse/services/reasoningCache.ts"); + + +function multiTurnBodyWithoutThinkingBlock() { + return { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { + role: "assistant", + content: [{ type: "tool_use", id: "call_x", name: "ls", input: { path: "." } }], + }, + { + role: "user", + content: [{ type: "tool_result", tool_use_id: "call_x", content: "README.md" }], + }, + ], + }; +} + +function multiTurnBodyWithThinkingBlock(thinkingText: string, toolUseId = "call_y") { + return { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { + role: "assistant", + content: [ + { type: "thinking", thinking: thinkingText, signature: "client-stored-sig" }, + { type: "tool_use", id: toolUseId, name: "ls", input: {} }, + ], + }, + { + role: "user", + content: [{ type: "tool_result", tool_use_id: toolUseId, content: "ok" }], + }, + ], + }; +} + +// ──────────────── Anthropic-native (claude, anthropic-compatible-*) ──────────────── + +test("claude provider — empty content, injects redacted_thinking{data} before tool_use", () => { + const body = multiTurnBodyWithoutThinkingBlock(); + const result = prepareClaudeRequest(body as any, "claude"); + const content = (result as any).messages[1].content; + assert.equal(content.length, 2); + assert.equal(content[0].type, "redacted_thinking"); + assert.equal(content[0].data, DEFAULT_THINKING_CLAUDE_SIGNATURE); + assert.equal(content[0].thinking, undefined); + assert.equal(content[0].signature, undefined); + assert.equal(content[1].type, "tool_use"); +}); + +test("claude provider — existing thinking block converted to redacted_thinking{data} on older messages", () => { + // Uses a two-assistant-turn body: the first assistant (with thinking) is an + // older turn; the second (latest) assistant's thinking must stay verbatim. + // This verifies that older assistant thinking blocks ARE rewritten. + const body: any = { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { + role: "assistant", + content: [ + { type: "thinking", thinking: "real thinking text", signature: "client-stored-sig" }, + { type: "tool_use", id: "call_y", name: "ls", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "call_y", content: "ok" }] }, + { + role: "assistant", + content: [ + { type: "thinking", thinking: "latest thinking", signature: "latest-sig" }, + { type: "tool_use", id: "call_z", name: "ls", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "call_z", content: "ok" }] }, + ], + }; + prepareClaudeRequest(body, "claude"); + // Older assistant: thinking rewritten to redacted_thinking + const olderContent = body.messages[1].content; + assert.equal(olderContent.length, 2, "no double-inject"); + assert.equal(olderContent[0].type, "redacted_thinking"); + assert.equal(olderContent[0].data, DEFAULT_THINKING_CLAUDE_SIGNATURE); + assert.equal( + olderContent[0].thinking, + undefined, + "plain text stripped (Anthropic does not trust replay text)" + ); + assert.equal(olderContent[0].signature, undefined); + assert.equal(olderContent[1].type, "tool_use"); + // Latest assistant: thinking preserved verbatim + const latestContent = body.messages[3].content; + assert.equal(latestContent[0].type, "thinking"); + assert.equal(latestContent[0].thinking, "latest thinking"); + assert.equal(latestContent[0].signature, "latest-sig"); +}); + +test("anthropic-compatible-* provider — same as claude (redacted_thinking)", () => { + const body = multiTurnBodyWithoutThinkingBlock(); + const result = prepareClaudeRequest(body as any, "anthropic-compatible-abc123"); + const content = (result as any).messages[1].content; + assert.equal(content[0].type, "redacted_thinking"); + assert.equal(content[0].data, DEFAULT_THINKING_CLAUDE_SIGNATURE); +}); + +// ──────────────── Non-Anthropic Claude-shape (kimi-coding, glmt, zai, …) ──────────────── + +test("kimi-coding provider — empty content, injects plain thinking{text} with placeholder (cache miss)", () => { + reasoningCache.clearReasoningCacheAll(); + const body = multiTurnBodyWithoutThinkingBlock(); + const result = prepareClaudeRequest(body as any, "kimi-coding"); + const content = (result as any).messages[1].content; + assert.equal(content.length, 2); + assert.equal(content[0].type, "thinking"); + assert.equal(content[0].thinking, PLACEHOLDER); + assert.equal(content[0].data, undefined, "no data field on plain thinking"); + assert.equal(content[0].signature, undefined, "no signature field on cross-provider replay"); + assert.equal(content[1].type, "tool_use"); +}); + +test("kimi-coding provider — empty content + cache hit on tool_use.id, injects real reasoning text", () => { + reasoningCache.clearReasoningCacheAll(); + reasoningCache.cacheReasoning( + "call_x", + "kimi-coding", + "kimi-k2.6", + "the model actually thought this" + ); + const body = multiTurnBodyWithoutThinkingBlock(); + const result = prepareClaudeRequest(body as any, "kimi-coding"); + const content = (result as any).messages[1].content; + assert.equal(content[0].type, "thinking"); + assert.equal(content[0].thinking, "the model actually thought this"); +}); + +test("kimi-coding provider — existing thinking block: client text preserved, signature stripped, data NOT added", () => { + reasoningCache.clearReasoningCacheAll(); + const body = multiTurnBodyWithThinkingBlock("client preserved reasoning", "call_y"); + const result = prepareClaudeRequest(body as any, "kimi-coding"); + const content = (result as any).messages[1].content; + assert.equal(content.length, 2); + assert.equal(content[0].type, "thinking"); + assert.equal(content[0].thinking, "client preserved reasoning", "client text preserved"); + assert.equal(content[0].data, undefined); + assert.equal( + content[0].signature, + undefined, + "client-stored signature stripped (no value for kimi)" + ); +}); + +test("kimi-coding provider — existing redacted_thinking block (no text), cache hit injects real text", () => { + reasoningCache.clearReasoningCacheAll(); + reasoningCache.cacheReasoning("call_z", "kimi-coding", "kimi-k2.6", "cached reasoning v2"); + const body = { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { + role: "assistant", + content: [ + { type: "redacted_thinking", data: "opaque-blob-from-prior-anthropic-turn" }, + { type: "tool_use", id: "call_z", name: "ls", input: {} }, + ], + }, + { + role: "user", + content: [{ type: "tool_result", tool_use_id: "call_z", content: "ok" }], + }, + ], + }; + const result = prepareClaudeRequest(body as any, "kimi-coding"); + const content = (result as any).messages[1].content; + assert.equal(content[0].type, "thinking"); + assert.equal(content[0].thinking, "cached reasoning v2", "cache substitutes redacted data"); + assert.equal(content[0].data, undefined); +}); + +test("kimi-coding provider — existing redacted_thinking block (no text), cache miss → placeholder", () => { + reasoningCache.clearReasoningCacheAll(); + const body = { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { + role: "assistant", + content: [ + { type: "redacted_thinking", data: "opaque-blob" }, + { type: "tool_use", id: "call_z_miss", name: "ls", input: {} }, + ], + }, + { + role: "user", + content: [{ type: "tool_result", tool_use_id: "call_z_miss", content: "ok" }], + }, + ], + }; + const result = prepareClaudeRequest(body as any, "kimi-coding"); + const content = (result as any).messages[1].content; + assert.equal(content[0].type, "thinking"); + assert.equal(content[0].thinking, PLACEHOLDER); +}); + +// ──────────────── Disabled / no-op paths ──────────────── + +test("thinking disabled — no inject regardless of provider or tool_use", () => { + for (const provider of ["claude", "kimi-coding", "anthropic-compatible-x"]) { + const body = { + thinking: { type: "disabled" }, + messages: [ + { role: "user", content: [{ type: "text", text: "hi" }] }, + { role: "assistant", content: [{ type: "tool_use", id: "x", name: "ls", input: {} }] }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "x", content: "ok" }] }, + ], + }; + const result = prepareClaudeRequest(body as any, provider); + const content = (result as any).messages[1].content; + assert.equal(content.length, 1, `${provider}: no inject when thinking disabled`); + assert.equal(content[0].type, "tool_use"); + } +}); + +test("thinking enabled + no tool_use — no precursor inject (single-turn text)", () => { + for (const provider of ["claude", "kimi-coding"]) { + const body = { + thinking: { type: "enabled", budget_tokens: 4096 }, + messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }], + }; + const result = prepareClaudeRequest(body as any, provider); + const content = (result as any).messages[0].content; + assert.ok(Array.isArray(content)); + assert.equal(content.length, 1); + assert.equal(content[0].type, "text"); + } +}); + +// ──────────────── Latest-assistant preservation (Anthropic & non-Anthropic) ──────────────── + +test("preserves verbatim thinking on the LATEST assistant message; rewrites only older ones", () => { + const body: any = { + thinking: { type: "enabled", budget_tokens: 4096 }, + model: "claude-opus-4-7", + messages: [ + { + role: "assistant", + content: [ + { type: "thinking", thinking: "older thought", signature: "sig-OLD" }, + { type: "tool_use", id: "tool_1", name: "do_x", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "tool_1", content: "ok" }] }, + { + role: "assistant", + content: [ + { type: "thinking", thinking: "latest thought", signature: "sig-LATEST" }, + { type: "tool_use", id: "tool_2", name: "do_y", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "tool_2", content: "ok" }] }, + ], + }; + + prepareClaudeRequest(body, "claude"); + + const olderAssistant = body.messages[0]; + const latestAssistant = body.messages[2]; + + // Older assistant thinking: rewritten to redacted_thinking { data } + assert.equal(olderAssistant.content[0].type, "redacted_thinking"); + assert.ok( + typeof olderAssistant.content[0].data === "string" && olderAssistant.content[0].data.length > 0 + ); + assert.equal(olderAssistant.content[0].thinking, undefined); + assert.equal(olderAssistant.content[0].signature, undefined); + + // Latest assistant thinking: untouched (type, text, signature all preserved) + assert.equal(latestAssistant.content[0].type, "thinking"); + assert.equal(latestAssistant.content[0].thinking, "latest thought"); + assert.equal(latestAssistant.content[0].signature, "sig-LATEST"); + assert.equal(latestAssistant.content[0].data, undefined); +}); + +test("non-Anthropic upstream: preserves latest assistant thinking text verbatim, only fills older from cache/placeholder", () => { + reasoningCache.clearReasoningCacheAll(); + const body: any = { + thinking: { type: "enabled", budget_tokens: 4096 }, + model: "kimi-k2.6-thinking", + messages: [ + { + role: "assistant", + content: [ + { type: "thinking", thinking: "" /* stripped on wire */ }, + { type: "tool_use", id: "tool_1", name: "do_x", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "tool_1", content: "ok" }] }, + { + role: "assistant", + content: [ + { type: "thinking", thinking: "latest reasoning text" }, + { type: "tool_use", id: "tool_2", name: "do_y", input: {} }, + ], + }, + { role: "user", content: [{ type: "tool_result", tool_use_id: "tool_2", content: "ok" }] }, + ], + }; + + prepareClaudeRequest(body, "kimi-coding"); + + // Latest assistant: text preserved verbatim + assert.equal(body.messages[2].content[0].type, "thinking"); + assert.equal(body.messages[2].content[0].thinking, "latest reasoning text"); + + // Older assistant: empty text -> placeholder (cache miss path) + assert.equal(body.messages[0].content[0].type, "thinking"); + assert.ok( + typeof body.messages[0].content[0].thinking === "string" && + body.messages[0].content[0].thinking.length > 0 + ); +}); diff --git a/tests/unit/translator-helper-branches.test.ts b/tests/unit/translator-helper-branches.test.ts index 9f80646b07..b0cfddd0e9 100644 --- a/tests/unit/translator-helper-branches.test.ts +++ b/tests/unit/translator-helper-branches.test.ts @@ -6,6 +6,10 @@ const openaiHelper = await import("../../open-sse/translator/helpers/openaiHelpe const claudeHelper = await import("../../open-sse/translator/helpers/claudeHelper.ts"); const geminiHelper = await import("../../open-sse/translator/helpers/geminiHelper.ts"); const toolCallHelper = await import("../../open-sse/translator/helpers/toolCallHelper.ts"); +const { FORMATS } = await import("../../open-sse/translator/formats.ts"); +const { translateRequest } = await import("../../open-sse/translator/index.ts"); +const { cacheReasoningByKey, clearReasoningCacheAll, getReasoningCacheServiceStats } = + await import("../../open-sse/services/reasoningCache.ts"); const originalMathRandom = Math.random; @@ -132,14 +136,18 @@ test("schemaCoercion sanitizes descriptions, tool schemas, tool ids and deepseek { role: "assistant", tool_calls: [{ id: "call_2" }], reasoning_content: "keep" }, { role: "user", tool_calls: [{ id: "call_3" }] }, ], - "deepseek" + "deepseek", + "deepseek-v4-flash" ); assert.equal(injected[0].reasoning_content, ""); assert.equal(injected[1].reasoning_content, "keep"); assert.equal(injected[2].reasoning_content, undefined); assert.equal( - schemaCoercion.injectEmptyReasoningContentForToolCalls([{ role: "assistant" }], "openai")[0] - .reasoning_content, + schemaCoercion.injectEmptyReasoningContentForToolCalls( + [{ role: "assistant" }], + "openai", + "gpt-4o" + )[0].reasoning_content, undefined ); }); @@ -304,12 +312,24 @@ test("claudeHelper validates content, ordering and request preparation branches" assert.equal(prepared.messages.length, 6); assert.equal(prepared.messages[2].content.at(-1).cache_control.type, "ephemeral"); assert.equal(prepared.messages[4].content[0].type, "tool_result"); + // messages[5] is the latest (and last) assistant message; Anthropic enforces + // that its thinking blocks must remain verbatim — not rewritten to + // redacted_thinking. The guard in prepareClaudeRequest preserves them. assert.deepEqual( prepared.messages[5].content.map((block) => block.type), - ["redacted_thinking", "text"] + ["thinking", "text"] + ); + assert.equal(prepared.messages[5].content[0].thinking, "old", "thinking text preserved verbatim"); + assert.equal( + prepared.messages[5].content[0].signature, + "replace", + "signature preserved verbatim" + ); + assert.equal( + prepared.messages[5].content[0].data, + undefined, + "no data field on verbatim thinking" ); - assert.ok(prepared.messages[5].content[0].signature); - assert.equal(prepared.messages[5].content[0].thinking, undefined); assert.equal(prepared.tools.length, 2); assert.equal(prepared.tools[0].cache_control, undefined); assert.deepEqual(prepared.tools[1].cache_control, { type: "ephemeral", ttl: "1h" }); @@ -468,3 +488,63 @@ test("toolCallHelper normalizes ids, links tool responses and inserts missing to assert.equal(toolCallHelper.hasToolResults({ role: "user", content: [] }, []), false); assert.deepEqual(toolCallHelper.fixMissingToolResponses({ messages: null }), { messages: null }); }); + +test("translateRequest replays cached DeepSeek reasoning messages without tool calls", () => { + clearReasoningCacheAll(); + cacheReasoningByKey( + "request:req_reasoning_only:message:0", + "deepseek", + "deepseek-reasoner", + "cached reasoning only" + ); + + const result = translateRequest( + FORMATS.OPENAI, + FORMATS.OPENAI, + "deepseek-reasoner", + { + _reasoningCacheRequestId: "req_reasoning_only", + messages: [ + { role: "user", content: "solve this" }, + { role: "assistant", content: "answer", reasoning_content: "" }, + ], + }, + false, + null, + "deepseek" + ); + + assert.equal(result.messages[1].reasoning_content, "cached reasoning only"); + assert.equal(getReasoningCacheServiceStats().replays, 1); + clearReasoningCacheAll(); +}); + +test("translateRequest does not replay reasoning-only messages for non-DeepSeek models", () => { + clearReasoningCacheAll(); + cacheReasoningByKey( + "request:req_kimi_reasoning_only:message:0", + "kimi", + "kimi-k2.5", + "cached kimi reasoning" + ); + + const result = translateRequest( + FORMATS.OPENAI, + FORMATS.OPENAI, + "kimi-k2.5", + { + _reasoningCacheRequestId: "req_kimi_reasoning_only", + messages: [ + { role: "user", content: "solve this" }, + { role: "assistant", content: "answer", reasoning_content: "" }, + ], + }, + false, + null, + "kimi" + ); + + assert.equal(result.messages[1].reasoning_content, ""); + assert.equal(getReasoningCacheServiceStats().replays, 0); + clearReasoningCacheAll(); +}); diff --git a/tests/unit/translator-openai-responses-req.test.ts b/tests/unit/translator-openai-responses-req.test.ts index e8004c3e6c..55b8791713 100644 --- a/tests/unit/translator-openai-responses-req.test.ts +++ b/tests/unit/translator-openai-responses-req.test.ts @@ -110,7 +110,7 @@ test("Responses -> Chat filters orphan tool outputs and supports role-based mess }); }); -test("Responses -> Chat rejects unsupported built-in tools and background mode", () => { +test("Responses -> Chat rejects unsupported built-in tools", () => { assert.throws( () => openaiResponsesToOpenAIRequest( @@ -124,20 +124,77 @@ test("Responses -> Chat rejects unsupported built-in tools and background mode", ), (error: any) => error.statusCode === 400 && error.errorType === "unsupported_feature" ); +}); - assert.throws( - () => - openaiResponsesToOpenAIRequest( - "gpt-4o", - { - input: [], - background: true, - }, - false, - null - ), - (error: any) => error.statusCode === 400 && error.errorType === "unsupported_feature" - ); +test("Responses -> Chat strips background flag and degrades to synchronous execution", () => { + // Previously this threw 400 unsupported_feature. OmniRoute is a forward proxy + // and cannot host the deferred run + poll contract, so background=true is + // silently dropped and the request runs synchronously. Clients that set the + // flag opportunistically (Capy Captain Pro, Codex agents) work unchanged. + const warnLog: string[] = []; + const originalWarn = console.warn; + console.warn = (msg: unknown) => warnLog.push(String(msg)); + try { + const result = openaiResponsesToOpenAIRequest( + "gpt-5.5", + { + input: [{ role: "user", content: [{ type: "input_text", text: "hi" }] }], + background: true, + }, + true, + { provider: "codex" } + ); + const r = result as Record<string, unknown>; + assert.equal(r.background, undefined, "background flag must be stripped from output"); + assert.ok(Array.isArray(r.messages), "translation must complete and produce messages"); + assert.equal((r.messages as unknown[]).length, 1, "user message must be preserved"); + assert.ok( + warnLog.some((m) => m.startsWith("BACKGROUND_DEGRADE provider=codex model=gpt-5.5")), + "BACKGROUND_DEGRADE warning log must be emitted when background=true" + ); + } finally { + console.warn = originalWarn; + } +}); + +test("Responses -> Chat passes through when background flag is unset or false (no degrade log)", () => { + // Verifies the inverse of the degradation case: when background is absent or + // explicitly false, no warning should be emitted and the request body should + // not carry a residual background field. Guards against accidental log spam + // and confirms the degradation logic is conditional on background === true. + const warnLog: string[] = []; + const originalWarn = console.warn; + console.warn = (msg: unknown) => warnLog.push(String(msg)); + try { + // Case 1: background unset + const r1 = openaiResponsesToOpenAIRequest( + "gpt-5.5", + { input: [{ role: "user", content: [{ type: "input_text", text: "hi" }] }] }, + true, + { provider: "codex" } + ) as Record<string, unknown>; + assert.equal(r1.background, undefined, "background must be absent on output (unset case)"); + + // Case 2: background explicitly false + const r2 = openaiResponsesToOpenAIRequest( + "gpt-5.5", + { + input: [{ role: "user", content: [{ type: "input_text", text: "hi" }] }], + background: false, + }, + true, + { provider: "codex" } + ) as Record<string, unknown>; + assert.equal(r2.background, undefined, "background must be stripped on output (false case)"); + + assert.equal( + warnLog.filter((m) => m.startsWith("BACKGROUND_DEGRADE")).length, + 0, + "BACKGROUND_DEGRADE must NOT be emitted for unset or false values" + ); + } finally { + console.warn = originalWarn; + } }); test("Chat -> Responses converts messages, tool calls, tool outputs, tools and pass-through params", () => { @@ -297,6 +354,35 @@ test("Chat -> Responses preserves explicit reasoning objects", () => { assert.equal((result as any).store, false); }); +test("Chat -> Responses propagates include so upstream streams the reasoning summary", () => { + const result = openaiToOpenAIResponsesRequest( + "gpt-5.3-codex-spark", + { + messages: [{ role: "user", content: "Hello" }], + reasoning: { effort: "high", summary: "auto" }, + include: ["reasoning.encrypted_content"], + }, + false, + null + ); + + assert.deepEqual((result as any).include, ["reasoning.encrypted_content"]); +}); + +test("Chat -> Responses does not inject include when caller did not set one", () => { + const result = openaiToOpenAIResponsesRequest( + "gpt-5.3-codex-spark", + { + messages: [{ role: "user", content: "Hello" }], + reasoning: { effort: "high" }, + }, + false, + null + ); + + assert.equal((result as any).include, undefined); +}); + test("Chat -> Responses maps reasoning_effort into Responses reasoning", () => { const result = openaiToOpenAIResponsesRequest( "gpt-5.3-codex-spark", diff --git a/tests/unit/translator-openai-to-claude.test.ts b/tests/unit/translator-openai-to-claude.test.ts index 8fa862b8d8..2c6b63a0f3 100644 --- a/tests/unit/translator-openai-to-claude.test.ts +++ b/tests/unit/translator-openai-to-claude.test.ts @@ -348,3 +348,117 @@ test("OpenAI -> Claude can disable OAuth prefixes and Antigravity strips Claude- "read_file" ); }); + +test("OpenAI -> Claude preserves reasoning_content on assistant tool call messages when thinking is enabled", () => { + // Bug: Kimi (and other thinking-enabled providers) require reasoning_content + // on assistant messages that contain tool_calls. When reasoning_content is + // present, it must be converted to a thinking block. When it's missing but + // thinking is enabled, we must NOT drop the tool_calls. + const result = openaiToClaudeRequest( + "claude-4-sonnet", + { + messages: [ + { role: "user", content: "What is the weather?" }, + { + role: "assistant", + reasoning_content: "I need to check the weather", + content: "Let me check that for you.", + tool_calls: [ + { + id: "call_weather_1", + type: "function", + function: { + name: "get_weather", + arguments: '{"location":"Tokyo"}', + }, + }, + ], + }, + { + role: "tool", + tool_call_id: "call_weather_1", + content: "Sunny, 25C", + }, + { role: "user", content: "Thanks!" }, + ], + tools: [ + { + type: "function", + function: { + name: "get_weather", + description: "Get weather info", + parameters: { type: "object", properties: {} }, + }, + }, + ], + thinking: { type: "enabled", budget_tokens: 1024 }, + }, + false + ); + + // Find the assistant message with tool_calls + const assistantMsgs = result.messages.filter((m) => m.role === "assistant"); + assert.equal(assistantMsgs.length, 1, "expected exactly one assistant message"); + + const assistantMsg = assistantMsgs[0]; + const thinkingBlock = assistantMsg.content.find((b) => b.type === "thinking"); + const textBlock = assistantMsg.content.find((b) => b.type === "text"); + const toolUseBlock = assistantMsg.content.find((b) => b.type === "tool_use"); + + assert.ok(thinkingBlock, "expected thinking block from reasoning_content"); + assert.equal(thinkingBlock.thinking, "I need to check the weather"); + assert.equal(thinkingBlock.signature, DEFAULT_THINKING_CLAUDE_SIGNATURE); + + assert.ok(textBlock, "expected text block"); + assert.equal(textBlock.text, "Let me check that for you."); + + assert.ok(toolUseBlock, "expected tool_use block"); + assert.equal(toolUseBlock.name, `${CLAUDE_OAUTH_TOOL_PREFIX}get_weather`); + assert.deepEqual(toolUseBlock.input, { location: "Tokyo" }); +}); + +test("OpenAI -> Claude handles assistant tool call messages without reasoning_content when thinking is enabled", () => { + // When thinking is enabled but the assistant message has no reasoning_content, + // the message should still be translated correctly with tool_calls preserved. + const result = openaiToClaudeRequest( + "claude-4-sonnet", + { + messages: [ + { role: "user", content: "Call a tool" }, + { + role: "assistant", + content: "OK", + tool_calls: [ + { + id: "call_1", + type: "function", + function: { + name: "do_thing", + arguments: "{}", + }, + }, + ], + }, + ], + tools: [ + { + type: "function", + function: { + name: "do_thing", + description: "Do a thing", + parameters: { type: "object", properties: {} }, + }, + }, + ], + thinking: { type: "enabled", budget_tokens: 1024 }, + }, + false + ); + + const assistantMsg = result.messages.find((m) => m.role === "assistant"); + assert.ok(assistantMsg, "expected assistant message"); + + const toolUseBlock = assistantMsg.content.find((b) => b.type === "tool_use"); + assert.ok(toolUseBlock, "expected tool_use block to be preserved"); + assert.equal(toolUseBlock.name, `${CLAUDE_OAUTH_TOOL_PREFIX}do_thing`); +}); diff --git a/tests/unit/translator-openai-to-gemini.test.ts b/tests/unit/translator-openai-to-gemini.test.ts index 8bf929d858..69f68d3783 100644 --- a/tests/unit/translator-openai-to-gemini.test.ts +++ b/tests/unit/translator-openai-to-gemini.test.ts @@ -756,7 +756,11 @@ test("OpenAI -> Antigravity Claude path sanitizes tool names for Gemini schema", assert.deepEqual(toolResultBlock.response, { result: { ok: true } }); }); -test("OpenAI -> Antigravity Claude path applies output cap in generationConfig", () => { +test("OpenAI -> Antigravity Claude path applies output cap and strips thinkingConfig", () => { + // For Claude on Antigravity, applyAntigravityGenerationDefaults must bump + // maxOutputTokens to thinkingBudget+1 BEFORE the envelope strips thinkingConfig + // (because Claude on Cloud Code does not understand Gemini's thinkingConfig + // shape but still benefits from the larger output cap derived from it). const result = openaiToAntigravityRequest( "claude-3-7-sonnet", { @@ -769,15 +773,14 @@ test("OpenAI -> Antigravity Claude path applies output cap in generationConfig", ); assert.equal((result as any).request?.generationConfig.maxOutputTokens, 32769); - assert.deepEqual((result as any).request?.generationConfig.thinkingConfig, { - thinkingBudget: 32768, - includeThoughts: true, - }); + // thinkingConfig must be stripped for Claude — Cloud Code Claude endpoint + // does not understand the Gemini-shape thinkingConfig field. + assert.equal((result as any).request?.generationConfig.thinkingConfig, undefined); assert.equal((result as any).request?.max_tokens, undefined); assert.equal((result as any).request?.thinking, undefined); }); -test("OpenAI -> Antigravity Claude path preserves lower requested output", () => { +test("OpenAI -> Antigravity Claude path preserves lower requested output and strips thinkingConfig", () => { const result = openaiToAntigravityRequest( "claude-3-7-sonnet", { @@ -790,10 +793,32 @@ test("OpenAI -> Antigravity Claude path preserves lower requested output", () => ); assert.equal((result as any).request?.generationConfig.maxOutputTokens, 32769); - assert.deepEqual((result as any).request?.generationConfig.thinkingConfig, { - thinkingBudget: 32768, - includeThoughts: true, - }); + assert.equal((result as any).request?.generationConfig.thinkingConfig, undefined); assert.equal((result as any).request?.max_tokens, undefined); assert.equal((result as any).request?.thinking, undefined); }); + +test("OpenAI -> Antigravity Gemini path preserves thinkingConfig (only Claude is stripped)", () => { + // Negative-control for the Claude-thinkingConfig-strip behavior. Gemini models + // on Antigravity must still receive thinkingConfig — only Claude needs it removed + // (Cloud Code Claude endpoint does not understand the Gemini-shape field). + const result = openaiToAntigravityRequest( + "gemini-2.5-pro", + { + messages: [{ role: "user", content: "Summarize this" }], + max_completion_tokens: 32000, + reasoning_effort: "high", + }, + false, + { projectId: "proj-gemini-thinking" } as any + ); + + // For Gemini, thinkingConfig must remain in place because the Cloud Code + // Gemini endpoint understands and uses it. + assert.ok( + (result as any).request?.generationConfig.thinkingConfig, + "thinkingConfig must be preserved for Gemini models on Antigravity" + ); + assert.equal((result as any).request?.generationConfig.thinkingConfig.thinkingBudget > 0, true); + assert.equal((result as any).request?.generationConfig.thinkingConfig.includeThoughts, true); +}); diff --git a/tests/unit/translator-openai-to-kiro.test.ts b/tests/unit/translator-openai-to-kiro.test.ts index adf7d46b37..6bccb7b1be 100644 --- a/tests/unit/translator-openai-to-kiro.test.ts +++ b/tests/unit/translator-openai-to-kiro.test.ts @@ -289,3 +289,153 @@ test("OpenAI -> Kiro merges adjacent user history turns after role normalization assert.equal(firstUser.content, "System rules\n\nFirst question"); assert.equal(history[1].assistantResponseMessage?.content, "Answer 1"); }); + +test("OpenAI -> Kiro synthesizes tools schema when body.tools is omitted but history has tool_calls", () => { + const result = buildKiroPayload( + "claude-opus-4.7", + { + messages: [ + { role: "user", content: "Start" }, + { + role: "assistant", + tool_calls: [ + { + id: "tooluse_1", + type: "function", + function: { name: "edit", arguments: '{"path":"x"}' }, + }, + ], + }, + { role: "tool", tool_call_id: "tooluse_1", content: "ok" }, + { + role: "assistant", + tool_calls: [ + { + id: "tooluse_2", + type: "function", + function: { name: "bash", arguments: '{"cmd":"ls"}' }, + }, + ], + }, + { role: "tool", tool_call_id: "tooluse_2", content: "listing" }, + { role: "user", content: "Continue" }, + ], + }, + false, + null + ); + + const ctx = result.conversationState.currentMessage.userInputMessage.userInputMessageContext as { + tools?: Array<{ toolSpecification: { name: string } }>; + }; + const tools = ctx?.tools; + assert.ok(tools, "synthesized tools schema should be attached to currentMessage"); + const names = tools.map((t) => t.toolSpecification.name).sort(); + assert.deepEqual(names, ["bash", "edit"]); +}); + +test("OpenAI -> Kiro does not override body.tools when caller already provides a schema", () => { + const result = buildKiroPayload( + "claude-opus-4.7", + { + messages: [ + { role: "user", content: "Start" }, + { + role: "assistant", + tool_calls: [ + { + id: "tooluse_1", + type: "function", + function: { name: "read_file", arguments: "{}" }, + }, + ], + }, + { role: "tool", tool_call_id: "tooluse_1", content: "ok" }, + { role: "user", content: "Continue" }, + ], + tools: [ + { + type: "function", + function: { + name: "read_file", + description: "Real description", + parameters: { type: "object", properties: { path: { type: "string" } } }, + }, + }, + ], + }, + false, + null + ); + + const ctx = result.conversationState.currentMessage.userInputMessage.userInputMessageContext as { + tools?: Array<{ toolSpecification: { name: string; description: string } }>; + }; + const tools = ctx.tools; + assert.ok(tools); + assert.equal(tools.length, 1); + assert.equal(tools[0].toolSpecification.description, "Real description"); +}); + +test("OpenAI -> Kiro synthesizes tools from Anthropic-style tool_use content blocks", () => { + const result = buildKiroPayload( + "claude-opus-4.7", + { + messages: [ + { role: "user", content: "Start" }, + { + role: "assistant", + content: [ + { type: "text", text: "Calling tools" }, + { type: "tool_use", id: "tu_1", name: "search", input: { q: "x" } }, + { type: "tool_use", id: "tu_2", name: "open_file", input: { path: "a" } }, + ], + }, + { + role: "user", + content: [ + { type: "tool_result", tool_use_id: "tu_1", content: [{ type: "text", text: "hit" }] }, + { type: "tool_result", tool_use_id: "tu_2", content: [{ type: "text", text: "ok" }] }, + ], + }, + { role: "user", content: "continue" }, + ], + }, + false, + null + ); + + const ctx = result.conversationState.currentMessage.userInputMessage.userInputMessageContext as { + tools?: Array<{ toolSpecification: { name: string } }>; + }; + const tools = ctx?.tools; + assert.ok(tools, "tools should be synthesized from tool_use content blocks"); + const names = tools.map((t) => t.toolSpecification.name).sort(); + assert.deepEqual(names, ["open_file", "search"]); +}); + +test("OpenAI -> Kiro attaches tools to currentMessage when history has no user turn to carry them", () => { + const result = buildKiroPayload( + "claude-opus-4.7", + { + messages: [ + { + role: "assistant", + tool_calls: [ + { id: "tc_1", type: "function", function: { name: "edit", arguments: "{}" } }, + ], + }, + ], + }, + false, + null + ); + + const cm = result.conversationState.currentMessage.userInputMessage; + const ctx = cm.userInputMessageContext as { + tools?: Array<{ toolSpecification: { name: string } }>; + }; + assert.ok(ctx?.tools, "tools should be attached to currentMessage fallback"); + assert.equal(ctx.tools!.length, 1); + assert.equal(ctx.tools![0].toolSpecification.name, "edit"); +}); diff --git a/tests/unit/translator-resp-openai-responses.test.ts b/tests/unit/translator-resp-openai-responses.test.ts index 78ba82d5bb..292c4b7d11 100644 --- a/tests/unit/translator-resp-openai-responses.test.ts +++ b/tests/unit/translator-resp-openai-responses.test.ts @@ -289,7 +289,7 @@ test("Responses -> OpenAI: tool-call delta, reasoning delta and completed usage assert.equal(added.choices[0].delta.tool_calls[0].function.name, "weather"); assert.equal(args.choices[0].delta.tool_calls[0].function.arguments, '{"city":"SP"}'); - assert.equal(reasoning.choices[0].delta.reasoning.summary, "Need weather info."); + assert.equal(reasoning.choices[0].delta.reasoning_content, "Need weather info."); assert.equal(completed.choices[0].finish_reason, "tool_calls"); assert.equal((completed as any).usage.prompt_tokens, 8); assert.equal((completed as any).usage.completion_tokens, 2); diff --git a/tests/unit/translator-tool-call-shim.test.ts b/tests/unit/translator-tool-call-shim.test.ts new file mode 100644 index 0000000000..14e9b4b0af --- /dev/null +++ b/tests/unit/translator-tool-call-shim.test.ts @@ -0,0 +1,263 @@ +import test from "node:test"; +import assert from "node:assert/strict"; + +const { applyToolCallShimToBuffer, hasToolCallShim, __test } = await import( + "../../open-sse/translator/helpers/toolCallShim.ts" +); +const { openaiToClaudeResponse } = await import( + "../../open-sse/translator/response/openai-to-claude.ts" +); + +const { coerceToArray } = __test as { coerceToArray: (v: unknown) => unknown[] }; + +// -------- Helper-level tests -------- + +test("hasToolCallShim: returns true for submit_pr_review only", () => { + assert.equal(hasToolCallShim("submit_pr_review"), true); + assert.equal(hasToolCallShim("some_other_tool"), false); + assert.equal(hasToolCallShim(""), false); + assert.equal(hasToolCallShim(undefined), false); + assert.equal(hasToolCallShim(null), false); +}); + +test("coerceToArray: passes arrays through unchanged", () => { + assert.deepEqual(coerceToArray([]), []); + assert.deepEqual(coerceToArray([{ a: 1 }]), [{ a: 1 }]); +}); + +test("coerceToArray: null/undefined -> []", () => { + assert.deepEqual(coerceToArray(null), []); + assert.deepEqual(coerceToArray(undefined), []); +}); + +test("coerceToArray: plain object -> []", () => { + assert.deepEqual(coerceToArray({}), []); + assert.deepEqual(coerceToArray({ a: 1 }), []); +}); + +test("coerceToArray: empty string -> []", () => { + assert.deepEqual(coerceToArray(""), []); +}); + +test("coerceToArray: stringified array parsed", () => { + assert.deepEqual(coerceToArray("[]"), []); + assert.deepEqual(coerceToArray('[{"title":"x"}]'), [{ title: "x" }]); +}); + +test("coerceToArray: unparseable string -> []", () => { + assert.deepEqual(coerceToArray("not json"), []); + assert.deepEqual(coerceToArray("{"), []); +}); + +test("coerceToArray: stringified non-array -> []", () => { + assert.deepEqual(coerceToArray('{"a":1}'), []); + assert.deepEqual(coerceToArray('"a string"'), []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with valid arrays preserved", () => { + const raw = JSON.stringify({ + summary: "ok", + functionalChanges: [{ description: "x" }], + findings: [{ title: "y" }], + }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.equal(out.summary, "ok"); + assert.deepEqual(out.functionalChanges, [{ description: "x" }]); + assert.deepEqual(out.findings, [{ title: "y" }]); +}); + +test("applyToolCallShimToBuffer: submit_pr_review missing both keys -> arrays injected", () => { + const raw = JSON.stringify({ summary: "no findings" }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.equal(out.summary, "no findings"); + assert.deepEqual(out.functionalChanges, []); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with functionalChanges=null replaced", () => { + const raw = JSON.stringify({ functionalChanges: null, findings: [] }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.deepEqual(out.functionalChanges, []); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with findings={} replaced", () => { + const raw = JSON.stringify({ functionalChanges: [], findings: {} }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with findings='' replaced", () => { + const raw = JSON.stringify({ functionalChanges: [], findings: "" }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with findings='[]' parsed", () => { + const raw = JSON.stringify({ functionalChanges: [], findings: "[]" }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with stringified array of objects parsed", () => { + const raw = JSON.stringify({ + functionalChanges: [], + findings: '[{"title":"x"}]', + }); + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", raw)); + assert.deepEqual(out.findings, [{ title: "x" }]); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with empty buffer -> empty arrays injected", () => { + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", "")); + assert.deepEqual(out.functionalChanges, []); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: submit_pr_review with unparseable buffer -> empty arrays", () => { + const out = JSON.parse(applyToolCallShimToBuffer("submit_pr_review", "{broken")); + assert.deepEqual(out.functionalChanges, []); + assert.deepEqual(out.findings, []); +}); + +test("applyToolCallShimToBuffer: non-shimmed tool passes raw through", () => { + const raw = '{"x":1}'; + assert.equal(applyToolCallShimToBuffer("some_other_tool", raw), raw); +}); + +// -------- Streaming integration tests -------- + +function freshState() { + return { + messageStartSent: false, + nextBlockIndex: 0, + toolCalls: new Map(), + thinkingBlockStarted: false, + textBlockStarted: false, + textBlockClosed: false, + }; +} + +function streamChunks(chunks: any[], state: any): any[] { + const all: any[] = []; + for (const c of chunks) { + const out = openaiToClaudeResponse(c, state); + if (out) all.push(...out); + } + return all; +} + +test("streaming: submit_pr_review with missing arrays gets corrective delta at finish", () => { + const state = freshState(); + const chunks = [ + // chunk 1: message start + tool call start with name + { + id: "chatcmpl-1", + model: "xiaomi-mimo/mimo-v2.5-pro", + choices: [ + { + delta: { + tool_calls: [ + { + index: 0, + id: "call_1", + function: { name: "submit_pr_review", arguments: "" }, + }, + ], + }, + }, + ], + }, + // chunk 2: argument fragment (summary only — no findings/functionalChanges) + { + choices: [ + { + delta: { + tool_calls: [ + { + index: 0, + function: { arguments: '{"summary":"no findings"}' }, + }, + ], + }, + }, + ], + }, + // chunk 3: finish + { + choices: [{ delta: {}, finish_reason: "tool_calls" }], + }, + ]; + + const events = streamChunks(chunks, state); + + // No passthrough input_json_delta for shimmed tool + const passthroughDeltas = events.filter( + (e) => + e.type === "content_block_delta" && + e.delta?.type === "input_json_delta" && + e.delta?.partial_json === '{"summary":"no findings"}' + ); + assert.equal(passthroughDeltas.length, 0, "raw passthrough delta should be suppressed"); + + // Exactly one corrective input_json_delta on the tool block + const correctiveDeltas = events.filter( + (e) => e.type === "content_block_delta" && e.delta?.type === "input_json_delta" + ); + assert.equal(correctiveDeltas.length, 1, "expected exactly one corrective delta"); + + const finalInput = JSON.parse(correctiveDeltas[0].delta.partial_json); + assert.equal(finalInput.summary, "no findings"); + assert.deepEqual(finalInput.functionalChanges, []); + assert.deepEqual(finalInput.findings, []); + + // Corrective delta MUST come before the content_block_stop for that tool block + const correctiveIdx = events.findIndex( + (e) => e.type === "content_block_delta" && e.delta?.type === "input_json_delta" + ); + const stopIdx = events.findIndex( + (e) => e.type === "content_block_stop" && e.index === correctiveDeltas[0].index + ); + assert.ok(correctiveIdx < stopIdx, "corrective delta must precede content_block_stop"); +}); + +test("streaming: non-shimmed tool still streams partials through", () => { + const state = freshState(); + const chunks = [ + { + id: "chatcmpl-1", + model: "x", + choices: [ + { + delta: { + tool_calls: [ + { + index: 0, + id: "call_1", + function: { name: "some_other_tool", arguments: "" }, + }, + ], + }, + }, + ], + }, + { + choices: [ + { + delta: { + tool_calls: [{ index: 0, function: { arguments: '{"x":1}' } }], + }, + }, + ], + }, + { choices: [{ delta: {}, finish_reason: "tool_calls" }] }, + ]; + + const events = streamChunks(chunks, state); + const deltas = events.filter( + (e) => e.type === "content_block_delta" && e.delta?.type === "input_json_delta" + ); + // For non-shimmed tools, the original passthrough delta survives (and no extra corrective delta). + assert.equal(deltas.length, 1); + assert.equal(deltas[0].delta.partial_json, '{"x":1}'); +}); diff --git a/tests/unit/usage-service-hardening.test.ts b/tests/unit/usage-service-hardening.test.ts index 3b77cff9dd..fb5b5550a8 100644 --- a/tests/unit/usage-service-hardening.test.ts +++ b/tests/unit/usage-service-hardening.test.ts @@ -961,8 +961,10 @@ test("usage service covers Qwen, Qoder, GLM, Z.AI and GLMT branches", async () = providerSpecificData: { apiRegion: "international" }, }); assert.equal(glmt.plan, "Pro"); - assert.equal(glmt.quotas["5 Hours Quota"].used, 15); - assert.equal(glmt.quotas["Weekly Quota"].remaining, 36); + assert.equal(glmt.quotas.session.used, 64); + assert.equal(glmt.quotas.session.displayName, "5 Hours Quota"); + assert.equal(glmt.quotas.weekly.remaining, 75); + assert.equal(glmt.quotas.weekly.displayName, "Weekly Quota"); let glmCnUrl = ""; globalThis.fetch = async (url) => { @@ -1119,68 +1121,6 @@ test("usage service treats MiniMax token-plan counts as used usage", async () => assert.ok(Date.parse(usage.quotas["session (5h)"].resetAt) >= beforeCall + 240_000); }); -test("usage service parses Cursor team quotas and clamps on-demand ratio", async () => { - const calls: any[] = []; - globalThis.fetch = async (url, init = {}) => { - calls.push({ url: String(url), init }); - - if (String(url).endsWith("/api/usage")) { - return new Response( - JSON.stringify({ - numRequestsTotal: 450, - hard_limit: 100, - teamMaxRequestUsage: 500, - onDemand: { - numRequests: 600, - }, - }), - { status: 200 } - ); - } - - if (String(url).endsWith("/api/auth/me")) { - return new Response( - JSON.stringify({ - plan: "team", - teamInfo: { id: "team-1", name: "Core Team" }, - }), - { status: 200 } - ); - } - - if (String(url).endsWith("/api/subscription")) { - return new Response( - JSON.stringify({ - teamMaxMonthlyRequests: 500, - }), - { status: 200 } - ); - } - - throw new Error(`unexpected fetch: ${url}`); - }; - - const usage: any = await usageService.getUsageForProvider({ - provider: "cursor", - accessToken: "cursor-token", - }); - - assert.equal(calls.length, 3); - for (const call of calls) { - assert.equal(call.init.headers.Authorization, "Bearer cursor-token"); - assert.equal(call.init.headers["User-Agent"], "Cursor/3.3"); - assert.equal(call.init.headers["x-cursor-client-version"], "3.3"); - } - - assert.equal(usage.plan, "Cursor Team"); - assert.equal(usage.quotas.requests.total, 500); - assert.equal(usage.quotas.requests.used, 450); - assert.equal(usage.quotas.requests.remainingPercentage, 10); - assert.equal(usage.quotas.on_demand.total, 500); - assert.equal(usage.quotas.on_demand.used, 500); - assert.equal(usage.quotas.on_demand.remainingPercentage, 0); -}); - test("usage helper branches cover reset parsing, GitHub quota math, and plan inference fallbacks", () => { const fixedDate = new Date("2026-01-02T03:04:05.000Z"); @@ -1279,32 +1219,6 @@ test("usage helper branches cover reset parsing, GitHub quota math, and plan inf "Copilot Student" ); assert.equal(__testing.inferGitHubPlanName({}, null), "GitHub Copilot"); - - assert.deepEqual(__testing.buildCursorUsageHeaders("cursor-token"), { - Authorization: "Bearer cursor-token", - Accept: "application/json", - "User-Agent": "Cursor/3.3", - "x-cursor-client-version": "3.3", - "x-cursor-user-agent": "Cursor/3.3", - }); - assert.equal( - __testing.getCursorMonthlyRequestLimit( - { hard_limit: 100, teamMaxRequestUsage: 400 }, - { teamMaxMonthlyRequests: 500 } - ), - 500 - ); - assert.equal(__testing.getCursorOnDemandLimit({ onDemand: { maxRequests: 120 } }, {}), 120); - assert.deepEqual(__testing.formatCursorQuota(150, 100, null), { - used: 100, - total: 100, - remaining: 0, - remainingPercentage: 0, - resetAt: null, - unlimited: false, - }); - assert.equal(__testing.inferCursorPlanName({ teamInfo: { id: "team-1" } }, {}), "Cursor Team"); - assert.equal(__testing.inferCursorPlanName({ plan: "pro" }, {}), "Cursor Pro"); }); test("usage helper branches cover Gemini CLI and Antigravity plan label fallbacks", () => { diff --git a/tests/unit/v1-ws-bridge.test.ts b/tests/unit/v1-ws-bridge.test.ts index 859ad6b805..4ccbbd78a8 100644 --- a/tests/unit/v1-ws-bridge.test.ts +++ b/tests/unit/v1-ws-bridge.test.ts @@ -2,7 +2,7 @@ import test from "node:test"; import assert from "node:assert/strict"; import http from "node:http"; -const { createOmnirouteWsBridge } = await import("../../scripts/v1-ws-bridge.mjs"); +const { createOmnirouteWsBridge } = await import("../../scripts/dev/v1-ws-bridge.mjs"); function listen(server) { return new Promise((resolve) => { diff --git a/tests/unit/virtual-auto-combo.test.ts b/tests/unit/virtual-auto-combo.test.ts new file mode 100644 index 0000000000..a303c1d365 --- /dev/null +++ b/tests/unit/virtual-auto-combo.test.ts @@ -0,0 +1,75 @@ +import test from "node:test"; +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; + +const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-virtual-auto-")); +const ORIGINAL_DATA_DIR = process.env.DATA_DIR; + +process.env.DATA_DIR = TEST_DATA_DIR; + +const core = await import("../../src/lib/db/core.ts"); +const providersDb = await import("../../src/lib/db/providers.ts"); +const virtualFactory = await import("../../open-sse/services/autoCombo/virtualFactory.ts"); + +type VirtualComboResult = Awaited<ReturnType<typeof virtualFactory.createVirtualAutoCombo>>; + +async function resetStorage() { + core.resetDbInstance(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + fs.mkdirSync(TEST_DATA_DIR, { recursive: true }); +} + +test.beforeEach(async () => { + await resetStorage(); +}); + +test.after(async () => { + await resetStorage(); + fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true }); + + if (ORIGINAL_DATA_DIR === undefined) { + delete process.env.DATA_DIR; + } else { + process.env.DATA_DIR = ORIGINAL_DATA_DIR; + } +}); + +test("createVirtualAutoCombo returns an executable auto combo for API-key connections", async () => { + await providersDb.createProviderConnection({ + provider: "openai", + authType: "apikey", + name: "OpenAI", + apiKey: "sk-test-openai", + defaultModel: "gpt-4o-mini", + }); + + const combo: VirtualComboResult = await virtualFactory.createVirtualAutoCombo("fast"); + + assert.equal(combo.strategy, "auto"); + assert.equal(combo.models.length, 1); + assert.equal(combo.models[0].kind, "model"); + assert.equal(combo.models[0].model, "openai/gpt-4o-mini"); + assert.equal(combo.models[0].providerId, "openai"); + assert.equal(combo.autoConfig.routerStrategy, "lkgp"); + assert.deepEqual(combo.autoConfig.candidatePool, ["openai"]); +}); + +test("createVirtualAutoCombo includes OAuth accessToken connections with real expiry fields", async () => { + await providersDb.createProviderConnection({ + provider: "anthropic", + authType: "oauth", + email: "oauth@example.com", + accessToken: "oauth-access-token", + tokenExpiresAt: new Date(Date.now() + 60_000).toISOString(), + defaultModel: "claude-sonnet-4-5", + }); + + const combo: VirtualComboResult = await virtualFactory.createVirtualAutoCombo("coding"); + + assert.equal(combo.strategy, "auto"); + assert.equal(combo.models.length, 1); + assert.equal(combo.models[0].model, "anthropic/claude-sonnet-4-5"); + assert.deepEqual(combo.autoConfig.candidatePool, ["anthropic"]); +}); diff --git a/tests/unit/windsurf-devin-executors.test.ts b/tests/unit/windsurf-devin-executors.test.ts new file mode 100644 index 0000000000..2b39d99029 --- /dev/null +++ b/tests/unit/windsurf-devin-executors.test.ts @@ -0,0 +1,236 @@ +import { test, describe } from "node:test"; +import assert from "node:assert/strict"; + +// ─── Model alias resolution (windsurf) ─────────────────────────────────────── +// We exercise the alias map indirectly through the exported class because +// resolveWsModelId is not exported. WindsurfExecutor.buildRequest() calls it. + +describe("Windsurf MODEL_ALIAS_MAP", () => { + const ALIAS_CASES: [string, string][] = [ + // SWE dot→dash conversions + ["swe-1.6-fast", "swe-1-6-fast"], + ["swe-1.6", "swe-1-6"], + ["swe-1.5", "swe-1p5"], + ["swe-1.5-fast", "swe-1p5"], + // GPT-5.5 default effort + ["gpt-5.5", "gpt-5-5-medium"], + // GPT-5.4 default effort + ["gpt-5.4", "gpt-5-4-medium"], + // GPT-5.3-codex default + ["gpt-5.3-codex", "gpt-5-3-codex-medium"], + // Claude aliases + ["claude-sonnet-4.6", "claude-sonnet-4-6"], + ["claude-opus-4.7-max", "claude-opus-4-7-max"], + ["claude-3.7-sonnet-thinking", "CLAUDE_3_7_SONNET_20250219_THINKING"], + // Gemini aliases + ["gemini-2.5-pro", "MODEL_GOOGLE_GEMINI_2_5_PRO"], + ["gemini-3.0-pro", "gemini-3-pro"], + // Kimi + ["kimi-k2", "MODEL_KIMI_K2"], + ]; + + const PASSTHROUGH_CASES = [ + "gpt-5", + "gpt-5-codex", + "grok-code-fast-1", + "deepseek-v4", + "some-unknown-model", + ]; + + // Load the alias map from the module source — we parse it at test time to + // avoid importing the full executor (which would require provider registry). + let aliasMap: Record<string, string>; + + test("setup: parse MODEL_ALIAS_MAP from executor source", async () => { + const fs = await import("node:fs/promises"); + const src = await fs.readFile( + new URL("../../open-sse/executors/windsurf.ts", import.meta.url), + "utf8" + ); + const match = src.match(/const MODEL_ALIAS_MAP[^=]*=\s*(\{[\s\S]*?\n\})/); + assert.ok(match, "MODEL_ALIAS_MAP block should be found in source"); + // Safe eval via Function constructor replacement — build a JS object literal + const objSrc = match[1] + .replace(/\/\/[^\n]*/g, "") // strip line comments + .trim(); + // Parse using JSON after stripping trailing commas (simple approach) + const jsonLike = objSrc + .replace(/,\s*([\]}])/g, "$1") // trailing commas + .replace(/'/g, '"'); // single → double quotes + aliasMap = JSON.parse(jsonLike); + assert.ok(typeof aliasMap === "object"); + }); + + for (const [input, expected] of ALIAS_CASES) { + test(`alias: "${input}" → "${expected}"`, () => { + const result = aliasMap[input] ?? input; + assert.equal(result, expected); + }); + } + + for (const model of PASSTHROUGH_CASES) { + test(`passthrough: "${model}" has no alias (returns itself)`, () => { + const result = aliasMap[model] ?? model; + assert.equal(result, model); + }); + } +}); + +// ─── openAIMessagesToWs message conversion ──────────────────────────────────── +// Tests the message role/content extraction logic. Since the function is not +// exported, we test via a re-implementation that mirrors the source exactly. + +function openAIMessagesToWsLocal( + messages: Array<{ role?: string; content?: unknown; tool_call_id?: string }> +): Array<{ role: string; content: string; toolCallId?: string }> { + const out: Array<{ role: string; content: string; toolCallId?: string }> = []; + for (const m of messages) { + const role = String(m.role || "user"); + let content = ""; + if (typeof m.content === "string") { + content = m.content; + } else if (Array.isArray(m.content)) { + for (const part of m.content) { + if (part && typeof part === "object" && (part as Record<string, unknown>).type === "text") { + content += String((part as Record<string, unknown>).text || ""); + } + } + } + out.push({ role, content, toolCallId: m.tool_call_id }); + } + return out; +} + +describe("openAIMessagesToWs", () => { + test("string content is passed through", () => { + const result = openAIMessagesToWsLocal([{ role: "user", content: "Hello" }]); + assert.equal(result[0].content, "Hello"); + assert.equal(result[0].role, "user"); + }); + + test("multi-part array content: only text parts are concatenated", () => { + const result = openAIMessagesToWsLocal([ + { + role: "user", + content: [ + { type: "text", text: "Part A " }, + { type: "image_url", url: "https://example.com/img.png" }, + { type: "text", text: "Part B" }, + ], + }, + ]); + assert.equal(result[0].content, "Part A Part B"); + }); + + test("missing role defaults to 'user'", () => { + const result = openAIMessagesToWsLocal([{ content: "Hi" }]); + assert.equal(result[0].role, "user"); + }); + + test("tool_call_id is mapped to toolCallId", () => { + const result = openAIMessagesToWsLocal([ + { role: "tool", content: "result", tool_call_id: "call_abc" }, + ]); + assert.equal(result[0].toolCallId, "call_abc"); + }); + + test("null/undefined content yields empty string", () => { + const result = openAIMessagesToWsLocal([{ role: "assistant", content: undefined }]); + assert.equal(result[0].content, ""); + }); +}); + +// ─── gRPC-web frame parser (Windsurf) ──────────────────────────────────────── + +function* parseGrpcWebFramesLocal( + buf: Uint8Array +): Generator<{ flag: number; payload: Uint8Array }> { + let offset = 0; + while (offset + 5 <= buf.length) { + const flag = buf[offset]; + const len = + (buf[offset + 1] << 24) | (buf[offset + 2] << 16) | (buf[offset + 3] << 8) | buf[offset + 4]; + offset += 5; + if (len < 0 || offset + len > buf.length) break; + yield { flag, payload: buf.slice(offset, offset + len) }; + offset += len; + } +} + +describe("parseGrpcWebFrames", () => { + function makeFrame(flag: number, payload: Uint8Array): Uint8Array { + const header = new Uint8Array(5); + header[0] = flag; + const len = payload.length; + header[1] = (len >>> 24) & 0xff; + header[2] = (len >>> 16) & 0xff; + header[3] = (len >>> 8) & 0xff; + header[4] = len & 0xff; + const frame = new Uint8Array(5 + payload.length); + frame.set(header); + frame.set(payload, 5); + return frame; + } + + test("parses a single data frame (flag=0x00)", () => { + const payload = new TextEncoder().encode("hello"); + const buf = makeFrame(0x00, payload); + const frames = [...parseGrpcWebFramesLocal(buf)]; + assert.equal(frames.length, 1); + assert.equal(frames[0].flag, 0x00); + assert.deepEqual(frames[0].payload, payload); + }); + + test("parses multiple frames in sequence", () => { + const p1 = new TextEncoder().encode("frame1"); + const p2 = new TextEncoder().encode("frame2"); + const buf = new Uint8Array([...makeFrame(0x00, p1), ...makeFrame(0x80, p2)]); + const frames = [...parseGrpcWebFramesLocal(buf)]; + assert.equal(frames.length, 2); + assert.equal(frames[0].flag, 0x00); + assert.equal(frames[1].flag, 0x80); + }); + + test("returns empty for truncated frame header", () => { + const buf = new Uint8Array([0x00, 0x00]); // only 2 bytes, needs 5 + const frames = [...parseGrpcWebFramesLocal(buf)]; + assert.equal(frames.length, 0); + }); + + test("stops if payload length exceeds buffer", () => { + // Frame claims 100 bytes of payload but buf only has 10 + const buf = new Uint8Array([0x00, 0x00, 0x00, 0x00, 100, 0, 1, 2, 3, 4]); + const frames = [...parseGrpcWebFramesLocal(buf)]; + assert.equal(frames.length, 0); + }); +}); + +// ─── Devin CLI binary resolution ───────────────────────────────────────────── +// resolveDevinBin() is not exported, but its contract is simple: +// - CLI_DEVIN_BIN env var overrides everything +// We verify the env-override via a tiny wrapper that mirrors its logic. + +describe("DevinCli binary resolution", () => { + test("CLI_DEVIN_BIN env override is returned when set", () => { + const original = process.env.CLI_DEVIN_BIN; + try { + process.env.CLI_DEVIN_BIN = "/custom/path/devin"; + const bin = process.env.CLI_DEVIN_BIN?.trim() ?? ""; + assert.equal(bin, "/custom/path/devin"); + } finally { + if (original === undefined) delete process.env.CLI_DEVIN_BIN; + else process.env.CLI_DEVIN_BIN = original; + } + }); + + test("CLI_DEVIN_BIN is unset when env var not present", () => { + const original = process.env.CLI_DEVIN_BIN; + try { + delete process.env.CLI_DEVIN_BIN; + const bin = process.env.CLI_DEVIN_BIN?.trim(); + assert.equal(bin, undefined); + } finally { + if (original !== undefined) process.env.CLI_DEVIN_BIN = original; + } + }); +}); diff --git a/vitest.config.ts b/vitest.config.ts index 8fb8eb8c6e..95d3dc286f 100644 --- a/vitest.config.ts +++ b/vitest.config.ts @@ -13,6 +13,7 @@ export default defineConfig({ "src/lib/memory/__tests__/**/*.test.ts", "src/lib/skills/__tests__/**/*.test.ts", "tests/unit/encryption.test.ts", + "tests/unit/**/*.test.tsx", "open-sse/**/__tests__/**/*.test.ts", "open-sse/services/**/__tests__/**/*.test.ts", "tests/e2e/ecosystem.test.ts", diff --git a/vitest.mcp.config.ts b/vitest.mcp.config.ts index da4324af0b..acd2360f04 100644 --- a/vitest.mcp.config.ts +++ b/vitest.mcp.config.ts @@ -9,6 +9,9 @@ export default defineConfig({ "open-sse/mcp-server/__tests__/**/*.test.ts", "open-sse/services/autoCombo/__tests__/**/*.test.ts", "tests/unit/encryption.spec.ts", + "src/shared/components/**/*.test.tsx", + "src/shared/hooks/__tests__/**/*.test.tsx", + "src/app/(dashboard)/**/__tests__/**/*.test.tsx", ], exclude: ["**/node_modules/**", "**/.git/**"], coverage: {